fast-clean-architecture 1.0.0__tar.gz → 1.1.2__tar.gz

{fast_clean_architecture-1.0.0 → fast_clean_architecture-1.1.2}/.gitignore

@@ -224,7 +224,7 @@ $RECYCLE.BIN/
 # Project-specific
 # Configuration backups
 *.backup.*
-fca-config.yaml.backup.*
+fca_config.yaml.backup.*
 
 # Generated systems directory (if not tracking)
 # systems/
@@ -410,7 +410,7 @@ override.toml
 # systems/
 
 # Configuration file backups (already covered above but being explicit)
-fca-config.yaml.backup*
+fca_config.yaml.backup*
 
 # Any local test configurations
 test-config.yaml
@@ -946,12 +946,12 @@ fastlane/readme.md
 # Temporary files created by R markdown
 *.utf8.md
 *.knit.md
+*_prompt.md
 
 # R Environment Variables
 .Renviron
 
 # pkgdown site
-docs/
 
 # translation temp files
 po/*~

fast_clean_architecture-1.1.2/.pre-commit-config.yaml

@@ -0,0 +1,105 @@
+repos:
+  # Dependency Management (Current)
+  - repo: local
+    hooks:
+      - id: export-requirements
+        name: Export requirements.txt
+        entry: poetry export -f requirements.txt --output requirements.txt
+        language: system
+        files: pyproject.toml
+        pass_filenames: false
+        stages: [commit]
+      - id: export-dev-requirements
+        name: Export dev requirements.txt
+        entry: poetry export -f requirements.txt --output requirements-dev.txt --extras dev
+        language: system
+        files: pyproject.toml
+        pass_filenames: false
+        stages: [commit]
+
+  # Code Formatting
+  - repo: https://github.com/psf/black
+    rev: 23.12.1
+    hooks:
+      - id: black
+        name: Format code with Black
+        language_version: python3
+        types: [python]
+
+  - repo: https://github.com/pycqa/isort
+    rev: 5.13.2
+    hooks:
+      - id: isort
+        name: Sort imports with isort
+        args: ["--profile", "black"]
+        types: [python]
+
+  # Code Quality & Linting
+  - repo: https://github.com/pycqa/flake8
+    rev: 7.0.0
+    hooks:
+      - id: flake8
+        name: Lint with flake8
+        args: ["--max-line-length=88", "--extend-ignore=E203,W503"]
+        types: [python]
+
+  # Type Checking
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.8.0
+    hooks:
+      - id: mypy
+        name: Type check with mypy
+        additional_dependencies: [types-all]
+        args: ["--ignore-missing-imports"]
+        types: [python]
+
+  # Security Scanning
+  - repo: https://github.com/pycqa/bandit
+    rev: 1.7.5
+    hooks:
+      - id: bandit
+        name: Security scan with bandit
+        args: ["-r", "fast_clean_architecture"]
+        types: [python]
+
+  # General Code Quality
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+        name: Remove trailing whitespace
+      - id: end-of-file-fixer
+        name: Fix end of files
+      - id: check-yaml
+        name: Check YAML syntax
+      - id: check-toml
+        name: Check TOML syntax
+      - id: check-json
+        name: Check JSON syntax
+      - id: check-merge-conflict
+        name: Check for merge conflicts
+      - id: check-added-large-files
+        name: Check for large files
+        args: ['--maxkb=500']
+      - id: debug-statements
+        name: Check for debug statements
+        types: [python]
+
+  # Documentation
+  - repo: https://github.com/pycqa/pydocstyle
+    rev: 6.3.0
+    hooks:
+      - id: pydocstyle
+        name: Check docstring style
+        args: ["--convention=google"]
+        types: [python]
+
+  # Dependency Security
+  - repo: local
+    hooks:
+      - id: safety-check
+        name: Check dependencies for security vulnerabilities
+        entry: poetry run safety check
+        language: system
+        pass_filenames: false
+        stages: [commit]

{fast_clean_architecture-1.0.0 → fast_clean_architecture-1.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-clean-architecture
-Version: 1.0.0
+Version: 1.1.2
 Summary: CLI tool for scaffolding clean architecture in FastAPI projects
 Project-URL: Homepage, https://github.com/alden-technologies/fast-clean-architecture
 Project-URL: Repository, https://github.com/alden-technologies/fast-clean-architecture
@@ -17,33 +17,27 @@ 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.8
 Classifier: Programming Language :: Python :: 3.9
 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
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Requires-Dist: jinja2<4.0.0,>=3.1.0
 Requires-Dist: pathlib-mate<2.0.0,>=1.0.0
+Requires-Dist: portalocker<3.0.0,>=2.0.0
+Requires-Dist: psutil>=5.9.0
 Requires-Dist: pydantic<3.0.0,>=2.0.0
 Requires-Dist: pyyaml<7.0.0,>=6.0
 Requires-Dist: rich<14.0.0,>=13.0.0
+Requires-Dist: structlog<24.0.0,>=23.0.0
 Requires-Dist: typer[all]<1.0.0,>=0.9.0
-Provides-Extra: dev
-Requires-Dist: bandit<2.0.0,>=1.7.0; extra == 'dev'
-Requires-Dist: black<24.0.0,>=23.0.0; extra == 'dev'
-Requires-Dist: isort<6.0.0,>=5.0.0; extra == 'dev'
-Requires-Dist: mypy<2.0.0,>=1.0.0; extra == 'dev'
-Requires-Dist: pytest-cov<5.0.0,>=4.0.0; extra == 'dev'
-Requires-Dist: pytest<8.0.0,>=7.0.0; extra == 'dev'
-Requires-Dist: safety<3.0.0,>=2.0.0; extra == 'dev'
 Description-Content-Type: text/markdown
 
 # Fast Clean Architecture
 
-[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
 
@@ -56,7 +50,10 @@ A powerful CLI tool for scaffolding clean architecture in FastAPI projects. Gene
 - **Code Generation**: Automated scaffolding for entities, repositories, services, and more
 - **Template System**: Customizable Jinja2 templates for code generation
 - **Type Safety**: Full type hints and Pydantic validation
-- **Modern Python**: Built for Python 3.8+ with async/await support
+- **Modern Python**: Built for Python 3.9+ with async/await support
+- **Analytics & Monitoring**: Built-in usage analytics, error tracking, and health monitoring
+- **Security Features**: Template validation, input sanitization, and secure file operations
+- **Batch Operations**: Create multiple components from YAML specifications
 - **CLI Interface**: Intuitive command-line interface with rich output
 - **Configuration Management**: YAML-based project configuration with versioning
 
@@ -74,37 +71,7 @@ pip install fast-clean-architecture
 poetry add fast-clean-architecture
 ```
 
-### From Source
-
-#### Using pip
-```bash
-git clone https://github.com/alden-technologies/fast-clean-architecture.git
-cd fast-clean-architecture
-pip install -e .
-```
-
-#### Using Poetry
-```bash
-git clone https://github.com/alden-technologies/fast-clean-architecture.git
-cd fast-clean-architecture
-poetry install
-```
-
-### Development Installation
-
-#### Using pip
-```bash
-git clone https://github.com/alden-technologies/fast-clean-architecture.git
-cd fast-clean-architecture
-pip install -e ".[dev]"
-```
-
-#### Using Poetry
-```bash
-git clone https://github.com/alden-technologies/fast-clean-architecture.git
-cd fast-clean-architecture
-poetry install --with dev
-```
+**Note**: This project uses Poetry for dependency management. The `requirements.txt` and `requirements-dev.txt` files are provided for convenience and compatibility with pip-based workflows.
 
 ## 🏗️ Architecture Overview
 
@@ -130,14 +97,14 @@ Fast Clean Architecture follows the clean architecture pattern with these layers
 │           └── 📁 presentation/     # API layer
 │               ├── 📁 api/          # FastAPI routers
 │               └── 📁 schemas/      # Pydantic schemas
-└── 📄 fca-config.yaml             # Project configuration
+└── 📄 fca_config.yaml             # Project configuration
 ```
 
 ## 📋 Prerequisites
 
 **Important**: This tool is designed to scaffold clean architecture components for FastAPI projects. You should have:
 
-- **Python 3.8+** installed on your system
+- **Python 3.9+** installed on your system
 - **Basic understanding of FastAPI** and web API development
 - **Familiarity with clean architecture principles** (recommended but not required)
 - **A new or existing directory** where you want to create your FastAPI project structure
@@ -306,24 +273,52 @@ Your API will be available at `http://localhost:8000` with automatic documentati
 | **Presentation** | `api` | FastAPI routers and endpoints |
 | | `schemas` | Pydantic request/response schemas |
 
-### CLI Options
+### CLI Commands
+
+#### Core Commands
+```bash
+# Project initialization
+fca-scaffold init                    # Initialize new project
+fca-scaffold create-system-context   # Create system (bounded context)
+fca-scaffold create-module          # Create module within system
+fca-scaffold create-component       # Create individual components
+```
+
+#### Batch Operations
+```bash
+# Create multiple components from YAML specification
+fca-scaffold batch-create components_spec.yaml
+fca-scaffold batch-create my-spec.yaml --dry-run  # Preview only
+```
 
+#### Project Management
 ```bash
-# Global options
-fca-scaffold --help
-fca-scaffold --version
-fca-scaffold --dry-run    # Preview changes without writing files
-fca-scaffold --force      # Overwrite existing files
-fca-scaffold --verbose    # Detailed output
-
-# Command-specific help
-fca-scaffold init --help
-fca-scaffold create-component --help
+# Project status and configuration
+fca-scaffold status                  # Show project overview
+fca-scaffold config show            # Display configuration
+fca-scaffold config validate        # Validate configuration
+fca-scaffold system-status          # Show system health and analytics
+```
+
+#### Help and Information
+```bash
+# Get help and version info
+fca-scaffold version                # Show version information
+fca-scaffold --help                 # General help
+```
+
+#### Global Options
+```bash
+# Available for most commands
+--dry-run    # Preview changes without writing files
+--force      # Overwrite existing files
+--verbose    # Detailed output
+--config     # Specify custom config file
 ```
 
 ### Configuration File
 
-The `fca-config.yaml` file tracks your project structure:
+The `fca_config.yaml` file tracks your project structure:
 
 ```yaml
 project:
@@ -352,6 +347,71 @@ project:
               api: ["user"]
 ```
 
+## 📊 Batch Component Creation
+
+### YAML Specification Format
+
+Create multiple components efficiently using YAML specifications:
+
+```yaml
+# components_spec.yaml
+systems:
+  - name: admin
+    description: "Admin management system"
+    modules:
+      - name: authentication
+        description: "Admin authentication module"
+        components:
+          domain:
+            entities: [AdminUser, AdminRole]
+            value_objects: [AdminEmail, AdminPassword]
+            repositories: [AdminUserRepository]
+          application:
+            services: [AdminAuthService]
+            commands: [CreateAdminUser, UpdateAdminUser]
+            queries: [GetAdminUser, ListAdminUsers]
+          infrastructure:
+            repositories: [AdminUserRepository]
+            models: [AdminUserModel]
+            external: [AdminEmailService]
+          presentation:
+            api: [AdminAuthRouter]
+            schemas: [AdminUserSchema, AdminAuthSchema]
+```
+
+### Usage
+
+```bash
+# Create all components from specification
+fca-scaffold batch-create components_spec.yaml
+
+# Preview what would be created
+fca-scaffold batch-create components_spec.yaml --dry-run
+
+# Force overwrite existing files
+fca-scaffold batch-create components_spec.yaml --force
+```
+
+## 📊 System Monitoring
+
+### Health and Analytics
+
+Fast Clean Architecture includes built-in monitoring capabilities:
+
+```bash
+# View system health and usage analytics
+fca-scaffold system-status
+
+# Detailed system information
+fca-scaffold system-status --verbose
+```
+
+**Features:**
+- **Usage Analytics**: Track command usage and component creation patterns
+- **Error Tracking**: Monitor and log errors with detailed context
+- **Health Monitoring**: System resource usage and performance metrics
+- **Security Monitoring**: Template validation and input sanitization tracking
+
 ## 🎨 Customization
 
 ### Custom Templates
@@ -423,9 +483,7 @@ pytest -v
 ```bash
 git clone https://github.com/alden-technologies/fast-clean-architecture.git
 cd fast-clean-architecture
-python -m venv venv
-source venv/bin/activate  # On Windows: venv\Scripts\activate
-pip install -e ".[dev]"
+poetry install --with dev
 ```
 
 ### Code Quality
@@ -447,11 +505,20 @@ bandit -r fast_clean_architecture
 safety check
 ```
 
+### Security Updates
+
+This project maintains up-to-date dependencies with security patches:
+
+- **Black 24.3.0+**: Fixes CVE-2024-21503 (ReDoS vulnerability)
+- **Pip 25.0+**: Fixes PVE-2025-75180 (malicious wheel execution)
+- **Setuptools 78.1.1+**: Fixes CVE-2025-47273 (path traversal vulnerability)
+
+All dependencies are pinned with SHA256 hashes for supply chain security.
+
 ### Pre-commit Hooks
 
 ```bash
-pip install pre-commit
-pre-commit install
+poetry run pre-commit install
 ```
 
 ## 📖 Examples
@@ -538,4 +605,4 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ---
 
-**Made with ❤️ by [Alden Technologies](https://aldentechnologies.com)**
+**Made with ❤️ by [Adegbenga Agoro](https://www.adegbengaagoro.co), [Founder of Alden Technologies](https://www.aldentechnologies.com)**

{fast_clean_architecture-1.0.0 → fast_clean_architecture-1.1.2}/README.md

@@ -1,6 +1,6 @@
 # Fast Clean Architecture
 
-[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
 
@@ -13,7 +13,10 @@ A powerful CLI tool for scaffolding clean architecture in FastAPI projects. Gene
 - **Code Generation**: Automated scaffolding for entities, repositories, services, and more
 - **Template System**: Customizable Jinja2 templates for code generation
 - **Type Safety**: Full type hints and Pydantic validation
-- **Modern Python**: Built for Python 3.8+ with async/await support
+- **Modern Python**: Built for Python 3.9+ with async/await support
+- **Analytics & Monitoring**: Built-in usage analytics, error tracking, and health monitoring
+- **Security Features**: Template validation, input sanitization, and secure file operations
+- **Batch Operations**: Create multiple components from YAML specifications
 - **CLI Interface**: Intuitive command-line interface with rich output
 - **Configuration Management**: YAML-based project configuration with versioning
 
@@ -31,37 +34,7 @@ pip install fast-clean-architecture
 poetry add fast-clean-architecture
 ```
 
-### From Source
-
-#### Using pip
-```bash
-git clone https://github.com/alden-technologies/fast-clean-architecture.git
-cd fast-clean-architecture
-pip install -e .
-```
-
-#### Using Poetry
-```bash
-git clone https://github.com/alden-technologies/fast-clean-architecture.git
-cd fast-clean-architecture
-poetry install
-```
-
-### Development Installation
-
-#### Using pip
-```bash
-git clone https://github.com/alden-technologies/fast-clean-architecture.git
-cd fast-clean-architecture
-pip install -e ".[dev]"
-```
-
-#### Using Poetry
-```bash
-git clone https://github.com/alden-technologies/fast-clean-architecture.git
-cd fast-clean-architecture
-poetry install --with dev
-```
+**Note**: This project uses Poetry for dependency management. The `requirements.txt` and `requirements-dev.txt` files are provided for convenience and compatibility with pip-based workflows.
 
 ## 🏗️ Architecture Overview
 
@@ -87,14 +60,14 @@ Fast Clean Architecture follows the clean architecture pattern with these layers
 │           └── 📁 presentation/     # API layer
 │               ├── 📁 api/          # FastAPI routers
 │               └── 📁 schemas/      # Pydantic schemas
-└── 📄 fca-config.yaml             # Project configuration
+└── 📄 fca_config.yaml             # Project configuration
 ```
 
 ## 📋 Prerequisites
 
 **Important**: This tool is designed to scaffold clean architecture components for FastAPI projects. You should have:
 
-- **Python 3.8+** installed on your system
+- **Python 3.9+** installed on your system
 - **Basic understanding of FastAPI** and web API development
 - **Familiarity with clean architecture principles** (recommended but not required)
 - **A new or existing directory** where you want to create your FastAPI project structure
@@ -263,24 +236,52 @@ Your API will be available at `http://localhost:8000` with automatic documentati
 | **Presentation** | `api` | FastAPI routers and endpoints |
 | | `schemas` | Pydantic request/response schemas |
 
-### CLI Options
+### CLI Commands
+
+#### Core Commands
+```bash
+# Project initialization
+fca-scaffold init                    # Initialize new project
+fca-scaffold create-system-context   # Create system (bounded context)
+fca-scaffold create-module          # Create module within system
+fca-scaffold create-component       # Create individual components
+```
+
+#### Batch Operations
+```bash
+# Create multiple components from YAML specification
+fca-scaffold batch-create components_spec.yaml
+fca-scaffold batch-create my-spec.yaml --dry-run  # Preview only
+```
 
+#### Project Management
 ```bash
-# Global options
-fca-scaffold --help
-fca-scaffold --version
-fca-scaffold --dry-run    # Preview changes without writing files
-fca-scaffold --force      # Overwrite existing files
-fca-scaffold --verbose    # Detailed output
-
-# Command-specific help
-fca-scaffold init --help
-fca-scaffold create-component --help
+# Project status and configuration
+fca-scaffold status                  # Show project overview
+fca-scaffold config show            # Display configuration
+fca-scaffold config validate        # Validate configuration
+fca-scaffold system-status          # Show system health and analytics
+```
+
+#### Help and Information
+```bash
+# Get help and version info
+fca-scaffold version                # Show version information
+fca-scaffold --help                 # General help
+```
+
+#### Global Options
+```bash
+# Available for most commands
+--dry-run    # Preview changes without writing files
+--force      # Overwrite existing files
+--verbose    # Detailed output
+--config     # Specify custom config file
 ```
 
 ### Configuration File
 
-The `fca-config.yaml` file tracks your project structure:
+The `fca_config.yaml` file tracks your project structure:
 
 ```yaml
 project:
@@ -309,6 +310,71 @@ project:
               api: ["user"]
 ```
 
+## 📊 Batch Component Creation
+
+### YAML Specification Format
+
+Create multiple components efficiently using YAML specifications:
+
+```yaml
+# components_spec.yaml
+systems:
+  - name: admin
+    description: "Admin management system"
+    modules:
+      - name: authentication
+        description: "Admin authentication module"
+        components:
+          domain:
+            entities: [AdminUser, AdminRole]
+            value_objects: [AdminEmail, AdminPassword]
+            repositories: [AdminUserRepository]
+          application:
+            services: [AdminAuthService]
+            commands: [CreateAdminUser, UpdateAdminUser]
+            queries: [GetAdminUser, ListAdminUsers]
+          infrastructure:
+            repositories: [AdminUserRepository]
+            models: [AdminUserModel]
+            external: [AdminEmailService]
+          presentation:
+            api: [AdminAuthRouter]
+            schemas: [AdminUserSchema, AdminAuthSchema]
+```
+
+### Usage
+
+```bash
+# Create all components from specification
+fca-scaffold batch-create components_spec.yaml
+
+# Preview what would be created
+fca-scaffold batch-create components_spec.yaml --dry-run
+
+# Force overwrite existing files
+fca-scaffold batch-create components_spec.yaml --force
+```
+
+## 📊 System Monitoring
+
+### Health and Analytics
+
+Fast Clean Architecture includes built-in monitoring capabilities:
+
+```bash
+# View system health and usage analytics
+fca-scaffold system-status
+
+# Detailed system information
+fca-scaffold system-status --verbose
+```
+
+**Features:**
+- **Usage Analytics**: Track command usage and component creation patterns
+- **Error Tracking**: Monitor and log errors with detailed context
+- **Health Monitoring**: System resource usage and performance metrics
+- **Security Monitoring**: Template validation and input sanitization tracking
+
 ## 🎨 Customization
 
 ### Custom Templates
@@ -380,9 +446,7 @@ pytest -v
 ```bash
 git clone https://github.com/alden-technologies/fast-clean-architecture.git
 cd fast-clean-architecture
-python -m venv venv
-source venv/bin/activate  # On Windows: venv\Scripts\activate
-pip install -e ".[dev]"
+poetry install --with dev
 ```
 
 ### Code Quality
@@ -404,11 +468,20 @@ bandit -r fast_clean_architecture
 safety check
 ```
 
+### Security Updates
+
+This project maintains up-to-date dependencies with security patches:
+
+- **Black 24.3.0+**: Fixes CVE-2024-21503 (ReDoS vulnerability)
+- **Pip 25.0+**: Fixes PVE-2025-75180 (malicious wheel execution)
+- **Setuptools 78.1.1+**: Fixes CVE-2025-47273 (path traversal vulnerability)
+
+All dependencies are pinned with SHA256 hashes for supply chain security.
+
 ### Pre-commit Hooks
 
 ```bash
-pip install pre-commit
-pre-commit install
+poetry run pre-commit install
 ```
 
 ## 📖 Examples
@@ -495,4 +568,4 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ---
 
-**Made with ❤️ by [Alden Technologies](https://aldentechnologies.com)**
+**Made with ❤️ by [Adegbenga Agoro](https://www.adegbengaagoro.co), [Founder of Alden Technologies](https://www.aldentechnologies.com)**