aegis-stack 0.1.0__tar.gz

aegis_stack-0.1.0/.gitignore

@@ -0,0 +1,130 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*.so
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Data
+data/

aegis_stack-0.1.0/CHANGELOG.md

@@ -0,0 +1,39 @@
+  # Changelog
+
+  All notable changes to this project will be documented in this file.
+
+  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+  ## [0.1.0] - 2025-08-27
+
+  ### Added
+  - Initial release of Aegis Stack CLI tool
+  - Database component with SQLite/SQLModel ORM integration
+  - FastAPI backend with health monitoring system
+  - Flet frontend for web and desktop applications
+  - Worker component with arq/Redis for background tasks
+  - Scheduler component with APScheduler
+  - Docker containerization support
+  - Comprehensive testing infrastructure with pytest
+  - Type checking with mypy and pydantic plugin
+  - Auto-formatting with ruff
+  - Project generation via `aegis init` command
+  - Component dependency resolution system
+  - Database health checks with detailed metrics
+  - Transaction rollback testing fixtures
+  - Template validation system
+
+  ### Fixed
+  - Database test isolation issues
+  - Type checking for Pydantic models with mypy plugin
+  - Template linting issues in generated projects
+
+  ### Components
+  - Backend (FastAPI) - Always included
+  - Frontend (Flet) - Always included
+  - Database (SQLite/SQLModel) - Optional
+  - Worker (arq/Redis) - Optional
+  - Scheduler (APScheduler) - Optional
+
+  [0.1.0]: https://github.com/lbedner/aegis-stack/releases/tag/v0.1.0

