Module pythondist

Decodes the 32bit hex representation of the Python distribution into a flat tuple of numbers.

Args:

ddat:

The 32bit value.

Returns:

Nametupel with the components:

PyDist = namedtuple('PyDist', ('category', 'disttype', 'dist', 'distrel'))

result := PyDist(
   PYE_PYTHON, <32bit-syntax-release>, <32bit-dist>, <32bit-dist-release>
 )

PYE_PYTHON:            32bit-enum for category
32bit-syntax-release:  32bit-value for syntax release
32bit-dist:            32bit-enum for distribution
32bit-dist-release:    32bit-value for distribution release

Raises:

pass-through

Decodes the 32bit hex representation of the Python distribution into a dict structure with str names and numeric release vectors.

Args:

ddat:

The 32bit value.

Returns:

Nametupel with the components:

PyDist = namedtuple('PyDist', ('category', 'disttype', 'dist', 'distrel'))

result := PyDist(
   PYE_PYTHON, (<syntax-major>,<syntax-minor>), <32bit-dist>, (<dist-major>, <dist-minor>, <dist-micro>)
 )

PYE_PYTHON:            32bit-enum for category
32bit-syntax-release:  32bit-value for syntax release
32bit-dist:            32bit-enum for distribution
32bit-dist-release:    32bit-value for distribution release

Dictionary with components:

result := {
   'category': 'python',
   'styntaxtype': (<syntax-major>,<syntax-minor>),
   'dist': <dist-name>,
   'distrel': (<dist-major>, <dist-minor>, <dist-micro>)
}

category:      canonical str name
syntax-major:  int value
syntax-minor:  int value
dist:          canonical str name
dist-major:    int value
dist-minor:    int value
dist-micro:    int value

Raises:

pass-through

Decodes the 32bit hex representation of the Python distribution into a dict structure with str names and str representation of releases.

Args:

ddat:

The 32bit value.

Returns:

Dictionary with components:

result := {
   'category': 'python',
   'styntaxtype': <str-syntax-release>,
   'dist': <dist-name>,
   'distrel': <str-dist-release>
}

category:            canonical str name
str-syntax-release:  string representation
dist:                canonical str name
str-dist-release:    string representation

Raises:

pass-through

Encodes the 32bit bitmask of the compressed platform information by the provided values of the sub fields. Non-provided values are set to 0, and though ignored.

This function is mainly designed and foreseen for cache preparation and test environments, though it inherently requires some of the systems performance. Thus do not use it within repetitive calls for performance critical large scale loops with small code sections.

Args:

kargs:

category:

The category. The only and one permitted is Python:

category := (
       PYE_PYTHON  # enum
     | 'Python'    # Pretty name
     | 'python'    # key
     | 0           # None
)

default := 0

dist:

The dist:

dist := (
       PYE_CPYTHON | PYE_IPYTHON | PYE_IRONPYTHON
     | PYE_JYTHON  | PYE_PYPY
     | PYE_CIRCUITPYTHON | PYE_MICROPYTHON
     | <known-name-of-dist>
     | 0
)
known-name-of-dist := "case insensitive name or pretty name of the distribution"
0 := None

default:=0

distrel:

The distrel:

distrel := (
       <int-val>
     | (<major>, <minor>, <micro>)
     | 0
)
int-val := the relative integer value of the distrel bits
(<major>, <minor>, <micro>):= the tuple of the Python distribution release
0 := None

default := 0

disttype:

The disttype:

disttype := (
       <int-val>
     | (<major>, <minor>)
     | 0
)
int-val := the relative integer value of the disttype bits
(<major>, <minor>) := the tuple of Python syntax version
0 := None

default := 0

Returns:

The 32bit compressed bitmask of the of the distribution.

Raises:

pass-through

Encodes the Python distribution by calculating the 32bit integer bitmask for the provided Python distribution and syntax release information.

Args:

d:

The numeric enum value of the distribution with original bit-positions.

dx:

The major distribution version number.

dy:

The minor distribution version number.

dz:

The micro distribution version number.

sma:

The major syntax version number.

smi:

The minor syntax version number.

Returns:

The 32bit bitmask.

See Python Distribution Categorization.

Raises:

pass-through

PYDIST_DATA

Value:

{"category": 0x80000000, "disttype": 0x34000000, "dist": 0x00040000, " distrel": 0x00003200, "hexrelease": 0xb4043200, "compiler": "GCC", "co mpiler_version": "7.3.1"}

SPLITVERS

Value:

re.compile('(?s)(^[0-9]+)[.]([0-9]*)[.]([0-9]*).*', re.DOTALL)

__cached__

Value:

'b'/local/hd1/home1/data/acue/rd/p-open-deploy/pythonids/repos/sourcef orge.net/pythonids/pythonids/__pycache__/pythondist.cpython-38.pyc''

__loader__

Value:

<_frozen_importlib_external.SourceFileLoader object at 0x7f51ac065850>

__spec__

Value:

ModuleSpec(name='pythonids.pythondist', loader=<_frozen_importlib_exte rnal.SourceFileLoader object at 0x7f51ac065850>, origin='/local/hd1/ho me1/data/acue/rd/p-open-deploy/pythonids/repos/sourceforge.net/pythoni ds/pythonids/pythondist.py')

attribute_map

Value:

{'b'c_compiler'': 'b'c_compiler'', 'b'c_compiler_version'': 'b'c_compiler_version'', 'b'c_libc_version'': 'b'c_libc_version'', 'b'category'': 'b'category'', 'b'compiler'': 'b'compiler'', 'b'compiler_version'': 'b'compiler_version'', 'b'dist'': 'b'dist'', 'b'distrel'': 'b'distrel'', ...

bash_map

Value:

{'b'c_compiler'': 'b'PYDIST_C_COMPILER'', 'b'c_compiler_version'': 'b'PYDIST_C_COMPILER_VERSION'', 'b'c_libc_version'': 'b'PYDIST_C_LIBC_VERSION'', 'b'category'': 'b'PYDIST_CATEGORY'', 'b'compiler'': 'b'PYDIST_COMPILER'', 'b'compiler_version'': 'b'PYDIST_COMPILER_VERSION'', 'b'dist'': 'b'PYDIST_DIST'', 'b'distrel'': 'b'PYDIST_DISTREL'', ...

dist2num

Value:

{524288: 524288, 'b'circuitpython'': 524288, 'b'CircuitPython'': 524288, 262144: 262144, 'b'cpython'': 262144, 'b'CPython'': 262144, 786432: 786432, 'b'cython'': 786432, ...

num2name

Value:

{0: 'b''', 262144: 'b'cpython'', 1048576: 'b'ipython'', 1310720: 'b'ironpython'', 1572864: 'b'jython'', 2097152: 'b'pypy'', 595591168: 'b'python2.7'', 847249408: 'b'python3.5'', ...

num2pretty

Value:

{0: 'b''', 262144: 'b'CPython'', 1048576: 'b'iPython'', 1310720: 'b'IronPython'', 1572864: 'b'Jython'', 2097152: 'b'PyPy'', 595591168: 'b'Python-2.7'', 847249408: 'b'Python-3.5'', ...