معرفی شرکت ها
corgy-8.1.1
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Elegant data classes
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | corgy-8.1.1 |
| نام | corgy |
| نسخه کتابخانه | 8.1.1 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Jayanth Koushik |
| ایمیل نویسنده | mail@jkoushik.me |
| آدرس صفحه اصلی | https://github.com/jayanthkoushik/corgy |
| آدرس اینترنتی | https://pypi.org/project/corgy/ |
| مجوز | MIT |
# corgy
Corgy is a Python library that allows you to create feature rich data
classes using intuitive type annotations.
```pycon
>>> from typing import List
>>> from typing_extensions import Literal
>>> from corgy import Corgy
>>> from corgy.types import KeyValuePairs
>>> class G(Corgy):
... x: int
... y: Literal["y1", "y2", "y3"]
>>> class C(Corgy):
... x: List[float] = [1.0, 2.0]
... y: KeyValuePairs[str, int]
... g: G
```
## Features
* **Type checking**: `Corgy` instances are type-checked, and support a
number of type modifiers.
```pycon
>>> from typing import Tuple
>>> class C(Corgy):
... x: int
... y: Tuple[int, int]
>>> C(x="1")
Traceback (most recent call last):
...
ValueError: error setting `x`: invalid value for type '<class 'int'>': '1'
>>> C(y=(1, 2, 3))
Traceback (most recent call last):
...
ValueError: error setting `y`: invalid value for type 'typing.Tuple[int, int]': (1, 2, 3): expected exactly '2' elements
```
* **Dictionary interface**: `Corgy` instances can be converted to/from
dictionaries.
```pycon
>>> class G(Corgy):
... x: int
>>> class C(Corgy):
... x: int
... g: G
>>> g = G.from_dict({"x": 1})
>>> g
G(x=1)
>>> c = C(x=2, g=g)
>>> c.as_dict()
{'x': 2, 'g': {'x': 1}}
```
* **Command-line parsing**: `Corgy` class attributes can be added to an
`ArgumentParser` instance, and parsed from the command-line. Help
messages can be added to attributes with `Annotated`, and will be
passed to the command line parser.
```pycon
>>> from argparse import ArgumentParser
>>> from typing import Optional
>>> from typing_extensions import Annotated
>>> class ArgGroup(Corgy):
... arg1: Annotated[Optional[int], "optional number"]
... arg2: Annotated[bool, "a boolean"]
>>> class MyArgs(Corgy):
... arg1: Annotated[int, "a number"] = 1
... arg2: Annotated[Tuple[float, ...], "at least one float"]
... grp1: Annotated[ArgGroup, "group 1"]
>>> parser = ArgumentParser(usage="")
>>> MyArgs.add_args_to_parser(parser)
>>> parser.print_help() # doctest: +SKIP
usage:
optional arguments:
-h, --help show this help message and exit
--arg1 ARG1 a number
--arg2 ARG2 [ARG2 ...]
at least one float
grp1:
group 1
--grp1:arg1 [GRP1:ARG1]
optional number
--grp1:arg2, --no-grp1:arg2
a boolean
```
* **Enhanced argparse formatting**: The `corgy` package provides
`CorgyHelpFormatter`, a formatter class for `argparse`, with support
for colorized output. It can also be used independent of `Corgy`
classes.
```pycon
>>> from corgy import CorgyHelpFormatter
>>> # `ArgGroup` and `MyArgs` as defined above
>>> parser = ArgumentParser(usage="", formatter_class=CorgyHelpFormatter)
>>> MyArgs.add_args_to_parser(parser)
>>> parser.print_help() # doctest: +SKIP
```
* **Convenience types**: `corgy.types` provides a number of types for
converting strings into objects like paths, dictionaries, classes,
etc. These can be used standalone, but are especially useful for
parsing from command line arguments. Refer to the docs for details on
all available types. A small example is shown below.
```pycon
>>> T = KeyValuePairs[str, int]
>>> m = T("x=1,y=2")
>>> print(m)
{'x': 1, 'y': 2}
```
# Install
`corgy` is available on PyPI, and can be installed with pip:
```bash
pip install corgy
```
Support for colorized output requires the `crayons` package, also
available on PyPI. You can pull it as a dependency for `corgy` by
installing with the `colors` extra:
```bash
pip install corgy[colors]
```
Parsing `Corgy` objects from `toml` files requires the `tomli` package
on Python versions below 3.11. This can be installed automatically with
the `toml` extra:
```bash
pip install corgy[toml]
```
# Usage
For documentation on usage, refer to docs/index.md.
نیازمندی
| مقدار | نام |
|---|---|
| >=0.4.0,<0.5.0 | crayons |
| >=4.0,<5.0 | typing_extensions |
| >=2.0.1,<3.0.0 | tomli |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.7,<4.0 | Python |
نحوه نصب
نصب پکیج whl corgy-8.1.1:
pip install corgy-8.1.1.whl
نصب پکیج tar.gz corgy-8.1.1:
pip install corgy-8.1.1.tar.gz