معرفی شرکت ها
baseclasses-0.1.0
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Dataclasses alternative
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | baseclasses-0.1.0 |
| نام | baseclasses |
| نسخه کتابخانه | 0.1.0 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | - |
| ایمیل نویسنده | - |
| آدرس صفحه اصلی | https://github.com/yanovs/baseclasses |
| آدرس اینترنتی | https://pypi.org/project/baseclasses/ |
| مجوز | Apache License 2.0 |
# baseclasses
Simple dataclasses alternative (beta)
[](https://badge.fury.io/py/baseclasses)
[](https://pypi.python.org/pypi/baseclasses/)
[](https://github.com/yanovs/baseclasses)
## Installation
`baseclasses` is available on [PyPI](https://pypi.org/project/baseclasses/):
```bash
pip install baseclasses
```
## Quick Start
`baseclasses` is an alternative to [`dataclasses`](https://docs.python.org/3/library/dataclasses.html).
There are many such alternatives, and there are a lot of reasons
to use them (including the built-in
`dataclasses`), but if you want a library with:
- No monkey-patched methods generated from strings
- No special decorators, just regular inheritance
- Ability to order fields in subclasses as desired
- Auto-inheritance of parent properties, with ability to change per subclass
- Emphasis on keyword args over positional args
- Optional `__pre_init__` ability to mutate kwargs
- Optional ability to reference other kwargs in `default_factory` func
- A shorthand helper to specify `InternalStateField`
- Ability to differentiate between `str` and `repr`
you can give `baseclasses` a try. E.g.:
```python
from typing import Dict, Optional
import baseclasses
# No decorator
class Foo(baseclasses.FrozenBaseClass):
a: int
b: int
c: Optional[str] = baseclasses.Field(default="hello", hash=False)
_d: Dict = baseclasses.InternalStateField(default_factory=dict)
# Auto-inherits FrozenBaseClass properties
class ChildFoo(Foo):
# No problems with child class field ordering
x: float
# Dynamic defaults
y: int = baseclasses.Field(
default_factory=lambda **kwargs: kwargs["a"] * 2.0
)
# Override frozen state per child class
class MutableChildFoo(ChildFoo, frozen=False):
pass
```
## Comparisons to Alternatives
See [`tests/test_compare.py`](https://github.com/yanovs/baseclasses/blob/main/baseclasses/tests/test_compare.py).
Like [dataclasses](https://docs.python.org/3/library/dataclasses.html), but:
- No issues with adding new optional fields because you're forced to
use `kwargs` in all but the simplest cases
- Uses `metaclass` and simple inheritance over monkey-patched generated code
- Child classes automatically inherit state from parent,
so no need to re-declare
- But you can also change `frozen` status per child class
- You can use `default_factory(lambda **kwargs: ...)` to access init fields
- Or you can mutate kwargs with an optional `__pre_init__`
- More consistent with traditional OOP style
(e.g., `obj.get_fields()` instead of `dataclasses.get_fields(obj)`)
Like [dataclassy](https://github.com/biqqles/dataclassy) but:
- Uses `metaclass` and simple inheritance over monkey-patched generated code
There are others:
- [attrs](https://github.com/python-attrs/attrs)
- [pydantic](https://github.com/samuelcolvin/pydantic)
- [traitlets](https://github.com/ipython/traitlets)
- [param](https://param.holoviz.org/)
Note: there are [perfectly valid reasons](https://peps.python.org/pep-0557/#rationale)
for why the Python community
decided to use generated code over simple inheritance.
`baseclasses` is just an alternative that implements things differently.
## TODO
- [ ] Add `init` property to field (to mirror `dataclasses`)
- [ ] Expose `obj.replace(**kwargs)` (to mirror `dataclasses`)
- [ ] Consider `serialize` property to field
- [ ] Take advantage of [PEP 681 included in Python 3.11](https://docs.python.org/3/whatsnew/3.11.html#whatsnew311-pep681)
نیازمندی
| مقدار | نام |
|---|---|
| >=0.6.0 | build |
| >=3.4 | setuptools-scm[toml] |
| >=0.38.0 | wheel |
| >=22.8 | black |
| >=1.5.2 | cached-property |
| >=1.5.0 | docformatter |
| >=5.0.4 | flake8 |
| >=5.2.2 | isort |
| >=0.800 | mypy |
| >=6.2.5 | pytest |
| <3,>=2 | pytest-cov |
| >=0.0.13 | pyright |
| >=3.27.1 | tox |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.7 | Python |
نحوه نصب
نصب پکیج whl baseclasses-0.1.0:
pip install baseclasses-0.1.0.whl
نصب پکیج tar.gz baseclasses-0.1.0:
pip install baseclasses-0.1.0.tar.gz