ic-code 1.1.8__tar.gz → 1.2.1__tar.gz

{ic_code-1.1.8/src/ic_code.egg-info → ic_code-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ic-code
-Version: 1.1.8
+Version: 1.2.1
 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
@@ -32,7 +32,7 @@ Requires-Dist: boto3<2.0.0,>=1.26.0
 Requires-Dist: botocore<2.0.0,>=1.29.0
 Requires-Dist: oci<3.0.0,>=2.149.0
 Requires-Dist: requests<3.0.0,>=2.28.0
-Requires-Dist: kubernetes<31.0.0,>=29.0.0
+Requires-Dist: kubernetes<32.0.0,>=29.0.0
 Requires-Dist: awscli<2.0.0,>=1.42.0
 Requires-Dist: google-cloud-compute<2.0.0,>=1.36.0
 Requires-Dist: google-cloud-container<3.0.0,>=2.44.0
@@ -45,15 +45,15 @@ Requires-Dist: google-auth<3.0.0,>=2.29.0
 Requires-Dist: google-auth-oauthlib<2.0.0,>=1.2.0
 Requires-Dist: google-auth-httplib2<1.0.0,>=0.2.0
 Requires-Dist: azure-identity<2.0.0,>=1.15.0
-Requires-Dist: azure-mgmt-compute<31.0.0,>=29.1.0
-Requires-Dist: azure-mgmt-network<26.0.0,>=24.0.0
+Requires-Dist: azure-mgmt-compute<32.0.0,>=29.0.0
+Requires-Dist: azure-mgmt-network<27.0.0,>=24.0.0
 Requires-Dist: azure-mgmt-containerinstance<11.0.0,>=10.1.0
-Requires-Dist: azure-mgmt-containerservice<30.0.0,>=28.0.0
+Requires-Dist: azure-mgmt-containerservice<31.0.0,>=28.0.0
 Requires-Dist: azure-mgmt-storage<22.0.0,>=21.1.0
 Requires-Dist: azure-mgmt-sql<4.0.0,>=3.0.1
 Requires-Dist: azure-mgmt-rdbms<11.0.0,>=10.1.0
 Requires-Dist: azure-mgmt-eventhub<11.0.0,>=10.1.0
-Requires-Dist: azure-mgmt-resource<24.0.0,>=22.0.0
+Requires-Dist: azure-mgmt-resource<25.0.0,>=22.0.0
 Requires-Dist: azure-mgmt-subscription<4.0.0,>=3.1.1
 Requires-Dist: paramiko<5.0.0,>=2.11.0
 Requires-Dist: netifaces<1.0.0,>=0.11.0
@@ -62,17 +62,17 @@ Requires-Dist: InquirerPy<1.0.0,>=0.3.4
 Requires-Dist: tqdm<5.0.0,>=4.67.0
 Requires-Dist: python-dotenv<2.0.0,>=0.19.0
 Requires-Dist: python-dateutil<3.0.0,>=2.8.0
-Requires-Dist: PyYAML<7.0.0,>=6.0
+Requires-Dist: PyYAML<8.0.0,>=6.0
 Requires-Dist: click<9.0.0,>=8.0.0
 Requires-Dist: docutils<1.0.0,>=0.19
 Requires-Dist: invoke<3.0.0,>=2.2.0
 Requires-Dist: jsonschema<5.0.0,>=4.23.0
 Requires-Dist: cryptography<50.0.0,>=3.4.8
-Requires-Dist: watchdog<4.0.0,>=3.0.0
+Requires-Dist: watchdog<6.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: packaging<25.0,>=21.0
-Requires-Dist: setuptools<71.0,>=61.0
+Requires-Dist: setuptools<75.0,>=61.0
 Provides-Extra: dev
 Requires-Dist: pytest<9.0.0,>=7.0.0; extra == "dev"
 Requires-Dist: pytest-cov<6.0.0,>=4.0.0; extra == "dev"

ic_code-1.2.1/docs/ci-workflow-guide.md

@@ -0,0 +1,221 @@
+# IC CLI - Smart CI Workflow Guide
+
+## 개요
+
+IC CLI의 CI workflow는 커밋 메시지와 변경된 파일을 기반으로 자동으로 테스트할 플랫폼을 감지합니다.
+
+## 사용 방법
+
+### 1. 커밋 메시지 태그 사용 (권장)
+
+특정 플랫폼만 테스트하려면 커밋 메시지에 플랫폼 태그를 추가하세요:
+
+```bash
+# NCP만 테스트
+git commit -m "[ncp] EC2 인스턴스 목록 조회 수정"
+
+# OCI만 테스트  
+git commit -m "[oci] Compartment 처리 업데이트"
+
+# 여러 플랫폼 테스트
+git commit -m "[ncp][oci] 인증 플로우 개선"
+
+# 모든 플랫폼 테스트
+git commit -m "[all] 핵심 설정 시스템 리팩토링"
+```
+
+### 2. 자동 감지
+
+커밋 메시지에 태그가 없으면 변경된 파일을 기반으로 자동 감지:
+
+```bash
+# src/ic/platforms/ncp/ 파일 변경 → NCP 테스트
+# tests/platforms/oci/ 파일 변경 → OCI 테스트
+```
+
+### 3. 기본 동작
+
+플랫폼이 감지되지 않으면 기본 플랫폼 테스트:
+- NCP (Naver Cloud Platform)
+- NCPGov (Naver Cloud Platform Government)
+
+## 지원 플랫폼 태그
+
+| 태그 | 플랫폼 | 테스트 상태 |
+|------|--------|------------|
+| `[ncp]` | Naver Cloud Platform | ✅ 완전 지원 |
+| `[ncpgov]` | NCP Government | ✅ 완전 지원 |
+| `[oci]` | Oracle Cloud Infrastructure | ⚠️ 테스트 개발 중 |
+| `[azure]` | Microsoft Azure | ⚠️ 테스트 개발 중 |
+| `[aws]` | Amazon Web Services | ⚠️ 테스트 개발 중 |
+| `[gcp]` | Google Cloud Platform | ⚠️ 테스트 개발 중 |
+| `[ssh]` | SSH Server Management | ⚠️ 테스트 개발 중 |
+| `[cf]` | CloudFlare | ⚠️ 테스트 개발 중 |
+
+## 태그 형식
+
+다음 형식 모두 지원:
+
+```bash
+[platform]    # 대괄호
+(platform)    # 소괄호  
+platform:     # 콜론
+```
+
+대소문자 구분 없음:
+```bash
+[ncp] = [NCP] = [Ncp]
+```
+
+## 실전 예제
+
+### 예제 1: NCP EC2 기능 개발
+
+```bash
+# 1. NCP EC2 코드 수정
+vim src/ic/platforms/ncp/ec2/info.py
+
+# 2. 커밋 (NCP 태그 포함)
+git commit -m "[ncp] GPU 인스턴스 지원 추가"
+
+# 3. Push
+git push
+
+# 결과: NCP 테스트만 실행 (unit, integration, performance)
+```
+
+### 예제 2: 다중 플랫폼 업데이트
+
+```bash
+# 1. 인증 코드 수정
+vim src/ic/core/auth.py
+
+# 2. 커밋 (여러 플랫폼 태그)
+git commit -m "[ncp][oci][aws] 인증 에러 처리 표준화"
+
+# 3. Push
+git push
+
+# 결과: NCP, OCI, AWS 테스트 실행
+```
+
+### 예제 3: 전체 시스템 변경
+
+```bash
+# 1. 설정 시스템 수정
+vim src/ic/config/manager.py
+
+# 2. 커밋 (all 태그)
+git commit -m "[all] 설정 로딩 시스템 리팩토링"
+
+# 3. Push
+git push
+
+# 결과: 모든 플랫폼 테스트 실행
+```
+
+### 예제 4: 자동 감지
+
+```bash
+# 1. OCI 코드 수정 (태그 없이)
+vim src/ic/platforms/oci/vm/info.py
+
+# 2. 커밋 (플랫폼 태그 없음)
+git commit -m "VM 인스턴스 필터링 수정"
+
+# 3. Push
+git push
+
+# 결과: OCI 테스트 자동 실행 (변경된 파일에서 감지)
+```
+
+## 테스트 타입
+
+각 플랫폼에 대해 3가지 테스트 실행:
+
+1. **Unit Tests**: 빠른 단위 테스트 (모킹된 의존성)
+2. **Integration Tests**: 통합 테스트 (CI에서는 모킹)
+3. **Performance Tests**: 성능 벤치마크
+
+## Python 버전
+
+각 플랫폼은 다음 Python 버전에서 테스트:
+- Python 3.11
+- Python 3.12
+
+## CI 최적화
+
+- ✅ 영향받은 플랫폼만 테스트
+- ✅ 병렬 실행 (Python 버전별)
+- ✅ 테스트 파일이 없는 플랫폼 자동 스킵
+- ✅ 의존성 캐싱
+
+## 수동 실행
+
+GitHub Actions에서 수동으로 실행:
+
+1. Actions → "IC CLI CI Tests" 선택
+2. "Run workflow" 클릭
+3. 플랫폼과 테스트 타입 선택
+4. "Run workflow" 클릭
+
+## CI 스킵
+
+CI를 완전히 스킵하려면:
+
+```bash
+git commit -m "[skip ci] 문서 업데이트"
+# 또는
+git commit -m "[ci skip] README 수정"
+```
+
+## 로컬 테스트
+
+CI 감지 로직을 로컬에서 테스트:
+
+```bash
+./scripts/test-ci-detection.sh
+```
+
+## 새 플랫폼 테스트 추가
+
+새 플랫폼에 대한 테스트를 추가하려면:
+
+```bash
+# 1. 테스트 디렉토리 생성
+mkdir -p tests/platforms/{platform}/{service}/{unit,integration,performance}
+
+# 2. 테스트 파일 추가
+# tests/platforms/{platform}/{service}/unit/test_{feature}.py
+
+# 3. 자동으로 CI에서 실행됨
+```
+
+## 문제 해결
+
+### 내 플랫폼 테스트가 실행되지 않음
+
+확인 사항:
+1. `tests/platforms/{platform}/` 디렉토리가 있나요?
+2. `test_*.py` 파일이 있나요?
+3. 커밋 메시지에 플랫폼 태그를 포함했나요?
+4. 변경된 파일이 `src/ic/platforms/{platform}/`에 있나요?
+
+### 하나만 변경했는데 모든 플랫폼이 테스트됨
+
+확인 사항:
+1. `[all]` 또는 `[test-all]` 태그를 사용했나요?
+2. 모든 플랫폼에 영향을 주는 핵심 파일을 변경했나요?
+
+### 현재 테스트 상태 확인
+
+```bash
+# 플랫폼별 테스트 파일 수 확인
+./scripts/test-ci-detection.sh
+```
+
+## 참고
+
+- 전체 workflow 설정: `.github/workflows/ci-tests.yml`
+- 상세 가이드: `.github/workflows/README.md`
+- 테스트 감지 스크립트: `scripts/test-ci-detection.sh`

ic_code-1.2.1/docs/release-guide.md

@@ -0,0 +1,258 @@
+# IC CLI Release Guide
+
+## 릴리스 프로세스
+
+### 1. 버전 업데이트
+
+두 파일의 버전을 동기화해야 합니다:
+
+```bash
+# src/ic/__init__.py
+__version__ = "1.1.10"
+
+# pyproject.toml
+version = "1.1.10"
+```
+
+### 2. CHANGELOG 업데이트
+
+`.local-docs/CHANGELOG.md`에 변경사항 추가:
+
+```markdown
+## [1.1.10] - 2025-11-17
+
+### Added
+- 새로운 기능들...
+
+### Changed
+- 변경된 사항들...
+
+### Fixed
+- 수정된 버그들...
+```
+
+### 3. 로컬 빌드 테스트
+
+```bash
+# 빌드 아티팩트 정리
+rm -rf dist/ build/ src/ic_code.egg-info/
+
+# 패키지 빌드
+python -m build
+
+# 빌드 결과 확인
+ls -lh dist/
+
+# 패키지 검증
+twine check dist/*
+```
+
+### 4. 변경사항 커밋 및 푸시
+
+```bash
+# 변경사항 확인
+git status
+
+# 커밋
+git add src/ic/__init__.py pyproject.toml .local-docs/CHANGELOG.md
+git commit -m "Release v1.1.10: Smart CI platform detection and improvements"
+
+# 푸시
+git push origin main
+```
+
+### 5. GitHub Release 생성
+
+#### 방법 1: GitHub 웹 인터페이스
+
+1. https://github.com/dgr009/ic/releases/new 접속
+2. "Choose a tag" → `v1.1.10` 입력 (새 태그 생성)
+3. Release title: `v1.1.10`
+4. Description: CHANGELOG 내용 복사
+5. "Publish release" 클릭
+
+#### 방법 2: Git 태그 + GitHub CLI
+
+```bash
+# 태그 생성
+git tag -a v1.1.10 -m "Release v1.1.10: Smart CI platform detection"
+
+# 태그 푸시
+git push origin v1.1.10
+
+# GitHub CLI로 release 생성 (선택사항)
+gh release create v1.1.10 \
+  --title "v1.1.10" \
+  --notes-file .local-docs/CHANGELOG.md
+```
+
+### 6. 자동 배포 확인
+
+GitHub Release가 생성되면 자동으로:
+
+1. `.github/workflows/publish-to-pypi.yml` workflow 실행
+2. 패키지 빌드
+3. PyPI에 자동 업로드 (Trusted Publishing 사용)
+
+진행 상황 확인:
+- https://github.com/dgr009/ic/actions
+
+### 7. PyPI 배포 확인
+
+```bash
+# PyPI에서 새 버전 확인
+pip index versions ic-code
+
+# 또는 웹에서 확인
+# https://pypi.org/project/ic-code/
+```
+
+### 8. 설치 테스트
+
+```bash
+# 새 가상환경에서 테스트
+python -m venv test-env
+source test-env/bin/activate
+
+# 최신 버전 설치
+pip install --upgrade ic-code
+
+# 버전 확인
+ic --version
+# 또는
+python -c "import ic; print(ic.__version__)"
+
+# 정리
+deactivate
+rm -rf test-env
+```
+
+## 버전 관리 규칙
+
+### Semantic Versioning
+
+`MAJOR.MINOR.PATCH` (예: 1.1.10)
+
+- **MAJOR**: 호환되지 않는 API 변경
+- **MINOR**: 하위 호환되는 기능 추가
+- **PATCH**: 하위 호환되는 버그 수정
+
+### 버전 증가 가이드
+
+```bash
+# 버그 수정만
+1.1.9 → 1.1.10
+
+# 새 기능 추가 (하위 호환)
+1.1.10 → 1.2.0
+
+# Breaking changes
+1.2.0 → 2.0.0
+```
+
+## 문제 해결
+
+### PyPI 업로드 실패: "File already exists"
+
+**원인**: 같은 버전을 다시 업로드하려고 시도
+
+**해결**:
+```bash
+# 버전 증가
+# src/ic/__init__.py와 pyproject.toml 모두 업데이트
+__version__ = "1.1.11"
+version = "1.1.11"
+
+# 커밋 및 새 release 생성
+```
+
+### 버전 불일치
+
+**확인**:
+```bash
+# pyproject.toml 버전
+grep "^version" pyproject.toml
+
+# __init__.py 버전
+grep "__version__" src/ic/__init__.py
+```
+
+**두 파일의 버전이 반드시 일치해야 합니다!**
+
+### GitHub Actions 실패
+
+**확인 사항**:
+1. Workflow 로그 확인: https://github.com/dgr009/ic/actions
+2. PyPI Trusted Publishing 설정 확인
+3. 빌드 에러 확인 (의존성, 문법 등)
+
+### 로컬 빌드 실패
+
+```bash
+# 빌드 도구 업데이트
+pip install --upgrade build twine setuptools wheel
+
+# 캐시 정리
+rm -rf dist/ build/ *.egg-info src/*.egg-info
+
+# 다시 빌드
+python -m build
+```
+
+## 체크리스트
+
+릴리스 전 확인사항:
+
+- [ ] `src/ic/__init__.py` 버전 업데이트
+- [ ] `pyproject.toml` 버전 업데이트
+- [ ] 두 파일의 버전이 일치하는지 확인
+- [ ] `.local-docs/CHANGELOG.md` 업데이트
+- [ ] 로컬 빌드 테스트 성공
+- [ ] `twine check` 통과
+- [ ] 변경사항 커밋 및 푸시
+- [ ] GitHub Release 생성
+- [ ] GitHub Actions 성공 확인
+- [ ] PyPI에 새 버전 확인
+- [ ] 설치 테스트 성공
+
+## 빠른 릴리스 스크립트
+
+```bash
+#!/bin/bash
+# scripts/quick-release.sh
+
+VERSION=$1
+
+if [ -z "$VERSION" ]; then
+    echo "Usage: ./scripts/quick-release.sh 1.1.10"
+    exit 1
+fi
+
+echo "🚀 Releasing version $VERSION"
+
+# 버전 업데이트
+sed -i '' "s/__version__ = \".*\"/__version__ = \"$VERSION\"/" src/ic/__init__.py
+sed -i '' "s/^version = \".*\"/version = \"$VERSION\"/" pyproject.toml
+
+# 빌드 테스트
+rm -rf dist/ build/ *.egg-info
+python -m build
+twine check dist/*
+
+echo "✅ Build successful!"
+echo ""
+echo "Next steps:"
+echo "1. Update .local-docs/CHANGELOG.md"
+echo "2. git add src/ic/__init__.py pyproject.toml .local-docs/CHANGELOG.md"
+echo "3. git commit -m 'Release v$VERSION'"
+echo "4. git push origin main"
+echo "5. git tag -a v$VERSION -m 'Release v$VERSION'"
+echo "6. git push origin v$VERSION"
+echo "7. Create GitHub Release at https://github.com/dgr009/ic/releases/new"
+```
+
+## 참고
+
+- PyPI 프로젝트: https://pypi.org/project/ic-code/
+- GitHub 저장소: https://github.com/dgr009/ic
+- Trusted Publishing 가이드: https://docs.pypi.org/trusted-publishers/

{ic_code-1.1.8 → ic_code-1.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ic-code"
-version = "1.1.8"
+version = "1.2.1"
 authors = [
     {name = "sykim", email = "cruiser594@gmail.com"},
 ]
@@ -30,15 +30,15 @@ classifiers = [
 ]
 keywords = ["cli", "infrastructure", "aws", "oci", "gcp", "azure", "ncp", "naver-cloud", "cloudflare", "ssh", "devops", "multi-cloud"]
 dependencies = [
-    # Core Cloud SDKs - Compatible with Python 3.9-3.12
+    # Core Cloud SDKs - Compatible with Python 3.9-3.13
     "boto3>=1.26.0,<2.0.0",              # AWS SDK for Python
     "botocore>=1.29.0,<2.0.0",           # AWS SDK core library
     "oci>=2.149.0,<3.0.0",               # Oracle Cloud Infrastructure SDK
     "requests>=2.28.0,<3.0.0",           # HTTP library for API calls (required for NCP REST API)
-    "kubernetes>=29.0.0,<31.0.0",        # Kubernetes Python client
+    "kubernetes>=29.0.0,<32.0.0",        # Kubernetes Python client
     "awscli>=1.42.0,<2.0.0",             # AWS CLI for additional functionality
     
-    # Google Cloud SDKs - Compatible with Python 3.9-3.12
+    # Google Cloud SDKs - Compatible with Python 3.9-3.13
     "google-cloud-compute>=1.36.0,<2.0.0",      # Google Compute Engine API
     "google-cloud-container>=2.44.0,<3.0.0",    # Google Kubernetes Engine API
     "google-cloud-storage>=2.18.0,<3.0.0",      # Google Cloud Storage API
@@ -50,17 +50,17 @@ dependencies = [
     "google-auth-oauthlib>=1.2.0,<2.0.0",       # Google OAuth2 authentication
     "google-auth-httplib2>=0.2.0,<1.0.0",       # Google HTTP transport for authentication
     
-    # Azure SDKs - Compatible with Python 3.9-3.12
+    # Azure SDKs - Compatible with Python 3.9-3.13
     "azure-identity>=1.15.0,<2.0.0",            # Azure identity and authentication
-    "azure-mgmt-compute>=29.1.0,<31.0.0",       # Azure Virtual Machines management
-    "azure-mgmt-network>=24.0.0,<26.0.0",       # Azure networking management
+    "azure-mgmt-compute>=29.0.0,<32.0.0",       # Azure Virtual Machines management
+    "azure-mgmt-network>=24.0.0,<27.0.0",       # Azure networking management
     "azure-mgmt-containerinstance>=10.1.0,<11.0.0",  # Azure Container Instances
-    "azure-mgmt-containerservice>=28.0.0,<30.0.0",   # Azure Kubernetes Service
+    "azure-mgmt-containerservice>=28.0.0,<31.0.0",   # Azure Kubernetes Service
     "azure-mgmt-storage>=21.1.0,<22.0.0",       # Azure Storage management
     "azure-mgmt-sql>=3.0.1,<4.0.0",             # Azure SQL management
     "azure-mgmt-rdbms>=10.1.0,<11.0.0",         # Azure Database services
     "azure-mgmt-eventhub>=10.1.0,<11.0.0",      # Azure Event Hubs
-    "azure-mgmt-resource>=22.0.0,<24.0.0",      # Azure Resource Manager
+    "azure-mgmt-resource>=22.0.0,<25.0.0",      # Azure Resource Manager
     "azure-mgmt-subscription>=3.1.1,<4.0.0",    # Azure Subscription management
     
     # SSH and Network - Compatible with Python 3.9-3.12
@@ -72,26 +72,26 @@ dependencies = [
     "InquirerPy>=0.3.4,<1.0.0",          # Interactive command line prompts
     "tqdm>=4.67.0,<5.0.0",               # Progress bars
     
-    # Configuration and Utilities - Compatible with Python 3.9-3.12
+    # Configuration and Utilities - Compatible with Python 3.9-3.13
     "python-dotenv>=0.19.0,<2.0.0",      # Environment variable loading
     "python-dateutil>=2.8.0,<3.0.0",     # Date/time utilities
-    "PyYAML>=6.0,<7.0.0",               # YAML parser (required for NCP config files)
+    "PyYAML>=6.0,<8.0.0",                # YAML parser (required for NCP config files)
     "click>=8.0.0,<9.0.0",               # Command line interface framework
     "docutils>=0.19,<1.0.0",             # Documentation utilities
     "invoke>=2.2.0,<3.0.0",              # Task execution library
     
-    # Security and Validation - Compatible with Python 3.9-3.12
+    # Security and Validation - Compatible with Python 3.9-3.13
     "jsonschema>=4.23.0,<5.0.0",         # JSON schema validation
     "cryptography>=3.4.8,<50.0.0",       # Cryptographic recipes and primitives (required for NCP HMAC-SHA256 signatures)
     
-    # Additional dependencies for new config system (v2.0) - Compatible with Python 3.9-3.12
-    "watchdog>=3.0.0,<4.0.0",            # File change monitoring
+    # Additional dependencies for new config system (v2.0) - Compatible with Python 3.9-3.13
+    "watchdog>=3.0.0,<6.0.0",            # File change monitoring
     "cerberus>=1.3.4,<2.0.0",            # Schema validation
     "pydantic>=2.0.0,<3.0.0",            # Data validation and settings management
     
     # Package management and compatibility
     "packaging>=21.0,<25.0",              # Version parsing and comparison
-    "setuptools>=61.0,<71.0",            # Package building tools
+    "setuptools>=61.0,<75.0",            # Package building tools
 ]
 
 [project.optional-dependencies]