ecreshore 1.0.1__tar.gz

ecreshore-1.0.1/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.4
+Name: ecreshore
+Version: 1.0.1
+Summary: cli utility for copying container images to private ECR
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: aiodocker==0.24.0
+Requires-Dist: boto3==1.40.25
+Requires-Dist: click==8.2.1
+Requires-Dist: docker==7.1.0
+Requires-Dist: kubernetes==33.1.0
+Requires-Dist: pytest-asyncio>=1.1.0
+Requires-Dist: pytest-cov>=7.0.0
+Requires-Dist: radon>=6.0.1
+Requires-Dist: rich==14.1.0
+Requires-Dist: structlog==25.4.0
+Requires-Dist: tenacity==9.1.2
+Requires-Dist: yaml-for-humans==1.1.1
+
+# ECReshore - Container Image Migration Tool
+
+ECReshore is a CLI tool for copying container images to AWS ECR registries with intelligent multi-architecture support and batch processing capabilities.
+
+## Core Commands
+
+### `copy` - Copy Single Images
+
+Copy container images to ECR with automatic multi-architecture detection.
+
+**Basic Usage:**
+```bash
+# Copy with automatic repository inference
+ecreshore copy nginx:latest
+
+# Copy with custom target repository
+ecreshore copy nginx:latest my-nginx-repo
+
+# Copy with specific platforms
+ecreshore copy nginx:latest --platforms linux/amd64,linux/arm64
+
+# Copy all architectures
+ecreshore copy nginx:latest -A
+```
+
+**Key Features:**
+- **Smart repository inference** - Automatically determines target repository name
+- **Multi-architecture support** - Preserves all platforms when Docker Buildx available
+- **Skip-if-present** - Automatically skips if target image already exists with matching content
+- **Force override** - Use `--force` to transfer even if target exists
+
+### `scan` - Kubernetes Cluster Scanning
+
+Scan Kubernetes clusters to identify non-ECR container images.
+
+**Basic Usage:**
+```bash
+# Scan current cluster and generate batch config
+ecreshore scan --export batch-config.yaml
+
+# Scan specific namespace
+ecreshore scan -n production
+
+# Scan all namespaces
+ecreshore scan -A
+
+# Generate report format
+ecreshore scan --output report
+```
+
+**Key Features:**
+- **Workload discovery** - Scans Deployments, DaemonSets, StatefulSets, Jobs, CronJobs, Pods
+- **ECR filtering** - Only identifies non-ECR images that need migration
+- **Batch config generation** - Creates ready-to-use configuration files
+- **Namespace targeting** - Include/exclude specific namespaces
+
+### `batch` - Batch Processing
+
+Execute multiple image transfers from YAML configuration files.
+
+**Basic Usage:**
+```bash
+# Execute batch transfers
+ecreshore batch config.yaml
+
+# Preview without executing
+ecreshore batch config.yaml --dry-run
+
+# Force rich UI display
+ecreshore batch config.yaml --rich
+
+# Output structured logs
+ecreshore batch config.yaml --output log
+```
+
+**Configuration Format:**
+```yaml
+settings:
+  concurrent_transfers: 3    # Parallel transfers
+  retry_attempts: 3          # Retry attempts per transfer
+  verify_digests: true       # Verify image integrity
+  region: us-east-2         # AWS region
+
+transfers:
+  - source: nginx:latest
+    target: my-nginx
+    source_tag: latest
+    target_tag: latest
+```
+
+**Key Features:**
+- **Concurrent processing** - Configurable parallel transfers (default: 3)
+- **Progress tracking** - Rich UI with real-time transfer status
+- **Error handling** - Automatic retries with configurable attempts
+- **Skip detection** - Automatically skips existing images with matching content
+
+### `purge` - Repository Cleanup
+
+Remove images from ECR repositories with safety controls.
+
+**Basic Usage:**
+```bash
+# Preview deletion for specific repository
+ecreshore purge my-repo --dry-run
+
+# Purge repository, keeping latest image
+ecreshore purge my-repo --keep-latest
+
+# Preview deletion for all repositories
+ecreshore purge -A --dry-run
+
+# Purge with pattern matching
+ecreshore purge -A --filter my-app-* --keep-latest
+```
+
+**Key Features:**
+- **Safety first** - Always use `--dry-run` to preview deletions
+- **Selective deletion** - Target specific repositories or use patterns
+- **Latest preservation** - `--keep-latest` protects most recent images
+- **Bulk operations** - Process all repositories with filtering options
+
+## Common Workflow
+
+1. **Discovery**: Scan your cluster to identify images needing migration
+   ```bash
+   ecreshore scan --export migration-plan.yaml
+   ```
+
+2. **Preview**: Review the generated configuration and preview the batch operation
+   ```bash
+   ecreshore batch migration-plan.yaml --dry-run
+   ```
+
+3. **Execute**: Run the batch migration
+   ```bash
+   ecreshore batch migration-plan.yaml
+   ```
+
+4. **Cleanup**: Optionally purge old/unused images
+   ```bash
+   ecreshore purge old-repo --dry-run
+   ecreshore purge old-repo --keep-latest
+   ```
+
+## Global Options
+
+- **`-v, --verbose`** - Increase verbosity (`-v` for INFO, `-vv` for DEBUG)
+- **`--region`** - AWS region (respects `AWS_DEFAULT_REGION`, `AWS_REGION`, `~/.aws/config`)
+- **`--registry-id`** - AWS account ID for ECR registry
+- **`--simple/--rich`** - Force specific UI modes (auto-detected by default)
+
+## UI Modes
+
+ECReshore automatically detects your terminal capabilities and chooses the best display mode:
+
+- **Rich UI** - Full-featured progress bars, colors, and real-time updates
+- **Simple UI** - Text-based progress suitable for basic terminals
+- **Log output** - Structured JSON logs for automation and monitoring
+
+Use `ecreshore terminal-info` to see your terminal's detected capabilities.
+
+## Authentication
+
+ECReshore uses your existing AWS credentials. Ensure you have:
+- AWS CLI configured (`aws configure`)
+- Appropriate ECR permissions (`ecr:*` or specific ECR actions)
+- Docker daemon running for image operations
+
+Test authentication with:
+```bash
+ecreshore auth-test
+```
+
+---
+
+For additional commands and advanced options, run `ecreshore --help` or `ecreshore COMMAND --help`.

