{"id":41665388,"url":"https://github.com/syntaxarc/archipy","last_synced_at":"2026-04-27T11:01:07.814Z","repository":{"id":277826435,"uuid":"933572448","full_name":"SyntaxArc/ArchiPy","owner":"SyntaxArc","description":"Architecture + Python – perfect for structured design.","archived":false,"fork":false,"pushed_at":"2026-04-27T10:14:03.000Z","size":51049,"stargazers_count":37,"open_issues_count":1,"forks_count":20,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-04-27T10:23:46.121Z","etag":null,"topics":["fastapi","pydantic","python"],"latest_commit_sha":null,"homepage":"https://archipy.readthedocs.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SyntaxArc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-02-16T09:45:21.000Z","updated_at":"2026-04-27T10:14:07.000Z","dependencies_parsed_at":null,"dependency_job_id":"369be9bc-7218-4611-8bca-deae4e5cea81","html_url":"https://github.com/SyntaxArc/ArchiPy","commit_stats":null,"previous_names":["syntaxarc/archipy"],"tags_count":106,"template":false,"template_full_name":null,"purl":"pkg:github/SyntaxArc/ArchiPy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SyntaxArc%2FArchiPy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SyntaxArc%2FArchiPy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SyntaxArc%2FArchiPy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SyntaxArc%2FArchiPy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SyntaxArc","download_url":"https://codeload.github.com/SyntaxArc/ArchiPy/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SyntaxArc%2FArchiPy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32333199,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T23:26:28.701Z","status":"online","status_checked_at":"2026-04-27T02:00:06.769Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["fastapi","pydantic","python"],"created_at":"2026-01-24T17:17:09.244Z","updated_at":"2026-04-27T11:01:07.808Z","avatar_url":"https://github.com/SyntaxArc.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"https://raw.githubusercontent.com/SyntaxArc/ArchiPy/master/docs/assets/logo.jpg\" alt=\"ArchiPy Logo\" width=\"150\"/\u003e\n\n# ArchiPy - Architecture + Python\n\n[![Forks](https://img.shields.io/github/forks/SyntaxArc/ArchiPy)](https://github.com/SyntaxArc/ArchiPy/network/members)\n[![Stars](https://img.shields.io/github/stars/SyntaxArc/ArchiPy)](https://github.com/SyntaxArc/ArchiPy/stargazers)\n[![Python](https://img.shields.io/badge/Python-3.14+-blue.svg)](https://www.python.org/downloads/)\n[![UV](https://img.shields.io/badge/UV-package%20manager-blue)](https://docs.astral.sh/uv/)\n[![Documentation](https://img.shields.io/badge/docs-MkDocs-blue.svg)](https://syntaxarc.github.io/ArchiPy/)\n[![License](https://img.shields.io/github/license/SyntaxArc/ArchiPy)](https://github.com/SyntaxArc/ArchiPy/blob/master/LICENSE)\n[![Maintained](https://img.shields.io/badge/Maintained-yes-brightgreen)](https://github.com/SyntaxArc/ArchiPy)\n[![Contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen)](https://github.com/SyntaxArc/ArchiPy/blob/master/CONTRIBUTING.md)\n[![PyPI - Version](https://img.shields.io/pypi/v/archipy)](https://pypi.org/project/archipy/)\n[![PyPI - Downloads](https://img.shields.io/pypi/dm/archipy)](https://pypi.org/project/archipy/)\n[![Contributors](https://img.shields.io/github/contributors/SyntaxArc/ArchiPy)](https://github.com/SyntaxArc/ArchiPy/graphs/contributors)\n[![Last Commit](https://img.shields.io/github/last-commit/SyntaxArc/ArchiPy)](https://github.com/SyntaxArc/ArchiPy/commits/main)\n[![Open Issues](https://img.shields.io/github/issues/SyntaxArc/ArchiPy)](https://github.com/SyntaxArc/ArchiPy/issues)\n[![Closed Issues](https://img.shields.io/github/issues-closed/SyntaxArc/ArchiPy)](https://github.com/SyntaxArc/ArchiPy/issues?q=is%3Aissue+is%3Aclosed)\n[![Pull Requests](https://img.shields.io/github/issues-pr/SyntaxArc/ArchiPy)](https://github.com/SyntaxArc/ArchiPy/pulls)\n[![Repo Size](https://img.shields.io/github/repo-size/SyntaxArc/ArchiPy)](https://github.com/SyntaxArc/ArchiPy)\n[![Code Size](https://img.shields.io/github/languages/code-size/SyntaxArc/ArchiPy)](https://github.com/SyntaxArc/ArchiPy)\n\n## **Structured Python Development Made Simple**\n\nArchiPy is a Python framework designed to provide a standardized, scalable, and maintainable architecture for modern applications. Built with Python 3.14+, it offers a suite of tools, utilities, and best practices to streamline configuration management, testing, and development workflows while adhering to clean architecture principles.\n\n---\n\n## 📋 Table of Contents\n\n- [ArchiPy - Architecture + Python](#archipy---architecture--python)\n  - [**Structured Python Development Made Simple**](#structured-python-development-made-simple)\n  - [📋 Table of Contents](#-table-of-contents)\n  - [🎯 Goals](#-goals)\n  - [✨ Features](#-features)\n  - [🛠️ Prerequisites](#️-prerequisites)\n  - [📥 Installation](#-installation)\n  - [🎯 Usage](#-usage)\n    - [Optional Dependencies](#optional-dependencies)\n  - [🛠️ Development](#️-development)\n    - [Quick Commands](#quick-commands)\n  - [🤝 Contributing](#-contributing)\n  - [📄 License](#-license)\n  - [🙌 Sponsors](#-sponsors)\n  - [📞 Contact](#-contact)\n  - [🔗 Links](#-links)\n  - [📚 Documentation](#-documentation)\n    - [Quick Start](#quick-start)\n\n---\n\n## 🎯 Goals\n\nArchiPy is built with the following objectives in mind:\n\n1. **Configuration Management \u0026 Injection** - Simplify and standardize configuration handling\n2. **Common Adapters \u0026 Mocks** - Provide ready-to-use adapters with testing mocks\n3. **Standardized Entities \u0026 DTOs** - Enforce consistency in data modeling\n4. **Common Helpers for Everyday Tasks** - Simplify routine development work\n5. **Behavior-Driven Development (BDD) Support** - Enable robust feature validation\n6. **Best Practices \u0026 Development Structure** - Enforce coding standards\n\n[Read more about ArchiPy's architecture and design](https://syntaxarc.github.io/ArchiPy/architecture)\n\n---\n\n## ✨ Features\n\n- **Config Standardization**: Tools for managing and injecting configurations\n- **Adapters \u0026 Mocks**: Pre-built adapters for Redis, SQLAlchemy, and email with testing mocks\n- **Data Standardization**: Base entities, DTOs, and type safety\n- **Helper Utilities**: Reusable tools for common tasks\n- **BDD Testing**: Fully integrated Behave setup\n- **Modern Tooling**: Dependency management and code quality tools\n\n[Explore the complete feature set](https://syntaxarc.github.io/ArchiPy/features)\n\n---\n\n## 🛠️ Prerequisites\n\n- **Python 3.14 or higher**\n- **UV** (recommended for development)\n\n---\n\n## 📥 Installation\n Install using pip\n```bash\n# Basic installation\npip install archipy\n\n# With optional dependencies (e.g., Redis and FastAPI)\npip install archipy[redis,fastapi]\n```\n\nUsing UV:\n```bash\nuv add archipy\n\n# With optional dependencies\nuv add archipy[redis,fastapi]\n```\n\n[View installation documentation](https://syntaxarc.github.io/ArchiPy/installation)\n\n---\n\n## 🎯 Usage\n\n### Optional Dependencies\n\nArchiPy's modular design lets you install only what you need:\n\n```bash\n# Examples\npip install archipy[redis]        # Redis support\npip install archipy[fastapi]      # FastAPI framework\npip install archipy[postgres]     # PostgreSQL support\n```\n\n[See the documentation for all available options and examples](https://syntaxarc.github.io/ArchiPy/usage)\n\n---\n\n## 🛠️ Development\n\n### Quick Commands\n\n```bash\n# Format code\nmake format\n\n# Run tests\nmake behave\n\n# Lint code\nmake lint\n```\n\n[View the complete development guide](https://syntaxarc.github.io/ArchiPy/development)\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! See our [contribution guidelines](CONTRIBUTING.md) for details.\n\n---\n\n## 📄 License\n\nThis project is licensed under the terms of the [LICENSE](LICENSE) file.\n\n---\n\n## 🙌 Sponsors\n\nSupport ArchiPy by checking out our amazing sponsors! [View Sponsors](SPONSORS.md)\n\n---\n\n## 📞 Contact\n\n- **Mehdi Einali**: [einali@gmail.com](mailto:einali@gmail.com)\n- **Hossein Nejati**: [hosseinnejati14@gmail.com](mailto:hosseinnejati14@gmail.com)\n\n---\n\n## 🔗 Links\n\n- [Documentation](https://syntaxarc.github.io/ArchiPy/)\n- [GitHub Repository](https://github.com/SyntaxArc/ArchiPy)\n- [PyPI Package](https://pypi.org/project/archipy/)\n\n## 📚 Documentation\n\nArchiPy's documentation has been migrated from Sphinx to MkDocs for improved readability and organization:\n\n- **Modern Interface**: Material theme with responsive design\n- **Improved Navigation**: Intuitive organization and search\n- **Clearer Examples**: Expanded code samples with explanations\n- **API Reference**: Auto-generated from source code docstrings\n- **Performance Optimized**: Multiple build modes for fast iteration\n\n### Quick Start\n\n```bash\n# Install documentation dependencies\nuv sync --group docs\n\n# Fast mode for quick iterations (10-20s builds)\nmake docs-serve-fast\n\n# Balanced mode for regular work (30-60s builds)\nmake docs-serve\n\n# Full production build (2-5min, all features)\nmake docs-build-full\n\n# Deploy to GitHub Pages\nmake docs-deploy\n```\n\n**See [DOCS_QUICKSTART.md](DOCS_QUICKSTART.md) for more commands and tips.**\n\n[View the latest documentation](https://syntaxarc.github.io/ArchiPy/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsyntaxarc%2Farchipy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsyntaxarc%2Farchipy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsyntaxarc%2Farchipy/lists"}