diff options
| -rw-r--r-- | .gitignore | 1 | ||||
| -rw-r--r-- | python-humanize.spec | 802 | ||||
| -rw-r--r-- | sources | 1 |
3 files changed, 804 insertions, 0 deletions
@@ -0,0 +1 @@ +/humanize-4.6.0.tar.gz diff --git a/python-humanize.spec b/python-humanize.spec new file mode 100644 index 0000000..f86f7c3 --- /dev/null +++ b/python-humanize.spec @@ -0,0 +1,802 @@ +%global _empty_manifest_terminate_build 0 +Name: python-humanize +Version: 4.6.0 +Release: 1 +Summary: Python humanize utilities +License: MIT +URL: https://github.com/python-humanize/humanize +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/06/b1/9e491df2ee1c919d67ee328d8bc9f17b7a9af68e4077f3f5fac83a4488c9/humanize-4.6.0.tar.gz +BuildArch: noarch + +Requires: python3-importlib-metadata +Requires: python3-freezegun +Requires: python3-pytest +Requires: python3-pytest-cov + +%description +# humanize + +[](https://pypi.org/project/humanize/) +[](https://pypi.org/project/humanize/) +[](https://python-humanize.readthedocs.io/en/latest/?badge=latest) +[](https://pypistats.org/packages/humanize) +[](https://github.com/python-humanize/humanize/actions) +[](https://codecov.io/gh/python-humanize/humanize) +[](LICENCE) +[](https://tidelift.com/subscription/pkg/pypi-humanize?utm_source=pypi-humanize&utm_medium=badge) + +This modest package contains various common humanization utilities, like turning +a number into a fuzzy human-readable duration ("3 minutes ago") or into a +human-readable size or throughput. It is localized to: + +- Arabic +- Basque +- Bengali +- Brazilian Portuguese +- Catalan +- Danish +- Dutch +- European Portuguese +- Finnish +- French +- German +- Greek +- Indonesian +- Italian +- Japanese +- Korean +- Persian +- Polish +- Russian +- Simplified Chinese +- Slovak +- Slovenian +- Spanish +- Swedish +- Turkish +- Ukrainian +- Vietnamese + +## API reference + +[https://python-humanize.readthedocs.io](https://python-humanize.readthedocs.io) + +<!-- usage-start --> + +## Installation + +### From PyPI + +```bash +python3 -m pip install --upgrade humanize +``` + +### From source + +```bash +git clone https://github.com/python-humanize/humanize +cd humanize +python3 -m pip install -e . +``` + +## Usage + +### Integer humanization + +```pycon +>>> import humanize +>>> humanize.intcomma(12345) +'12,345' +>>> humanize.intword(123455913) +'123.5 million' +>>> humanize.intword(12345591313) +'12.3 billion' +>>> humanize.apnumber(4) +'four' +>>> humanize.apnumber(41) +'41' +``` + +### Date & time humanization + +```pycon +>>> import humanize +>>> import datetime as dt +>>> humanize.naturalday(dt.datetime.now()) +'today' +>>> humanize.naturaldelta(dt.timedelta(seconds=1001)) +'16 minutes' +>>> humanize.naturalday(dt.datetime.now() - dt.timedelta(days=1)) +'yesterday' +>>> humanize.naturalday(dt.date(2007, 6, 5)) +'Jun 05' +>>> humanize.naturaldate(dt.date(2007, 6, 5)) +'Jun 05 2007' +>>> humanize.naturaltime(dt.datetime.now() - dt.timedelta(seconds=1)) +'a second ago' +>>> humanize.naturaltime(dt.datetime.now() - dt.timedelta(seconds=3600)) +'an hour ago' +``` + +### Precise time delta + +```pycon +>>> import humanize +>>> import datetime as dt +>>> delta = dt.timedelta(seconds=3633, days=2, microseconds=123000) +>>> humanize.precisedelta(delta) +'2 days, 1 hour and 33.12 seconds' +>>> humanize.precisedelta(delta, minimum_unit="microseconds") +'2 days, 1 hour, 33 seconds and 123 milliseconds' +>>> humanize.precisedelta(delta, suppress=["days"], format="%0.4f") +'49 hours and 33.1230 seconds' +``` + +#### Smaller units + +If seconds are too large, set `minimum_unit` to milliseconds or microseconds: + +```pycon +>>> import humanize +>>> import datetime as dt +>>> humanize.naturaldelta(dt.timedelta(seconds=2)) +'2 seconds' +``` + +```pycon +>>> delta = dt.timedelta(milliseconds=4) +>>> humanize.naturaldelta(delta) +'a moment' +>>> humanize.naturaldelta(delta, minimum_unit="milliseconds") +'4 milliseconds' +>>> humanize.naturaldelta(delta, minimum_unit="microseconds") +'4 milliseconds' +``` + +```pycon +>>> humanize.naturaltime(delta) +'now' +>>> humanize.naturaltime(delta, minimum_unit="milliseconds") +'4 milliseconds ago' +>>> humanize.naturaltime(delta, minimum_unit="microseconds") +'4 milliseconds ago' +``` + +### File size humanization + +```pycon +>>> import humanize +>>> humanize.naturalsize(1_000_000) +'1.0 MB' +>>> humanize.naturalsize(1_000_000, binary=True) +'976.6 KiB' +>>> humanize.naturalsize(1_000_000, gnu=True) +'976.6K' +``` + +### Human-readable floating point numbers + +```pycon +>>> import humanize +>>> humanize.fractional(1/3) +'1/3' +>>> humanize.fractional(1.5) +'1 1/2' +>>> humanize.fractional(0.3) +'3/10' +>>> humanize.fractional(0.333) +'333/1000' +>>> humanize.fractional(1) +'1' +``` + +### Scientific notation + +```pycon +>>> import humanize +>>> humanize.scientific(0.3) +'3.00 x 10⁻¹' +>>> humanize.scientific(500) +'5.00 x 10²' +>>> humanize.scientific("20000") +'2.00 x 10⁴' +>>> humanize.scientific(1**10) +'1.00 x 10⁰' +>>> humanize.scientific(1**10, precision=1) +'1.0 x 10⁰' +>>> humanize.scientific(1**10, precision=0) +'1 x 10⁰' +``` + +## Localization + +How to change locale at runtime: + +```pycon +>>> import humanize +>>> import datetime as dt +>>> humanize.naturaltime(dt.timedelta(seconds=3)) +'3 seconds ago' +>>> _t = humanize.i18n.activate("ru_RU") +>>> humanize.naturaltime(dt.timedelta(seconds=3)) +'3 секунды назад' +>>> humanize.i18n.deactivate() +>>> humanize.naturaltime(dt.timedelta(seconds=3)) +'3 seconds ago' +``` + +You can pass additional parameter `path` to `activate` to specify a path to search +locales in. + +```pycon +>>> import humanize +>>> humanize.i18n.activate("xx_XX") +<...> +FileNotFoundError: [Errno 2] No translation file found for domain: 'humanize' +>>> humanize.i18n.activate("pt_BR", path="path/to/my/own/translation/") +<gettext.GNUTranslations instance ...> +``` + +<!-- usage-end --> + +How to add new phrases to existing locale files: + +```sh +xgettext --from-code=UTF-8 -o humanize.pot -k'_' -k'N_' -k'P_:1c,2' -k'NS_:1,2' -k'_ngettext:1,2' -l python src/humanize/*.py # extract new phrases +msgmerge -U src/humanize/locale/ru_RU/LC_MESSAGES/humanize.po humanize.pot # add them to locale files +``` + +How to add a new locale: + +```sh +msginit -i humanize.pot -o humanize/locale/<locale name>/LC_MESSAGES/humanize.po --locale <locale name> +``` + +Where `<locale name>` is a locale abbreviation, eg. `en_GB`, `pt_BR` or just `ru`, `fr` +etc. + +List the language at the top of this README. + + +%package -n python3-humanize +Summary: Python humanize utilities +Provides: python-humanize +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-humanize +# humanize + +[](https://pypi.org/project/humanize/) +[](https://pypi.org/project/humanize/) +[](https://python-humanize.readthedocs.io/en/latest/?badge=latest) +[](https://pypistats.org/packages/humanize) +[](https://github.com/python-humanize/humanize/actions) +[](https://codecov.io/gh/python-humanize/humanize) +[](LICENCE) +[](https://tidelift.com/subscription/pkg/pypi-humanize?utm_source=pypi-humanize&utm_medium=badge) + +This modest package contains various common humanization utilities, like turning +a number into a fuzzy human-readable duration ("3 minutes ago") or into a +human-readable size or throughput. It is localized to: + +- Arabic +- Basque +- Bengali +- Brazilian Portuguese +- Catalan +- Danish +- Dutch +- European Portuguese +- Finnish +- French +- German +- Greek +- Indonesian +- Italian +- Japanese +- Korean +- Persian +- Polish +- Russian +- Simplified Chinese +- Slovak +- Slovenian +- Spanish +- Swedish +- Turkish +- Ukrainian +- Vietnamese + +## API reference + +[https://python-humanize.readthedocs.io](https://python-humanize.readthedocs.io) + +<!-- usage-start --> + +## Installation + +### From PyPI + +```bash +python3 -m pip install --upgrade humanize +``` + +### From source + +```bash +git clone https://github.com/python-humanize/humanize +cd humanize +python3 -m pip install -e . +``` + +## Usage + +### Integer humanization + +```pycon +>>> import humanize +>>> humanize.intcomma(12345) +'12,345' +>>> humanize.intword(123455913) +'123.5 million' +>>> humanize.intword(12345591313) +'12.3 billion' +>>> humanize.apnumber(4) +'four' +>>> humanize.apnumber(41) +'41' +``` + +### Date & time humanization + +```pycon +>>> import humanize +>>> import datetime as dt +>>> humanize.naturalday(dt.datetime.now()) +'today' +>>> humanize.naturaldelta(dt.timedelta(seconds=1001)) +'16 minutes' +>>> humanize.naturalday(dt.datetime.now() - dt.timedelta(days=1)) +'yesterday' +>>> humanize.naturalday(dt.date(2007, 6, 5)) +'Jun 05' +>>> humanize.naturaldate(dt.date(2007, 6, 5)) +'Jun 05 2007' +>>> humanize.naturaltime(dt.datetime.now() - dt.timedelta(seconds=1)) +'a second ago' +>>> humanize.naturaltime(dt.datetime.now() - dt.timedelta(seconds=3600)) +'an hour ago' +``` + +### Precise time delta + +```pycon +>>> import humanize +>>> import datetime as dt +>>> delta = dt.timedelta(seconds=3633, days=2, microseconds=123000) +>>> humanize.precisedelta(delta) +'2 days, 1 hour and 33.12 seconds' +>>> humanize.precisedelta(delta, minimum_unit="microseconds") +'2 days, 1 hour, 33 seconds and 123 milliseconds' +>>> humanize.precisedelta(delta, suppress=["days"], format="%0.4f") +'49 hours and 33.1230 seconds' +``` + +#### Smaller units + +If seconds are too large, set `minimum_unit` to milliseconds or microseconds: + +```pycon +>>> import humanize +>>> import datetime as dt +>>> humanize.naturaldelta(dt.timedelta(seconds=2)) +'2 seconds' +``` + +```pycon +>>> delta = dt.timedelta(milliseconds=4) +>>> humanize.naturaldelta(delta) +'a moment' +>>> humanize.naturaldelta(delta, minimum_unit="milliseconds") +'4 milliseconds' +>>> humanize.naturaldelta(delta, minimum_unit="microseconds") +'4 milliseconds' +``` + +```pycon +>>> humanize.naturaltime(delta) +'now' +>>> humanize.naturaltime(delta, minimum_unit="milliseconds") +'4 milliseconds ago' +>>> humanize.naturaltime(delta, minimum_unit="microseconds") +'4 milliseconds ago' +``` + +### File size humanization + +```pycon +>>> import humanize +>>> humanize.naturalsize(1_000_000) +'1.0 MB' +>>> humanize.naturalsize(1_000_000, binary=True) +'976.6 KiB' +>>> humanize.naturalsize(1_000_000, gnu=True) +'976.6K' +``` + +### Human-readable floating point numbers + +```pycon +>>> import humanize +>>> humanize.fractional(1/3) +'1/3' +>>> humanize.fractional(1.5) +'1 1/2' +>>> humanize.fractional(0.3) +'3/10' +>>> humanize.fractional(0.333) +'333/1000' +>>> humanize.fractional(1) +'1' +``` + +### Scientific notation + +```pycon +>>> import humanize +>>> humanize.scientific(0.3) +'3.00 x 10⁻¹' +>>> humanize.scientific(500) +'5.00 x 10²' +>>> humanize.scientific("20000") +'2.00 x 10⁴' +>>> humanize.scientific(1**10) +'1.00 x 10⁰' +>>> humanize.scientific(1**10, precision=1) +'1.0 x 10⁰' +>>> humanize.scientific(1**10, precision=0) +'1 x 10⁰' +``` + +## Localization + +How to change locale at runtime: + +```pycon +>>> import humanize +>>> import datetime as dt +>>> humanize.naturaltime(dt.timedelta(seconds=3)) +'3 seconds ago' +>>> _t = humanize.i18n.activate("ru_RU") +>>> humanize.naturaltime(dt.timedelta(seconds=3)) +'3 секунды назад' +>>> humanize.i18n.deactivate() +>>> humanize.naturaltime(dt.timedelta(seconds=3)) +'3 seconds ago' +``` + +You can pass additional parameter `path` to `activate` to specify a path to search +locales in. + +```pycon +>>> import humanize +>>> humanize.i18n.activate("xx_XX") +<...> +FileNotFoundError: [Errno 2] No translation file found for domain: 'humanize' +>>> humanize.i18n.activate("pt_BR", path="path/to/my/own/translation/") +<gettext.GNUTranslations instance ...> +``` + +<!-- usage-end --> + +How to add new phrases to existing locale files: + +```sh +xgettext --from-code=UTF-8 -o humanize.pot -k'_' -k'N_' -k'P_:1c,2' -k'NS_:1,2' -k'_ngettext:1,2' -l python src/humanize/*.py # extract new phrases +msgmerge -U src/humanize/locale/ru_RU/LC_MESSAGES/humanize.po humanize.pot # add them to locale files +``` + +How to add a new locale: + +```sh +msginit -i humanize.pot -o humanize/locale/<locale name>/LC_MESSAGES/humanize.po --locale <locale name> +``` + +Where `<locale name>` is a locale abbreviation, eg. `en_GB`, `pt_BR` or just `ru`, `fr` +etc. + +List the language at the top of this README. + + +%package help +Summary: Development documents and examples for humanize +Provides: python3-humanize-doc +%description help +# humanize + +[](https://pypi.org/project/humanize/) +[](https://pypi.org/project/humanize/) +[](https://python-humanize.readthedocs.io/en/latest/?badge=latest) +[](https://pypistats.org/packages/humanize) +[](https://github.com/python-humanize/humanize/actions) +[](https://codecov.io/gh/python-humanize/humanize) +[](LICENCE) +[](https://tidelift.com/subscription/pkg/pypi-humanize?utm_source=pypi-humanize&utm_medium=badge) + +This modest package contains various common humanization utilities, like turning +a number into a fuzzy human-readable duration ("3 minutes ago") or into a +human-readable size or throughput. It is localized to: + +- Arabic +- Basque +- Bengali +- Brazilian Portuguese +- Catalan +- Danish +- Dutch +- European Portuguese +- Finnish +- French +- German +- Greek +- Indonesian +- Italian +- Japanese +- Korean +- Persian +- Polish +- Russian +- Simplified Chinese +- Slovak +- Slovenian +- Spanish +- Swedish +- Turkish +- Ukrainian +- Vietnamese + +## API reference + +[https://python-humanize.readthedocs.io](https://python-humanize.readthedocs.io) + +<!-- usage-start --> + +## Installation + +### From PyPI + +```bash +python3 -m pip install --upgrade humanize +``` + +### From source + +```bash +git clone https://github.com/python-humanize/humanize +cd humanize +python3 -m pip install -e . +``` + +## Usage + +### Integer humanization + +```pycon +>>> import humanize +>>> humanize.intcomma(12345) +'12,345' +>>> humanize.intword(123455913) +'123.5 million' +>>> humanize.intword(12345591313) +'12.3 billion' +>>> humanize.apnumber(4) +'four' +>>> humanize.apnumber(41) +'41' +``` + +### Date & time humanization + +```pycon +>>> import humanize +>>> import datetime as dt +>>> humanize.naturalday(dt.datetime.now()) +'today' +>>> humanize.naturaldelta(dt.timedelta(seconds=1001)) +'16 minutes' +>>> humanize.naturalday(dt.datetime.now() - dt.timedelta(days=1)) +'yesterday' +>>> humanize.naturalday(dt.date(2007, 6, 5)) +'Jun 05' +>>> humanize.naturaldate(dt.date(2007, 6, 5)) +'Jun 05 2007' +>>> humanize.naturaltime(dt.datetime.now() - dt.timedelta(seconds=1)) +'a second ago' +>>> humanize.naturaltime(dt.datetime.now() - dt.timedelta(seconds=3600)) +'an hour ago' +``` + +### Precise time delta + +```pycon +>>> import humanize +>>> import datetime as dt +>>> delta = dt.timedelta(seconds=3633, days=2, microseconds=123000) +>>> humanize.precisedelta(delta) +'2 days, 1 hour and 33.12 seconds' +>>> humanize.precisedelta(delta, minimum_unit="microseconds") +'2 days, 1 hour, 33 seconds and 123 milliseconds' +>>> humanize.precisedelta(delta, suppress=["days"], format="%0.4f") +'49 hours and 33.1230 seconds' +``` + +#### Smaller units + +If seconds are too large, set `minimum_unit` to milliseconds or microseconds: + +```pycon +>>> import humanize +>>> import datetime as dt +>>> humanize.naturaldelta(dt.timedelta(seconds=2)) +'2 seconds' +``` + +```pycon +>>> delta = dt.timedelta(milliseconds=4) +>>> humanize.naturaldelta(delta) +'a moment' +>>> humanize.naturaldelta(delta, minimum_unit="milliseconds") +'4 milliseconds' +>>> humanize.naturaldelta(delta, minimum_unit="microseconds") +'4 milliseconds' +``` + +```pycon +>>> humanize.naturaltime(delta) +'now' +>>> humanize.naturaltime(delta, minimum_unit="milliseconds") +'4 milliseconds ago' +>>> humanize.naturaltime(delta, minimum_unit="microseconds") +'4 milliseconds ago' +``` + +### File size humanization + +```pycon +>>> import humanize +>>> humanize.naturalsize(1_000_000) +'1.0 MB' +>>> humanize.naturalsize(1_000_000, binary=True) +'976.6 KiB' +>>> humanize.naturalsize(1_000_000, gnu=True) +'976.6K' +``` + +### Human-readable floating point numbers + +```pycon +>>> import humanize +>>> humanize.fractional(1/3) +'1/3' +>>> humanize.fractional(1.5) +'1 1/2' +>>> humanize.fractional(0.3) +'3/10' +>>> humanize.fractional(0.333) +'333/1000' +>>> humanize.fractional(1) +'1' +``` + +### Scientific notation + +```pycon +>>> import humanize +>>> humanize.scientific(0.3) +'3.00 x 10⁻¹' +>>> humanize.scientific(500) +'5.00 x 10²' +>>> humanize.scientific("20000") +'2.00 x 10⁴' +>>> humanize.scientific(1**10) +'1.00 x 10⁰' +>>> humanize.scientific(1**10, precision=1) +'1.0 x 10⁰' +>>> humanize.scientific(1**10, precision=0) +'1 x 10⁰' +``` + +## Localization + +How to change locale at runtime: + +```pycon +>>> import humanize +>>> import datetime as dt +>>> humanize.naturaltime(dt.timedelta(seconds=3)) +'3 seconds ago' +>>> _t = humanize.i18n.activate("ru_RU") +>>> humanize.naturaltime(dt.timedelta(seconds=3)) +'3 секунды назад' +>>> humanize.i18n.deactivate() +>>> humanize.naturaltime(dt.timedelta(seconds=3)) +'3 seconds ago' +``` + +You can pass additional parameter `path` to `activate` to specify a path to search +locales in. + +```pycon +>>> import humanize +>>> humanize.i18n.activate("xx_XX") +<...> +FileNotFoundError: [Errno 2] No translation file found for domain: 'humanize' +>>> humanize.i18n.activate("pt_BR", path="path/to/my/own/translation/") +<gettext.GNUTranslations instance ...> +``` + +<!-- usage-end --> + +How to add new phrases to existing locale files: + +```sh +xgettext --from-code=UTF-8 -o humanize.pot -k'_' -k'N_' -k'P_:1c,2' -k'NS_:1,2' -k'_ngettext:1,2' -l python src/humanize/*.py # extract new phrases +msgmerge -U src/humanize/locale/ru_RU/LC_MESSAGES/humanize.po humanize.pot # add them to locale files +``` + +How to add a new locale: + +```sh +msginit -i humanize.pot -o humanize/locale/<locale name>/LC_MESSAGES/humanize.po --locale <locale name> +``` + +Where `<locale name>` is a locale abbreviation, eg. `en_GB`, `pt_BR` or just `ru`, `fr` +etc. + +List the language at the top of this README. + + +%prep +%autosetup -n humanize-4.6.0 + +%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-humanize -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Mon Apr 10 2023 Python_Bot <Python_Bot@openeuler.org> - 4.6.0-1 +- Package Spec generated @@ -0,0 +1 @@ +17dd6c0415a34c0478d5c849560276bb humanize-4.6.0.tar.gz |