defrost 0.4.0

PipFreeze

PipFreeze 接收 pip freeze 输出作为输入并内部构建包。

>>> from defrost import PipFreeze

>>> pip_freeze_output = """\
foo==1.2.3
bar==2.0
"""

>>> pip_freeze = PipFreeze(pip_freeze_output)
>>> len(pip_freeze)
2

>>> list(pip_freeze)
[Package(foo==1.2.3), Package(bar==2.0)]

# test presence of package foo that is less or equal to v2.0
>>> 'foo<=2.0' in pip_freeze
True

# test presence of any version of package zoo
>>> 'zoo' in pip_freeze
False

# test can also be done with a Package instance
>>> Package('foo==0.1') in pip_freeze
False

# ... or with a Requirement
>>> Requirement('bar>=2.0') in pip_freeze
True

包弃用

您可以通过加载 YAML 需求文件并将结果传递给 PipFreeze.load_requirements() 来标记包为弃用。如果 PipFreeze 中的包不满足加载的需求，则这些包将被标记为弃用。您还可以提供一个可选的理由来解释为什么包被弃用。

>>> pip_freeze = PipFreeze("""\
foobar==0.8
bar==2.0
ordereddict==1.1
""")

>>> import yaml
>>> reqs = yaml.load(open('my-reqs.yaml'))
>>> pip_freeze.load_requirements(reqs)
>>> pip_freeze.deprecated
[Package(foobar==0.8), Package(ordereddict==1.1)]
>>> for package in pip_freeze.deprecated:
...     print("%s: deprecated=%s, deprecated_by=%s, reason=%s" % (
            package, package.deprecated, package.deprecated_by, package.deprecation_reason
        ))
...
Package(foobar==0.8): deprecated=True, deprecated_by=Requirement(foobar>=1.0), reason=foobar pre-1.0 is no longer supported, please upgrade to 1.x
Package(ordereddict==1.1): deprecated=True, deprecated_by=Requirement(ordereddict<0.0), reason=ordereddict is part of Python 2.7 and above. If you are still running Python 2.6, please upgrade!

包

包接受精确的包版本作为输入。

>>> from defrost import Package

>>> package = Package('foo==1.2')
>>> package.name
'foo'
>>> package.version
'1.2'

如果您在需求中没有传递精确的版本，则会引发一个 ValueError。

>>> package = Package('foo')
>>> Package('foo')
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
    ...
ValueError: foo does not represent an exact package version; the format should be foo==1.0

您还可以手动弃用包

>>> package = Package('foo==1.2')
>>> package.deprecated
False
>>> package.deprecate(reason='because')
>>> package.deprecated
True
>>> package.deprecation_reason
'because'

需求

需求表示一系列包版本。

>>> from defrost import Requirement

>>> req = Requirement('foo>=1.0,<2.0')
>>> req.name
'foo'
>>> req.specifier
[('>=', '1.0'), ('<', '2.0')]

需求与包配合良好。使用 Python 操作符 in，您可以检查一个包是否满足需求。

>>> req = Requirement('foo>=1.0')
>>> Package('foo==1.0') in req
True
>>> Package('foo==2.0') in req
True
>>> Package('foo==0.1') in req
False