rez.rex_bindings#
Provides wrappers for various types for binding to Rex. We do not want to bind object instances directly in Rex, because this would create an indirect dependency between rex code in package.py files, and versions of Rez.
The classes in this file are intended to have simple interfaces that hide unnecessary data from Rex, and provide APIs that will not change.
- class rez.rex_bindings.VersionBinding#
Bases:
Binding
Binds a version.Version object.
Examples
>>> v = VersionBinding(Version("1.2.3alpha")) >>> v.major 1 >>> v.patch '3alpha' >>> len(v) 3 >>> v[1] 2 >>> v[:3] (1, 2, '3alpha') >>> str(v) '1.2.3alpha' >>> print(v[5]) None >>> v.as_tuple(): (1, 2, '3alpha')
- __init__(version)#
- property major#
- property minor#
- property patch#
- as_tuple()#
- class rez.rex_bindings.VariantBinding#
Bases:
Binding
Binds a packages.Variant object.
- __init__(variant, cached_root=None, interpreter=None)#
- property root#
This is here to support package caching. This ensures that references such as ‘resolve.mypkg.root’ resolve to the cached payload location, if the package is cached.
- class rez.rex_bindings.RO_MappingBinding#
Bases:
Binding
A read-only, dict-like object.
- __init__(data)#
- get(name, default=None)#
- class rez.rex_bindings.VariantsBinding#
Bases:
RO_MappingBinding
Binds a list of packages.VariantBinding objects, under the package name of each variant.
- __init__(variant_bindings)#
- get(name, default=None)#
- class rez.rex_bindings.RequirementsBinding#
Bases:
RO_MappingBinding
Binds a list of version.Requirement objects.
- __init__(requirements)#
- get_range(name, default=None)#
Returns requirement version range object
- get(name, default=None)#
- class rez.rex_bindings.EphemeralsBinding#
Bases:
RO_MappingBinding
Binds a list of resolved ephemeral packages.
Note
The leading ‘.’ is implied when referring to ephemerals. Eg:
# in package.py def commands(): if "foo.cli" in ephemerals: # will match '.foo.cli-*' request
- __init__(ephemerals)#
- get_range(name, default=None)#
Returns ephemeral version range object
- get(name, default=None)#
- rez.rex_bindings.intersects(obj, range_)#
Test if an object intersects with the given version range.
Examples
# in package.py def commands(): # test a request if intersects(request.maya, '2019+'): info('requested maya allows >=2019.*') # tests if a resolved version intersects with given range if intersects(resolve.maya, '2019+') ... # same as above if intersects(resolve.maya.version, '2019+') ...
# disable my cli tools if .foo.cli-0 was specified def commands(): if intersects(ephemerals.get('foo.cli', '1'), '1'): env.PATH.append('{root}/bin')
- Parameters:
obj (VariantBinding or str) – Object to test, either a variant, or requirement string (eg ‘foo-1.2.3+’).
range (str) – Version range, eg ‘1.2+<2’
- Returns:
True if the object intersects the given range.
- Return type: