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

chzzk_python-0.13.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.11.0 → chzzk_python-0.13.0}/.env.example

@@ -1,6 +1,14 @@
 # Chzzk CLI Configuration
 # Copy this file to .env and fill in your values
 
+# Timezone Configuration
+# Docker 컨테이너 시스템 시간대 (default: Asia/Seoul)
+TZ=Asia/Seoul
+
+# 채팅 타임스탬프 및 로그 파일명에 사용되는 시간대 (default: Asia/Seoul)
+# TZ와 별도로 설정 가능하며, 로그 출력에만 영향
+CHZZK_TIMEZONE=Asia/Seoul
+
 # Authentication (Naver Cookie)
 # 브라우저에서 네이버 로그인 후 개발자 도구에서 쿠키 확인
 # 1. 브라우저에서 chzzk.naver.com에 로그인
@@ -9,6 +17,16 @@
 CHZZK_NID_AUT=
 CHZZK_NID_SES=
 
+# Channel ID
+# 채팅을 모니터링할 채널 ID
+CHZZK_CHANNEL_ID=
+
+# Channel IDs (Docker Compose only)
+# Docker Compose 다중 채널 모니터링 전용 (chat-watch-1, chat-watch-2, chat-watch-3)
+CHZZK_CHANNEL_ID_1=
+CHZZK_CHANNEL_ID_2=
+CHZZK_CHANNEL_ID_3=
+
 # Logging Configuration
 # Log level: DEBUG, INFO, WARNING, ERROR
 CHZZK_LOG_LEVEL=WARNING

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

@@ -0,0 +1,160 @@
+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: Get image digest
+        id: digest
+        run: |
+          DIGEST=$(docker buildx imagetools inspect ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:${{ steps.meta.outputs.version }} --format '{{json .Manifest.Digest}}' | tr -d '"')
+          echo "digest=$DIGEST" >> "$GITHUB_OUTPUT"
+          echo "Image digest: $DIGEST"
+
+      - name: Generate artifact attestation
+        uses: actions/attest-build-provenance@v2
+        with:
+          subject-name: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          subject-digest: ${{ steps.digest.outputs.digest }}
+          push-to-registry: true

chzzk_python-0.13.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.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chzzk-python
-Version: 0.11.0
+Version: 0.13.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,55 @@ 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`
+
+### Docker Compose
+
+```bash
+# Copy and configure environment variables
+cp .env.example .env
+# Edit .env with your credentials and channel ID
+
+# Run CLI commands
+docker compose run --rm chzzk --help
+docker compose run --rm chzzk live info CHANNEL_ID
+
+# Watch chat (background service with auto-restart)
+docker compose --profile chat up -d chat-watch
+
+# Interactive chat mode
+docker compose --profile interactive run --rm chat-interactive
+
+# View logs
+docker compose --profile chat logs -f chat-watch
+
+# Stop services
+docker compose --profile chat down
+```
+
 ## Quick Start
 
 ```python
@@ -526,6 +576,8 @@ chzzk chat send CHANNEL_ID -i --offline
 | `CHZZK_CHAT_OUTPUT_FORMAT` | Default chat output format (jsonl, txt) |
 | `CHZZK_POLL_INTERVAL` | Live status polling interval in seconds (default: 10) |
 | `CHZZK_AUTO_RECONNECT` | Enable auto-reconnection (default: true, set "false" to disable) |
+| `CHZZK_TIMEZONE` | Timezone for chat timestamps and log filenames (default: Asia/Seoul) |
+| `TZ` | System timezone for Docker containers (default: Asia/Seoul) |
 
 ## Examples
 

