New version checker for software releases
Find a file
David Arnold f8a73a5a92
docs: document changes don't mention the old keys
while the old way of declaring the keys is still available it is no longer documented

this should encourage new users to use the new, netrc-compatible way
2024-03-04 12:54:13 +01:00
.github/workflows update github actions 2024-02-27 15:03:38 +08:00
docs docs: document changes don't mention the old keys 2024-03-04 12:54:13 +01:00
nvchecker feat: add netrc support 2024-03-02 10:46:46 +01:00
nvchecker_source feat: add configurable host to github 2024-03-02 10:47:50 +01:00
scripts nvchecker-notify: accept and pass --tries and --failures to nvchecker 2023-10-03 17:28:34 +02:00
tests support using prefix and from_pattern/to_pattern at the same time 2024-02-27 13:52:35 +08:00
.gitignore introduce tox support 2022-03-03 09:56:33 -08:00
.readthedocs.yaml fix readthedocs 2023-08-26 11:47:34 +08:00
.typos.toml fix typos 2022-04-21 17:16:34 +08:00
keyfile.toml.enc update keyfile.toml.enc 2021-07-27 16:06:39 +08:00
LICENSE add MIT LICENSE 2017-02-04 16:36:48 +08:00
mypy.ini silence mypy for new module 2023-05-08 23:28:20 +08:00
pyproject.toml PyPI signature support is gone 2023-06-17 22:27:21 +08:00
README.rst drop support for Python 3.7 2023-12-09 20:38:23 +08:00
sample_config.toml rename sample_source.toml to sample_config.toml 2020-10-02 12:35:37 +08:00
setup.cfg drop support for Python 3.7 2023-12-09 20:38:23 +08:00
tox.ini drop support for Python 3.7 2023-12-09 20:38:23 +08:00

**nvchecker** (short for *new version checker*) is for checking if a new version of some software has been released.

This is the version 2.0 branch. For the old version 1.x, please switch to the ``v1.x`` branch.

.. image:: https://github.com/lilydjwg/nvchecker/workflows/run%20tests/badge.svg?branch=master
   :alt: Test Status
   :target: https://github.com/lilydjwg/nvchecker/actions?query=workflow%3A%22run+tests%22
.. image:: https://badge.fury.io/py/nvchecker.svg
   :alt: PyPI version
   :target: https://badge.fury.io/py/nvchecker
.. image:: https://readthedocs.org/projects/nvchecker/badge/?version=latest
   :target: https://nvchecker.readthedocs.io/en/latest/?badge=latest
   :alt: Documentation Status

|

.. image:: https://repology.org/badge/vertical-allrepos/nvchecker.svg
   :alt: Packaging status
   :target: https://repology.org/metapackage/nvchecker/versions

.. contents::
   :local:

Dependency
----------
- Python 3.8+
- Python library: structlog, platformdirs, tomli (on Python < 3.11)
- One of these Python library combinations (ordered by preference):

  * tornado + pycurl
  * aiohttp
  * httpx with http2 support (experimental; only latest version is supported)
  * tornado

- All commands used in your software version configuration files

Install and Run
---------------
To install::

  pip3 install nvchecker

To use the latest code, you can also clone this repository and run::

  pip install .

To see available options::

  nvchecker --help

Run with one or more software version files::

  nvchecker -c config_file

You normally will like to specify some "version record files"; see below.

Documentation
-------------

For detailed documentation, see `https://nvchecker.readthedocs.io/en/latest/ <https://nvchecker.readthedocs.io/en/latest/>`_.