ecreshore-1.0.1/README.md

@@ -0,0 +1,176 @@
+# ECReshore - Container Image Migration Tool
+
+ECReshore is a CLI tool for copying container images to AWS ECR registries with intelligent multi-architecture support and batch processing capabilities.
+
+## Core Commands
+
+### `copy` - Copy Single Images
+
+Copy container images to ECR with automatic multi-architecture detection.
+
+**Basic Usage:**
+```bash
+# Copy with automatic repository inference
+ecreshore copy nginx:latest
+
+# Copy with custom target repository
+ecreshore copy nginx:latest my-nginx-repo
+
+# Copy with specific platforms
+ecreshore copy nginx:latest --platforms linux/amd64,linux/arm64
+
+# Copy all architectures
+ecreshore copy nginx:latest -A
+```
+
+**Key Features:**
+- **Smart repository inference** - Automatically determines target repository name
+- **Multi-architecture support** - Preserves all platforms when Docker Buildx available
+- **Skip-if-present** - Automatically skips if target image already exists with matching content
+- **Force override** - Use `--force` to transfer even if target exists
+
+### `scan` - Kubernetes Cluster Scanning
+
+Scan Kubernetes clusters to identify non-ECR container images.
+
+**Basic Usage:**
+```bash
+# Scan current cluster and generate batch config
+ecreshore scan --export batch-config.yaml
+
+# Scan specific namespace
+ecreshore scan -n production
+
+# Scan all namespaces
+ecreshore scan -A
+
+# Generate report format
+ecreshore scan --output report
+```
+
+**Key Features:**
+- **Workload discovery** - Scans Deployments, DaemonSets, StatefulSets, Jobs, CronJobs, Pods
+- **ECR filtering** - Only identifies non-ECR images that need migration
+- **Batch config generation** - Creates ready-to-use configuration files
+- **Namespace targeting** - Include/exclude specific namespaces
+
+### `batch` - Batch Processing
+
+Execute multiple image transfers from YAML configuration files.
+
+**Basic Usage:**
+```bash
+# Execute batch transfers
+ecreshore batch config.yaml
+
+# Preview without executing
+ecreshore batch config.yaml --dry-run
+
+# Force rich UI display
+ecreshore batch config.yaml --rich
+
+# Output structured logs
+ecreshore batch config.yaml --output log
+```
+
+**Configuration Format:**
+```yaml
+settings:
+  concurrent_transfers: 3    # Parallel transfers
+  retry_attempts: 3          # Retry attempts per transfer
+  verify_digests: true       # Verify image integrity
+  region: us-east-2         # AWS region
+
+transfers:
+  - source: nginx:latest
+    target: my-nginx
+    source_tag: latest
+    target_tag: latest
+```
+
+**Key Features:**
+- **Concurrent processing** - Configurable parallel transfers (default: 3)
+- **Progress tracking** - Rich UI with real-time transfer status
+- **Error handling** - Automatic retries with configurable attempts
+- **Skip detection** - Automatically skips existing images with matching content
+
+### `purge` - Repository Cleanup
+
+Remove images from ECR repositories with safety controls.
+
+**Basic Usage:**
+```bash
+# Preview deletion for specific repository
+ecreshore purge my-repo --dry-run
+
+# Purge repository, keeping latest image
+ecreshore purge my-repo --keep-latest
+
+# Preview deletion for all repositories
+ecreshore purge -A --dry-run
+
+# Purge with pattern matching
+ecreshore purge -A --filter my-app-* --keep-latest
+```
+
+**Key Features:**
+- **Safety first** - Always use `--dry-run` to preview deletions
+- **Selective deletion** - Target specific repositories or use patterns
+- **Latest preservation** - `--keep-latest` protects most recent images
+- **Bulk operations** - Process all repositories with filtering options
+
+## Common Workflow
+
+1. **Discovery**: Scan your cluster to identify images needing migration
+   ```bash
+   ecreshore scan --export migration-plan.yaml
+   ```
+
+2. **Preview**: Review the generated configuration and preview the batch operation
+   ```bash
+   ecreshore batch migration-plan.yaml --dry-run
+   ```
+
+3. **Execute**: Run the batch migration
+   ```bash
+   ecreshore batch migration-plan.yaml
+   ```
+
+4. **Cleanup**: Optionally purge old/unused images
+   ```bash
+   ecreshore purge old-repo --dry-run
+   ecreshore purge old-repo --keep-latest
+   ```
+
+## Global Options
+
+- **`-v, --verbose`** - Increase verbosity (`-v` for INFO, `-vv` for DEBUG)
+- **`--region`** - AWS region (respects `AWS_DEFAULT_REGION`, `AWS_REGION`, `~/.aws/config`)
+- **`--registry-id`** - AWS account ID for ECR registry
+- **`--simple/--rich`** - Force specific UI modes (auto-detected by default)
+
+## UI Modes
+
+ECReshore automatically detects your terminal capabilities and chooses the best display mode:
+
+- **Rich UI** - Full-featured progress bars, colors, and real-time updates
+- **Simple UI** - Text-based progress suitable for basic terminals
+- **Log output** - Structured JSON logs for automation and monitoring
+
+Use `ecreshore terminal-info` to see your terminal's detected capabilities.
+
+## Authentication
+
+ECReshore uses your existing AWS credentials. Ensure you have:
+- AWS CLI configured (`aws configure`)
+- Appropriate ECR permissions (`ecr:*` or specific ECR actions)
+- Docker daemon running for image operations
+
+Test authentication with:
+```bash
+ecreshore auth-test
+```
+
+---
+
+For additional commands and advanced options, run `ecreshore --help` or `ecreshore COMMAND --help`.

