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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ic-code
-Version: 1.1.8
+Version: 1.1.10
 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

ic_code-1.1.10/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.1.10/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.1.10}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ic-code"
-version = "1.1.8"
+version = "1.1.10"
 authors = [
     {name = "sykim", email = "cruiser594@gmail.com"},
 ]

ic_code-1.1.10/scripts/test-ci-detection.sh

@@ -0,0 +1,111 @@
+#!/bin/bash
+# Test CI platform detection logic locally
+
+set -e
+
+echo "🔍 Testing CI Platform Detection Logic"
+echo "========================================"
+echo ""
+
+# All available platforms
+ALL_PLATFORMS=("ncp" "ncpgov" "oci" "azure" "aws" "gcp" "ssh" "cf")
+
+# Test function
+test_detection() {
+    local commit_msg="$1"
+    local expected="$2"
+    
+    echo "Test: $commit_msg"
+    echo "Expected: $expected"
+    
+    DETECTED_PLATFORMS=()
+    
+    # Check for platform tags in commit message
+    for platform in "${ALL_PLATFORMS[@]}"; do
+        if echo "$commit_msg" | grep -iE "\[${platform}\]|\(${platform}\)|${platform}:" > /dev/null; then
+            DETECTED_PLATFORMS+=("$platform")
+        fi
+    done
+    
+    # Check for [all] tag
+    if echo "$commit_msg" | grep -iE "\[all\]|\[test-all\]" > /dev/null; then
+        DETECTED_PLATFORMS=("${ALL_PLATFORMS[@]}")
+    fi
+    
+    # If no platforms detected, use defaults
+    if [ ${#DETECTED_PLATFORMS[@]} -eq 0 ]; then
+        DETECTED_PLATFORMS=("ncp" "ncpgov")
+    fi
+    
+    # Remove duplicates
+    UNIQUE_PLATFORMS=($(echo "${DETECTED_PLATFORMS[@]}" | tr ' ' '\n' | sort -u | tr '\n' ' '))
+    
+    echo "Detected: ${UNIQUE_PLATFORMS[*]}"
+    
+    if [ "${UNIQUE_PLATFORMS[*]}" = "$expected" ]; then
+        echo "✅ PASS"
+    else
+        echo "❌ FAIL"
+    fi
+    echo ""
+}
+
+# Run tests
+echo "Test 1: Single platform tag"
+test_detection "[ncp] Fix EC2 listing" "ncp"
+
+echo "Test 2: Multiple platform tags"
+test_detection "[ncp][oci] Update auth" "ncp oci"
+
+echo "Test 3: All platforms tag"
+test_detection "[all] Major refactor" "aws azure cf gcp ncp ncpgov oci ssh"
+
+echo "Test 4: Platform in parentheses"
+test_detection "(oci) Add compartment support" "oci"
+
+echo "Test 5: Platform with colon"
+test_detection "aws: Add S3 support" "aws"
+
+echo "Test 6: No platform tag (should use defaults)"
+test_detection "Fix typo in README" "ncp ncpgov"
+
+echo "Test 7: Case insensitive"
+test_detection "[NCP] Fix bug" "ncp"
+
+echo "Test 8: Multiple platforms mixed format"
+test_detection "[ncp] (oci) aws: Update all" "aws ncp oci"
+
+echo ""
+echo "🔍 Checking test directory structure"
+echo "====================================="
+echo ""
+
+for platform in "${ALL_PLATFORMS[@]}"; do
+    if [ -d "tests/platforms/$platform" ]; then
+        test_count=$(find "tests/platforms/$platform" -name "test_*.py" -type f 2>/dev/null | wc -l)
+        if [ "$test_count" -gt 0 ]; then
+            echo "✅ $platform: $test_count test files"
+        else
+            echo "⚠️  $platform: directory exists but no test files"
+        fi
+    else
+        echo "❌ $platform: no test directory"
+    fi
+done
+
+echo ""
+echo "🔍 Checking platform source directories"
+echo "========================================"
+echo ""
+
+for platform in "${ALL_PLATFORMS[@]}"; do
+    if [ -d "src/ic/platforms/$platform" ]; then
+        service_count=$(find "src/ic/platforms/$platform" -mindepth 1 -maxdepth 1 -type d 2>/dev/null | wc -l)
+        echo "✅ $platform: $service_count services"
+    else
+        echo "❌ $platform: no source directory"
+    fi
+done
+
+echo ""
+echo "✅ Detection logic test complete!"

{ic_code-1.1.8 → ic_code-1.1.10}/src/ic/__init__.py

@@ -4,7 +4,7 @@ IC (Infra Resource Management CLI) - A comprehensive tool for managing cloud inf
 This package provides CLI tools and libraries for managing AWS, Azure, GCP, OCI, and CloudFlare resources.
 """
 
-__version__ = "1.1.5"
+__version__ = "1.1.10"
 __author__ = "SangYun"
 __email__ = "cruiser594@gmail.com"
 

{ic_code-1.1.8 → ic_code-1.1.10}/src/ic/platforms/aws/profile/info.py

@@ -14,6 +14,21 @@ from rich.console import Console
 from rich.table import Table
 
 
+###############################################################################
+# CLI 인자 정의
+###############################################################################
+def add_arguments(parser):
+    """AWS Profile Info에 필요한 인자 추가"""
+    parser.add_argument(
+        "--config",
+        help="AWS config 파일 경로 (기본: ~/.aws/config)"
+    )
+    parser.add_argument(
+        "--credentials",
+        help="AWS credentials 파일 경로 (기본: ~/.aws/credentials)"
+    )
+
+
 class AWSProfileParser:
     """Parses AWS configuration and credentials files."""
     
@@ -308,4 +323,38 @@ class ProfileTableRenderer:
         missing_accounts = [p['profile_name'] for p in profiles if not p['account_id']]
         if missing_accounts:
             self.console.print(f"\n⚠️  Profiles without account ID: {', '.join(missing_accounts)}")
-            self.console.print("💡 Consider adding role_arn or account_id to these profiles")
+            self.console.print("💡 Consider adding role_arn or account_id to these profiles")
+
+
+###############################################################################
+# main
+###############################################################################
+def main(args, config=None):
+    """
+    AWS Profile 정보를 조회하고 출력합니다.
+    
+    Args:
+        args: CLI 인자
+        config: 설정 정보 (선택사항)
+    """
+    console = Console()
+    
+    try:
+        # Profile 정보 수집
+        collector = ProfileInfoCollector()
+        
+        # 사용자 지정 경로가 있으면 사용
+        if hasattr(args, 'config') and args.config:
+            collector.parser.aws_config_path = Path(args.config)
+        if hasattr(args, 'credentials') and args.credentials:
+            collector.parser.aws_credentials_path = Path(args.credentials)
+        
+        profiles = collector.collect_profile_info()
+        
+        # 테이블 렌더링
+        renderer = ProfileTableRenderer()
+        console.print()  # 빈 줄 추가
+        renderer.render_profiles(profiles)
+        
+    except Exception as e:
+        console.print(f"❌ AWS Profile 조회 중 오류 발생: {e}")