buildout-versions-checker 1.10.0

用法

如果您使用将所有在buildout中使用的egg版本钉到文件的实用约定，您会发现这个包在检查Pypi上是否有最新的egg版本时很有用。

以下是一个版本文件的示例

$ cat versions.cfg
[versions]
Pillow                          = 2.0.0
pytz                            = 2012j
South                           = 0.8.1
django                          = 1.5
django-tagging                  = 0.3.1

现在让我们执行check-buildout-updates脚本

$ ./check-buildout-updates
[versions]
Pillow                          = 2.1.0
pytz                            = 2013b
South                           = 0.8.2
django                          = 1.5.2

您现在可以根据需要相应地更新versions.cfg文件。

选项

usage: check-buildout-updates [-h] [--pre] [-s SPECIFIERS] [-i INCLUDES]
                              [-e EXCLUDES] [-w] [--indent INDENTATION]
                              [--sorting {alpha,ascii,length}]
                              [--service-url SERVICE_URL] [--timeout TIMEOUT]
                              [-t THREADS] [-v] [-q]
                              [source]

Check availables updates from a version section of a buildout script

positional arguments:
  source                The file where versions are pinned (default:
                        versions.cfg)

optional arguments:
  -h, --help            show this help message and exit

Allowed versions:
  --pre                 Allow pre-releases and development versions (by
                        default only stable versions are found)
  -s SPECIFIERS, --specifier SPECIFIERS
                        Describe what versions of a package are acceptable.
                        Example "package:>=1.0,!=1.3.4.*,< 2.0" (can be used
                        multiple times)

Filtering:
  -i INCLUDES, --include INCLUDES
                        Include package when checking updates (can be used
                        multiple times)
  -e EXCLUDES, --exclude EXCLUDES
                        Exclude package when checking updates (can be used
                        multiple times)

File:
  -w, --write           Write the updates in the source file
  --indent INDENTATION  Spaces used when indenting "key = value" (default:
                        auto)
  --sorting {alpha,ascii,length}
                        Sorting algorithm used on the keys when writing source
                        file (default: None)

Network:
  --service-url SERVICE_URL
                        The service to use for checking the packages (default:
                        https://pypi.python.org/pypi)
  --timeout TIMEOUT     Timeout for each request (default: 10s)
  -t THREADS, --threads THREADS
                        Threads used for checking the versions in parallel

Verbosity:
  -v                    Increase verbosity (specify multiple times for more)
  -q                    Decrease verbosity (specify multiple times for more)

Buildout集成

您可以轻松地将此脚本集成到buildout脚本中，以自动查找和写入更新。

[buildout]
parts                   = evolution

[evolution]
recipe                  = zc.recipe.egg
eggs                    = buildout-versions-checker
scripts                 = check-buildout-updates=evolve
arguments               = '-w --indent 24 -s django:<1.8 buildout.cfg'

在buildout中加入这部分后，将创建一个名为./bin/evolve的新脚本。它将检查versions.cfg文件versions部分中列出的egg的可用更新，然后写入找到的更新。

Python兼容性

Buildout-versions-checker最初是为Python 2.7开发的，但已移植并测试了Python 3.4及其以上版本。

自1.10.0版本起，项目兼容性从Python 3.7开始，更高。

要求

• packaging >= 16

额外功能

Buildout-versions-checker还提供了一些额外的脚本，用于简化版本文件的管理。

$ ./indent-buildout buildout.cfg versions.cfg

$ ./find-unused-versions