Skip to main content

Check for a newer version of your package and notify the user about it

Project description

Logo Vermon

PyPI - Status PyPI GitHub release (latest by date) License MIT

Index

About

Vermon monitors the version of the package specified on the pypi platform, compares the version of the package installed in your environment with the latest published version and, if less, shows a warning with instructions for updating in the terminal.

For example: suppose you created a package called foo and published version 1.0.0 in pypi. Some users are already using the foo package as a dependency on their projects. You found a bug and released a patch with the fix, now the latest version of foo is 1.0.1. All users using version 1.0.0 (less than the last release) of the package will receive a warning on the terminal similar to this one whenever they run the project:

> python your_project.py
You are using an old version of the foo package (v1.0.0)
a new version has been released (v1.0.1).
Please run: python -m pip install foo --upgrade

Now users know they have a dependency that needs to be updated ;)

Install

Use pipenv to install fordev in your environment. It will create a virtual environment and separate all dependencies and subdependencies from your global environment.

Install with pipenv

Create a directory and enter it:

$ mkdir my_project && cd my_project

Install with pipenv using:

$ pipenv install vermon

Now activate the virtual environment:

$ pipenv shell

Install with pip and virtualenv

Alternatively, if you don't want to use pipenv, use pip + virtualenv to do the same thing.

Create a directory and enter it:

$ mkdir my_project && cd my_project

Create and activate the virtual environment:

$ virtualenv venv && source venv/Scripts/activate

Note: In linux environment, use source venv/bin/activate to activate the virtual environment.

Now install with pip:

$ pip install vermon

Done, now you can start the job ;)

Use

To use the vermon package, call Vermon.run method in your package's __init__.py file:

from vermon import Vermon

Vermon.run(
    package='YOUR_PACKAGE',
    current_version=your_package.__version__
)

Done 🎉

Contributions

All contributions are welcome!

Found a problem, want to give a tip? open an issue

Do you have a solution to the problem? Send me a PR

Did you like this project? Click on the star ⭐

License

This project is using the MIT license, see in MIT LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vermon-0.1.0.tar.gz (6.4 kB view details)

Uploaded Source

Built Distribution

vermon-0.1.0-py3-none-any.whl (6.5 kB view details)

Uploaded Python 3

File details

Details for the file vermon-0.1.0.tar.gz.

File metadata

  • Download URL: vermon-0.1.0.tar.gz
  • Upload date:
  • Size: 6.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.5.0.1 requests/2.25.1 setuptools/53.0.0 requests-toolbelt/0.9.1 tqdm/4.49.0 CPython/3.8.5

File hashes

Hashes for vermon-0.1.0.tar.gz
Algorithm Hash digest
SHA256 87378ac44e99f509dab09bf6b155399715e210d268d9ddcbf54085470fedc509
MD5 3495e77acd6b5ea75f2c673ec6909f48
BLAKE2b-256 48c57e0e7b7f9afdecdfa9ca8a95c7ed7a30a8477632633e32401c390e11b7e4

See more details on using hashes here.

File details

Details for the file vermon-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: vermon-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 6.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.5.0.1 requests/2.25.1 setuptools/53.0.0 requests-toolbelt/0.9.1 tqdm/4.49.0 CPython/3.8.5

File hashes

Hashes for vermon-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 970915eae1e6394a697b326b96d56cf955092523b2987607db4a9a2ef6b54082
MD5 c1ada0c310aa2d0cc8c9730ca9a07680
BLAKE2b-256 88934e0d979adde34d0715c3430137979aae4f82e63fc296b7dfe411c9d2a6af

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page