myosin 0.1.0

Lightweight state management engine for posix compliant systems

Myosin

Modified: 2022-03

Lightweight state management engine.

About

State-driven software architectures are useful for allowing multiple modules to be able to communicate using the same base syntax. The syntax for communication of data is implemented through the state models which represent the the states of different components of the software.

Quickstart

Install myosin from pip

python3 -m pip install myosin

Start by defining a model by creating a class that implements StateModel

from myosin import _PKey
from myosin import StateModel

class User(StateModel):

    def __init__(self, _id: _PKey, name: str, email: str) -> None:
        super().__init__(_id)
        self.name = name
        self.email = email

    @property
    def name(self) -> str:
        return self.__name

    @name.setter
    def name(self, name: str) -> None:
        self.__name = name

    @property
    def email(self) -> str:
        return self.__email

    @email.setter
    def email(self, email: str) -> None:
        self.__email = email

    def serialize(self) -> Dict[str, Any]:
        return {
            'id': self.id,
            'name': self.name,
            'email': self.email
        }

    def deserialize(self, **kwargs) -> None:
        for k, v in kwargs.items():
            setattr(self, k, v)

In the application init load the default state model into the engine:

from myosin import _PKey

usr = User(
    _id=1,
    name="chris",
    email="[e-mail]"
)

with State() as state:
    # register the model into the state engine
    state.load(usr)

In a consumer module you can access the global User model through a checked out copy:

with State() as state:
    # checkout a copy of the user state model
    user = state.checkout(User)
# read properties from the user state model
logging.info("Username: %s", user.name)

In a producer module you can commit to the global User model:

with State() as state:
    # checkout a copy of the user state model
    user = state.checkout(User)
    # modify user state model copy
    user.name = "cS"
    # commit the modified copy
    state.commit(user)

Documentation

Documentation coming soon

Contributions

Contributions are welcome. Please see the issue log and project kanban if you are unsure how to help.

License

This project is licensed under the terms of the MIT License