Metadata-Version: 2.1
Name: just-use-dataclass
Version: 0.1.0
Summary: Convert a python dictionary into a dataclass
License: MIT
Author: André da Silva
Author-email: andre-da.silva@outlook.com
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Description-Content-Type: text/markdown

# just-use-dataclass

Simple function to convert a python dict to a dataclass.

If you want to know how the library works, the best place to look at is in the [tests](./tests)

In short: it converts a dictionary to a dataclass by looking at the annotations in the dataclass and converting the
data in the dictionary to it.

## Installation

```
pip install just-use-dataclass
```

## Usage and examples

### Simple data type conversion

```python
from dataclasses import dataclass
import typing

from just_use_dataclass import dict_to_dataclass

@dataclass
class Simple:
    a: str
    b: int
    c: float
    d: bool
    e: typing.Optional[str]
    f: typing.Optional[str]

data = {
    "a": 1,
    "b": "1",
    "c": "2.0",
    "d": True,
    "e": None,
    "f": 42,
}

simple = dict_to_dataclass(data, Simple)

print(simple)

# Output:
# Simple(a='1', b=1, c=2.0, d=True, e=None, f='42')
```

### Nested dataclass conversion

```python
from dataclasses import dataclass
from decimal import Decimal

from just_use_dataclass import dict_to_dataclass

@dataclass
class C:
    value: str


@dataclass
class B:
    value: int
    c: C


@dataclass
class A:
    value_1: Decimal
    value_2: Decimal
    b: B

data = {
    "value_1": "23.23",
    "value_2": 49.0001,
    "b": {
        "value": 1,
        "c": {"value": "test"},
    },
}

nested = dict_to_dataclass(data, A)

print(nested)

# Output:
# A(value_1=Decimal('23.23'), value_2=Decimal('49.0001'), b=B(value=1, c=C(value='test'))
```

### Deeply nested typing conversion

```python
from dataclasses import dataclass
import typing

from just_use_dataclass import dict_to_dataclass

@dataclass
class Crazy:
    value: dict[str, dict[int, list[typing.Optional[str]]]]

data = {"value": {"test": {1: ["hey", None, 42]}}}

crazy = dict_to_dataclass(data, Crazy)

print(crazy)

# Output:
# Crazy(value={'test': {1: ['hey', None, '42']}})
```

## Development

1. Fork and clone the repo

2. Install poetry or just pytest, mypy and black

```sh
poetry install

# or

pip install -U pytest mypy black
```

3. Run tests

```sh
poetry run pytest .
```

3. Linting / Formatting

```sh
poetry run mypy .
poetry run black .
```

## Use in production

The library is really new. if you want to contribute feel welcome.
Otherwise don't use it in production (yet) :)

