forgeapi 0.1.0__py3-none-any.whl

forgeapi-0.1.0.dist-info/METADATA

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: forgeapi
+Version: 0.1.0
+Summary: A highly modular FastAPI project scaffolding CLI tool for the AI application era
+Project-URL: Homepage, https://github.com/zachary/fastapi-forge
+Project-URL: Documentation, https://github.com/zachary/fastapi-forge#readme
+Project-URL: Repository, https://github.com/zachary/fastapi-forge
+Project-URL: Issues, https://github.com/zachary/fastapi-forge/issues
+Author-email: Zachary <zachary@example.com>
+License: MIT
+License-File: LICENSE
+Keywords: boilerplate,cli,fastapi,generator,project-generator,scaffold,template
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: questionary>=2.1.0
+Requires-Dist: rich>=13.9.0
+Requires-Dist: typer>=0.15.0
+Provides-Extra: ai
+Requires-Dist: httpx>=0.28.0; extra == 'ai'
+Requires-Dist: openai>=1.60.0; extra == 'ai'
+Description-Content-Type: text/markdown
+
+# ForgeAPI 🚀
+
+[![PyPI version](https://badge.fury.io/py/forgeapi.svg)](https://badge.fury.io/py/forgeapi)
+[![Python](https://img.shields.io/pypi/pyversions/forgeapi.svg)](https://pypi.org/project/forgeapi/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+> A highly modular FastAPI project scaffolding CLI tool for the AI application era.
+
+## ✨ Features
+
+- 🏗️ **Clean Architecture** - Auto-generate API/Service/DAO layered structure
+- 📦 **Package Manager Choice** - Support uv (default), Poetry, or pip
+- 🗄️ **Database Integration** - SQLAlchemy (Async) + Alembic migrations
+- 🐳 **Docker Ready** - Optimized Dockerfile and docker-compose.yml
+- 🔐 **JWT Authentication** - Out-of-the-box auth module
+- ⚙️ **Multi-Environment Config** - dev/staging/prod configurations
+- 🧪 **Testing Setup** - Pytest + pytest-asyncio pre-configured
+- 🤖 **AI-Powered** (Coming Soon) - Generate models from natural language
+
+## 📦 Installation
+
+```bash
+# Using pipx (recommended)
+pipx install forgeapi
+
+# Using uv
+uv tool install forgeapi
+
+# Using pip
+pip install forgeapi
+```
+
+## 🚀 Quick Start
+
+### Interactive Mode
+
+```bash
+forge create my-awesome-api
+```
+
+Follow the interactive prompts to configure your project:
+
+```
+🚀 ForgeAPI - Create New Project
+
+? Project name: my-awesome-api
+? Description: A awesome FastAPI project
+? Author name: Your Name
+? Author email: your@email.com
+? Python version: 3.11
+
+📦 Package Manager
+? Select package manager: uv (recommended)
+
+🗄️ Database
+? Select database: PostgreSQL
+? Enable Alembic migrations? Yes
+
+🔐 Authentication
+? Include JWT auth module? Yes
+
+🐳 Docker
+? Generate Docker configuration? Yes
+? Generate docker-compose.yml? Yes
+
+✅ Project my-awesome-api created successfully!
+```
+
+### Non-Interactive Mode
+
+```bash
+forge create my-api \
+  --package-manager uv \
+  --database postgres \
+  --auth jwt \
+  --docker \
+  --no-interactive
+```
+
+## 📁 Generated Project Structure
+
+```
+my-awesome-api/
+├── app/
+│   ├── api/           # API routes
+│   ├── config/        # Configuration
+│   ├── core/          # Core utilities
+│   ├── daos/          # Data Access Objects
+│   ├── exceptions/    # Exception handlers
+│   ├── models/        # SQLAlchemy models
+│   ├── schemas/       # Pydantic schemas
+│   ├── services/      # Business logic
+│   └── utils/         # Utilities
+├── alembic/           # Database migrations
+├── tests/             # Test suite
+├── Dockerfile
+├── docker-compose.yml
+├── pyproject.toml
+└── README.md
+```
+
+## 🛠️ Commands
+
+| Command               | Description                  |
+| --------------------- | ---------------------------- |
+| `forge create <name>` | Create a new FastAPI project |
+| `forge version`       | Show version information     |
+| `forge --help`        | Show help message            |
+
+## 🤖 AI Features (Coming Soon)
+
+```bash
+# Generate SQLAlchemy model from description
+forge add model "User with name, email, and subscription relationship"
+
+# Generate CRUD API for a model
+forge add api User --crud
+```
+
+## 📚 Documentation
+
+- [Design Document](DESIGN.md)
+- [Development Tasks](TODO.md)
+- [Changelog](CHANGELOG.md)
+
+## 🤝 Contributing
+
+Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- [FastAPI](https://fastapi.tiangolo.com/) - The awesome web framework
+- [Typer](https://typer.tiangolo.com/) - CLI framework
+- [SQLAlchemy](https://www.sqlalchemy.org/) - Database toolkit
+- [customer_trial_website](../customer_trial_website/backend) - Architecture reference

forgeapi-0.1.0.dist-info/RECORD

@@ -0,0 +1,57 @@
+fastapi_forge/__init__.py,sha256=WMbvDeWcIDFjO2dZQdcrrH--ARF82a9iaXAd7RkkpiA,401
+fastapi_forge/cli.py,sha256=rguRV0ypTFArS6Ca1Cr3jm38FFLRIQQ5KEn0fCWQsF8,3071
+fastapi_forge/generator.py,sha256=qrRmslklldAa4TKWVGhj9c9uR5b2vCAvyFDswSCIUXc,10140
+fastapi_forge/models.py,sha256=lM-zTk_EcglYV0mvK7-X7hunWSvfEfpzNb5pBhOG_RM,5360
+fastapi_forge/prompts.py,sha256=mqjRoUnAYhzaWnlGmy2_zsh-ZLJI6K-zntP6Dx3JDgQ,10401
+fastapi_forge/commands/__init__.py,sha256=nkmi9Bq-s4pRwhHv51a9aFZeZXou_49Xz4alB84boXM,95
+fastapi_forge/commands/create.py,sha256=4ZEyBH0MA39ZIgvHWjS7fFOMgmJ4DgFOjOXld4qn984,3935
+fastapi_forge/templates/base/.dockerignore.jinja,sha256=bu3mXABYYbJaU5EG1wHBoftZLABtkvOPo_1DBxnzdlw,162
+fastapi_forge/templates/base/.gitignore.jinja,sha256=SA8tshTt0N7b7v0V8smheaNUZHIfDq0uvJmZ-pg9Qag,603
+fastapi_forge/templates/base/Dockerfile.jinja,sha256=hoQwnqbzNUUt1F63BDgXKZLSoXNv6uIK5V0eZF548yw,1300
+fastapi_forge/templates/base/README.md.jinja,sha256=UN3TMnRDOtDzWoeSXcm2Wc29l9WSSHp6bovTssfLFeM,2603
+fastapi_forge/templates/base/alembic.ini.jinja,sha256=1TptA6_F-fs5o-apQ-jyNdpGURxtnO2wX435G1q0wE4,1480
+fastapi_forge/templates/base/config.yaml.jinja,sha256=gs4hJyv0VtxCeFAqxkghxKqy0WHPWoSsijuwQLLQkyo,1258
+fastapi_forge/templates/base/docker-compose.yml.jinja,sha256=r9ZD9ZboNRodSmtY8s6WsH6_8IT0BALHcEkmiP-wzt8,2337
+fastapi_forge/templates/base/pyproject.toml.jinja,sha256=dPIE32ZSjZL-CkqYI-gUrPZNtB2U94Jxc1Orah4FzVQ,1739
+fastapi_forge/templates/base/pytest.ini.jinja,sha256=9w81uK4M3QofDyAB0w8ItxPhWSbgdC7jL010HOhv8e4,231
+fastapi_forge/templates/base/ruff.toml.jinja,sha256=hfBsT8pk9R49On8pRCgCmymkpLKu2MwE4Nk_DP-QoSU,799
+fastapi_forge/templates/base/.github/workflows/ci.yml.jinja,sha256=jGmbBp-hTZosB0MM81y4H9GlCsivvTSMFn8ZTsot84A,4359
+fastapi_forge/templates/base/alembic/README.md.jinja,sha256=Nh70M7cdRqWAcps1Ie5o9qstNOmeEIlSJmFrnN5sqAM,843
+fastapi_forge/templates/base/alembic/env.py.jinja,sha256=GCFwxpQBZmQiTL-RaKIoqVH5tpAczHTcuraJP8OK4ZM,2389
+fastapi_forge/templates/base/alembic/script.py.mako.jinja,sha256=MEqL-2qATlST9TAOeYgscMn1uy6HUS9NFvDgl93dMj8,635
+fastapi_forge/templates/base/alembic/versions/.gitkeep.jinja,sha256=lruTndj0whSP0UmybIkjrPLNz_W-a4QdL6W61GGkkmw,31
+fastapi_forge/templates/base/app/__init__.py.jinja,sha256=Qf4GAeQeqs2vs8l0Y23yBujV80857k-nJBpBRiPbtRk,78
+fastapi_forge/templates/base/app/main.py.jinja,sha256=6SALYAemS6tG1lLaTrnoXa4ndy_c1zwUqiemI4v4c4c,429
+fastapi_forge/templates/base/app/server.py.jinja,sha256=RSM3Sh0K3NV-jmfOjEwcQGKIcZu6QR61tVn-XAwo8-0,2146
+fastapi_forge/templates/base/app/api/__init__.py.jinja,sha256=z7yNH0lbGVu1Ik-oVJIEQq24ZuCU3focPqQF_r6tp_4,26
+fastapi_forge/templates/base/app/api/auth_api.py.jinja,sha256=S4uRC9ur_c5LBIiyyyFP3UvV1KCI52_qI4qngWigcq0,1862
+fastapi_forge/templates/base/app/api/health_api.py.jinja,sha256=svxojwV7Yjja-miIzXGAlbwdLkT_yhSPPg88gl_8oeY,822
+fastapi_forge/templates/base/app/config/__init__.py.jinja,sha256=7z0CSBivE9lWJp90SecoU2uVp8TJnEBMdATqjhdr6Pc,580
+fastapi_forge/templates/base/app/config/base.py.jinja,sha256=rU15VOWj3bR9O_6FjhP36kZVrHL7i3c1I8h2oqE4Pi4,958
+fastapi_forge/templates/base/app/config/env.py.jinja,sha256=bcsgGRYokII0iPqou1gTk2GoB9WJLDlUP9BEOq8i9J0,1696
+fastapi_forge/templates/base/app/core/__init__.py.jinja,sha256=9I_nAvnArfLSI0NzwmARJuTDYsJnp4U0UT2_Z2L5sR0,20
+fastapi_forge/templates/base/app/core/auth.py.jinja,sha256=RFIc1XTN-YOjL2JlxucQtaQYem0_bh-Xv4bwRP_i2UU,2396
+fastapi_forge/templates/base/app/core/config.py.jinja,sha256=IUSn8IkJjCElMgqPIqf8ZVXczUUrslk_oWEd9X9_DB0,1416
+fastapi_forge/templates/base/app/core/database.py.jinja,sha256=qHVEHBrgU_d3ht4oPVXo_o2dGmq_7G0kWNZy1hCClyA,1580
+fastapi_forge/templates/base/app/core/deps.py.jinja,sha256=-ats4omSmPGv_lJm-xYf0wQ8y_NTCRUMBzVXXsXA8l8,1102
+fastapi_forge/templates/base/app/core/redis.py.jinja,sha256=kJtlrBHAMzD33vezyLbrM3772iky7r7GElBVQvi5ZGg,831
+fastapi_forge/templates/base/app/daos/__init__.py.jinja,sha256=xV9vy4GJB-1F1wzXoSIv1WrB3W073Dl4Za_AwApWLPI,35
+fastapi_forge/templates/base/app/exceptions/__init__.py.jinja,sha256=VvNY_dwDxiZXnemgw5FTA1a6WXo03hEGCW5vPBMTT4o,137
+fastapi_forge/templates/base/app/exceptions/exception.py.jinja,sha256=3gwIPqRJB7XxNXks2iKUMXUOOvtHBMwx0hGK-9Pd1Nc,813
+fastapi_forge/templates/base/app/exceptions/handler.py.jinja,sha256=3Tg2fzXO658qwC-t-EImtS55uEbzyiLtneSv9oA_hv0,1855
+fastapi_forge/templates/base/app/models/__init__.py.jinja,sha256=uREOdg1ybf9dhnZeZXFXPwwjDUy7yUn6ikjdqWxwtts,87
+fastapi_forge/templates/base/app/models/base.py.jinja,sha256=gs5bM6z7cPkJ5YB-M0M1-Juv5x5wuGIaPKuTI8o8hsM,218
+fastapi_forge/templates/base/app/schemas/__init__.py.jinja,sha256=po2cQZhQzNQOO5LaDX4bZTnwSANTLXQUatRehYnj3-A,32
+fastapi_forge/templates/base/app/schemas/api_schema.py.jinja,sha256=whiTgrkcHcgnZzm33nfknerd0ZuGLvY8jsKmRk_5RSM,450
+fastapi_forge/templates/base/app/schemas/auth_schema.py.jinja,sha256=rU4S4JvFskPKFykVS-O2thT91AyOaN_SVkUArlWGsRc,519
+fastapi_forge/templates/base/app/services/__init__.py.jinja,sha256=d_SsEPaHwuOY_Ia6JMCP4fzcwMiapbeqHCOlr1vL1XA,24
+fastapi_forge/templates/base/app/utils/__init__.py.jinja,sha256=xapIpxdEFapo51eG3-HZrMW--EqWxjVWC27VGNa9ZK8,25
+fastapi_forge/templates/base/app/utils/log.py.jinja,sha256=ZM1B-02rg-XptEKrRYsQElA6vX_nLb5oYG5jAX1GSXg,406
+fastapi_forge/templates/base/tests/__init__.py.jinja,sha256=tHVBdTfoZmsFCAZk7NlTxGQ4yxO0kz30TBEkaAn9fKM,19
+fastapi_forge/templates/base/tests/conftest.py.jinja,sha256=jL35xyIYio8geInyu_L_5_6oVev23ANzydGgnucJ4eg,686
+fastapi_forge/templates/base/tests/test_health.py.jinja,sha256=0tPur37M3lJtcMydcbxhnnhFw8H6mcefWccNFc6JimU,612
+forgeapi-0.1.0.dist-info/METADATA,sha256=cnREYlmcsjUtrtae4jY9kuechUtXuQO_4tFtq8iCb6s,5661
+forgeapi-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+forgeapi-0.1.0.dist-info/entry_points.txt,sha256=ElkRooX32X4EwIQi5oMGQvRw5VIAlVnlE_uc7Ga5xZA,48
+forgeapi-0.1.0.dist-info/licenses/LICENSE,sha256=qPCmddeYDPqK4_bx1-P5PiSYF-p9gFOc01bEjLfH2No,1069
+forgeapi-0.1.0.dist-info/RECORD,,

forgeapi-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

forgeapi-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+forge = fastapi_forge.cli:app

forgeapi-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BlockZachary
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.