diff options
author | CoprDistGit <infra@openeuler.org> | 2023-03-09 14:50:04 +0000 |
---|---|---|
committer | CoprDistGit <infra@openeuler.org> | 2023-03-09 14:50:04 +0000 |
commit | 6a738e1755a4f05f83f0e1b1fd1a28271d2a10e2 (patch) | |
tree | 7292d8d7ad321b48c5cf3dbe470efb5fe4a40e72 | |
parent | 884e874447f116026ba1c4da14ac63209a83e644 (diff) |
automatic import of python-outdated
-rw-r--r-- | .gitignore | 1 | ||||
-rw-r--r-- | python-outdated.spec | 249 | ||||
-rw-r--r-- | sources | 1 |
3 files changed, 251 insertions, 0 deletions
@@ -0,0 +1 @@ +/outdated-0.2.2.tar.gz diff --git a/python-outdated.spec b/python-outdated.spec new file mode 100644 index 0000000..e1271ed --- /dev/null +++ b/python-outdated.spec @@ -0,0 +1,249 @@ +%global _empty_manifest_terminate_build 0 +Name: python-outdated +Version: 0.2.2 +Release: 1 +Summary: Check if a version of a PyPI package is outdated +License: MIT +URL: http://github.com/alexmojaki/outdated +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/e9/43/ac45b6c53fc62c99f02dbc310939d8693aa76cdf9900afe74a60febc8266/outdated-0.2.2.tar.gz +BuildArch: noarch + +Requires: python3-setuptools +Requires: python3-littleutils +Requires: python3-requests + +%description +# outdated + +[](https://travis-ci.org/alexmojaki/outdated) [](https://coveralls.io/github/alexmojaki/outdated?branch=master) [](https://pypi.python.org/pypi/outdated) + +This is a mini-library which, given a package name and a version, checks if it's the latest version available on PyPI. + +To install: + + pip install outdated + +## Quickstart: + + from outdated import warn_if_outdated + + warn_if_outdated('my-package-name', '1.2.3') + +This will: + +- Show a warning if the given version is not the latest. The warning includes the package name, the given version, and the latest version. +- Perform the check in a background thread (so it doesn't delay anything) +- Make at most one HTTP call (unless there is an HTTP error, in which case it will try 3 times) to the PyPI server for that specific package +- Cache the result of the HTTP call on disk for 24 hours +- Show a warning if any exception occurs during the check + +This will *not* check what version is currently installed, it will only use the given version. Library authors must make sure that the version in their `setup.py` matches the version here. + +The package name argument must be exactly the name used on PyPI, so that e.g. https://pypi.python.org/pypi/my-package-name is a valid URL. + +Optional arguments: + +- `background` (default `True`): run the check in a separate thread. Set to `False` to run immediately. +- `raise_exceptions` (default: `False`): if `True`, allow exceptions to bubble to the top. Otherwise, show a warning including the exception message. If `background` is `True` and this is `True` then this will result in a full traceback showing but the process continuing. + +## Lower level API + + from outdated import check_outdated + + is_outdated, latest_version = check_outdated('my-package-name', '1.2.3') + +`is_outdated` is a boolean which is True if the given version is earlier than the latest version, which is the string `latest_version`. + +Optional arguments: + +- `repository_url` (default `https://pypi.python.org/pypi/%s/json`): a `%` style format string to use a different repository PyPI repository URL, e.g. test.pypi.org or a private repository. The string is formatted with the package name. + +This still makes the HTTP call with retries and caches the result on disk. It doesn't use a separate thread or emit any warnings (unless there is an exception specifically while using the cache, in which case the check will be done without the cache). + +## Additional configuration + +To disable all warnings from this library, set the environment variable `OUTDATED_IGNORE` to any non-empty value. + +To always raise exceptions instead of converting them to warnings (both in general in `warn_if_outdated` and more specifically when there's a caching problem) set the environment variable `OUTDATED_RAISE_EXCEPTION=1`. + +The warnings are also categorised so that you can easily control them with standard [warning filters](https://docs.python.org/3/library/warnings.html#the-warnings-filter). The classes are [here](https://github.com/alexmojaki/outdated/blob/master/outdated/mywarnings.py) and can be imported directly from the `outdated` module. + +## Performance + +This library works by fetching a URL such as [this](https://pypi.python.org/pypi/requests/json) - the time it takes to visit that link is essentially the speed of the library. This is much faster than the command `pip list --outdated` or any equivalent code. + + +%package -n python3-outdated +Summary: Check if a version of a PyPI package is outdated +Provides: python-outdated +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-outdated +# outdated + +[](https://travis-ci.org/alexmojaki/outdated) [](https://coveralls.io/github/alexmojaki/outdated?branch=master) [](https://pypi.python.org/pypi/outdated) + +This is a mini-library which, given a package name and a version, checks if it's the latest version available on PyPI. + +To install: + + pip install outdated + +## Quickstart: + + from outdated import warn_if_outdated + + warn_if_outdated('my-package-name', '1.2.3') + +This will: + +- Show a warning if the given version is not the latest. The warning includes the package name, the given version, and the latest version. +- Perform the check in a background thread (so it doesn't delay anything) +- Make at most one HTTP call (unless there is an HTTP error, in which case it will try 3 times) to the PyPI server for that specific package +- Cache the result of the HTTP call on disk for 24 hours +- Show a warning if any exception occurs during the check + +This will *not* check what version is currently installed, it will only use the given version. Library authors must make sure that the version in their `setup.py` matches the version here. + +The package name argument must be exactly the name used on PyPI, so that e.g. https://pypi.python.org/pypi/my-package-name is a valid URL. + +Optional arguments: + +- `background` (default `True`): run the check in a separate thread. Set to `False` to run immediately. +- `raise_exceptions` (default: `False`): if `True`, allow exceptions to bubble to the top. Otherwise, show a warning including the exception message. If `background` is `True` and this is `True` then this will result in a full traceback showing but the process continuing. + +## Lower level API + + from outdated import check_outdated + + is_outdated, latest_version = check_outdated('my-package-name', '1.2.3') + +`is_outdated` is a boolean which is True if the given version is earlier than the latest version, which is the string `latest_version`. + +Optional arguments: + +- `repository_url` (default `https://pypi.python.org/pypi/%s/json`): a `%` style format string to use a different repository PyPI repository URL, e.g. test.pypi.org or a private repository. The string is formatted with the package name. + +This still makes the HTTP call with retries and caches the result on disk. It doesn't use a separate thread or emit any warnings (unless there is an exception specifically while using the cache, in which case the check will be done without the cache). + +## Additional configuration + +To disable all warnings from this library, set the environment variable `OUTDATED_IGNORE` to any non-empty value. + +To always raise exceptions instead of converting them to warnings (both in general in `warn_if_outdated` and more specifically when there's a caching problem) set the environment variable `OUTDATED_RAISE_EXCEPTION=1`. + +The warnings are also categorised so that you can easily control them with standard [warning filters](https://docs.python.org/3/library/warnings.html#the-warnings-filter). The classes are [here](https://github.com/alexmojaki/outdated/blob/master/outdated/mywarnings.py) and can be imported directly from the `outdated` module. + +## Performance + +This library works by fetching a URL such as [this](https://pypi.python.org/pypi/requests/json) - the time it takes to visit that link is essentially the speed of the library. This is much faster than the command `pip list --outdated` or any equivalent code. + + +%package help +Summary: Development documents and examples for outdated +Provides: python3-outdated-doc +%description help +# outdated + +[](https://travis-ci.org/alexmojaki/outdated) [](https://coveralls.io/github/alexmojaki/outdated?branch=master) [](https://pypi.python.org/pypi/outdated) + +This is a mini-library which, given a package name and a version, checks if it's the latest version available on PyPI. + +To install: + + pip install outdated + +## Quickstart: + + from outdated import warn_if_outdated + + warn_if_outdated('my-package-name', '1.2.3') + +This will: + +- Show a warning if the given version is not the latest. The warning includes the package name, the given version, and the latest version. +- Perform the check in a background thread (so it doesn't delay anything) +- Make at most one HTTP call (unless there is an HTTP error, in which case it will try 3 times) to the PyPI server for that specific package +- Cache the result of the HTTP call on disk for 24 hours +- Show a warning if any exception occurs during the check + +This will *not* check what version is currently installed, it will only use the given version. Library authors must make sure that the version in their `setup.py` matches the version here. + +The package name argument must be exactly the name used on PyPI, so that e.g. https://pypi.python.org/pypi/my-package-name is a valid URL. + +Optional arguments: + +- `background` (default `True`): run the check in a separate thread. Set to `False` to run immediately. +- `raise_exceptions` (default: `False`): if `True`, allow exceptions to bubble to the top. Otherwise, show a warning including the exception message. If `background` is `True` and this is `True` then this will result in a full traceback showing but the process continuing. + +## Lower level API + + from outdated import check_outdated + + is_outdated, latest_version = check_outdated('my-package-name', '1.2.3') + +`is_outdated` is a boolean which is True if the given version is earlier than the latest version, which is the string `latest_version`. + +Optional arguments: + +- `repository_url` (default `https://pypi.python.org/pypi/%s/json`): a `%` style format string to use a different repository PyPI repository URL, e.g. test.pypi.org or a private repository. The string is formatted with the package name. + +This still makes the HTTP call with retries and caches the result on disk. It doesn't use a separate thread or emit any warnings (unless there is an exception specifically while using the cache, in which case the check will be done without the cache). + +## Additional configuration + +To disable all warnings from this library, set the environment variable `OUTDATED_IGNORE` to any non-empty value. + +To always raise exceptions instead of converting them to warnings (both in general in `warn_if_outdated` and more specifically when there's a caching problem) set the environment variable `OUTDATED_RAISE_EXCEPTION=1`. + +The warnings are also categorised so that you can easily control them with standard [warning filters](https://docs.python.org/3/library/warnings.html#the-warnings-filter). The classes are [here](https://github.com/alexmojaki/outdated/blob/master/outdated/mywarnings.py) and can be imported directly from the `outdated` module. + +## Performance + +This library works by fetching a URL such as [this](https://pypi.python.org/pypi/requests/json) - the time it takes to visit that link is essentially the speed of the library. This is much faster than the command `pip list --outdated` or any equivalent code. + + +%prep +%autosetup -n outdated-0.2.2 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-outdated -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Thu Mar 09 2023 Python_Bot <Python_Bot@openeuler.org> - 0.2.2-1 +- Package Spec generated @@ -0,0 +1 @@ +54e1c2d4ba1a1ab4e27e492002860099 outdated-0.2.2.tar.gz |