{chzzk_python-0.11.0 → chzzk_python-0.13.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,55 @@ 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`
+
+### Docker Compose
+
+```bash
+# Copy and configure environment variables
+cp .env.example .env
+# Edit .env with your credentials and channel ID
+
+# Run CLI commands
+docker compose run --rm chzzk --help
+docker compose run --rm chzzk live info CHANNEL_ID
+
+# Watch chat (background service with auto-restart)
+docker compose --profile chat up -d chat-watch
+
+# Interactive chat mode
+docker compose --profile interactive run --rm chat-interactive
+
+# View logs
+docker compose --profile chat logs -f chat-watch
+
+# Stop services
+docker compose --profile chat down
+```
+
 ## Quick Start
 
 ```python
@@ -489,6 +539,8 @@ chzzk chat send CHANNEL_ID -i --offline
 | `CHZZK_CHAT_OUTPUT_FORMAT` | Default chat output format (jsonl, txt) |
 | `CHZZK_POLL_INTERVAL` | Live status polling interval in seconds (default: 10) |
 | `CHZZK_AUTO_RECONNECT` | Enable auto-reconnection (default: true, set "false" to disable) |
+| `CHZZK_TIMEZONE` | Timezone for chat timestamps and log filenames (default: Asia/Seoul) |
+| `TZ` | System timezone for Docker containers (default: Asia/Seoul) |
 
 ## Examples
 

{chzzk_python-0.11.0 → chzzk_python-0.13.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,55 @@ 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`
+
+### Docker Compose
+
+```bash
+# 환경 변수 파일 복사 및 설정
+cp .env.example .env
+# .env 파일에 인증 정보와 채널 ID 입력
+
+# CLI 명령어 실행
+docker compose run --rm chzzk --help
+docker compose run --rm chzzk live info CHANNEL_ID
+
+# 채팅 모니터링 (백그라운드 서비스, 자동 재시작)
+docker compose --profile chat up -d chat-watch
+
+# 대화형 채팅 모드
+docker compose --profile interactive run --rm chat-interactive
+
+# 로그 확인
+docker compose --profile chat logs -f chat-watch
+
+# 서비스 종료
+docker compose --profile chat down
+```
+
 ## 빠른 시작
 
 ```python
@@ -489,6 +539,8 @@ chzzk chat send CHANNEL_ID -i --offline
 | `CHZZK_CHAT_OUTPUT_FORMAT` | 기본 채팅 출력 형식 (jsonl, txt) |
 | `CHZZK_POLL_INTERVAL` | 라이브 상태 폴링 간격 (초, 기본값: 10) |
 | `CHZZK_AUTO_RECONNECT` | 자동 재연결 활성화 (기본값: true, 비활성화: "false") |
+| `CHZZK_TIMEZONE` | 채팅 타임스탬프 및 로그 파일명 시간대 (기본값: Asia/Seoul) |
+| `TZ` | Docker 컨테이너 시스템 시간대 (기본값: Asia/Seoul) |
 
 ## 예제 코드
 

chzzk_python-0.13.0/docker-compose.yml

@@ -0,0 +1,140 @@
+# =============================================================================
+# chzzk-python Docker Compose
+# =============================================================================
+#
+# Setup:
+#   cp .env.example .env
+#   # Edit .env with your CHZZK_CHANNEL_ID_1, CHZZK_CHANNEL_ID_2, ...
+#
+# Usage:
+#   # QR 로그인으로 쿠키 저장 (최초 1회)
+#   mkdir -p .chzzk .logs && chmod 777 .chzzk .logs
+#   docker compose run --rm -v ./.chzzk:/home/chzzk/.chzzk chzzk auth qr
+#   # 또는 docker run 사용:
+#   docker run --rm -it -v ./.chzzk:/home/chzzk/.chzzk ghcr.io/hypn4/chzzk-python:latest auth qr
+#   # 또는 호스트 사용자 권한으로 실행:
+#   docker run --rm -it --user $(id -u):$(id -g) -v ./.chzzk:/home/chzzk/.chzzk ghcr.io/hypn4/chzzk-python:latest auth qr
+#
+#   # CLI 명령어 실행
+#   docker compose run --rm chzzk --help
+#   docker compose run --rm chzzk live info CHANNEL_ID
+#
+#   # 채팅 모니터링 (백그라운드)
+#   # .env에 CHZZK_CHANNEL_ID_1, CHZZK_CHANNEL_ID_2, ... 설정 후:
+#   docker compose --profile chat up -d
+#   docker compose --profile chat logs -f
+#   docker compose --profile chat down
+#   # 특정 채널만 실행:
+#   docker compose --profile chat up -d chat-watch-1
+#
+#   # 대화형 채팅
+#   docker compose --profile interactive run --rm chat-interactive
+#
+# =============================================================================
+
+# YAML Anchor: 채팅 모니터링 서비스 공통 설정
+x-chat-watch-base: &chat-watch-base
+  image: ghcr.io/hypn4/chzzk-python:latest
+  restart: unless-stopped
+  profiles:
+    - chat
+  environment:
+    - TZ=${TZ:-Asia/Seoul}
+    - CHZZK_TIMEZONE=${CHZZK_TIMEZONE:-Asia/Seoul}
+    - CHZZK_NID_AUT=${CHZZK_NID_AUT:-}
+    - CHZZK_NID_SES=${CHZZK_NID_SES:-}
+    - CHZZK_LOG_LEVEL=${CHZZK_LOG_LEVEL:-INFO}
+    - CHZZK_POLL_INTERVAL=${CHZZK_POLL_INTERVAL:-10}
+  volumes:
+    - ./.logs:/home/chzzk/logs
+    - ./.chzzk:/home/chzzk/.chzzk
+
+services:
+  chzzk:
+    image: ghcr.io/hypn4/chzzk-python:latest
+    container_name: chzzk
+    restart: "no"
+    stdin_open: true
+    tty: true
+    environment:
+      - TZ=${TZ:-Asia/Seoul}
+      - CHZZK_TIMEZONE=${CHZZK_TIMEZONE:-Asia/Seoul}
+      - CHZZK_NID_AUT=${CHZZK_NID_AUT:-}
+      - CHZZK_NID_SES=${CHZZK_NID_SES:-}
+      - CHZZK_LOG_LEVEL=${CHZZK_LOG_LEVEL:-INFO}
+      - CHZZK_POLL_INTERVAL=${CHZZK_POLL_INTERVAL:-10}
+      - CHZZK_AUTO_RECONNECT=${CHZZK_AUTO_RECONNECT:-true}
+    volumes:
+      - ./.logs:/home/chzzk/logs
+      # Uncomment to persist cookies (run: docker compose run --rm chzzk auth qr)
+      # - ./.chzzk:/home/chzzk/.chzzk
+    # Override command as needed:
+    # command: ["chat", "watch", "CHANNEL_ID"]
+    # command: ["chat", "watch", "CHANNEL_ID", "--output-dir", "/home/chzzk/logs"]
+    # command: ["live", "info", "CHANNEL_ID"]
+
+  # Multi-channel chat monitoring (uses x-chat-watch-base anchor)
+  # 각 서비스는 CHZZK_CHANNEL_ID_N 환경변수를 사용하여 채널 지정
+  chat-watch-1:
+    <<: *chat-watch-base
+    container_name: chzzk-chat-watch-1
+    command:
+      - chat
+      - watch
+      - ${CHZZK_CHANNEL_ID_1:-}
+      - --output-dir
+      - /home/chzzk/logs
+      - --offline
+      - --auto-reconnect
+
+  chat-watch-2:
+    <<: *chat-watch-base
+    container_name: chzzk-chat-watch-2
+    command:
+      - chat
+      - watch
+      - ${CHZZK_CHANNEL_ID_2:-}
+      - --output-dir
+      - /home/chzzk/logs
+      - --offline
+      - --auto-reconnect
+
+  chat-watch-3:
+    <<: *chat-watch-base
+    container_name: chzzk-chat-watch-3
+    command:
+      - chat
+      - watch
+      - ${CHZZK_CHANNEL_ID_3:-}
+      - --output-dir
+      - /home/chzzk/logs
+      - --offline
+      - --auto-reconnect
+
+  # Example: Interactive chat mode
+  chat-interactive:
+    image: ghcr.io/hypn4/chzzk-python:latest
+    container_name: chzzk-chat-interactive
+    restart: "no"
+    profiles:
+      - interactive
+    stdin_open: true
+    tty: true
+    environment:
+      - TZ=${TZ:-Asia/Seoul}
+      - CHZZK_TIMEZONE=${CHZZK_TIMEZONE:-Asia/Seoul}
+      - CHZZK_NID_AUT=${CHZZK_NID_AUT:-}
+      - CHZZK_NID_SES=${CHZZK_NID_SES:-}
+      - CHZZK_LOG_LEVEL=${CHZZK_LOG_LEVEL:-INFO}
+    volumes:
+      - ./.logs:/home/chzzk/logs
+      # - ./.chzzk:/home/chzzk/.chzzk
+    command:
+      - chat
+      - send
+      - ${CHZZK_CHANNEL_ID:-}
+      - --interactive
+      - --output-dir
+      - /home/chzzk/logs
+      - --offline
+      - --auto-reconnect

{chzzk_python-0.11.0 → chzzk_python-0.13.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.13.0'
+__version_tuple__ = version_tuple = (0, 13, 0)
 
 __commit_id__ = commit_id = None

{chzzk_python-0.11.0 → chzzk_python-0.13.0}/src/chzzk/cli/commands/chat.py

@@ -7,7 +7,6 @@ import contextlib
 import json
 import logging
 import signal
-from datetime import datetime
 from pathlib import Path
 from typing import Annotated
 
@@ -16,6 +15,7 @@ from prompt_toolkit import PromptSession
 from prompt_toolkit.patch_stdout import patch_stdout
 from rich.console import Console
 
+from chzzk.cli import timezone as tz
 from chzzk.cli.formatter import ChatFormatter, FormatConfig
 from chzzk.cli.writers import ChatWriter, OutputFormat, create_writer, generate_chat_log_filename
 from chzzk.constants import StatusText
@@ -57,7 +57,7 @@ def format_chat_message_json(msg: ChatMessage) -> str:
     return json.dumps(
         {
             "type": "chat",
-            "timestamp": datetime.now().isoformat(),
+            "timestamp": tz.now().isoformat(),
             "user_id_hash": msg.user_id_hash,
             "nickname": msg.nickname,
             "content": msg.content,
@@ -71,7 +71,7 @@ def format_donation_message_json(msg: DonationMessage) -> str:
     return json.dumps(
         {
             "type": "donation",
-            "timestamp": datetime.now().isoformat(),
+            "timestamp": tz.now().isoformat(),
             "user_id_hash": msg.user_id_hash,
             "nickname": msg.nickname,
             "content": msg.content,
@@ -85,7 +85,7 @@ def format_sent_message_json(content: str) -> str:
     return json.dumps(
         {
             "type": "sent",
-            "timestamp": datetime.now().isoformat(),
+            "timestamp": tz.now().isoformat(),
             "content": content,
         }
     )

{chzzk_python-0.11.0 → chzzk_python-0.13.0}/src/chzzk/cli/formatter.py

@@ -3,11 +3,12 @@
 from __future__ import annotations
 
 from dataclasses import dataclass
-from datetime import datetime
 from typing import TYPE_CHECKING, Any
 
 from rich.markup import escape
 
+from chzzk.cli import timezone as tz
+
 if TYPE_CHECKING:
     from chzzk.unofficial import ChatMessage, ChatProfile, DonationMessage
 
@@ -119,7 +120,7 @@ class ChatFormatter:
 
     def _get_timestamp(self) -> str:
         """Get formatted timestamp string."""
-        return datetime.now().strftime(self.config.time_format)
+        return tz.now().strftime(self.config.time_format)
 
     def _escape_markup(self, text: str) -> str:
         """Escape Rich markup characters in text.
@@ -214,7 +215,7 @@ class ChatFormatter:
         """
         if not message_time:
             return ""
-        dt = datetime.fromtimestamp(message_time / 1000)
+        dt = tz.from_timestamp(message_time / 1000)
         return dt.strftime(self.config.time_format)
 
     def _get_pay_type_str(self, pay_type: str | None) -> str:

chzzk_python-0.13.0/src/chzzk/cli/timezone.py

@@ -0,0 +1,49 @@
+"""Timezone utilities for CLI output.
+
+This module provides centralized timezone handling for consistent timestamp
+display across different environments (local, Docker, etc.).
+
+The timezone can be configured via the CHZZK_TIMEZONE environment variable.
+Default timezone is Asia/Seoul (KST).
+"""
+
+from __future__ import annotations
+
+import os
+from datetime import datetime
+from zoneinfo import ZoneInfo
+
+DEFAULT_TIMEZONE = "Asia/Seoul"
+
+
+def get_timezone() -> ZoneInfo:
+    """Get the configured timezone.
+
+    Returns:
+        ZoneInfo object for the configured timezone.
+        Uses CHZZK_TIMEZONE environment variable if set,
+        otherwise defaults to Asia/Seoul.
+    """
+    tz_name = os.environ.get("CHZZK_TIMEZONE", DEFAULT_TIMEZONE)
+    return ZoneInfo(tz_name)
+
+
+def now() -> datetime:
+    """Get current datetime in the configured timezone.
+
+    Returns:
+        Current datetime with timezone info.
+    """
+    return datetime.now(get_timezone())
+
+
+def from_timestamp(timestamp: float) -> datetime:
+    """Convert Unix timestamp to datetime in the configured timezone.
+
+    Args:
+        timestamp: Unix timestamp (seconds since epoch).
+
+    Returns:
+        Datetime object in the configured timezone.
+    """
+    return datetime.fromtimestamp(timestamp, get_timezone())

{chzzk_python-0.11.0 → chzzk_python-0.13.0}/src/chzzk/cli/writers.py

@@ -4,11 +4,12 @@ from __future__ import annotations
 
 import json
 from abc import ABC, abstractmethod
-from datetime import datetime
 from enum import StrEnum
 from pathlib import Path
 from typing import TYPE_CHECKING
 
+from chzzk.cli import timezone as tz
+
 if TYPE_CHECKING:
     from chzzk.unofficial import ChatMessage, DonationMessage
 
@@ -98,7 +99,7 @@ class JsonlWriter(ChatWriter):
 
         data = {
             "type": "chat",
-            "timestamp": datetime.now().isoformat(),
+            "timestamp": tz.now().isoformat(),
             "user_id_hash": msg.user_id_hash,
             "nickname": msg.nickname,
             "content": msg.content,
@@ -111,7 +112,7 @@ class JsonlWriter(ChatWriter):
         """Write a donation message in JSONL format."""
         data = {
             "type": "donation",
-            "timestamp": datetime.now().isoformat(),
+            "timestamp": tz.now().isoformat(),
             "user_id_hash": msg.user_id_hash,
             "nickname": msg.nickname,
             "content": msg.content,
@@ -124,7 +125,7 @@ class JsonlWriter(ChatWriter):
         """Write a sent message in JSONL format."""
         data = {
             "type": "sent",
-            "timestamp": datetime.now().isoformat(),
+            "timestamp": tz.now().isoformat(),
             "content": content,
         }
         self._file.write(json.dumps(data, ensure_ascii=False) + "\n")
@@ -150,7 +151,7 @@ class TextWriter(ChatWriter):
 
     def write_chat(self, msg: ChatMessage) -> None:
         """Write a chat message in text format."""
-        timestamp = datetime.now().strftime("%H:%M:%S")
+        timestamp = tz.now().strftime("%H:%M:%S")
         badge_name = None
         if msg.profile:
             # 1. Check profile.badge dict
@@ -175,14 +176,14 @@ class TextWriter(ChatWriter):
 
     def write_donation(self, msg: DonationMessage) -> None:
         """Write a donation message in text format."""
-        timestamp = datetime.now().strftime("%H:%M:%S")
+        timestamp = tz.now().strftime("%H:%M:%S")
         content = msg.content or ""
         self._file.write(f"[{timestamp}] {msg.pay_amount}원 {msg.nickname}: {content}\n")
         self._file.flush()
 
     def write_sent(self, content: str) -> None:
         """Write a sent message in text format."""
-        timestamp = datetime.now().strftime("%H:%M:%S")
+        timestamp = tz.now().strftime("%H:%M:%S")
         self._file.write(f"[{timestamp}] > {content}\n")
         self._file.flush()
 
@@ -219,9 +220,9 @@ def generate_chat_log_filename(
             # Parse date from open_date string (format: "YYYY-MM-DD HH:MM:SS")
             date_str = open_date.split()[0].replace("-", "")
         except (IndexError, ValueError):
-            date_str = datetime.now().strftime("%Y%m%d")
+            date_str = tz.now().strftime("%Y%m%d")
     else:
-        date_str = datetime.now().strftime("%Y%m%d")
+        date_str = tz.now().strftime("%Y%m%d")
 
     # Use live_id if available, otherwise use "offline"
     live_id_str = str(live_id) if live_id else "offline"