nvchecker/README.rst

61 lines
1.7 KiB
ReStructuredText
Raw Normal View History

2013-05-26 14:20:14 +00:00
**nvchecker** (short for *new version checker*) is for checking if a new version of some software has been released.
2020-10-01 06:41:35 +00:00
This is the version 2.0 branch. For the old version 1.x, please switch to the ``v1.x`` branch.
2020-08-21 10:16:44 +00:00
2021-02-01 09:43:55 +00:00
.. 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
2015-11-11 06:31:25 +00:00
.. image:: https://badge.fury.io/py/nvchecker.svg
2015-11-11 06:20:49 +00:00
:alt: PyPI version
2017-07-06 08:14:18 +00:00
:target: https://badge.fury.io/py/nvchecker
2020-09-03 08:53:29 +00:00
.. image:: https://readthedocs.org/projects/nvchecker/badge/?version=latest
:target: https://nvchecker.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
2019-03-16 13:32:00 +00:00
2018-12-16 06:17:58 +00:00
|
2019-03-16 13:32:00 +00:00
.. image:: https://repology.org/badge/vertical-allrepos/nvchecker.svg
:alt: Packaging status
:target: https://repology.org/metapackage/nvchecker/versions
.. contents::
:local:
2013-05-26 15:22:21 +00:00
Dependency
2020-09-03 08:27:35 +00:00
----------
2020-08-21 09:42:31 +00:00
- Python 3.7+
- Python library: structlog, platformdirs, tomli (on Python < 3.11)
2018-04-11 08:45:19 +00:00
- One of these Python library combinations (ordered by preference):
2017-07-08 06:58:46 +00:00
* tornado + pycurl
* aiohttp
2020-09-23 09:11:56 +00:00
* httpx with http2 support (experimental; only latest version is supported)
2017-07-08 06:58:46 +00:00
* tornado
2020-08-26 17:55:11 +00:00
- All commands used in your software version configuration files
2013-05-26 15:22:21 +00:00
Install and Run
2020-09-03 08:27:35 +00:00
---------------
To install::
pip3 install nvchecker
To use the latest code, you can also clone this repository and run::
pip install .
2013-05-26 15:22:21 +00:00
To see available options::
nvchecker --help
2013-05-26 15:22:21 +00:00
2020-08-21 09:42:31 +00:00
Run with one or more software version files::
2013-05-26 15:22:21 +00:00
2020-08-21 09:42:31 +00:00
nvchecker -c config_file
2013-05-26 15:22:21 +00:00
You normally will like to specify some "version record files"; see below.
2013-05-26 15:22:21 +00:00
Documentation
-------------
2013-09-05 08:27:44 +00:00
For detailed documentation, see `https://nvchecker.readthedocs.io/en/latest/ <https://nvchecker.readthedocs.io/en/latest/>`_.