New version checker for software releases
Go to file
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
.github/workflows github actions: try run directly on ubuntu to speed up and get latest Python packages via pip 2020-08-17 22:09:54 +08:00
docs add documentation for plugins 2020-09-03 16:27:35 +08:00
nvchecker Merge branch 'master' of github.com:lilydjwg/nvchecker into master 2020-09-03 16:27:57 +08:00
nvchecker_source Fix f-string in github source 2020-09-03 04:38:14 +08:00
scripts Use f-string for better readability 2020-09-03 00:51:46 +08:00
tests tests/test_debianpkg: update 2020-09-03 16:30:32 +08:00
.gitignore port tools.py and change record files to use json format 2020-08-26 20:06:13 +08:00
.travis.yml travis-ci: use keyfile when KEY is set 2020-09-01 21:51:47 +08:00
keyfile.toml.enc final tweak of keyfile 2020-08-20 15:18:43 +08:00
LICENSE add MIT LICENSE 2017-02-04 16:36:48 +08:00
mypy.ini missing updates about the new "appdirs" dep 2020-08-31 17:50:11 +08:00
NEW update README and make new version master 2020-08-27 23:28:59 +08:00
README.rst trim down README and link the docs from readthedocs 2020-09-03 16:39:51 +08:00
sample_source.toml port tools.py and change record files to use json format 2020-08-26 20:06:13 +08:00
setup.cfg AsyncIO rewrite 2017-07-06 12:24:45 +08:00
setup.py use appdirs for the default configuration file 2020-08-31 17:34:11 +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 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/>`_.