SageMath version and banner info¶
- sage.misc.banner.banner()[source]¶
- Print the Sage banner. - OUTPUT: none - If the environment variable - SAGE_BANNERis set to- no, no banner is displayed. If- SAGE_BANNERis set to- bare, a simplified plain ASCII banner is displayed. Otherwise, the full banner with box art is displayed.- EXAMPLES: - sage: import sage.misc.banner; sage.misc.banner.SAGE_BANNER = '' sage: sage.misc.banner.banner() ┌────────────────────────────────────────────────────────────────────┐ │ SageMath version ..., Release Date: ... │ │ Using Python .... Type "help()" for help. │ ... - >>> from sage.all import * >>> import sage.misc.banner; sage.misc.banner.SAGE_BANNER = '' >>> sage.misc.banner.banner() ┌────────────────────────────────────────────────────────────────────┐ │ SageMath version ..., Release Date: ... │ │ Using Python .... Type "help()" for help. │ ... 
- sage.misc.banner.banner_text(full=True)[source]¶
- Text for the Sage banner. - INPUT: - full– boolean (default:- True)
 - OUTPUT: - A string containing the banner message. - If option full is - False, a simplified plain ASCII banner is displayed; if- Truethe full banner with box art is displayed.- EXAMPLES: - sage: print(sage.misc.banner.banner_text(full=True)) ┌────────────────────────────────────────────────────────────────────┐ │ SageMath version ... sage: print(sage.misc.banner.banner_text(full=False)) SageMath version ..., Release Date: ... - >>> from sage.all import * >>> print(sage.misc.banner.banner_text(full=True)) ┌────────────────────────────────────────────────────────────────────┐ │ SageMath version ... >>> print(sage.misc.banner.banner_text(full=False)) SageMath version ..., Release Date: ... 
- sage.misc.banner.require_version(major, minor=0, tiny=0, prerelease=False, print_message=False)[source]¶
- Return - Trueif Sage version is at least- major.minor.tiny.- INPUT: - major– integer
- minor– integer (default: 0)
- tiny– float (default: 0)
- prerelease– boolean (default:- False)
- print_message– boolean (default:- False)
 - OUTPUT: - Trueif- major.minor.tinyis <= version of Sage,- Falseotherwise- For example, if the Sage version number is 3.1.2, then require_version(3, 1, 3) will return False, while require_version(3, 1, 2) will return True. If the Sage version is 3.1.2.alpha0, then require_version(3, 1, 1) will return True, while, by default, require_version(3, 1, 2) will return False. Note, though, that require_version(3, 1, 2, prerelease=True) will return True: if the optional argument prerelease is True, then a prerelease version of Sage counts as if it were the released version. - If optional argument print_message is - Trueand this function is returning False, print a warning message.- EXAMPLES: - sage: from sage.misc.banner import require_version sage: require_version(2, 1, 3) True sage: require_version(821, 4) False sage: require_version(821, 4, print_message=True) This code requires at least version 821.4 of SageMath to run correctly. You are running version ... False - >>> from sage.all import * >>> from sage.misc.banner import require_version >>> require_version(Integer(2), Integer(1), Integer(3)) True >>> require_version(Integer(821), Integer(4)) False >>> require_version(Integer(821), Integer(4), print_message=True) This code requires at least version 821.4 of SageMath to run correctly. You are running version ... False 
- sage.misc.banner.version()[source]¶
- Return the version of Sage. - OUTPUT: string - EXAMPLES: - sage: version() 'SageMath version ..., Release Date: ...' - >>> from sage.all import * >>> version() 'SageMath version ..., Release Date: ...' 
- sage.misc.banner.version_dict()[source]¶
- A dictionary describing the version of Sage. - OUTPUT: dictionary with keys ‘major’, ‘minor’, ‘tiny’, ‘prerelease’ - This process the Sage version string and produces a dictionary. It expects the Sage version to be in one of these forms: - N.N N.N.N N.N.N.N N.N.str N.N.N.str N.N.N.N.str - where ‘N’ stands for an integer and ‘str’ stands for a string. The first integer is stored under the ‘major’ key and the second integer under ‘minor’. If there is one more integer, it is stored under ‘tiny’; if there are two more integers, then they are stored together as a float N.N under ‘tiny’. If there is a string, then the key ‘prerelease’ returns True. - For example, if the Sage version is ‘3.2.1’, then the dictionary is {‘major’: 3, ‘minor’: 2, ‘tiny’: 1, ‘prerelease’: False}. If the Sage version is ‘3.2.1.2’, then the dictionary is {‘major’: 3, ‘minor’: 2, ‘tiny’: 1.200…, ‘prerelease’: False}. If the Sage version is ‘3.2.alpha0’, then the dictionary is {‘major’: 3, ‘minor’: 2, ‘tiny’: 0, ‘prerelease’: True}. - EXAMPLES: - sage: from sage.misc.banner import version_dict sage: print("SageMath major version is %s" % version_dict()['major']) SageMath major version is ... sage: version_dict()['major'] == int(sage.version.version.split('.')[0]) True - >>> from sage.all import * >>> from sage.misc.banner import version_dict >>> print("SageMath major version is %s" % version_dict()['major']) SageMath major version is ... >>> version_dict()['major'] == int(sage.version.version.split('.')[Integer(0)]) True