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

{fast_clean_architecture-1.0.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.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.1.2.dist-info/RECORD

@@ -0,0 +1,38 @@
+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=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
+fast_clean_architecture/health.py,sha256=yvvGAOW_VXiuX7J4Od-IN7yazSA9fw8ugvfyb-hKzeU,5294
+fast_clean_architecture/logging_config.py,sha256=6I82AWCFGMdP5KFeDiL_wtXk2RLMcDL0_-u9Ka8TW4M,1580
+fast_clean_architecture/metrics.py,sha256=-7ln9E8UTSTBXWr7QhPRwpkGl_H1gKjmOMq79m6ASa0,3219
+fast_clean_architecture/protocols.py,sha256=45IQhACDJj8KvlHLAETlSpf_F5BTkivl52MgUJwizhs,12547
+fast_clean_architecture/utils.py,sha256=TbD7evQsKf_2KAr4RJ8iVhnpgBLA1FY6VaRd0CJSwEU,18837
+fast_clean_architecture/validation.py,sha256=Iu9KyaBZX1VznM_bMb_4Jvu8o4XtAQoUxaWcA1UhNkI,10873
+fast_clean_architecture/generators/__init__.py,sha256=bpq_b3lMiOBcn8bJhC3UCVLsSxIj9bGaSteGgN-Lgkc,560
+fast_clean_architecture/generators/component_generator.py,sha256=xlYnqeK55Y5pjYOuz4OaRenQkng0hYe6Kx1MICr9lSs,50128
+fast_clean_architecture/generators/config_updater.py,sha256=faSjwPX_sFWl8-qq4rl0HfOMUoZNKA1HwX3uP0BVCT4,16711
+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=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
+fast_clean_architecture/templates/api.py.j2,sha256=jPt1i84GuGEyeftJ8IythTrcTzac1GGyd4lQedl7_FA,2362
+fast_clean_architecture/templates/command.py.j2,sha256=jjmteEF-UqXdlhM487SSUHzeaz2l8vHq6BzOykw0gJM,612
+fast_clean_architecture/templates/entity.py.j2,sha256=5AIP6LwuusVNHiiAhph0bpFfnVzPhfnBdDMwZi_gx_s,1458
+fast_clean_architecture/templates/external.py.j2,sha256=dXqm9Y_EsoFXErF0ukdAzOwQbZy667gjQtU7ZD5iWnw,5418
+fast_clean_architecture/templates/infrastructure_repository.py.j2,sha256=nxKe7zpSRnpZkqpBrlhOkKLu2vERAiFhrt9iWU3K6aU,2543
+fast_clean_architecture/templates/model.py.j2,sha256=f3toWIDu5nX5wkHKPbk0-XXow3RLP7D5VknhLPNwSHo,1113
+fast_clean_architecture/templates/query.py.j2,sha256=7AwqC8BpzGq6L4T-g3Wo8Xj_SPOK0L1ke1RkJ4DQsVU,594
+fast_clean_architecture/templates/repository.py.j2,sha256=YsjPpVakZR2A-JmsK-VYE6bYDhmeRBfNtID9SdhsGj8,1694
+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.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,,

fast_clean_architecture-1.0.0.dist-info/RECORD

@@ -1,30 +0,0 @@
-fast_clean_architecture/__init__.py,sha256=1B-oli8nUGzjXVe62dN_uAV6fTQlt_wNZmlbzLZs1C8,524
-fast_clean_architecture/cli.py,sha256=bug84CZx87zlAw7eCRGMs6-wVtFDER9snAvWPv-GxEs,15447
-fast_clean_architecture/config.py,sha256=W-H4r3sPHbx4CSp8_wC3VylnRRYngzw2OosC2__V0RE,18742
-fast_clean_architecture/exceptions.py,sha256=cFgIcHGlY7EqIeQvt95_D57AWZxCJja9XVt_MQo4gFE,1667
-fast_clean_architecture/utils.py,sha256=rrdiYUyj-xQ24nCaK5fspFvHIsjpspJAhxc64jzWgrk,18295
-fast_clean_architecture/generators/__init__.py,sha256=xgd1_9vo1DZ5DgKZainvK-rqoRVKz8Nvo7X34uDOdIs,280
-fast_clean_architecture/generators/component_generator.py,sha256=zPBkkTq0gTRPQGeaatCmqTeJt5QLmgN2k3kNZwzXfao,39089
-fast_clean_architecture/generators/config_updater.py,sha256=5SNeOszx_9urd8_NBM3aDDqw_Pu4cyWW9gLE_IMwo3c,10518
-fast_clean_architecture/generators/package_generator.py,sha256=pMi-SNMe2mUuwmE7YrJnfJNJrYmMk6jgTp7hJV_bozE,5896
-fast_clean_architecture/generators/template_validator.py,sha256=xOBRxvCLaR6cE0q3CgVdMjN5pHud8tJEWIOEMh4kRBA,20399
-fast_clean_architecture/generators/validation_config.py,sha256=OU46Ye2ik9AH51009faWIoe-GPzg-b8A4D2JaoFZSDY,2313
-fast_clean_architecture/generators/validation_metrics.py,sha256=owUYjqbDIttg4ZLXKvUkjqRQqxsrYe2f009oTrzbXXU,6493
-fast_clean_architecture/templates/__init__.py,sha256=uweRUmrNZosbwDlnM10Nfu9rKzPcEqXEr6BchsSAr58,146
-fast_clean_architecture/templates/__init__.py.j2,sha256=ogycgpBmYv-O1yoyQK9-Ki_x4FlYgb58mvhPrhiQNpA,618
-fast_clean_architecture/templates/api.py.j2,sha256=jPt1i84GuGEyeftJ8IythTrcTzac1GGyd4lQedl7_FA,2362
-fast_clean_architecture/templates/command.py.j2,sha256=jjmteEF-UqXdlhM487SSUHzeaz2l8vHq6BzOykw0gJM,612
-fast_clean_architecture/templates/entity.py.j2,sha256=5AIP6LwuusVNHiiAhph0bpFfnVzPhfnBdDMwZi_gx_s,1458
-fast_clean_architecture/templates/external.py.j2,sha256=SbZ8GEp9Q02bQTI59k0wDE5lDWVJWa7wI6VOBpsoAd4,1844
-fast_clean_architecture/templates/infrastructure_repository.py.j2,sha256=nxKe7zpSRnpZkqpBrlhOkKLu2vERAiFhrt9iWU3K6aU,2543
-fast_clean_architecture/templates/model.py.j2,sha256=f3toWIDu5nX5wkHKPbk0-XXow3RLP7D5VknhLPNwSHo,1113
-fast_clean_architecture/templates/query.py.j2,sha256=7AwqC8BpzGq6L4T-g3Wo8Xj_SPOK0L1ke1RkJ4DQsVU,594
-fast_clean_architecture/templates/repository.py.j2,sha256=YsjPpVakZR2A-JmsK-VYE6bYDhmeRBfNtID9SdhsGj8,1694
-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.0.0.dist-info/METADATA,sha256=UAswG12fAvPtXkdOGttTx-o3Dh10jIUAtdx9jYoHFeg,16765
-fast_clean_architecture-1.0.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-fast_clean_architecture-1.0.0.dist-info/entry_points.txt,sha256=5R_7kBX0dYEq6n8lyTmv7Sn4Rs3pjpLqGX-mB_3FL1w,65
-fast_clean_architecture-1.0.0.dist-info/licenses/LICENSE,sha256=wpM1B1Znw_YrC9L_R0jiXPHWz5iM_tNW4UOvBtl026s,1075
-fast_clean_architecture-1.0.0.dist-info/RECORD,,