os-traits 0.1.0

A library containing standardized trait strings

A library containing standardized trait strings.

Traits are strings that represent a feature of some resource provider. This library contains the catalog of constants that have been standardized in the OpenStack community to refer to a particular hardware, virtualization, storage, network, or device trait.

• Free software: Apache license

• Documentation: http://docs.openstack.org/developer/os-traits

• Source: http://git.openstack.org/cgit/openstack/os-traits

• Bugs: http://bugs.launchpad.net/os-traits

Usage

os-traits is primarily composed of a set of constants that may be referenced by simply importing the os_traits module and referencing one of the module’s traits constants:

$ python
Python 2.7.11+ (default, Apr 17 2016, 14:00:29)
[GCC 5.3.1 20160413] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> import os_traits as ot
>>> print ot.HW_CPU_X86_SSE42
hw:cpu:x86:sse42

Don’t know what the symbol names are for the os_traits module? There’s a helper method for that:

>>> import pprint
>>> pprint.pprint(ot.get_symbol_names())
[...
<snip>
'HW_CPU_X86_AVX2',
'HW_CPU_X86_SGX',
'HW_CPU_X86_AVX',
'HW_CPU_X86_AVX512BW',
'HW_CPU_X86_AVX512DQ',
'HW_CPU_X86_SSE',
'HW_CPU_X86_SHA',
'HW_CPU_X86_AVX512F',
'HW_CPU_X86_F16C',
'HW_CPU_X86_SSE41',
'HW_CPU_X86_SSE42',
'HW_CPU_X86_VMX',
'HW_CPU_X86_ASF',
'HW_CPU_X86_BMI2',
'HW_CPU_X86_CLMUL',
'HW_CPU_X86_AVX512VL',
'HW_CPU_X86_AVX512PF',
'HW_CPU_X86_XOP',
'HW_CPU_X86_BMI',
'HW_CPU_X86_ABM',
'HW_CPU_X86_3DNOW']

Want to see the trait strings for a subset of traits? There’s a method for that too:

>>> pprint.pprint(ot.get_traits(ot.NAMESPACES['x86']))
['hw:cpu:x86:aes-ni',
'hw:cpu:x86:avx512er',
'hw:cpu:x86:avx512cd',
'hw:cpu:x86:tbm',
'hw:cpu:x86:tsx',
'hw:cpu:x86:fma3',
'hw:cpu:x86:svm',
'hw:cpu:x86:fma4',
'hw:cpu:x86:mpx',
'hw:cpu:x86:sse2',
'hw:cpu:x86:sse3',
'hw:cpu:x86:mmx',
'hw:cpu:x86:ssse3',
'hw:cpu:x86:sse4a',
'hw:cpu:x86:avx2',
'hw:cpu:x86:sgx',
'hw:cpu:x86:avx',
'hw:cpu:x86:avx512bw',
'hw:cpu:x86:avx512dq',
'hw:cpu:x86:sse',
'hw:cpu:x86:sha',
'hw:cpu:x86:avx512f',
'hw:cpu:x86:f16c',
'hw:cpu:x86:sse41',
'hw:cpu:x86:sse42',
'hw:cpu:x86:vmx',
'hw:cpu:x86:asf',
'hw:cpu:x86:bmi2',
'hw:cpu:x86:clmul',
'hw:cpu:x86:avx512vl',
'hw:cpu:x86:avx512pf',
'hw:cpu:x86:xop',
'hw:cpu:x86:bmi',
'hw:cpu:x86:abm',
'hw:cpu:x86:3dnow']