runbooks 0.7.0__py3-none-any.whl → 0.7.6__py3-none-any.whl

runbooks-0.7.0.dist-info/METADATA

@@ -1,375 +0,0 @@
-Metadata-Version: 2.4
-Name: runbooks
-Version: 0.7.0
-Summary: CloudOps Automation Toolkit with Enhanced Cloud Foundations Assessment for DevOps and SRE teams.
-Author-email: Maintainers <nnthanh101@gmail.com>
-License-Expression: Apache-2.0
-Project-URL: Homepage, https://cloudops.oceansoft.io
-Project-URL: Repository, https://github.com/1xOps/CloudOps-Runbooks
-Project-URL: Documentation, https://cloudops.oceansoft.io/runbooks/
-Project-URL: Issues, https://github.com/1xOps/CloudOps-Runbooks/issues
-Project-URL: Changelog, https://github.com/1xOps/CloudOps-Runbooks/blob/main/CHANGELOG.md
-Keywords: runbooks,automation,DevOps,SRE,CloudOps,AWS,cloud-foundations,FinOps
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Environment :: Console
-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 :: System :: Systems Administration
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Utilities
-Requires-Python: <3.14,>=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: boto3>=1.35.40
-Requires-Dist: botocore>=1.35.40
-Requires-Dist: diagrams>=0.24.4
-Requires-Dist: click>=8.2.1
-Requires-Dist: pydantic>=2.10.0
-Requires-Dist: jinja2>=3.1.4
-Requires-Dist: werkzeug>=3.1.0
-Requires-Dist: markdown>=3.7.0
-Requires-Dist: prettytable>=3.16.0
-Requires-Dist: simplejson>=3.20.1
-Requires-Dist: python-dateutil>=2.9.0
-Requires-Dist: loguru>=0.7.3
-Requires-Dist: tqdm>=4.67.1
-Requires-Dist: rich>=14.0.0
-Requires-Dist: reportlab>=3.6.1
-Requires-Dist: requests>=2.32.0
-Requires-Dist: packaging>=21.0
-Requires-Dist: pyyaml>=6.0.2
-Requires-Dist: jmespath>=1.0.1
-Requires-Dist: urllib3<1.27,>=1.26.18
-Dynamic: license-file
-
-# 🚀 CloudOps Runbooks - Enterprise AWS Automation Toolkit
-
-[![PyPI Version](https://img.shields.io/pypi/v/runbooks)](https://pypi.org/project/runbooks/)
-[![Python Support](https://img.shields.io/pypi/pyversions/runbooks)](https://pypi.org/project/runbooks/)
-[![License](https://img.shields.io/pypi/l/runbooks)](https://opensource.org/licenses/Apache-2.0)
-[![Documentation](https://img.shields.io/badge/docs-latest-brightgreen)](https://cloudops.oceansoft.io/runbooks/)
-[![CI/CD](https://img.shields.io/github/actions/workflow/status/1xOps/CloudOps-Runbooks/ci.yml?branch=main)](https://github.com/1xOps/CloudOps-Runbooks/actions)
-[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
-[![Type Checked: mypy](https://img.shields.io/badge/type%20checked-mypy-blue.svg)](https://mypy-lang.org/)
-[![Tests: pytest](https://img.shields.io/badge/tests-pytest-green.svg)](https://pytest.org/)
-
-> **Enterprise-grade AWS automation toolkit for cloud operations (SRE and DevOps teams) at scale**
-
-CloudOps Runbooks provides comprehensive AWS resource discovery, inventory management, and automation capabilities with enterprise-grade architecture, type safety, and validation.
-
-
-## 🚀 Overview
-
-CloudOps Runbooks is a production-ready AWS automation framework that combines traditional scripting excellence with modern AI orchestration. Designed for enterprises managing complex multi-account AWS environments, it delivers comprehensive discovery, intelligent analysis, and automated remediation across 50+ AWS services.
-
-> Why CloudOps Runbooks?
-
-- **🎯 Proven in Production**: Deployed across enterprises managing 50+ AWS accounts
-- **🤖 AI-Ready Architecture**: Native integration with AI-Agents and MCP-servers
-- **⚡ Blazing Fast**: Parallel execution reducing discovery time by 60%
-- **🔒 Enterprise Security**: Zero-trust validation, compliance automation, and audit trails
-- **💰 Cost Intelligence**: Identifies 25-50% optimization opportunities automatically
-- **🏗️ AWS Landing Zone Native**: Purpose-built for Multi-Organizations Landing Zone
-
-## 🌟 Key Features
-
-### 🔍 **Comprehensive AWS Discovery**
-- **Multi-Account Inventory**: Seamless discover resources (EC2, RDS, Lambda, ECS, S3, IAM, and more) across entire AWS Organizations
-- **Cross-Region Support**: Parallel scanning of all available AWS regions  
-- **Resource Coverage**: 50+ AWS resource types across all major services
-- **Real-time Collection**: Concurrent collection with progress tracking
-
-### 🏗️ **Enterprise Architecture**
-- **Type Safety**: Full Pydantic V2 models with runtime validation
-- **Modular Design**: Service-specific collectors with common interfaces
-- **Extensibility**: Easy to add new collectors and resource types
-- **Error Handling**: Comprehensive error tracking and retry logic
-
-
-### Hybrid Intelligence Integration
-
-- **MCP Server Integration**: Real-time AWS API access without custom code
-- **AI Agent Orchestration**: AI-powered analysis and recommendations
-- **Evidence Pipeline**: Unified data normalization and correlation
-- **Intelligent Prioritization**: ML-based resource targeting
-
-### 💰 **Cost Integration**
-- **Cost Estimation**: Automatic cost calculations for billable resources
-- **Cost Analytics**: Cost breakdown by service, account, and region
-- **Budget Tracking**: Resource cost monitoring and alerting
-
-### 📊 **Multiple Output Formats**
-- **Structured Data**: JSON, CSV, Excel, Parquet
-- **Visual Reports**: HTML reports with charts and graphs
-- **Console Output**: Rich table formatting with colors
-- **API Integration**: REST API for programmatic access
-
-### 🔒 **Security & Compliance**
-- **IAM Integration**: Role-based access control
-- **Audit Logging**: Comprehensive operation logging
-- **Encryption**: Secure credential management
-- **Compliance Reports**: Security and compliance validation
-
-## 🚀 Quick Start Excellence: Progressive Examples
-
-### 📦 Installation
-
-```bash
-# Install using UV (recommended for speed and reliability)
-uv add runbooks
-
-# Or using pip
-pip install runbooks
-
-# Development installation
-git clone https://github.com/1xOps/CloudOps-Runbooks.git
-cd CloudOps-Runbooks
-uv sync --all-extras --dev
-```
-
-### 🔰 Level 1: Basic Single Account Discovery
-
-**Goal**: Discover EC2 instances in your current AWS account
-
-```bash
-# Set up your AWS credentials
-export AWS_PROFILE="your-aws-profile"
-aws sts get-caller-identity  # Verify access
-
-# Basic EC2 instance discovery
-cd CloudOps-Runbooks
-python src/runbooks/inventory/list_ec2_instances.py --profile $AWS_PROFILE --regions us-east-1 --timing
-
-# Example output:
-# Finding instances from 1 locations: 100%|██████████| 1/1 [00:02<00:00,  2.43 locations/s]
-# Found 12 instances across 1 account across 1 region
-# This script completed in 3.45 seconds
-```
-
-### 🏃 Level 2: Multi-Service Resource Discovery 
-
-**Goal**: Discover multiple AWS resource types efficiently
-
-```bash
-# EBS Volumes with orphan detection
-python src/runbooks/inventory/list_ec2_ebs_volumes.py --profile $AWS_PROFILE --regions ap-southeast-2 --timing
-
-# Lambda Functions with cost analysis
-python src/runbooks/inventory/list_lambda_functions.py --profile $AWS_PROFILE --regions ap-southeast-2
-
-# RDS Instances across multiple regions
-python src/runbooks/inventory/list_rds_db_instances.py --profile $AWS_PROFILE --regions us-east-1,eu-west-1,ap-southeast-2
-
-# Security Groups analysis
-python src/runbooks/inventory/find_ec2_security_groups.py --profile $AWS_PROFILE --regions us-east-1 --defaults
-```
-
-### 🏢 Level 3: Enterprise Multi-Account Operations
-
-**Goal**: Organization-wide resource discovery and compliance
-
-```bash
-# Comprehensive inventory across AWS Organizations
-python src/runbooks/inventory/list_org_accounts.py --profile $AWS_PROFILE
-
-# Multi-account CloudFormation stack discovery
-python src/runbooks/inventory/list_cfn_stacks.py --profile $AWS_PROFILE --regions ap-southeast-2 --timing
-
-# Organization-wide GuardDuty detector inventory
-python src/runbooks/inventory/list_guardduty_detectors.py --profile $AWS_PROFILE --regions ap-southeast-2
-
-# CloudTrail compliance validation
-python src/runbooks/inventory/check_cloudtrail_compliance.py --profile $AWS_PROFILE --regions ap-southeast-2 --timing
-```
-
-### 🚀 Level 4: Autonomous Testing Framework
-
-**Goal**: Automated testing and validation of entire inventory suite
-
-```bash
-# Test individual script
-./src/runbooks/inventory/inventory.sh list_ec2_instances.py --profile $AWS_PROFILE --regions ap-southeast-2 --timing
-
-# Test specific script category with detailed analysis
-./src/runbooks/inventory/inventory.sh list_ec2_ebs_volumes.py --profile $AWS_PROFILE --regions ap-southeast-2 --timing
-
-# Full autonomous test suite (20+ core scripts)
-./src/runbooks/inventory/inventory.sh all --profile $AWS_PROFILE --regions ap-southeast-2 --timing
-
-# Review test results and analysis
-ls test_logs_*/
-cat test_logs_*/test_execution.log
-```
-
-### 🔬 Level 5: Advanced Integration & Analysis
-
-**Goal**: Production-grade automation with comprehensive reporting
-
-```bash
-# 1. VPC Network Discovery with Subnet Analysis
-python src/runbooks/inventory/list_vpc_subnets.py --profile $AWS_PROFILE --regions ap-southeast-2 --timing
-python src/runbooks/inventory/list_vpcs.py --profile $AWS_PROFILE --regions ap-southeast-2
-
-# 2. Load Balancer Infrastructure Mapping
-python src/runbooks/inventory/list_elbs_load_balancers.py --profile $AWS_PROFILE --regions ap-southeast-2 --timing
-
-# 3. IAM Security Posture Assessment
-python src/runbooks/inventory/list_iam_roles.py --profile $AWS_PROFILE --timing
-python src/runbooks/inventory/list_iam_policies.py --profile $AWS_PROFILE --timing
-
-# 4. ECS Container Platform Discovery
-python src/runbooks/inventory/list_ecs_clusters_and_tasks.py --profile $AWS_PROFILE --regions ap-southeast-2 --timing
-
-# 5. Network Interface and ENI Analysis
-python src/runbooks/inventory/list_enis_network_interfaces.py --profile $AWS_PROFILE --regions ap-southeast-2 --timing
-```
-
-### 🎯 Level 6: Specialized Operations
-
-**Goal**: Advanced scenarios for specific use cases
-
-```bash
-# 1. Landing Zone Readiness Assessment
-python src/runbooks/inventory/check_landingzone_readiness.py --profile $AWS_PROFILE
-
-# 2. CloudFormation Drift Detection
-python src/runbooks/inventory/find_cfn_drift_detection.py --profile $AWS_PROFILE --regions ap-southeast-2
-
-# 3. Organizations Structure Analysis
-python src/runbooks/inventory/list_org_accounts_users.py --profile $AWS_PROFILE --timing
-
-# 4. Config Compliance Monitoring
-python src/runbooks/inventory/list_config_recorders_delivery_channels.py --profile $AWS_PROFILE --regions ap-southeast-2
-
-# 5. Route53 DNS Infrastructure
-python src/runbooks/inventory/list_route53_hosted_zones.py --profile $AWS_PROFILE --timing
-```
-
-### 📊 Integration Examples
-
-**Modern Architecture Integration:**
-
-```python
-# collectors/ and core/ directories provide modern modular architecture
-from runbooks.inventory.collectors.aws_compute import ComputeCollector
-from runbooks.inventory.core.collector import InventoryCollector
-from runbooks.inventory.core.formatter import OutputFormatter
-
-# Enterprise-grade type-safe collection
-collector = InventoryCollector(profile='production')
-results = collector.collect_compute_resources(include_costs=True)
-formatter = OutputFormatter()
-report = formatter.generate_html_report(results)
-```
-
-### 📈 Performance & Success Metrics
-
-**Test Suite Results (Latest):**
-- ✅ **20/43 core scripts passing** (47% success rate)
-- ⚡ **Average execution time**: 8-12 seconds per script
-- 🔧 **Known issues**: 4 scripts with permissions issues, 19 with parameter dependencies
-- 📋 **Excluded scripts**: 20 utility/support modules (correct exclusion)
-- 🏗️ **Architecture**: Modern modular design with collectors/ and core/ directories
-
-## 📋 Architecture Overview
-
-### 🏗️ **Module Structure**
-
-```
-src/runbooks/inventory/
-├── 🧠 core/                    # Business Logic
-│   ├── collector.py           # Main orchestration engine
-│   ├── formatter.py           # Multi-format output handling  
-│   └── session_manager.py     # AWS session management
-├── 🔧 collectors/              # Resource Specialists
-│   ├── base.py               # Abstract base collector
-│   ├── aws_compute.py        # EC2, Lambda, ECS, Batch
-│   ├── aws_storage.py        # S3, EBS, EFS, FSx
-│   ├── aws_database.py       # RDS, DynamoDB, ElastiCache
-│   ├── aws_network.py        # VPC, ELB, Route53, CloudFront
-│   ├── aws_security.py       # IAM, GuardDuty, Config, WAF
-│   └── aws_management.py     # CloudFormation, Organizations
-├── 📊 models/                  # Data Structures  
-│   ├── account.py            # AWS account representation
-│   ├── resource.py           # Resource models with metadata
-│   └── inventory.py          # Collection results and analytics
-├── 🛠️ utils/                   # Shared Utilities
-│   ├── aws_helpers.py        # AWS session and API utilities
-│   ├── threading_utils.py    # Concurrent execution helpers
-│   └── validation.py         # Input validation and sanitization
-└── 📜 legacy/                  # Migration Support
-    └── migration_guide.md    # Legacy script migration guide
-```
-
-## 🧪 Testing & Development
-
-### Running Tests
-
-```bash
-# Run full test suite
-task test
-
-# Run specific test categories
-pytest tests/unit/test_inventory.py -v
-pytest tests/integration/test_collectors.py -v
-
-# Test with coverage
-task _test.coverage
-
-# Test inventory module specifically
-task inventory.test
-```
-
-### Development Workflow
-
-```bash
-# Install development dependencies
-task install
-
-# Code quality checks
-task code_quality
-
-# Validate module structure
-task inventory.validate
-
-# Full validation workflow
-task validate
-```
-
-## 📚 Documentation
-
-- [API Reference](docs/api-reference.md)
-- [Configuration Guide](docs/configuration.md)
-- [Migration Guide](src/runbooks/inventory/legacy/migration_guide.md)
-- [Contributing Guide](CONTRIBUTING.md)
-
-
-## 🚦 Roadmap
-
-- **v1.0** (Q4 2025): Enhanced AI agent orchestration
-- **v1.5** (Q1 2026): Self-healing infrastructure capabilities
-
-## 📝 License
-
-This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.
-
-## 🆘 Support
-
-### Community
-- [GitHub Issues](https://github.com/1xOps/CloudOps-Runbooks/issues)
-- [Discussions](https://github.com/1xOps/CloudOps-Runbooks/discussions)
-
-### Enterprise Support
-- Professional services and training available
-- Custom collector development
-- Enterprise deployment assistance
-- Contact: [info@oceansoft.io](mailto:info@oceansoft.io)
-
----
-
-**Built with ❤️ by the xOps team at OceanSoft**
-
-[Website](https://cloudops.oceansoft.io) • [Documentation](https://cloudops.oceansoft.io/runbooks/) • [GitHub](https://github.com/1xOps/CloudOps-Runbooks)