fast-clean-architecture 1.1.0__py3-none-any.whl → 1.1.2__py3-none-any.whl

fast_clean_architecture/__init__.py

@@ -1,8 +1,8 @@
 """Fast Clean Architecture - CLI tool for scaffolding clean architecture in FastAPI projects."""
 
-__version__ = "1.0.0"
+__version__ = "1.1.2"
 __author__ = "Agoro, Adegbenga. B (IAM)"
-__email__ = "adegbenga@alden-technologies.com"
+__email__ = "opensource@aldentechnologies.com"
 
 from .cli import app
 from .config import Config

fast_clean_architecture/cli.py

@@ -335,11 +335,23 @@ def create_module(
         if not validate_python_identifier(sanitized_module):
             raise ValidationError(f"Invalid module name: {module_name}")
 
-        # Initialize generators
+        # Initialize config updater for validation
         config_updater = ConfigUpdater(config_path, console)
+
+        # Validate system exists BEFORE creating any directory structure
+        if sanitized_system not in config_updater.config.project.systems:
+            raise ValidationError(
+                f"System '{sanitized_system}' not found.\n\n"
+                f"To create the module, first create the system:\n"
+                f'  fca-scaffold create-system-context {sanitized_system} --description "[SYSTEM_DESCRIPTION]"\n\n'
+                f"Then create your module:\n"
+                f"  fca-scaffold create-module {sanitized_system} {sanitized_module}"
+            )
+
+        # Initialize package generator
         package_generator = PackageGenerator(console)
 
-        # Create module structure
+        # Create module structure (only after validation passes)
         package_generator.create_module_structure(
             base_path=project_root,
             system_name=sanitized_system,
@@ -348,7 +360,7 @@ def create_module(
         )
 
         if not dry_run:
-            # Update configuration
+            # Update configuration (system existence already validated)
             config_updater.add_module(sanitized_system, sanitized_module, description)
 
         console.print(
@@ -878,8 +890,8 @@ def system_status(
 
         console.print("\n[bold blue]📊 Fast Clean Architecture Status[/bold blue]\n")
 
-        # Health Status
-        console.print("[bold yellow]🏥 System Health[/bold yellow]")
+        # FCA System Health
+        console.print("[bold yellow]🏥 FCA System Health[/bold yellow]")
         health_monitor = get_health_monitor()
         health_data = health_monitor.get_system_health()
 
@@ -887,20 +899,13 @@ def system_status(
             console.print(f"[red]❌ Health check failed: {health_data['error']}[/red]")
         else:
             process_data = health_data.get("process", {})
-            system_data = health_data.get("system", {})
 
             console.print(
                 f"  • Memory Usage: {process_data.get('memory_rss_mb', 0):.1f} MB ({process_data.get('memory_percent', 0):.1f}%)"
             )
             console.print(f"  • CPU Usage: {process_data.get('cpu_percent', 0):.1f}%")
             console.print(
-                f"  • System Memory: {system_data.get('memory_used_percent', 0):.1f}% used"
-            )
-            console.print(
-                f"  • Disk Space: {system_data.get('disk_used_percent', 0):.1f}% used"
-            )
-            console.print(
-                f"  • Uptime: {health_data.get('uptime_seconds', 0):.1f} seconds"
+                f"  • Session Duration: {health_data.get('uptime_seconds', 0):.1f} seconds"
             )
 
         # Error Tracking

fast_clean_architecture/generators/validation_config.py

@@ -39,9 +39,9 @@ class ValidationConfig:
 
     # Basic monitoring
     enable_metrics: bool = False  # Disabled by default to reduce complexity
-    log_level: Literal[
-        "DEBUG", "INFO", "WARNING", "ERROR"
-    ] = "WARNING"  # Reduced logging
+    log_level: Literal["DEBUG", "INFO", "WARNING", "ERROR"] = (
+        "WARNING"  # Reduced logging
+    )
 
     def __post_init__(self) -> None:
         """Validate configuration after initialization."""

{fast_clean_architecture-1.1.0.dist-info → fast_clean_architecture-1.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-clean-architecture
-Version: 1.1.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
@@ -37,7 +37,7 @@ 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)
 
@@ -50,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
 
@@ -68,52 +71,6 @@ pip install fast-clean-architecture
 poetry add fast-clean-architecture
 ```
 
-### From Source
-
-#### Using Poetry (Recommended)
-```bash
-git clone https://github.com/alden-technologies/fast-clean-architecture.git
-cd fast-clean-architecture
-poetry install
-```
-
-#### Using pip with requirements.txt
-```bash
-git clone https://github.com/alden-technologies/fast-clean-architecture.git
-cd fast-clean-architecture
-pip install -r requirements.txt
-```
-
-#### Using pip (editable install)
-```bash
-git clone https://github.com/alden-technologies/fast-clean-architecture.git
-cd fast-clean-architecture
-pip install -e .
-```
-
-### Development Installation
-
-#### Using Poetry (Recommended)
-```bash
-git clone https://github.com/alden-technologies/fast-clean-architecture.git
-cd fast-clean-architecture
-poetry install --extras dev
-```
-
-#### Using pip with dev requirements
-```bash
-git clone https://github.com/alden-technologies/fast-clean-architecture.git
-cd fast-clean-architecture
-pip install -r requirements-dev.txt
-```
-
-#### Using pip (editable install with dev dependencies)
-```bash
-git clone https://github.com/alden-technologies/fast-clean-architecture.git
-cd fast-clean-architecture
-pip install -e ".[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
@@ -147,7 +104,7 @@ Fast Clean Architecture follows the clean architecture pattern with these layers
 
 **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
@@ -316,19 +273,47 @@ 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
@@ -362,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
@@ -433,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
@@ -457,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
@@ -548,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.1.0.dist-info → fast_clean_architecture-1.1.2.dist-info}/RECORD

@@ -1,6 +1,6 @@
-fast_clean_architecture/__init__.py,sha256=VOCrdvUXRx1IOKghlxhkzuKY4KFcU7s_RlLtjL10rFE,533
+fast_clean_architecture/__init__.py,sha256=Px5-n1SqwkAYF2UnNimI1zdixKV6Kx5UEm6DVvgQ_Z8,533
 fast_clean_architecture/analytics.py,sha256=2EC8iF1WERhoJm_XCATkUnkBvLIm8lxp9-Ukl4sf4dU,8733
-fast_clean_architecture/cli.py,sha256=S_GViX0gYFQJmmorqSk2nPunHRGL-8VpAmannJMFS-c,37263
+fast_clean_architecture/cli.py,sha256=JIeRpUPG44ISNJX3O1sgvDO1eTFw3GM6NdN4kniZr0I,37662
 fast_clean_architecture/config.py,sha256=UAyzEifdqrbpZDDirVR_E2yq5rlTJyv19Iixd01ufiI,19969
 fast_clean_architecture/error_tracking.py,sha256=uyOEg6IZLNd-1u57bCCLpTzeBwP02pjVxRivXy1GyVM,6034
 fast_clean_architecture/exceptions.py,sha256=0CTkgDjG-Ilqc9Vex02ofgPCSBfmNNceK6ZGwCIF8n0,16578
@@ -16,7 +16,7 @@ fast_clean_architecture/generators/config_updater.py,sha256=faSjwPX_sFWl8-qq4rl0
 fast_clean_architecture/generators/generator_factory.py,sha256=YB_qlGcdNWJsu1ZFP46ik3eK7fjZFCCFo4hfSkwQYMc,7746
 fast_clean_architecture/generators/package_generator.py,sha256=S234nCTHezdGMor0IaxbyWUyO3T68kAx_pJuHVKJHog,5978
 fast_clean_architecture/generators/template_validator.py,sha256=7N1_Sn3BqPIWnv0oKZvSvGgi3y64FKShSIvkFlrlbVA,23651
-fast_clean_architecture/generators/validation_config.py,sha256=ryqlEnE0tGIG5Ste9QsQccr_5HCS1Bl-gn422faDXug,2392
+fast_clean_architecture/generators/validation_config.py,sha256=KmFL1WxDpZ989sPOnREN7fpw1emgRQnKw2aswyTr93U,2394
 fast_clean_architecture/generators/validation_metrics.py,sha256=mQ5pUVH2zg-gfaTHm0lf7-n6X7evTEGPeN__OPeaqS0,6644
 fast_clean_architecture/templates/__init__.py,sha256=uweRUmrNZosbwDlnM10Nfu9rKzPcEqXEr6BchsSAr58,146
 fast_clean_architecture/templates/__init__.py.j2,sha256=ogycgpBmYv-O1yoyQK9-Ki_x4FlYgb58mvhPrhiQNpA,618
@@ -31,8 +31,8 @@ fast_clean_architecture/templates/repository.py.j2,sha256=YsjPpVakZR2A-JmsK-VYE6
 fast_clean_architecture/templates/schemas.py.j2,sha256=iwZT42LxqgNL4ms_-uQkWKWQWaiMDflWzdlWMBke_3M,755
 fast_clean_architecture/templates/service.py.j2,sha256=utNp_E7bywlMfjY9SHzzrH4isr-WeXpnRIb15XkZrj4,3926
 fast_clean_architecture/templates/value_object.py.j2,sha256=IVI69cuYTa_7g1s9T5guigIqeSl1lXFapWFu-XKzYjE,919
-fast_clean_architecture-1.1.0.dist-info/METADATA,sha256=mqX8xt3q2b-miLJHwU5S0el4gaiXfXhPQ38K4JrZwhQ,17096
-fast_clean_architecture-1.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-fast_clean_architecture-1.1.0.dist-info/entry_points.txt,sha256=5R_7kBX0dYEq6n8lyTmv7Sn4Rs3pjpLqGX-mB_3FL1w,65
-fast_clean_architecture-1.1.0.dist-info/licenses/LICENSE,sha256=wpM1B1Znw_YrC9L_R0jiXPHWz5iM_tNW4UOvBtl026s,1075
-fast_clean_architecture-1.1.0.dist-info/RECORD,,
+fast_clean_architecture-1.1.2.dist-info/METADATA,sha256=xh-9NH9spbwIDd5rXdx2SeoeWNLTK-jJzo-w_qJjmOk,19348
+fast_clean_architecture-1.1.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+fast_clean_architecture-1.1.2.dist-info/entry_points.txt,sha256=5R_7kBX0dYEq6n8lyTmv7Sn4Rs3pjpLqGX-mB_3FL1w,65
+fast_clean_architecture-1.1.2.dist-info/licenses/LICENSE,sha256=wpM1B1Znw_YrC9L_R0jiXPHWz5iM_tNW4UOvBtl026s,1075
+fast_clean_architecture-1.1.2.dist-info/RECORD,,