Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tadashi-aikawa/owlmixin
Parsing mixin which converts data class instance, dict object, json string and yaml string each other.
https://github.com/tadashi-aikawa/owlmixin
Last synced: 25 days ago
JSON representation
Parsing mixin which converts data class instance, dict object, json string and yaml string each other.
- Host: GitHub
- URL: https://github.com/tadashi-aikawa/owlmixin
- Owner: tadashi-aikawa
- License: mit
- Created: 2016-11-13T01:51:30.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2024-05-12T12:12:00.000Z (6 months ago)
- Last Synced: 2024-05-12T13:29:26.076Z (6 months ago)
- Language: Python
- Homepage:
- Size: 1.28 MB
- Stars: 4
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# OwlMixin
[](https://pypi.org/project/owlmixin/)
[](https://pypi.org/project/owlmixin/)
[](https://github.com/tadashi-aikawa/owlmixin/actions)
[](https://codecov.io/gh/tadashi-aikawa/owlmixin)
[]()
(ﾟ∀ﾟ) v5.0 have breaking changes
* `TIterator#group_by`
* Return `TDict[TList[T]]` instead of `TDict[TIterator[T]]`
(ﾟ∀ﾟ) v4.0 have breaking changes
* `OwlMixin`
* Must use keyword arguments in `from_XXX` and `to_XXX` except for some ones
* `from_csvf` -> `from_csvf_to_list`
* `TList`
* `head` -> `take`
* `partial` -> `partition` (switch left and right)
* `transformers.XXX`
* Must use keyword arguments in
* `to_dict`
* `to_dicts`
* `to_json`
* `to_jsonf`
* `to_yaml`
* `to_yamlf`
* `to_csv`
* `to_csvf`
## 💪 Motivation
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.
## 💃 Installation
```bash
pip install owlmixin
```
## 📜 API Reference
https://tadashi-aikawa.github.io/owlmixin/
## 👉 Examples
```python
from owlmixin import OwlMixin, OwlEnum, TOption, TList
class Color(OwlEnum):
RED = "red"
GREEN = "green"
BLUE = "blue"
class Food(OwlMixin):
id: int
name: str
color: TOption[Color]
class Human(OwlMixin):
id: int
name: str
favorite: TList[Food]
jiro = Human.from_dict({
"id": 10,
"name": "jiro",
"favorite": [
{"id": 1, "name": "apple"},
{"id": 2, "name": "orange", "color": "green"}
]
})
```
Then...
```
>>> jiro.id
10
>>> jiro.name
'jiro'
>>> print(jiro.to_dict())
{'id': 10, 'name': 'jiro', 'favorite': [{'id': 1, 'name': 'apple'}, {'id': 2, 'name': 'orange', 'color': 'green'}]}
>>> print(jiro.favorite[0].to_pretty_json())
{
"id": 1,
"name": "apple"
}
>>> print(jiro.to_yaml())
favorite:
- id: 1
name: apple
- color: green
id: 2
name: orange
id: 10
name: jiro
>>> print(jiro.favorite.to_csv(['id', 'name', 'color'], with_header=True))
id,name,color
1,apple,
2,orange,green
```
You can also use methods chains as following.
```python
from owlmixin import OwlMixin, TOption, TIterator
class Repository(OwlMixin):
id: int
name: str
description: TOption[str]
stargazers_count: int
class GithubRepository(OwlMixin):
total_count: int
incomplete_results: bool
items: TIterator[Repository]
```
Then...
```python
>>> print(
... GithubRepository
... .from_json_url("https://api.github.com/search/repositories?q=git")
... .items
... .filter(lambda x: x.stargazers_count > 100)
... .order_by(lambda x: x.stargazers_count, True)
... .take(5)
... .emap(lambda v, i: {
... 'RANK': i+1,
... 'STAR': v.stargazers_count,
... 'NAME': v.name,
... 'DESCRIPTION': v.description
... })
... .to_csv(fieldnames=["RANK", "STAR", "NAME", "DESCRIPTION"], with_header=True)
... )
RANK,STAR,NAME,DESCRIPTION
1,84643,gitignore,A collection of useful .gitignore templates
2,30456,gogs,Gogs is a painless self-hosted Git service.
3,29908,git-flight-rules,Flight rules for git
4,27704,git,Git Source Code Mirror - This is a publish-only repository and all pull requests are ignored. Please follow Documentation/SubmittingPatches procedure for any of your improvements.
5,15541,tips,Most commonly used git tips and tricks.
```
Don't you think smart?
## 💻 For developers
### Requirements
* poetry
* make
### Flow
1. Development on master and if you need branches and issues, create them
2. Commit with prefix emoji such as "📝", and suffix issue number like "#120"
### Commands
```bash
# Create env
$ poetry env use
$ poetry install
# Build documentation and run server locally
$ make serve-docs
# Test (Doc test & Unit test)
$ make test
```
## 📦 Release
https://github.com/tadashi-aikawa/owlmixin/actions/workflows/release.yaml?query=workflow%3ARelease
### (Appendix) Another way
If you can't or don't want to use GitHub Actions, you can release locally as following.
#### (a1) Requirements
* **Windows is not supported!!!**
* poetry (with pypi authentications)
* make
#### (a2) Commands
```bash
make release version=x.y.z
```
[ghr]: https://github.com/tcnksm/ghr