{"id":23818932,"url":"https://github.com/fillmula/jsonclasses","last_synced_at":"2025-09-07T01:30:39.783Z","repository":{"id":45132326,"uuid":"290935966","full_name":"fillmula/jsonclasses","owner":"fillmula","description":"🌎 The Modern Declarative Data Flow Framework for the AI Empowered Generation.","archived":false,"fork":false,"pushed_at":"2024-02-01T19:58:30.000Z","size":1289,"stargazers_count":58,"open_issues_count":0,"forks_count":7,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-12-20T16:48:25.484Z","etag":null,"topics":["data","json","python","validation"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fillmula.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-08-28T02:54:52.000Z","updated_at":"2024-12-10T22:52:44.000Z","dependencies_parsed_at":"2022-08-25T23:12:19.769Z","dependency_job_id":null,"html_url":"https://github.com/fillmula/jsonclasses","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fillmula%2Fjsonclasses","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fillmula%2Fjsonclasses/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fillmula%2Fjsonclasses/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fillmula%2Fjsonclasses/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fillmula","download_url":"https://codeload.github.com/fillmula/jsonclasses/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":232158506,"owners_count":18480889,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data","json","python","validation"],"created_at":"2025-01-02T06:19:23.625Z","updated_at":"2025-01-02T06:19:24.246Z","avatar_url":"https://github.com/fillmula.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"DEPRECATED NOTICE!\n===========\n\nThis project is **deprecated**. Use [Teo](https://teocloud.io) instead.\n\n🌎 JSONClasses [![Pypi][pypi-image]][pypi-url] [![Python Version][python-image]][python-url] [![License][license-image]][license-url] [![PR Welcome][pr-image]][pr-url]\n===========\n\nJSONClasses is a declarative data flow pipeline and data graph framework.\n\nOfficial Website: https://www.jsonclasses.com\n\nOfficial Documentation: https://docs.jsonclasses.com\n\n## 🚗 Features\n\n|     | **Features**|\n| --- | ----------------------------------------------------------------------------------|\n| 🛠  | **Data Modeling** Declarative data model with Python type hints |\n| 🍸  | **Data Sanitization** Two strictness modes |\n| 🩺  | **Data Validation** Descriptive data validation rules without even a line of code |\n| 🧬  | **Data Transformation** Intuitive with modifier pipelines |\n| 🦖  | **Data Presentation** Custom key encoding \u0026 decoding strategies |\n| 🌍  | **Data Graphing** Models are linked with each other on the same graph |\n| 🏄‍♂️  | **Data Querying** Well-designed protocols and implementations for databases |\n| 🚀  | **Synthesized CRUD** Only with a line of code |\n| 👮‍♀️  | **Session \u0026 Authorization** Builtin support for session and authorization |\n| 🔐  | **Permission System** Supports both object level and field level |\n| 📁  | **File Uploading** A configuration is enough for file uploading |\n| 📦  | **Data Seeder** Declarative named graph relationship |\n\n## 🍎 Getting Started\n\n### Prerequisites\n\n[Python \u003e= 3.10](https://www.python.org) is required. You can download it [here](https://www.python.org/downloads/).\n\n### Install JSONClasses\n\nInstall JSONClasses is simple with `pip`.\n\n```sh\npip install jsonclasses\n```\n\n### Install Components\n\nDepends on your need, you can install ORM integration and HTTP library integration with the following commands.\n\n```sh\npip install jsonclasses-pymongo jsonclasses-server\n```\n\n## 🎹 Examples\n\n## Business Logic Examples\n\n### Example 1: Dating App Users\n\nLet's say, you are building the base user functionality for a cross-platform\ndating app.\n\nThe product requirements are:\n\n1. Unique phone number is required\n2. Password should be secure, encrypted, hidden from response\n3. Gender cannot be changed after set\n4. This product is adult only\n5. User intro should be brief\n\nLet's transform the requirements into code.\n\n```python\nfrom jsonclasses import jsonclass, types\nfrom jsonclasses_pymongo import pymongo\nfrom jsonclasses_server import api\n\n\n@api\n@pymongo\n@jsonclass\nclass User:\n    id: str = types.readonly.str.primary.mongoid.required\n    phone_no: str = types.str.unique.index.match(local_phone_no_regex).required #1\n    email: str = types.str.match(email_regex)\n    password: str = types.str.writeonly.length(8, 16).match(secure_password_regex).transform(salt).required #2\n    nickname: str = types.str.required\n    gender: str = types.str.writeonce.oneof(['male', 'female']) #3\n    age: int = types.int.min(18).max(100) #4\n    intro: str = types.str.truncate(500) #5\n    created_at: datetime = types.readonly.datetime.tscreated.required\n    updated_at: datetime = types.readonly.datetime.tsupdated.required\n```\n\n## ⚽️ Database \u0026 HTTP Library Integrations\n\n* [JSON Classes Pymongo](https://github.com/fillmula/jsonclasses-pymongo)\nThe mongodb integration through pymongo driver.\n\n* [JSON Classes Server](https://github.com/fillmula/jsonclasses-server)\nThe server integration.\n\n## 🦸 Contributing\n\n* File a [bug report](https://github.com/fillmula/jsonclasses/issues/new). Be sure to include information like what version of YoMo you are using, what your operating system is, and steps to recreate the bug.\n* Suggest a new feature.\n\n## 🤹🏻‍♀️ Feedback\n\nAny questions or good ideas, please feel free to come to our Discussion. Any feedback would be greatly appreciated!\n\n## License\n\n[MIT License](https://github.com/fillmula/jsonclasses/blob/master/LICENSE)\n\n[pypi-image]: https://img.shields.io/pypi/v/jsonclasses.svg?style=flat-square\n[pypi-url]: https://pypi.org/project/jsonclasses/\n[python-image]: https://img.shields.io/pypi/pyversions/jsonclasses?style=flat-square\n[python-url]: https://pypi.org/project/jsonclasses/\n[license-image]: https://img.shields.io/github/license/fillmula/jsonclasses.svg?style=flat-square\n[license-url]: https://github.com/fillmula/jsonclasses/blob/master/LICENSE\n[pr-image]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square\n[pr-url]: https://github.com/fillmula/jsonclasses\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffillmula%2Fjsonclasses","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffillmula%2Fjsonclasses","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffillmula%2Fjsonclasses/lists"}