pydataclasses 0.0.1

Python Data Classes

Python Data Classes support Python 2 and 3 with the human-friendly features.

This project is under active development and has been tested in Python 2.7 and Python 3.6. It is not related to the dataclasses module introduced in Python 3.7.

Feature Support

The core features and tests have been developed. More documents are on the way.

Python Data Classes generally support

• untyped data, typed data, and typed data list

• arbitrary attribute names in the dictionary input

• no python attribute naming conflict or pollution

• lazy and auto object creation on-the-fly

• lazy loading of the dict input (default: enabled)

• synchronous updates of the dict input (default: disabled)

Getting Started

1. Install the Python Data Classes

pip install pydataclasses

2. Create the Python Data Classes

from pydataclasses import DataClass


class TT(DataClass):

    attr = None


class ONCE(DataClass):

    data = None


class TWICE(ONCE):

    tear = TT
    tears = [TT]

    def __init__(self, *args, **kwargs):

        super(TWICE, self).__init__(*args, **kwargs)

        self.pair = TWICE
        self.pairs = List[TWICE]

3. Play with the Python Data Classes

old_data = 'hello'
new_data = 'world'
old_dict = {'data': old_data}
new_dict = {'data': new_data}

# lazy and auto object creation on-the-fly
twice = TWICE()
assert twice.pairs[1].tear.attr is None
twice.pairs[1].tear.attr = old_data
assert old_data == twice.pairs[1].tear.attr

# lazy loading of the dict input (default: enabled)
twice = TWICE(old_dict)
assert old_data == twice.data
assert old_dict == twice.__as_dict__(dict, 0)

# synchronous updates of the dict input (default: disabled)
assert old_dict != new_dict
twice = TWICE(old_dict, __sync__=True)
twice.data = new_data
assert old_dict == new_dict

Best Practices

Please

• read and refer to pydataclasses.JSONData as an example

• put a tailored subclass between pydataclasses and your project

• write (or copy from pydataclasses) as many tests as possible for this subclass

from pydataclasses import DataClass


class ProjectDataClass(DataClass):

    def as_dict(self, dict_class=OrderedDict):
        return self.__as_dict__(dict_class, 0)

Release History

0.0.1 (2018-08-26)

• Birthday