codekingpro/portable-devtools

1"""Record of phased-in incompatible language changes.2 3Each line is of the form:4 5    FeatureName = "_Feature(" OptionalRelease "," MandatoryRelease ","6                              CompilerFlag ")"7 8where, normally, OptionalRelease < MandatoryRelease, and both are 5-tuples9of the same form as sys.version_info:10 11    (PY_MAJOR_VERSION, # the 2 in 2.1.0a3; an int12     PY_MINOR_VERSION, # the 1; an int13     PY_MICRO_VERSION, # the 0; an int14     PY_RELEASE_LEVEL, # "alpha", "beta", "candidate" or "final"; string15     PY_RELEASE_SERIAL # the 3; an int16    )17 18OptionalRelease records the first release in which19 20    from __future__ import FeatureName21 22was accepted.23 24In the case of MandatoryReleases that have not yet occurred,25MandatoryRelease predicts the release in which the feature will become part26of the language.27 28Else MandatoryRelease records when the feature became part of the language;29in releases at or after that, modules no longer need30 31    from __future__ import FeatureName32 33to use the feature in question, but may continue to use such imports.34 35MandatoryRelease may also be None, meaning that a planned feature got36dropped or that the release version is undetermined.37 38Instances of class _Feature have two corresponding methods,39.getOptionalRelease() and .getMandatoryRelease().40 41CompilerFlag is the (bitfield) flag that should be passed in the fourth42argument to the builtin function compile() to enable the feature in43dynamically compiled code.  This flag is stored in the .compiler_flag44attribute on _Future instances.  These values must match the appropriate45#defines of CO_xxx flags in Include/cpython/compile.h.46 47No feature line is ever to be deleted from this file.48"""49 50all_feature_names = [51    "nested_scopes",52    "generators",53    "division",54    "absolute_import",55    "with_statement",56    "print_function",57    "unicode_literals",58    "barry_as_FLUFL",59    "generator_stop",60    "annotations",61]62 63__all__ = ["all_feature_names"] + all_feature_names64 65# The CO_xxx symbols are defined here under the same names defined in66# code.h and used by compile.h, so that an editor search will find them here.67# However, they're not exported in __all__, because they don't really belong to68# this module.69CO_NESTED = 0x0010                      # nested_scopes70CO_GENERATOR_ALLOWED = 0                # generators (obsolete, was 0x1000)71CO_FUTURE_DIVISION = 0x20000            # division72CO_FUTURE_ABSOLUTE_IMPORT = 0x40000     # perform absolute imports by default73CO_FUTURE_WITH_STATEMENT = 0x80000      # with statement74CO_FUTURE_PRINT_FUNCTION = 0x100000     # print function75CO_FUTURE_UNICODE_LITERALS = 0x200000   # unicode string literals76CO_FUTURE_BARRY_AS_BDFL = 0x40000077CO_FUTURE_GENERATOR_STOP = 0x800000     # StopIteration becomes RuntimeError in generators78CO_FUTURE_ANNOTATIONS = 0x1000000       # annotations become strings at runtime79 80 81class _Feature:82 83    def __init__(self, optionalRelease, mandatoryRelease, compiler_flag):84        self.optional = optionalRelease85        self.mandatory = mandatoryRelease86        self.compiler_flag = compiler_flag87 88    def getOptionalRelease(self):89        """Return first release in which this feature was recognized.90 91        This is a 5-tuple, of the same form as sys.version_info.92        """93        return self.optional94 95    def getMandatoryRelease(self):96        """Return release in which this feature will become mandatory.97 98        This is a 5-tuple, of the same form as sys.version_info, or, if99        the feature was dropped, or the release date is undetermined, is None.100        """101        return self.mandatory102 103    def __repr__(self):104        return "_Feature" + repr((self.optional,105                                  self.mandatory,106                                  self.compiler_flag))107 108 109nested_scopes = _Feature((2, 1, 0, "beta",  1),110                         (2, 2, 0, "alpha", 0),111                         CO_NESTED)112 113generators = _Feature((2, 2, 0, "alpha", 1),114                      (2, 3, 0, "final", 0),115                      CO_GENERATOR_ALLOWED)116 117division = _Feature((2, 2, 0, "alpha", 2),118                    (3, 0, 0, "alpha", 0),119                    CO_FUTURE_DIVISION)120 121absolute_import = _Feature((2, 5, 0, "alpha", 1),122                           (3, 0, 0, "alpha", 0),123                           CO_FUTURE_ABSOLUTE_IMPORT)124 125with_statement = _Feature((2, 5, 0, "alpha", 1),126                          (2, 6, 0, "alpha", 0),127                          CO_FUTURE_WITH_STATEMENT)128 129print_function = _Feature((2, 6, 0, "alpha", 2),130                          (3, 0, 0, "alpha", 0),131                          CO_FUTURE_PRINT_FUNCTION)132 133unicode_literals = _Feature((2, 6, 0, "alpha", 2),134                            (3, 0, 0, "alpha", 0),135                            CO_FUTURE_UNICODE_LITERALS)136 137barry_as_FLUFL = _Feature((3, 1, 0, "alpha", 2),138                          (4, 0, 0, "alpha", 0),139                          CO_FUTURE_BARRY_AS_BDFL)140 141generator_stop = _Feature((3, 5, 0, "beta", 1),142                          (3, 7, 0, "alpha", 0),143                          CO_FUTURE_GENERATOR_STOP)144 145annotations = _Feature((3, 7, 0, "beta", 1),146                       None,147                       CO_FUTURE_ANNOTATIONS)148