ecreshore-1.0.1/pyproject.toml

@@ -0,0 +1,88 @@
+[project]
+name = "ecreshore"
+version = "1.0.1"
+description = "cli utility for copying container images to private ECR"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+  "aiodocker==0.24.0",
+  "boto3==1.40.25",
+  "click==8.2.1",
+  "docker==7.1.0",
+  "kubernetes==33.1.0",
+  "pytest-asyncio>=1.1.0",
+  "pytest-cov>=7.0.0",
+  "radon>=6.0.1",
+  "rich==14.1.0",
+  "structlog==25.4.0",
+  "tenacity==9.1.2",
+  "yaml-for-humans==1.1.1",
+]
+
+[project.scripts]
+ecreshore = "ecreshore.cli:cli"
+
+[dependency-groups]
+dev = [
+  "pytest==8.4.2",
+  "mypy==1.17.1",
+  "vulture>=2.14",
+  "unimport>=1.2.1",
+  "types-pyyaml>=6.0.12.20250915",
+  "types-psutil>=7.0.0.20250822",
+  "boto3-stubs>=1.40.32",
+  "lxml>=6.0.2",
+]
+
+[tool.uv]
+package = true
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = false
+warn_unused_configs = true
+disallow_untyped_defs = false
+disallow_incomplete_defs = false
+check_untyped_defs = true
+disallow_untyped_decorators = false
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+warn_unreachable = false
+strict_equality = true
+show_error_codes = true
+implicit_reexport = true
+
+# Allow untyped calls for third-party libraries without stubs
+[[tool.mypy.overrides]]
+module = [
+    "aiodocker.*",
+    "docker.*",
+    "kubernetes.*",
+    "tenacity.*",
+    "psutil.*",
+    "yaml.*",
+    "botocore.*",
+]
+ignore_missing_imports = true
+follow_imports = "skip"
+disable_error_code = ["attr-defined", "no-any-return", "union-attr", "unreachable"]
+
+# Targeted suppression for files with heavy third-party integration
+[[tool.mypy.overrides]]
+module = [
+    "ecreshore.async_docker_client",
+    "ecreshore.services.k8s_config",
+    "ecreshore.services.k8s_scanner",
+    "ecreshore.services.retry_service",
+]
+disable_error_code = ["unreachable", "no-any-return", "attr-defined", "assignment", "return-value", "union-attr"]
+
+[tool.pytest.ini_options]
+markers = [
+    "slow: marks tests as slow (deselected by default)",
+    "ux: marks tests that involve Rich UI components (may have threading warnings)",
+    "integration: marks tests that involve remote APIs"
+]
+addopts = "-m 'not slow and not ux'"

ecreshore-1.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ecreshore-1.0.1/src/ecreshore/__init__.py

@@ -0,0 +1,5 @@
+"""ECReshore - ECR Image Copy Tool."""
+
+from importlib.metadata import version
+
+__version__ = version("ecreshore")