diff options
| -rw-r--r-- | .gitignore | 1 | ||||
| -rw-r--r-- | python-typical.spec | 710 | ||||
| -rw-r--r-- | sources | 1 |
3 files changed, 712 insertions, 0 deletions
@@ -0,0 +1 @@ +/typical-2.8.1.tar.gz diff --git a/python-typical.spec b/python-typical.spec new file mode 100644 index 0000000..6802159 --- /dev/null +++ b/python-typical.spec @@ -0,0 +1,710 @@ +%global _empty_manifest_terminate_build 0 +Name: python-typical +Version: 2.8.1 +Release: 1 +Summary: Typical: Python's Typing Toolkit. +License: MIT +URL: https://github.com/seandstewart/typical +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/c4/dd/76c8fc5d054235f942f492c3761a72fd7a79592e03bbae6930b345a09491/typical-2.8.1.tar.gz +BuildArch: noarch + +Requires: python3-inflection +Requires: python3-pendulum +Requires: python3-fastjsonschema +Requires: python3-ujson +Requires: python3-orjson +Requires: python3-typing-extensions +Requires: python3-pytest +Requires: python3-pytest-cov +Requires: python3-pandas +Requires: python3-sqlalchemy +Requires: python3-pytest-benchmark[histogram] +Requires: python3-marshmallow +Requires: python3-toastedmarshmallow +Requires: python3-djangorestframework +Requires: python3-pydantic[email] +Requires: python3-django +Requires: python3-flake8 +Requires: python3-mypy +Requires: python3-black +Requires: python3-types-python-dateutil +Requires: python3-types-setuptools +Requires: python3-types-toml +Requires: python3-types-typed-ast +Requires: python3-types-ujson +Requires: python3-mkdocs +Requires: python3-mkdocs-material +Requires: python3-mkdocs-awesome-pages-plugin +Requires: python3-pymdown-extensions +Requires: python3-future-typing + +%description +# typical: Python's Typing Toolkit +[](https://pypi.org/project/typical/) +[](https://pypi.org/project/typical/) +[](https://pypi.org/project/typical/) +[](https://github.com/seandstewart/typical) +[](https://github.com/seandstewart/typical/actions) +[](https://codecov.io/gh/seandstewart/typical) +[](https://github.com/ambv/black) +[](https://app.netlify.com/sites/typical-python/deploys) + + + +## Introduction + +Typical is a library devoted to runtime analysis, inference, +validation, and enforcement of Python types, +[PEP 484](https://www.python.org/dev/peps/pep-0484/) Type Hints, and +custom user-defined data-types. + +Typical is fully compliant with the following Python Typing PEPs: + +- [PEP 484 -- Type Hints](https://www.python.org/dev/peps/pep-0484/) +- [PEP 563 -- Postponed Evaluation of Annotations](https://www.python.org/dev/peps/pep-0563/) +- [PEP 585 -- Type Hinting Generics In Standard Collections](https://www.python.org/dev/peps/pep-0585/) +- [PEP 586 -- Literal Types](https://www.python.org/dev/peps/pep-0586/) +- [PEP 589 -- TypedDict: Type Hints for Dictionaries with a Fixed Set of Keys](https://www.python.org/dev/peps/pep-0589/) +- [PEP 604 -- Allow writing union types as X | Y](https://www.python.org/dev/peps/pep-0604/) + +It provides a high-level Protocol API, Functional API, and Object API to suit most any +occasion. + +## Getting Started + +Installation is as simple as `pip install -U typical`. +## Help + +The latest documentation is hosted at +[python-typical.org](https://python-typical.org/). + +> Starting with version 2.0, All documentation is hand-crafted +> markdown & versioned documentation can be found at typical's +> [Git Repo](https://github.com/seandstewart/typical/tree/master/docs). +> (Versioned documentation is still in-the-works directly on our +> domain.) + +## A Typical Use-Case + +The decorator that started it all: + +### `typic.al(...)` + +```python +import typic + + +@typic.al +def hard_math(a: int, b: int, *c: int) -> int: + return a + b + sum(c) + +hard_math(1, "3") +#> 4 + + +@typic.al(strict=True) +def strict_math(a: int, b: int, *c: int) -> int: + return a + b + sum(c) + +strict_math(1, 2, 3, "4") +#> Traceback (most recent call last): +#> ... +#> typic.constraints.error.ConstraintValueError: Given value <'4'> fails constraints: (type=int, nullable=False, coerce=False) + +``` + +Typical has both a high-level *Object API* and high-level +*Functional API*. In general, any method registered to one API is also +available to the other. + +### The Protocol API + +```python +import dataclasses +from typing import Iterable + +import typic + + +@typic.constrained(ge=1) +class ID(int): + ... + + +@typic.constrained(max_length=280) +class Tweet(str): + ... + + +@dataclasses.dataclass # or typing.TypedDict or typing.NamedTuple or annotated class... +class Tweeter: + id: ID + tweets: Iterable[Tweet] + + +json = '{"id":1,"tweets":["I don\'t understand Twitter"]}' +protocol = typic.protocol(Tweeter) + +t = protocol.transmute(json) +print(t) +#> Tweeter(id=1, tweets=["I don't understand Twitter"]) + +print(protocol.tojson(t)) +#> '{"id":1,"tweets":["I don\'t understand Twitter"]}' + +protocol.validate({"id": 0, "tweets": []}) +#> Traceback (most recent call last): +#> ... +#> typic.constraints.error.ConstraintValueError: Tweeter.id: value <0> fails constraints: (type=int, nullable=False, coerce=False, ge=1) +``` + +### The Functional API + +```python +import dataclasses +from typing import Iterable + +import typic + + +@typic.constrained(ge=1) +class ID(int): + ... + + +@typic.constrained(max_length=280) +class Tweet(str): + ... + + +@dataclasses.dataclass # or typing.TypedDict or typing.NamedTuple or annotated class... +class Tweeter: + id: ID + tweets: Iterable[Tweet] + + +json = '{"id":1,"tweets":["I don\'t understand Twitter"]}' + +t = typic.transmute(Tweeter, json) +print(t) +#> Tweeter(id=1, tweets=["I don't understand Twitter"]) + +print(typic.tojson(t)) +#> '{"id":1,"tweets":["I don\'t understand Twitter"]}' + +typic.validate(Tweeter, {"id": 0, "tweets": []}) +#> Traceback (most recent call last): +#> ... +#> typic.constraints.error.ConstraintValueError: Tweeter.id: value <0> fails constraints: (type=int, nullable=False, coerce=False, ge=1) +``` + +### The Object API + +```python +from typing import Iterable + +import typic + + +@typic.constrained(ge=1) +class ID(int): + ... + + +@typic.constrained(max_length=280) +class Tweet(str): + ... + + +@typic.klass +class Tweeter: + id: ID + tweets: Iterable[Tweet] + + +json = '{"id":1,"tweets":["I don\'t understand Twitter"]}' +t = Tweeter.transmute(json) + +print(t) +#> Tweeter(id=1, tweets=["I don't understand Twitter"]) + +print(t.tojson()) +#> '{"id":1,"tweets":["I don\'t understand Twitter"]}' + +Tweeter.validate({"id": 0, "tweets": []}) +#> Traceback (most recent call last): +#> ... +#> typic.constraints.error.ConstraintValueError: Given value <0> fails constraints: (type=int, nullable=False, coerce=False, ge=1) +``` + + +## Changelog + +See our +[Releases](https://github.com/seandstewart/typical/releases). + + +%package -n python3-typical +Summary: Typical: Python's Typing Toolkit. +Provides: python-typical +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-typical +# typical: Python's Typing Toolkit +[](https://pypi.org/project/typical/) +[](https://pypi.org/project/typical/) +[](https://pypi.org/project/typical/) +[](https://github.com/seandstewart/typical) +[](https://github.com/seandstewart/typical/actions) +[](https://codecov.io/gh/seandstewart/typical) +[](https://github.com/ambv/black) +[](https://app.netlify.com/sites/typical-python/deploys) + + + +## Introduction + +Typical is a library devoted to runtime analysis, inference, +validation, and enforcement of Python types, +[PEP 484](https://www.python.org/dev/peps/pep-0484/) Type Hints, and +custom user-defined data-types. + +Typical is fully compliant with the following Python Typing PEPs: + +- [PEP 484 -- Type Hints](https://www.python.org/dev/peps/pep-0484/) +- [PEP 563 -- Postponed Evaluation of Annotations](https://www.python.org/dev/peps/pep-0563/) +- [PEP 585 -- Type Hinting Generics In Standard Collections](https://www.python.org/dev/peps/pep-0585/) +- [PEP 586 -- Literal Types](https://www.python.org/dev/peps/pep-0586/) +- [PEP 589 -- TypedDict: Type Hints for Dictionaries with a Fixed Set of Keys](https://www.python.org/dev/peps/pep-0589/) +- [PEP 604 -- Allow writing union types as X | Y](https://www.python.org/dev/peps/pep-0604/) + +It provides a high-level Protocol API, Functional API, and Object API to suit most any +occasion. + +## Getting Started + +Installation is as simple as `pip install -U typical`. +## Help + +The latest documentation is hosted at +[python-typical.org](https://python-typical.org/). + +> Starting with version 2.0, All documentation is hand-crafted +> markdown & versioned documentation can be found at typical's +> [Git Repo](https://github.com/seandstewart/typical/tree/master/docs). +> (Versioned documentation is still in-the-works directly on our +> domain.) + +## A Typical Use-Case + +The decorator that started it all: + +### `typic.al(...)` + +```python +import typic + + +@typic.al +def hard_math(a: int, b: int, *c: int) -> int: + return a + b + sum(c) + +hard_math(1, "3") +#> 4 + + +@typic.al(strict=True) +def strict_math(a: int, b: int, *c: int) -> int: + return a + b + sum(c) + +strict_math(1, 2, 3, "4") +#> Traceback (most recent call last): +#> ... +#> typic.constraints.error.ConstraintValueError: Given value <'4'> fails constraints: (type=int, nullable=False, coerce=False) + +``` + +Typical has both a high-level *Object API* and high-level +*Functional API*. In general, any method registered to one API is also +available to the other. + +### The Protocol API + +```python +import dataclasses +from typing import Iterable + +import typic + + +@typic.constrained(ge=1) +class ID(int): + ... + + +@typic.constrained(max_length=280) +class Tweet(str): + ... + + +@dataclasses.dataclass # or typing.TypedDict or typing.NamedTuple or annotated class... +class Tweeter: + id: ID + tweets: Iterable[Tweet] + + +json = '{"id":1,"tweets":["I don\'t understand Twitter"]}' +protocol = typic.protocol(Tweeter) + +t = protocol.transmute(json) +print(t) +#> Tweeter(id=1, tweets=["I don't understand Twitter"]) + +print(protocol.tojson(t)) +#> '{"id":1,"tweets":["I don\'t understand Twitter"]}' + +protocol.validate({"id": 0, "tweets": []}) +#> Traceback (most recent call last): +#> ... +#> typic.constraints.error.ConstraintValueError: Tweeter.id: value <0> fails constraints: (type=int, nullable=False, coerce=False, ge=1) +``` + +### The Functional API + +```python +import dataclasses +from typing import Iterable + +import typic + + +@typic.constrained(ge=1) +class ID(int): + ... + + +@typic.constrained(max_length=280) +class Tweet(str): + ... + + +@dataclasses.dataclass # or typing.TypedDict or typing.NamedTuple or annotated class... +class Tweeter: + id: ID + tweets: Iterable[Tweet] + + +json = '{"id":1,"tweets":["I don\'t understand Twitter"]}' + +t = typic.transmute(Tweeter, json) +print(t) +#> Tweeter(id=1, tweets=["I don't understand Twitter"]) + +print(typic.tojson(t)) +#> '{"id":1,"tweets":["I don\'t understand Twitter"]}' + +typic.validate(Tweeter, {"id": 0, "tweets": []}) +#> Traceback (most recent call last): +#> ... +#> typic.constraints.error.ConstraintValueError: Tweeter.id: value <0> fails constraints: (type=int, nullable=False, coerce=False, ge=1) +``` + +### The Object API + +```python +from typing import Iterable + +import typic + + +@typic.constrained(ge=1) +class ID(int): + ... + + +@typic.constrained(max_length=280) +class Tweet(str): + ... + + +@typic.klass +class Tweeter: + id: ID + tweets: Iterable[Tweet] + + +json = '{"id":1,"tweets":["I don\'t understand Twitter"]}' +t = Tweeter.transmute(json) + +print(t) +#> Tweeter(id=1, tweets=["I don't understand Twitter"]) + +print(t.tojson()) +#> '{"id":1,"tweets":["I don\'t understand Twitter"]}' + +Tweeter.validate({"id": 0, "tweets": []}) +#> Traceback (most recent call last): +#> ... +#> typic.constraints.error.ConstraintValueError: Given value <0> fails constraints: (type=int, nullable=False, coerce=False, ge=1) +``` + + +## Changelog + +See our +[Releases](https://github.com/seandstewart/typical/releases). + + +%package help +Summary: Development documents and examples for typical +Provides: python3-typical-doc +%description help +# typical: Python's Typing Toolkit +[](https://pypi.org/project/typical/) +[](https://pypi.org/project/typical/) +[](https://pypi.org/project/typical/) +[](https://github.com/seandstewart/typical) +[](https://github.com/seandstewart/typical/actions) +[](https://codecov.io/gh/seandstewart/typical) +[](https://github.com/ambv/black) +[](https://app.netlify.com/sites/typical-python/deploys) + + + +## Introduction + +Typical is a library devoted to runtime analysis, inference, +validation, and enforcement of Python types, +[PEP 484](https://www.python.org/dev/peps/pep-0484/) Type Hints, and +custom user-defined data-types. + +Typical is fully compliant with the following Python Typing PEPs: + +- [PEP 484 -- Type Hints](https://www.python.org/dev/peps/pep-0484/) +- [PEP 563 -- Postponed Evaluation of Annotations](https://www.python.org/dev/peps/pep-0563/) +- [PEP 585 -- Type Hinting Generics In Standard Collections](https://www.python.org/dev/peps/pep-0585/) +- [PEP 586 -- Literal Types](https://www.python.org/dev/peps/pep-0586/) +- [PEP 589 -- TypedDict: Type Hints for Dictionaries with a Fixed Set of Keys](https://www.python.org/dev/peps/pep-0589/) +- [PEP 604 -- Allow writing union types as X | Y](https://www.python.org/dev/peps/pep-0604/) + +It provides a high-level Protocol API, Functional API, and Object API to suit most any +occasion. + +## Getting Started + +Installation is as simple as `pip install -U typical`. +## Help + +The latest documentation is hosted at +[python-typical.org](https://python-typical.org/). + +> Starting with version 2.0, All documentation is hand-crafted +> markdown & versioned documentation can be found at typical's +> [Git Repo](https://github.com/seandstewart/typical/tree/master/docs). +> (Versioned documentation is still in-the-works directly on our +> domain.) + +## A Typical Use-Case + +The decorator that started it all: + +### `typic.al(...)` + +```python +import typic + + +@typic.al +def hard_math(a: int, b: int, *c: int) -> int: + return a + b + sum(c) + +hard_math(1, "3") +#> 4 + + +@typic.al(strict=True) +def strict_math(a: int, b: int, *c: int) -> int: + return a + b + sum(c) + +strict_math(1, 2, 3, "4") +#> Traceback (most recent call last): +#> ... +#> typic.constraints.error.ConstraintValueError: Given value <'4'> fails constraints: (type=int, nullable=False, coerce=False) + +``` + +Typical has both a high-level *Object API* and high-level +*Functional API*. In general, any method registered to one API is also +available to the other. + +### The Protocol API + +```python +import dataclasses +from typing import Iterable + +import typic + + +@typic.constrained(ge=1) +class ID(int): + ... + + +@typic.constrained(max_length=280) +class Tweet(str): + ... + + +@dataclasses.dataclass # or typing.TypedDict or typing.NamedTuple or annotated class... +class Tweeter: + id: ID + tweets: Iterable[Tweet] + + +json = '{"id":1,"tweets":["I don\'t understand Twitter"]}' +protocol = typic.protocol(Tweeter) + +t = protocol.transmute(json) +print(t) +#> Tweeter(id=1, tweets=["I don't understand Twitter"]) + +print(protocol.tojson(t)) +#> '{"id":1,"tweets":["I don\'t understand Twitter"]}' + +protocol.validate({"id": 0, "tweets": []}) +#> Traceback (most recent call last): +#> ... +#> typic.constraints.error.ConstraintValueError: Tweeter.id: value <0> fails constraints: (type=int, nullable=False, coerce=False, ge=1) +``` + +### The Functional API + +```python +import dataclasses +from typing import Iterable + +import typic + + +@typic.constrained(ge=1) +class ID(int): + ... + + +@typic.constrained(max_length=280) +class Tweet(str): + ... + + +@dataclasses.dataclass # or typing.TypedDict or typing.NamedTuple or annotated class... +class Tweeter: + id: ID + tweets: Iterable[Tweet] + + +json = '{"id":1,"tweets":["I don\'t understand Twitter"]}' + +t = typic.transmute(Tweeter, json) +print(t) +#> Tweeter(id=1, tweets=["I don't understand Twitter"]) + +print(typic.tojson(t)) +#> '{"id":1,"tweets":["I don\'t understand Twitter"]}' + +typic.validate(Tweeter, {"id": 0, "tweets": []}) +#> Traceback (most recent call last): +#> ... +#> typic.constraints.error.ConstraintValueError: Tweeter.id: value <0> fails constraints: (type=int, nullable=False, coerce=False, ge=1) +``` + +### The Object API + +```python +from typing import Iterable + +import typic + + +@typic.constrained(ge=1) +class ID(int): + ... + + +@typic.constrained(max_length=280) +class Tweet(str): + ... + + +@typic.klass +class Tweeter: + id: ID + tweets: Iterable[Tweet] + + +json = '{"id":1,"tweets":["I don\'t understand Twitter"]}' +t = Tweeter.transmute(json) + +print(t) +#> Tweeter(id=1, tweets=["I don't understand Twitter"]) + +print(t.tojson()) +#> '{"id":1,"tweets":["I don\'t understand Twitter"]}' + +Tweeter.validate({"id": 0, "tweets": []}) +#> Traceback (most recent call last): +#> ... +#> typic.constraints.error.ConstraintValueError: Given value <0> fails constraints: (type=int, nullable=False, coerce=False, ge=1) +``` + + +## Changelog + +See our +[Releases](https://github.com/seandstewart/typical/releases). + + +%prep +%autosetup -n typical-2.8.1 + +%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-typical -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Fri May 05 2023 Python_Bot <Python_Bot@openeuler.org> - 2.8.1-1 +- Package Spec generated @@ -0,0 +1 @@ +56a488cb72fb8a594b4e0bc5bcb05f43 typical-2.8.1.tar.gz |