chzzk-python 0.11.0__tar.gz → 0.12.0__tar.gz

chzzk_python-0.12.0/.dockerignore

@@ -0,0 +1,26 @@
+.git
+.gitignore
+__pycache__
+*.py[cod]
+.venv
+venv/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+dist/
+build/
+*.egg-info/
+.env
+.env.*
+*.token.json
+.chzzk_token.json
+*.log
+*.jsonl
+docs/
+.github/
+.mcp.json
+CLAUDE.md
+.claude/
+chzzk.spec
+tests/
+examples/

chzzk_python-0.12.0/.github/workflows/docker.yml

@@ -0,0 +1,157 @@
+name: Docker Build and Push
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+    inputs:
+      push:
+        description: "Push image to registry"
+        required: false
+        default: false
+        type: boolean
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  ci:
+    uses: ./.github/workflows/ci.yml
+
+  # Stage 1: 각 아키텍처를 네이티브 러너에서 병렬 빌드
+  build:
+    needs: ci
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - platform: linux/amd64
+            runner: ubuntu-latest
+          - platform: linux/arm64
+            runner: ubuntu-24.04-arm  # Native ARM runner (QEMU 없음!)
+    runs-on: ${{ matrix.runner }}
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+
+      - name: Get version from tag
+        id: version
+        run: |
+          if [[ "${{ github.ref_type }}" == "tag" ]]; then
+            VERSION="${{ github.ref_name }}"
+            VERSION="${VERSION#v}"  # Remove 'v' prefix
+          else
+            VERSION="0.0.0+$(git rev-parse --short HEAD)"
+          fi
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+
+      - name: Build and push by digest
+        id: build
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          platforms: ${{ matrix.platform }}
+          labels: ${{ steps.meta.outputs.labels }}
+          build-args: |
+            VERSION=${{ steps.version.outputs.version }}
+          outputs: type=image,name=${{ env.REGISTRY }}/${{ env.IMAGE_NAME }},push-by-digest=true,name-canonical=true,push=true
+          cache-from: type=gha,scope=${{ matrix.platform }}
+          cache-to: type=gha,scope=${{ matrix.platform }},mode=max
+
+      - name: Export digest
+        run: |
+          mkdir -p /tmp/digests
+          digest="${{ steps.build.outputs.digest }}"
+          touch "/tmp/digests/${digest#sha256:}"
+
+      - name: Upload digest
+        uses: actions/upload-artifact@v4
+        with:
+          name: digests-${{ matrix.platform == 'linux/amd64' && 'amd64' || 'arm64' }}
+          path: /tmp/digests/*
+          if-no-files-found: error
+          retention-days: 1
+
+  # Stage 2: Multi-arch manifest 병합
+  merge:
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+      attestations: write
+      id-token: write
+
+    steps:
+      - name: Download digests
+        uses: actions/download-artifact@v4
+        with:
+          path: /tmp/digests
+          pattern: digests-*
+          merge-multiple: true
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=semver,pattern={{major}}
+            type=raw,value=latest,enable={{is_default_branch}}
+            type=sha,prefix=sha-
+          labels: |
+            org.opencontainers.image.title=chzzk-python
+            org.opencontainers.image.description=Unofficial Python SDK and CLI for Chzzk
+            org.opencontainers.image.vendor=hypn4
+
+      - name: Create manifest list and push
+        working-directory: /tmp/digests
+        run: |
+          docker buildx imagetools create $(jq -cr '.tags | map("-t " + .) | join(" ")' <<< "$DOCKER_METADATA_OUTPUT_JSON") \
+            $(printf '${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}@sha256:%s ' *)
+
+      - name: Inspect image
+        run: |
+          docker buildx imagetools inspect ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:${{ steps.meta.outputs.version }}
+
+      - name: Generate artifact attestation
+        uses: actions/attest-build-provenance@v2
+        with:
+          subject-name: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          subject-digest: ${{ steps.meta.outputs.version }}
+          push-to-registry: true

chzzk_python-0.12.0/Dockerfile

@@ -0,0 +1,54 @@
+# syntax=docker/dockerfile:1
+
+# =============================================================================
+# Stage 1: Builder - uv로 의존성 설치
+# =============================================================================
+FROM ghcr.io/astral-sh/uv:python3.14-bookworm-slim AS builder
+
+# 버전 정보 (hatch-vcs용 - .git 없이 빌드 지원)
+ARG VERSION=0.0.0
+ENV SETUPTOOLS_SCM_PRETEND_VERSION=${VERSION}
+
+ENV UV_COMPILE_BYTECODE=1 \
+    UV_LINK_MODE=copy \
+    UV_PYTHON_DOWNLOADS=0
+
+WORKDIR /app
+
+# 의존성 먼저 설치 (레이어 캐싱 최적화)
+RUN --mount=type=cache,target=/root/.cache/uv \
+    --mount=type=bind,source=uv.lock,target=uv.lock \
+    --mount=type=bind,source=pyproject.toml,target=pyproject.toml \
+    uv sync --locked --no-install-project --no-dev --all-extras
+
+# 소스 코드 복사 및 프로젝트 설치
+COPY src/ /app/src/
+COPY pyproject.toml uv.lock README.md LICENSE /app/
+
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --locked --no-dev --all-extras --no-editable
+
+# =============================================================================
+# Stage 2: Runtime - 최소 프로덕션 이미지
+# =============================================================================
+FROM python:3.14-slim-bookworm AS runtime
+
+# 보안: non-root 사용자
+RUN groupadd --gid 1000 chzzk && \
+    useradd --uid 1000 --gid 1000 --shell /bin/bash --create-home chzzk
+
+# 가상환경만 복사
+COPY --from=builder --chown=chzzk:chzzk /app/.venv /app/.venv
+
+ENV PATH="/app/.venv/bin:$PATH" \
+    PYTHONUNBUFFERED=1 \
+    PYTHONDONTWRITEBYTECODE=1
+
+USER chzzk
+WORKDIR /home/chzzk
+
+HEALTHCHECK --interval=30s --timeout=5s --start-period=5s --retries=3 \
+    CMD chzzk --help || exit 1
+
+ENTRYPOINT ["chzzk"]
+CMD ["--help"]

{chzzk_python-0.11.0 → chzzk_python-0.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chzzk-python
-Version: 0.11.0
+Version: 0.12.0
 Summary: Unofficial Python SDK for Chzzk (NAVER Live Streaming Platform) API
 Project-URL: Homepage, https://github.com/hypn4/chzzk-python
 Project-URL: Repository, https://github.com/hypn4/chzzk-python
@@ -39,6 +39,7 @@ Description-Content-Type: text/markdown
 
 [![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Docker](https://img.shields.io/badge/docker-ghcr.io-blue.svg)](https://ghcr.io/hypn4/chzzk-python)
 
 Unofficial Python SDK for Chzzk (NAVER Live Streaming Platform) API
 
@@ -64,6 +65,31 @@ uv add "chzzk-python[cli]"
 pip install "chzzk-python[cli]"
 ```
 
+### Docker
+
+```bash
+# Pull from GitHub Container Registry
+docker pull ghcr.io/hypn4/chzzk-python:latest
+
+# Run CLI commands
+docker run --rm ghcr.io/hypn4/chzzk-python --help
+docker run --rm ghcr.io/hypn4/chzzk-python auth --help
+
+# Watch chat (with environment variables)
+docker run --rm -it \
+  -e CHZZK_NID_AUT="your-nid-aut" \
+  -e CHZZK_NID_SES="your-nid-ses" \
+  ghcr.io/hypn4/chzzk-python chat watch CHANNEL_ID
+
+# Interactive chat (requires -it flags)
+docker run --rm -it \
+  -e CHZZK_NID_AUT="your-nid-aut" \
+  -e CHZZK_NID_SES="your-nid-ses" \
+  ghcr.io/hypn4/chzzk-python chat send CHANNEL_ID -i
+```
+
+Available tags: `latest`, `X.Y.Z`, `X.Y`, `X`
+
 ## Quick Start
 
 ```python

{chzzk_python-0.11.0 → chzzk_python-0.12.0}/README.md

@@ -2,6 +2,7 @@
 
 [![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Docker](https://img.shields.io/badge/docker-ghcr.io-blue.svg)](https://ghcr.io/hypn4/chzzk-python)
 
 Unofficial Python SDK for Chzzk (NAVER Live Streaming Platform) API
 
@@ -27,6 +28,31 @@ uv add "chzzk-python[cli]"
 pip install "chzzk-python[cli]"
 ```
 
+### Docker
+
+```bash
+# Pull from GitHub Container Registry
+docker pull ghcr.io/hypn4/chzzk-python:latest
+
+# Run CLI commands
+docker run --rm ghcr.io/hypn4/chzzk-python --help
+docker run --rm ghcr.io/hypn4/chzzk-python auth --help
+
+# Watch chat (with environment variables)
+docker run --rm -it \
+  -e CHZZK_NID_AUT="your-nid-aut" \
+  -e CHZZK_NID_SES="your-nid-ses" \
+  ghcr.io/hypn4/chzzk-python chat watch CHANNEL_ID
+
+# Interactive chat (requires -it flags)
+docker run --rm -it \
+  -e CHZZK_NID_AUT="your-nid-aut" \
+  -e CHZZK_NID_SES="your-nid-ses" \
+  ghcr.io/hypn4/chzzk-python chat send CHANNEL_ID -i
+```
+
+Available tags: `latest`, `X.Y.Z`, `X.Y`, `X`
+
 ## Quick Start
 
 ```python

{chzzk_python-0.11.0 → chzzk_python-0.12.0}/README_KO.md

@@ -1,7 +1,8 @@
 # chzzk-python
 
-[![Python 3.14+](https://img.shields.io/badge/python-3.14+-blue.svg)](https://www.python.org/downloads/)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Docker](https://img.shields.io/badge/docker-ghcr.io-blue.svg)](https://ghcr.io/hypn4/chzzk-python)
 
 치지직(CHZZK) 스트리밍 플랫폼을 위한 비공식 Python SDK
 
@@ -27,6 +28,31 @@ uv add "chzzk-python[cli]"
 pip install "chzzk-python[cli]"
 ```
 
+### Docker
+
+```bash
+# GitHub Container Registry에서 Pull
+docker pull ghcr.io/hypn4/chzzk-python:latest
+
+# CLI 명령어 실행
+docker run --rm ghcr.io/hypn4/chzzk-python --help
+docker run --rm ghcr.io/hypn4/chzzk-python auth --help
+
+# 채팅 보기 (환경 변수 사용)
+docker run --rm -it \
+  -e CHZZK_NID_AUT="your-nid-aut" \
+  -e CHZZK_NID_SES="your-nid-ses" \
+  ghcr.io/hypn4/chzzk-python chat watch CHANNEL_ID
+
+# 대화형 채팅 (-it 플래그 필요)
+docker run --rm -it \
+  -e CHZZK_NID_AUT="your-nid-aut" \
+  -e CHZZK_NID_SES="your-nid-ses" \
+  ghcr.io/hypn4/chzzk-python chat send CHANNEL_ID -i
+```
+
+사용 가능한 태그: `latest`, `X.Y.Z`, `X.Y`, `X`
+
 ## 빠른 시작
 
 ```python

{chzzk_python-0.11.0 → chzzk_python-0.12.0}/src/chzzk/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.11.0'
-__version_tuple__ = version_tuple = (0, 11, 0)
+__version__ = version = '0.12.0'
+__version_tuple__ = version_tuple = (0, 12, 0)
 
 __commit_id__ = commit_id = None