ic-code 1.1.0__tar.gz → 1.1.6__tar.gz

{ic_code-1.1.0 → ic_code-1.1.6}/MANIFEST.in

@@ -16,19 +16,13 @@ recursive-include docs *.md *.rst *.txt
 # Include scripts and tools
 recursive-include scripts *.py *.sh *.bat
 
-# Include source code
-recursive-include src *.py
-recursive-include src/ic/config *.yaml *.yml *.json
+# Include source code (already covered above)
 
-# Include service modules
-recursive-include aws *.py
-recursive-include azure_module *.py
-recursive-include gcp *.py
-recursive-include oci_module *.py
-recursive-include ssh *.py
-recursive-include cf *.py
-recursive-include common *.py
-recursive-include mcp *.py
+# Include all source modules and data files
+recursive-include src *.py *.yaml *.yml *.json *.md *.txt
+recursive-include src/ic/platforms *.py *.yaml *.yml *.json *.md *.txt
+recursive-include src/common *.py *.yaml *.yml *.json
+recursive-include src/mcp *.py *.yaml *.yml *.json
 
 # Include new configuration system files
 include requirements-updated.txt

{ic_code-1.1.0/src/ic_code.egg-info → ic_code-1.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ic-code
-Version: 1.1.0
+Version: 1.1.6
 Summary: Infrastructure CLI tool for managing AWS, Azure, GCP, OCI, NCP, CloudFlare, SSH, and more
 Home-page: https://github.com/dgr009/ic
 Author: SangYun Kim
@@ -20,11 +20,12 @@ 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: Programming Language :: Python :: 3.13
 Classifier: Topic :: System :: Systems Administration
 Classifier: Topic :: Utilities
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Environment :: Console
-Requires-Python: >=3.9,<3.13
+Requires-Python: >=3.9,<3.15
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: boto3<2.0.0,>=1.26.0
@@ -45,6 +46,7 @@ Requires-Dist: setuptools<71.0,>=61.0
 Requires-Dist: watchdog<4.0.0,>=3.0.0
 Requires-Dist: cerberus<2.0.0,>=1.3.4
 Requires-Dist: pydantic<3.0.0,>=2.0.0
+Requires-Dist: InquirerPy<1.0.0,>=0.3.4
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
@@ -128,8 +130,8 @@ ic ncp --help      # Verify NCP support
 ic ncpgov --help   # Verify NCP Government Cloud support
 
 # Test NCP dependencies
-python -c "from ncp_module.client import NCPClient; print('NCP support: OK')"
-python -c "from ncpgov_module.client import NCPGovClient; print('NCP Gov support: OK')"
+python -c "from src.ic.platforms.ncp.client import NCPClient; print('NCP support: OK')"
+python -c "from src.ic.platforms.ncpgov.client import NCPGovClient; print('NCP Gov support: OK')"
 ```
 
 ### From Source (Development)
@@ -1618,16 +1620,15 @@ ic/
 │   ├── config/            # Configuration management system
 │   ├── core/              # Core utilities and logging
 │   └── commands/          # Command implementations
-├── aws/                   # AWS service modules
-├── oci_module/            # Oracle Cloud Infrastructure modules
-├── ncp_module/            # NCP (Naver Cloud Platform) modules
-├── ncpgov_module/         # NCP Government Cloud modules
-├── ncp/                   # NCP legacy modules (compatibility)
-├── ncpgov/                # NCP Gov legacy modules (compatibility)
-├── cf/                    # CloudFlare modules
-├── ssh/                   # SSH management modules
-├── azure_module/          # Azure modules (development)
-├── gcp/                   # Google Cloud Platform modules (development)
+├── platforms/             # Cloud platform modules
+│   ├── aws/              # Amazon Web Services
+│   ├── azure/            # Microsoft Azure
+│   ├── cf/               # CloudFlare
+│   ├── gcp/              # Google Cloud Platform
+│   ├── ncp/              # Naver Cloud Platform
+│   ├── ncpgov/           # NCP Government Cloud
+│   ├── oci/              # Oracle Cloud Infrastructure
+│   └── ssh/              # SSH management
 ├── common/                # Shared utilities and progress decorators
 ├── tests/                 # Test suite
 │   ├── unit/             # Unit tests

{ic_code-1.1.0 → ic_code-1.1.6}/README.md

@@ -70,8 +70,8 @@ ic ncp --help      # Verify NCP support
 ic ncpgov --help   # Verify NCP Government Cloud support
 
 # Test NCP dependencies
-python -c "from ncp_module.client import NCPClient; print('NCP support: OK')"
-python -c "from ncpgov_module.client import NCPGovClient; print('NCP Gov support: OK')"
+python -c "from src.ic.platforms.ncp.client import NCPClient; print('NCP support: OK')"
+python -c "from src.ic.platforms.ncpgov.client import NCPGovClient; print('NCP Gov support: OK')"
 ```
 
 ### From Source (Development)
@@ -1560,16 +1560,15 @@ ic/
 │   ├── config/            # Configuration management system
 │   ├── core/              # Core utilities and logging
 │   └── commands/          # Command implementations
-├── aws/                   # AWS service modules
-├── oci_module/            # Oracle Cloud Infrastructure modules
-├── ncp_module/            # NCP (Naver Cloud Platform) modules
-├── ncpgov_module/         # NCP Government Cloud modules
-├── ncp/                   # NCP legacy modules (compatibility)
-├── ncpgov/                # NCP Gov legacy modules (compatibility)
-├── cf/                    # CloudFlare modules
-├── ssh/                   # SSH management modules
-├── azure_module/          # Azure modules (development)
-├── gcp/                   # Google Cloud Platform modules (development)
+├── platforms/             # Cloud platform modules
+│   ├── aws/              # Amazon Web Services
+│   ├── azure/            # Microsoft Azure
+│   ├── cf/               # CloudFlare
+│   ├── gcp/              # Google Cloud Platform
+│   ├── ncp/              # Naver Cloud Platform
+│   ├── ncpgov/           # NCP Government Cloud
+│   ├── oci/              # Oracle Cloud Infrastructure
+│   └── ssh/              # SSH management
 ├── common/                # Shared utilities and progress decorators
 ├── tests/                 # Test suite
 │   ├── unit/             # Unit tests

{ic_code-1.1.0 → ic_code-1.1.6}/docs/README.md

@@ -61,6 +61,9 @@ This directory contains comprehensive documentation for the IC (Infrastructure R
 ## Development
 
 - [Development Documentation](development/) - For contributors
+  - [Development Guide](development/development_guide.md) - Complete development setup and patterns
+  - [Import Patterns Guide](development/import_patterns.md) - Essential import patterns and best practices
+  - [Migration Guide](development/migration_guide.md) - Migration procedures and troubleshooting
 
 ## Documentation Templates
 

ic_code-1.1.6/docs/development/README.md

@@ -0,0 +1,241 @@
+# IC CLI Development Documentation
+
+## Overview
+
+This directory contains comprehensive development documentation for the IC CLI tool. Whether you're a new contributor or an experienced developer, these guides will help you understand the project structure, development patterns, and best practices.
+
+## Quick Start
+
+1. **[Development Guide](development_guide.md)** - Complete development setup and patterns
+2. **[Import Patterns](import_patterns.md)** - Essential import patterns and best practices
+3. **[Migration Guide](migration_guide.md)** - Migration procedures and troubleshooting
+
+## Documentation Index
+
+### Core Development Guides
+
+- **[Development Guide](development_guide.md)** - Comprehensive development guide including:
+  - Environment setup and configuration
+  - Project architecture and patterns
+  - Code quality standards and testing
+  - Security guidelines and performance tips
+  - Contributing guidelines and PR process
+
+- **[Import Patterns Guide](import_patterns.md)** - Essential guide for import patterns:
+  - Standard import patterns for the new structure
+  - Fallback patterns for package compatibility
+  - Platform module standards and interfaces
+  - Migration examples and troubleshooting
+  - Testing import patterns
+
+- **[Migration Guide](migration_guide.md)** - Migration procedures and history:
+  - Recent platform consolidation migration
+  - Automated migration tools and scripts
+  - Future migration guidelines and best practices
+  - Common issues and rollback procedures
+  - Version compatibility information
+
+### Specialized Topics
+
+- **[Dependency Management](.local-docs/development/dependency_management.md)** - Managing project dependencies
+- **[Output Formatting System](.local-docs/development/output_formatting_system.md)** - Rich terminal output patterns
+- **[PyPI Deployment](.local-docs/development/pypi_deployment.md)** - Package deployment procedures
+
+### Testing Documentation
+
+- **[Testing Guide](../tests/README.md)** - Comprehensive testing information
+- **[Testing Summary](../tests/TESTING_SUMMARY.md)** - Current testing status and coverage
+
+## Development Workflow
+
+### 1. Initial Setup
+
+```bash
+# Clone and setup development environment
+git clone <repository-url>
+cd ic-cli
+python -m venv ic-env
+source ic-env/bin/activate
+pip install -r requirements.txt
+pip install -e .
+```
+
+### 2. Development Patterns
+
+Follow the patterns outlined in the [Development Guide](development_guide.md):
+
+- Use the standardized import patterns from [Import Patterns Guide](import_patterns.md)
+- Implement required service module interfaces
+- Include proper error handling and progress indicators
+- Add comprehensive tests for new functionality
+
+### 3. Code Quality
+
+```bash
+# Format and lint code
+black src/ tests/
+flake8 src/ tests/
+mypy src/
+
+# Run security scanning
+bandit -r src/
+
+# Run comprehensive tests
+make test-all
+python tests/run_comprehensive_validation.py
+```
+
+### 4. Contributing
+
+1. Create feature branch from main
+2. Follow development patterns and guidelines
+3. Add tests and update documentation
+4. Submit pull request with clear description
+
+## Architecture Overview
+
+### Project Structure
+
+```
+src/ic/
+├── cli.py                    # Main CLI entry point
+├── config/                   # Configuration management
+├── core/                     # Core functionality
+├── platforms/               # Platform modules (AWS, Azure, GCP, etc.)
+└── security/                # Security utilities
+
+src/common/                   # Common utilities
+tests/                        # Test suite
+docs/                         # Documentation
+```
+
+### Key Principles
+
+1. **Consistent Import Patterns**: All modules use standardized import patterns with fallbacks
+2. **Service Module Interface**: All services implement `add_arguments()` and `main()` functions
+3. **Security First**: Credential protection, input validation, and audit logging
+4. **Rich User Experience**: Progress indicators, formatted output, and helpful error messages
+5. **Comprehensive Testing**: Unit, integration, and performance tests
+
+## Common Development Tasks
+
+### Adding a New Platform
+
+1. Create platform directory: `src/ic/platforms/{platform}/`
+2. Implement platform client and services following the standard pattern
+3. Add comprehensive tests in `tests/platforms/{platform}/`
+4. Update CLI discovery and documentation
+
+### Adding a New Service
+
+1. Create service module: `src/ic/platforms/{platform}/{service}/info.py`
+2. Implement required interface: `add_arguments()` and `main()`
+3. Add unit and integration tests
+4. Update platform documentation
+
+### Updating Import Patterns
+
+1. Follow patterns from [Import Patterns Guide](import_patterns.md)
+2. Use try/except blocks for fallback imports
+3. Test in both development and installed environments
+4. Update related tests and documentation
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Import Errors**: Check [Import Patterns Guide](import_patterns.md) for correct patterns
+2. **CLI Commands Not Found**: Verify platform discovery is working
+3. **Test Failures**: Ensure PYTHONPATH includes src directory
+4. **Package Installation Issues**: Check pyproject.toml configuration
+
+### Debug Tools
+
+```python
+# Debug import issues
+from src.ic.core.platform_discovery import debug_platform_discovery
+debug_platform_discovery()
+
+# Enable debug logging
+import logging
+logging.basicConfig(level=logging.DEBUG)
+```
+
+### Getting Help
+
+1. Check existing documentation and guides
+2. Review test cases for examples
+3. Check project issues and discussions
+4. Contact the development team
+
+## Resources
+
+### Internal Documentation
+- [Project History](.local-docs/history/) - Detailed project history and changes
+- [Security Documentation](.local-docs/security/) - Security reports and guidelines
+- [Validation Reports](.local-docs/validation/) - Validation and testing reports
+
+### External Resources
+- [Python Packaging Guide](https://packaging.python.org/) - Python packaging best practices
+- [Click Documentation](https://click.palletsprojects.com/) - CLI framework documentation
+- [Rich Documentation](https://rich.readthedocs.io/) - Terminal formatting library
+
+---
+
+**Last Updated**: 2024  
+**Maintainer**: IC CLI Development Team
+
+## Quick Reference
+
+### Essential Commands
+
+```bash
+# Development setup
+python -m venv ic-env && source ic-env/bin/activate
+pip install -r requirements.txt && pip install -e .
+
+# Testing
+make test-all
+python tests/run_comprehensive_validation.py
+
+# Code quality
+black src/ tests/ && flake8 src/ tests/ && mypy src/
+
+# Package building
+python setup.py sdist bdist_wheel
+
+# CLI testing
+ic --help
+ic config init
+ic aws ec2 info --help
+```
+
+### Import Template
+
+```python
+# Standard import pattern with fallback
+try:
+    from src.ic.platforms.{platform}.{service} import info
+    from src.ic.config.manager import ConfigManager
+    from src.common.progress_decorator import progress_decorator
+except ImportError:
+    from ic.platforms.{platform}.{service} import info
+    from ic.config.manager import ConfigManager
+    from common.progress_decorator import progress_decorator
+```
+
+### Service Module Template
+
+```python
+def add_arguments(parser):
+    """Add service-specific arguments."""
+    parser.add_argument('--region', help='Specify region')
+
+def main(args, config=None):
+    """Execute service command."""
+    try:
+        # Service implementation
+        return {"success": True, "data": result}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+```

ic_code-1.1.6/docs/development/cleanup_summary.md

@@ -0,0 +1,125 @@
+# Import Migration Cleanup Summary
+
+## Overview
+
+This document summarizes the cleanup work performed after the major import migration from root-level platform directories to the consolidated `src/ic/platforms/` structure.
+
+## Cleanup Actions Performed
+
+### 1. Dead Code Removal
+
+- **Removed `fix_import_syntax.py`**: This script was used during the migration to automatically fix import statements but is no longer needed
+- **Verified no legacy import patterns remain**: Searched for and confirmed removal of all references to old module names (`oci_module`, `azure_module`, etc.)
+
+### 2. Documentation Updates
+
+- **Updated README.md**: Fixed project structure diagram to reflect new consolidated platform structure
+- **Updated import examples**: Fixed code examples in README to use new import patterns
+- **Created comprehensive development documentation**:
+  - [Import Patterns Guide](import_patterns.md) - Detailed import patterns and best practices
+  - [Development Guide](development_guide.md) - Complete development setup and patterns
+  - [Migration Guide](migration_guide.md) - Migration procedures and troubleshooting
+
+### 3. Code Examples Updates
+
+- **Updated user guide**: Fixed programming API examples to use new import patterns with fallbacks
+- **Updated example scripts**: Fixed import patterns in `examples/mcp_manager_example.py` and `examples/security_validation_demo.py`
+
+### 4. Module Structure Improvements
+
+- **Enhanced `src/ic/platforms/__init__.py`**: Added comprehensive documentation about available platforms and structure
+- **Improved service-level `__init__.py` files**: Added proper documentation and exports where needed
+- **Verified all required `__init__.py` files exist**: Confirmed proper module structure throughout the project
+
+### 5. Configuration and Reference Updates
+
+- **Updated README.md project structure**: Fixed directory tree to show new consolidated structure
+- **Updated test import examples**: Fixed import patterns in README test examples
+- **Verified no configuration files reference old structure**: Checked YAML and JSON files for legacy references
+
+## Verification Steps Performed
+
+### 1. Import Pattern Verification
+
+- ✅ Searched for legacy import patterns: `from (aws|oci_module|azure_module|ncp|ncpgov|gcp|cf|ssh).`
+- ✅ Searched for old module references: `(oci_module|azure_module|ncp_module|ncpgov_module)`
+- ✅ Verified no hardcoded legacy imports remain
+- ✅ Confirmed all imports use proper fallback patterns
+
+### 2. Dead Code Detection
+
+- ✅ Searched for commented out import statements
+- ✅ Searched for unused variables related to old import system
+- ✅ Searched for deprecated function markers
+- ✅ Verified no backup or temporary files remain
+
+### 3. Documentation Consistency
+
+- ✅ Updated all code examples to use new import patterns
+- ✅ Fixed project structure references in documentation
+- ✅ Verified no documentation references old module names
+- ✅ Created comprehensive migration and development guides
+
+### 4. Module Structure Validation
+
+- ✅ Verified all required `__init__.py` files exist
+- ✅ Enhanced minimal `__init__.py` files with proper documentation
+- ✅ Confirmed consistent module structure across platforms
+- ✅ Validated import resolution works correctly
+
+## Files Modified During Cleanup
+
+### Documentation Files
+- `docs/development/import_patterns.md` - **Created**: Comprehensive import patterns guide
+- `docs/development/development_guide.md` - **Created**: Complete development guide
+- `docs/development/migration_guide.md` - **Created**: Migration procedures and history
+- `docs/development/README.md` - **Created**: Development documentation index
+- `docs/README.md` - **Updated**: Added references to new development documentation
+- `docs/user_guide.md` - **Updated**: Fixed programming API examples
+- `README.md` - **Updated**: Fixed project structure and test examples
+
+### Code Files
+- `fix_import_syntax.py` - **Removed**: No longer needed migration script
+- `src/ic/platforms/__init__.py` - **Enhanced**: Added comprehensive documentation
+- `src/ic/platforms/ncp/ec2/__init__.py` - **Enhanced**: Added proper documentation and exports
+- `examples/mcp_manager_example.py` - **Updated**: Fixed import patterns
+- `examples/security_validation_demo.py` - **Updated**: Fixed import patterns
+
+### Summary File
+- `docs/development/cleanup_summary.md` - **Created**: This summary document
+
+## Current State
+
+### ✅ Completed
+- All legacy import patterns removed
+- All dead code eliminated
+- Documentation updated and enhanced
+- Code examples fixed
+- Module structure improved
+- Comprehensive development guides created
+
+### ✅ Verified
+- No unused imports or dead code remain
+- All import patterns use proper fallback mechanisms
+- Documentation is consistent with new structure
+- All required module files exist and are properly documented
+
+## Best Practices Established
+
+1. **Import Patterns**: All imports use try/except fallback pattern for development/package compatibility
+2. **Documentation**: Comprehensive guides for development, imports, and migration
+3. **Module Structure**: Consistent `__init__.py` files with proper documentation and exports
+4. **Code Examples**: All examples demonstrate proper import patterns
+5. **Migration Process**: Documented procedures for future structural changes
+
+## Future Maintenance
+
+- **Regular Cleanup**: Periodically check for unused imports and dead code
+- **Documentation Updates**: Keep development guides updated with any structural changes
+- **Import Pattern Consistency**: Ensure new code follows established import patterns
+- **Migration Documentation**: Update migration guide for any future structural changes
+
+---
+
+**Cleanup Completed**: 2024  
+**Performed By**: IC CLI Development Team