跳至主要内容

在PyPI上查找更新的软件包版本

项目描述

介绍

查找您已安装的Python包的新版本,或者查找构建文件中包的新版本。

此包提供了一个名为 checkversions 的控制台脚本。

https://github.com/zopefoundation/z3c.checkversions/actions/workflows/tests.yml/badge.svg

安装

您可以在虚拟环境中安装此包

$ virtualenv sandbox
$ sandbox/bin/pip install z3c.checkversions
$ sandbox/bin/checkversions --help

或在您的系统中

$ sudo pip install z3c.checkversions
$ checkversions --help

或在构建文件中

[buildout]
parts = checkversions

[checkversions]
recipe=zc.recipe.egg
eggs=z3c.checkversions [buildout]

请注意,构建文件支持是可选的,必须通过 [buildout] 启用,以便同时安装 zc.buildout。

如果您在通过 pip 安装此包时需要构建文件支持,您必须按如下方式安装

pip install z3c.checkversions[buildout]

用法

$ checkversions -h
Usage: checkversions [-v] [-1] [-l LEVEL] [-i INDEX] [-b BLACKLIST] [buildout_file]

This script will check new package versions of either your current installed
distributions or a buildout file if provided. It can detect major or minor
versions availability: level 0 gets the highest version (X.y.z), level 1 gets
the highest intermediate version (x.Y.z), level 2 gets the highest minor
version (x.y.Z).  Using level 2, you can automatically retrieve all bugfix
versions of a buildout.  If you provide a blacklist file with bad versions,
these versions won't be suggested.

Options:
  -h, --help            show this help message and exit
  -l LEVEL, --level=LEVEL
                        Version level to check
  -i INDEX, --index=INDEX
                        Provide and alternative package index URL
  -b BLACKLIST, --blacklist=BLACKLIST
                        Provide a blacklist file with bad versions
  -1, --incremental     Suggest only one upgrade. Skip others.
  -v, --verbose         Verbose mode (prints old versions too)

示例

对于已安装的包

虚拟环境示例

$ virtualenv --no-site-packages sandbox
$ sandbox/bin/pip install z3c.checkversions
$ sandbox/bin/checkversions -v -l 1
# Checking your installed distributions
pip=0.7.1 # was: 0.6.3

对于构建文件

它可以使用完整的 buildout.cfg 或简单的 versions.cfg 文件。

以下是一个示例 versions.cfg 文件

[versions]
somepackage=0.5.3
otherpackage=0.1.1

您可以生成一个新的 versions.cfg

$ checkversions -v -l 1 versions.cfg
# Checking buildout file versions.cfg
somepackage=0.6.2 # was: 0.5.0
otherpackage=0.1.2 # was: 0.1.1

如果您提供了一个黑名单文件,例如包含不兼容版本(如)的 blacklist.cfg

somepackage=0.6.2
somepackage=0.6.1

则不会建议这些版本

$ checkversions -v -l 1 versions.cfg -b blacklist.cfg
# Checking buildout file versions.cfg
somepackage=0.6.0 # was: 0.5.0
otherpackage=0.1.2 # was: 0.1.1

如果您启用了 –incremental 选项,则只会建议一个升级

$ checkversions --incremental -v -l 1 versions.cfg
# Checking buildout file versions.cfg
somepackage=0.6.0 # was: 0.5.0
otherpackage=0.1.1

运行测试

解压存档,然后运行

$ virtualenv .
$ bin/pip install tox
$ tox

变更日志

2.1 (2023-02-06)

  • 修复真正是需求规范版本的解析问题。 (#24)

2.0 (2023-02-14)

  • 支持 Python 3.10、3.11。

  • 放弃对 Python 2.7、3.5、3.6 的支持。

  • setuptools < 66 锁定为新版本不再兼容。

1.2 (2020-04-13)

  • 支持 Python 3.8,放弃对 Python 3.4 的支持。

  • 在 zc.buildout 未安装的情况下改进错误消息。

  • 改进安装说明。

  • 将索引 URL 传递给“已安装”和“构建文件”检查器。

1.1 (2018-11-03)

  • 支持 Python 3.7。

  • 放弃对 python setup.py test 的支持。

1.0 (2018-05-23)

  • 通过使用 setuptools 8 中引入的 API 修复与 setuptools 39 的兼容性。 (GH #8)

  • 支持 Python 3.5、3.6 和 PyPy3。

  • 放弃对 Python 2.6 和 3.3 的支持。

  • 标准化命名空间 __init__

0.5 (2014-09-15)

  • 通过 Nicolas Dietrich 支持 Python 3 (GH #2GH #4)

0.4.2 (2013-10-02)

  • 在搜索新版本时忽略已安装的包,仅查找包索引(使测试套件更可靠,等等)。

  • 修复了当 buildout.cfg 包含带有空白版本锁定的包时的 IndexError: list index out of range。

  • 如果 PyPI 上有更新的非最终版本,则显示非最终包版本的更新(GH #1

0.4.1 (2010-08-25)

  • 修复了 1.0 从未更新到 1.0.x 的边缘案例错误。

  • 警告构建文件用户有关额外需求

0.4 (2010-07-26)

  • 添加了一个 blacklist 选项,用于传递要避免的版本(可能来自 buildbot)

  • 添加了一个 incremental 选项,以建议仅进行一次升级

  • 在测试期间删除临时文件

0.3 (2010-07-09)

  • 不要累积旧评论

  • 首选最终版本

0.2 (2010-05-22)

  • 添加了一个详细选项,以打印旧版本

  • 更新元数据、文档和许可证

0.1 (2010-05-16)

  • 初始发布

项目详情


下载文件

下载您平台的文件。如果您不确定要选择哪个,请了解更多关于 安装包 的信息。

源代码分发

z3c.checkversions-2.1.tar.gz (15.8 kB 查看哈希值)

上传时间 源代码

构建分发

z3c.checkversions-2.1-py3-none-any.whl (17.2 kB 查看哈希值)

上传时间 Python 3

由以下支持