verlat

Verlat

Pypiのパッケージの最新リリースに関する情報を入手してください。

インストール

pip install --upgrade verlat

使用法

 from verlat import latest_release

package = "verlat" # name of the package on PyPI
release = latest_release ( package )
print ( release . version )

応用

pipやghなどの多くのCLIアプリは、最新リリースを使用していない場合は警告を発生させます。

verlatを使用すると、Pypiのパッケージの最新リリースに関する情報を取得できます。その後、最新リリースのバージョン文字列と現在実行中のプログラムを比較できます。それが主要なリリースかマイナーなリリースか、またはあなたが持っているロジックが何であれ、ユーザーに有用な情報を記録することができます。

バージョン文字列を扱うために、 packagingライブラリを使用できます。

以下は、 verlatの実用的なアプリケーションを示す例です。

poetryを使用してPythonパッケージを構築していると仮定し、 versionキーがpyproject.tomlファイルの[tool.poetry]の下に存在すると仮定します。

 # __init__.py

import logging
from importlib . metadata import version

from verlat import latest_release

__version__ = version ( __package__ )
latest = latest_release ( __package__ )


def major ( string ):
    # based on semantic versioning
    return int ( string . split ( "." , 1 )[ 0 ])


if major ( __version__ ) < major ( latest . version ):
    logging . warning (
        f"A new major release for { __package__ } is availaible. 
        n Download it from { latest . release_url } "
    )