aegis_stack-0.1.0/PKG-INFO

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: aegis-stack
+Version: 0.1.0
+Summary: A production-ready Python foundation for builders who refuse to wait
+Project-URL: Homepage, https://github.com/lbedner/aegis-stack
+Project-URL: Documentation, https://github.com/lbedner/aegis-stack#readme
+Project-URL: Repository, https://github.com/lbedner/aegis-stack
+Project-URL: Issues, https://github.com/lbedner/aegis-stack/issues
+Project-URL: Changelog, https://github.com/lbedner/aegis-stack/blob/main/CHANGELOG.md
+Author-email: Leonard Bedner <gamecoder99@gmail.com>
+License: MIT
+Keywords: boilerplate,cli,cookiecutter,database,fastapi,generator,python,scaffold,scheduler,stack,template,worker
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: cookiecutter>=2.6.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.8.0; extra == 'dev'
+Requires-Dist: pip-audit>=2.6.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.7.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs-gen-files>=0.5.0; extra == 'docs'
+Requires-Dist: mkdocs-material>=9.5.0; extra == 'docs'
+Requires-Dist: mkdocs-mermaid2-plugin>=1.1.0; extra == 'docs'
+Requires-Dist: mkdocs>=1.5.0; extra == 'docs'
+Requires-Dist: mkdocstrings[python]>=0.24.0; extra == 'docs'
+Requires-Dist: pymdown-extensions>=10.0.0; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# Aegis Stack 🛡️
+
+[![CI](https://github.com/lbedner/aegis-stack/workflows/CI/badge.svg)](https://github.com/lbedner/aegis-stack/actions/workflows/ci.yml)
+[![Documentation](https://github.com/lbedner/aegis-stack/workflows/Deploy%20Documentation/badge.svg)](https://github.com/lbedner/aegis-stack/actions/workflows/docs.yml)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+
+**Build production-ready Python applications with your chosen components.**
+
+Aegis Stack is a CLI-driven framework for creating custom Python applications. Select exactly the components you need - no bloat, no unused dependencies.
+
+## 🚀 Quick Start
+
+```bash
+# Install
+pip install aegis-stack
+
+# Create a simple API
+aegis init my-api
+
+# Create with background processing  
+aegis init task-processor --components scheduler,worker
+
+# Start building
+cd my-project && uv sync && source .venv/bin/activate && make run-local
+```
+
+## 🧩 Available Components
+
+| Component | Purpose | Status |
+|-----------|---------|--------|
+| **Core** (FastAPI + Flet) | Web API + Frontend | ✅ **Included** |
+| **Scheduler** | Background tasks, cron jobs | ✅ **Available** |
+| **Worker** | Async task queues, job processing | ✅ **Available** |
+| **Database** | PostgreSQL + SQLAlchemy + Alembic | 🚧 **Coming Soon** |
+| **Cache** | Redis caching and sessions | 🚧 **Coming Soon** |
+
+## What You Get
+
+- **FastAPI backend** with automatic API documentation
+- **Flet frontend** with health dashboard  
+- **CLI management** with health monitoring commands
+- **Worker queues** with async task processing and load testing
+- **Production ready** with structured logging and containerization
+- **Async-first** architecture for high-concurrency workloads
+
+## 📱 System Health Dashboard
+
+![System Health Dashboard](docs/images/dashboard-light.png#only-light)
+![System Health Dashboard](docs/images/dashboard-dark.png#only-dark)
+
+Real-time monitoring with component status, health percentages, and cross-platform deployment (web, desktop, mobile).
+
+## 📚 Learn More
+
+- **[📖 CLI Reference](docs/cli-reference.md)** - Complete command reference
+- **[🏗️ Components](docs/components/index.md)** - Deep dive into available components  
+- **[🧠 Philosophy](docs/philosophy.md)** - Architecture and design principles
+
+## Development Commands
+
+```bash
+make run-local    # Start development server
+make test         # Run test suite  
+make check        # Run all quality checks
+make docs-serve   # Serve documentation
+```
+
+Built on FastAPI, Flet, Typer, and other open-source tools.

aegis_stack-0.1.0/README.md

@@ -0,0 +1,68 @@
+# Aegis Stack 🛡️
+
+[![CI](https://github.com/lbedner/aegis-stack/workflows/CI/badge.svg)](https://github.com/lbedner/aegis-stack/actions/workflows/ci.yml)
+[![Documentation](https://github.com/lbedner/aegis-stack/workflows/Deploy%20Documentation/badge.svg)](https://github.com/lbedner/aegis-stack/actions/workflows/docs.yml)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+
+**Build production-ready Python applications with your chosen components.**
+
+Aegis Stack is a CLI-driven framework for creating custom Python applications. Select exactly the components you need - no bloat, no unused dependencies.
+
+## 🚀 Quick Start
+
+```bash
+# Install
+pip install aegis-stack
+
+# Create a simple API
+aegis init my-api
+
+# Create with background processing  
+aegis init task-processor --components scheduler,worker
+
+# Start building
+cd my-project && uv sync && source .venv/bin/activate && make run-local
+```
+
+## 🧩 Available Components
+
+| Component | Purpose | Status |
+|-----------|---------|--------|
+| **Core** (FastAPI + Flet) | Web API + Frontend | ✅ **Included** |
+| **Scheduler** | Background tasks, cron jobs | ✅ **Available** |
+| **Worker** | Async task queues, job processing | ✅ **Available** |
+| **Database** | PostgreSQL + SQLAlchemy + Alembic | 🚧 **Coming Soon** |
+| **Cache** | Redis caching and sessions | 🚧 **Coming Soon** |
+
+## What You Get
+
+- **FastAPI backend** with automatic API documentation
+- **Flet frontend** with health dashboard  
+- **CLI management** with health monitoring commands
+- **Worker queues** with async task processing and load testing
+- **Production ready** with structured logging and containerization
+- **Async-first** architecture for high-concurrency workloads
+
+## 📱 System Health Dashboard
+
+![System Health Dashboard](docs/images/dashboard-light.png#only-light)
+![System Health Dashboard](docs/images/dashboard-dark.png#only-dark)
+
+Real-time monitoring with component status, health percentages, and cross-platform deployment (web, desktop, mobile).
+
+## 📚 Learn More
+
+- **[📖 CLI Reference](docs/cli-reference.md)** - Complete command reference
+- **[🏗️ Components](docs/components/index.md)** - Deep dive into available components  
+- **[🧠 Philosophy](docs/philosophy.md)** - Architecture and design principles
+
+## Development Commands
+
+```bash
+make run-local    # Start development server
+make test         # Run test suite  
+make check        # Run all quality checks
+make docs-serve   # Serve documentation
+```
+
+Built on FastAPI, Flet, Typer, and other open-source tools.

aegis_stack-0.1.0/aegis/__init__.py

@@ -0,0 +1,5 @@
+"""
+Aegis Stack CLI - Component generation and project management tools.
+"""
+
+__version__ = "0.1.0"