Mixin which converts data class instance and others each other more simple.
Have you ever wanted to write robust code in Python? This library will make such your wishes come true.
Define your data class which is extend OwlMixin, you can use some useful methods which help your codes robust. See following Example and API Reference sections.
pip install owlmixinYou don't need to use
See PEP 484 -- Type Hints.
typing necessarily, but I recommend to use this to make your codes more robust.See PEP 484 -- Type Hints.
Warning
If you use python 3.5.0 or 3.5.1, please use # type: str instead of # type: Text
from typing import Text, Optional
from owlmixin import OwlMixin
from owlmixin.owlcollections import TList
class Food(OwlMixin):
def __init__(self, id, name, color=None):
self.id = id # type: Text
self.name = name # type: Text
self.color = color # type: Optional[Text]
class Human(OwlMixin):
def __init__(self, id, name, favorite):
self.id = id # type: Text
self.name = name # type: Text
self.favorite = Food.from_dicts(favorite) # type: TList[Food]
jiro = Human.from_dict({
"id": 10,
"name": "jiro",
"favorite": [
{"id": 1, "name": "apple"},
{"id": 2, "name": "orange", "color": "white"}
]
})
>>> jiro.id
10
>>> jiro.name
'jiro'
>>> print(jiro.favorite[0].to_pretty_json())
{
"id": 1,
"name": "apple"
}
>>> print(jiro.to_dict())
{'name': 'jiro', 'id': 10, 'favorite': [{'name': 'apple', 'id': 1}, {'name': 'orange', 'id': 2, 'color': 'white'}]}
>>> print(jiro.to_dict(ignore_none=False))
{'name': 'jiro', 'id': 10, 'favorite': [{'name': 'apple', 'id': 1, 'color': None}, {'name': 'orange', 'id': 2, 'color': 'white'}]}You can also use methods chains as following.
from typing import Optional
from owlmixin import OwlMixin
from owlmixin.owlcollections import TList
# `**extra` is necessary to allow extra elements.
# Note that you must define all properties in github response json if you don't use `**extra`
class Repository(OwlMixin):
def __init__(self, id, name, description, stargazers_count, **extra):
self.id = id # type: int
self.name = name # type: Text
self.description = description # type: Optional[Text]
self.star_count = stargazers_count # type: int
class GithubRepository(OwlMixin):
def __init__(self, total_count, incomplete_results, items):
self.total_count = total_count # type: int
self.incomplete_results = incomplete_results # type: bool
self.repositories = Repository.from_dicts(items) # type: TList[Repository]
>>> r = GithubRepository \
... .from_json_url("https://api.github.com/search/repositories?q=git") \
... .repositories \
... .filter(lambda x: x.star_count > 100) \
... .order_by(lambda x: x.star_count, True) \
... .map(lambda x: {
... "id": x.id,
... "message": '★{0.star_count} {0.name}'.format(x)
... }) \
... .to_csv(fieldnames=["id", "message"], with_header=True)
>>> print(r)
id,message
1062897,★46515 gitignore
16752620,★17762 gogs
36502,★16272 git
401025,★9879 hub
817345,★9542 git-extras
9350746,★6178 gitbucket
901662,★5962 libgit2
3721219,★4666 githug
16899487,★4560 gitql
1951148,★4318 legit
13021798,★4307 git-lfs
8310356,★4074 vim-gitgutter
140656,★3956 tig
2499845,★3757 lolcommits
33088032,★3489 git-style-guide
7266492,★2889 bfg-repo-cleaner
43998576,★2653 git-recipes
655492,★2453 magit
21125024,★2144 husky
85953,★1995 gitextensions
15400220,★1785 progit2
43623432,★1553 git-fire
22106110,★1380 git-cheat-sheet
44739044,★1127 go-git
15342073,★986 training-kit
58859,★858 gitosis
63418718,★561 git-tips
15783450,★404 patchwork
18484639,★216 git
3720815,★101 gitfor master
for current stable version