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 )

طلب

تنتج العديد من تطبيقات CLI مثل pip أو gh تحذيرات إذا كنت لا تستخدم أحدث إصدار لها.

باستخدام verlat يمكنك جلب معلومات حول أحدث إصدار من الحزمة الخاصة بك على PYPI. يمكنك بعد ذلك مقارنة سلاسل الإصدار لأحدث الإصدار وبرنامج التشغيل حاليًا. بناءً على ما إذا كان إصدارًا رئيسيًا أو بسيطًا ، أو أي منطق لديك ، يمكنك تسجيل معلومات مفيدة للمستخدم.

للتعامل مع سلاسل الإصدار ، يمكنك استخدام مكتبة packaging .

فيما يلي رمز مثال يوضح التطبيق العملي لـ verlat .

لاحظ على افتراض أنك قد قمت ببناء حزمة Python الخاصة بك باستخدام poetry ، وأن مفتاح version موجود ضمن [tool.poetry] من ملف pyproject.toml الخاص بك.

 # __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 } "
    )