nvchecker/README.rst
lilydjwg 1ceea05e15 trim down README and link the docs from readthedocs
It doesn't link well on GitHub.
2020-09-03 16:39:51 +08:00

60 lines
1.5 KiB
ReStructuredText

**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 that is in beta. Things may still change without backward-compatibility.
For the old version 1.x, please switch to the ``v1.x`` branch.
.. image:: https://travis-ci.org/lilydjwg/nvchecker.svg?branch=master
:alt: Build Status
:target: https://travis-ci.org/lilydjwg/nvchecker
.. image:: https://badge.fury.io/py/nvchecker.svg
:alt: PyPI version
:target: https://badge.fury.io/py/nvchecker
|
.. image:: https://repology.org/badge/vertical-allrepos/nvchecker.svg
:alt: Packaging status
:target: https://repology.org/metapackage/nvchecker/versions
.. contents::
:local:
Dependency
----------
- Python 3.7+
- Python library: structlog, toml, appdirs
- One of these Python library combinations (ordered by preference):
* tornado + pycurl
* aiohttp
* httpx with http2 support
* 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::
python3 setup.py 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/>`_.