https://github.com/zopefoundation/z3c.checkversions
Find newer package versions on PyPI
https://github.com/zopefoundation/z3c.checkversions
maintained
Last synced: 8 months ago
JSON representation
Find newer package versions on PyPI
- Host: GitHub
- URL: https://github.com/zopefoundation/z3c.checkversions
- Owner: zopefoundation
- License: other
- Created: 2013-03-02T01:43:08.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2025-05-08T15:23:57.000Z (about 1 year ago)
- Last Synced: 2025-07-13T16:53:59.513Z (11 months ago)
- Topics: maintained
- Language: Python
- Homepage:
- Size: 179 KB
- Stars: 2
- Watchers: 62
- Forks: 6
- Open Issues: 2
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGES.rst
- Contributing: CONTRIBUTING.md
- License: LICENSE.rst
Awesome Lists containing this project
README
Introduction
============
Find newer versions of your installed Python packages, or newer versions of
packages in a buildout file.
This package provides a console script named ``checkversions``.
.. image:: https://github.com/zopefoundation/z3c.checkversions/actions/workflows/tests.yml/badge.svg
:target: https://github.com/zopefoundation/z3c.checkversions/actions/workflows/tests.yml
.. contents::
Install
=======
you can install this package either in a virtualenv::
$ virtualenv sandbox
$ sandbox/bin/pip install z3c.checkversions
$ sandbox/bin/checkversions --help
or in your system::
$ sudo pip install z3c.checkversions
$ checkversions --help
or in a buildout::
[buildout]
parts = checkversions
[checkversions]
recipe=zc.recipe.egg
eggs=z3c.checkversions [buildout]
Note that buildout support is optional and must be enabled with [buildout] so
that zc.buildout is installed as well.
If you need buildout support while installing this package via pip
you have to install it like this:
pip install z3c.checkversions[buildout]
Usage
=====
::
$ 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)
Examples
========
For installed packages
----------------------
Example with a virtualenv::
$ 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
For a buildout
--------------
It can work either with a full buildout.cfg or with a simple versions.cfg file.
Here is a sample `versions.cfg` file::
[versions]
somepackage=0.5.3
otherpackage=0.1.1
You can generate a new 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
If you provide a blacklist file, such as `blacklist.cfg` containing bad
versions, such as::
somepackage=0.6.2
somepackage=0.6.1
Then these versions won't be suggested::
$ 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
If you enable the `--incremental` option, only one upgrade will be suggested::
$ checkversions --incremental -v -l 1 versions.cfg
# Checking buildout file versions.cfg
somepackage=0.6.0 # was: 0.5.0
otherpackage=0.1.1
Run tests
=========
Uncompress the archive, then run::
$ virtualenv .
$ bin/pip install tox
$ tox