장마감이후 호출하는 경우 KeyError에 대한 방어코드 추가함.

.coveragerc

@@ -0,0 +1,11 @@
+[run]
+branch = True
+source = pykis
+omit =
+    */tests/*
+    */examples/*
+    */scripts/*
+    */__init__.py
+
+[report]
+fail_under = 90

.github/DISCUSSION_TEMPLATE/feature-request.yml

@@ -0,0 +1,55 @@
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Python-KIS를 더 좋게 만드는 데 도움을 주셔서 감사합니다! 🎉
+        새로운 기능 제안을 자세히 설명해주세요.
+
+  - type: textarea
+    id: summary
+    attributes:
+      label: "기능 요약"
+      description: "어떤 기능을 추가하고 싶나요?"
+      placeholder: "예: 실시간 데이터 구독 기능"
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: "현재의 문제점"
+      description: "이 기능이 해결할 문제를 설명해주세요."
+      placeholder: |
+        현재 quote() 메서드는 일회성 호출만 가능합니다.
+        실시간 가격 변동을 모니터링할 수 없습니다.
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: "제안하는 솔루션"
+      description: "이 기능이 어떻게 작동했으면 좋겠나요?"
+      placeholder: |
+        예: subscribe() 메서드를 추가하여 실시간 데이터를 받을 수 있도록:
+
+        stock = pykis.stock("005930")
+        async for quote in stock.subscribe():
+            print(quote.price)
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: "대안"
+      description: "다른 방법으로 이 문제를 해결할 수 있나요? (선택사항)"
+      placeholder: "WebSocket을 직접 사용하면 되지만 복잡합니다."
+      required: false
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: "확인 사항"
+      options:
+        - label: "유사한 기능 제안을 검색했습니다"
+          required: false
+        - label: "이 기능이 라이브러리의 범위에 맞다고 생각합니다"
+          required: false

.github/DISCUSSION_TEMPLATE/general.yml

@@ -0,0 +1,27 @@
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Python-KIS 커뮤니티에 오신 것을 환영합니다! 👋
+        자유롭게 의견을 공유해주세요.
+
+  - type: textarea
+    id: message
+    attributes:
+      label: "내용"
+      description: "공유하고 싶은 내용을 작성해주세요."
+      placeholder: |
+        예: "Python-KIS를 사용해서 만든 거래 봇을 공유하고 싶습니다.
+        또는 다른 사용자들의 경험을 듣고 싶습니다."
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: "추가 정보"
+      description: "추가로 공유할 정보가 있으신가요? (선택사항)"
+      placeholder: |
+        - 코드 링크
+        - 관련 리소스
+        - 기타 의견
+      required: false

.github/DISCUSSION_TEMPLATE/question.yml

@@ -0,0 +1,70 @@
+body:
+  - type: markdown
+    attributes:
+      value: |
+        감사합니다! Python-KIS 커뮤니티에 질문을 제출해주셨습니다.
+        다른 사용자들을 도와드릴 수 있도록 최대한 자세하게 설명해주세요.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: "질문 내용"
+      description: "어떤 문제가 있나요? 최대한 자세하게 설명해주세요."
+      placeholder: |
+        예: "quote() 메서드를 호출했을 때 None이 반환됩니다.
+        다음과 같이 코드를 작성했습니다..."
+      required: true
+
+  - type: textarea
+    id: code
+    attributes:
+      label: "재현 코드"
+      description: "문제를 재현할 수 있는 최소한의 코드를 제공해주세요."
+      language: python
+      placeholder: |
+        from pykis import PyKis
+        pykis = PyKis(mock=True)
+        stock = pykis.stock("005930")
+        quote = stock.quote()
+        print(quote)
+      required: false
+
+  - type: dropdown
+    id: environment
+    attributes:
+      label: "환경"
+      options:
+        - "Windows"
+        - "macOS"
+        - "Linux"
+        - "기타"
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: "추가 정보"
+      description: |
+        다음 정보를 포함해주세요:
+        - Python 버전: (예: 3.9)
+        - pykis 버전: (예: 2.2.0)
+        - OS:
+        - 에러 메시지 (있으면):
+      placeholder: |
+        Python 3.11
+        pykis 2.2.0
+        Windows 11
+        ConnectionError: ...
+      required: false
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: "확인 사항"
+      options:
+        - label: "FAQ를 읽었습니다"
+          required: false
+        - label: "유사한 이슈를 검색했습니다"
+          required: false
+        - label: "최신 버전을 사용하고 있습니다"
+          required: false

.github/workflows/ci.yml

@@ -0,0 +1,91 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+    tags: [ 'v*' ]
+  pull_request:
+
+jobs:
+  test:
+    name: Tests (${{ matrix.os }}, Python ${{ matrix.python-version }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ['3.11', '3.12']
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install Poetry
+        run: pipx install poetry
+      - name: Install dependencies
+        run: poetry install --no-interaction --with=dev
+      - name: Run unit + integration tests
+        env:
+          PYTEST_ADDOPTS: "-m 'not requires_api'"
+        run: |
+          poetry run pytest \
+            --maxfail=1 -q \
+            --cov=pykis --cov-report=xml:reports/coverage.xml \
+            --cov-report=html:reports/coverage_html \
+            --html=reports/test_report.html --self-contained-html
+      - name: Check coverage threshold
+        run: |
+          poetry run coverage report --fail-under=90
+        continue-on-error: false
+      - name: Upload coverage.xml
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-xml
+          path: reports/coverage.xml
+      - name: Upload coverage html
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-html
+          path: reports/coverage_html
+      - name: Upload pytest html
+        uses: actions/upload-artifact@v4
+        with:
+          name: pytest-report
+          path: reports/test_report.html
+  build:
+    if: startsWith(github.ref, 'refs/tags/v')
+    name: Build (tagged releases)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - name: Install Poetry
+        run: pipx install poetry
+      - name: Install deps
+        run: poetry install --no-interaction --with=dev
+      - name: Inject version from tag (current B-option)
+        shell: bash
+        run: |
+          tag=${GITHUB_REF_NAME#v}
+          python - <<'PY'
+from pathlib import Path
+import os
+ver=os.environ.get('TAG') or os.environ.get('GITHUB_REF_NAME','v0.0.0')[1:]
+p=Path('pykis/__env__.py')
+s=p.read_text(encoding='utf-8')
+s=s.replace('{{VERSION_PLACEHOLDER}}', ver)
+p.write_text(s, encoding='utf-8')
+print('Set version to', ver)
+PY
+        env:
+          TAG: ${{ github.ref_name }}
+      - name: Build
+        run: poetry build
+      - name: Upload dist
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/*

.github/workflows/publish.yml

@@ -7,6 +7,26 @@ on:
       - 'v*.*.*'
 
 jobs:
+  build-test:
+    name: Build & Test (${{ matrix.os }}, Python ${{ matrix.python-version }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ['3.11', '3.12']
+    steps:
+      - uses: actions/checkout@v3
+      - name: Set up Python
+        uses: actions/setup-python@v3
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: |
+          python -m pip install setuptools==72.1.0 wheel==0.43.0 twine==5.1.1 build==1.2.2.post1
+      - name: Build
+        run: |
+          python -m build --sdist --wheel --outdir dist/ .
+
   pypi-publish:
     name: upload release to PyPI
     runs-on: ubuntu-latest
@@ -21,26 +41,21 @@ jobs:
         uses: actions/setup-python@v3
         with:
           python-version: '3.12.6'
-
       - name: Install dependencies
         run: |
           python -m pip install setuptools==72.1.0 wheel==0.43.0 twine==5.1.1 build==1.2.2.post1
-
       - name: Extract tag name
         id: tag
         run: echo "TAG_NAME=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT
-
       - name: Update version in pykis/__env__.py
         run: |
           VERSION=${{ steps.tag.outputs.TAG_NAME }}
           VERSION=${VERSION#v}
           sed -i "s/{{VERSION_PLACEHOLDER}}/$VERSION/g" pykis/__env__.py
-
       - name: Build and publish
         run: |
           python -m build --sdist --wheel --outdir dist/ .
-
       - name: Publish package distributions to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
         with:
-            packages-dir: dist/
+            packages-dir: dist/

.gitignore

@@ -3,7 +3,7 @@ test-*.py
 test.ipynb
 test-*.ipynb
 __pycache__
-.vscode
+# .vscode
 build/
 develop-eggs/
 dist/
@@ -30,3 +30,11 @@ dummy/
 
 real_secret.json
 virtual_secret.json
+
+.venv/
+.python-version
+.coverage
+/htmlcov/
+/reports/
+poetry.toml
+config.yaml

.pre-commit-config.yaml

@@ -0,0 +1,44 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: mixed-line-ending
+      - id: check-yaml
+      - id: check-json
+      - id: check-toml
+      - id: check-merge-conflict
+  - repo: https://github.com/charliermarsh/ruff-pre-commit
+    rev: v0.14.10
+    hooks:
+      - id: ruff
+        args: ["--fix"]
+      - id: ruff-format
+
+  - repo: https://github.com/psf/black
+    rev: 25.12.0
+    hooks:
+      - id: black
+
+  - repo: https://github.com/pre-commit/mirrors-isort
+    rev: v5.10.1
+    hooks:
+      - id: isort
+
+  - repo: https://github.com/asottile/pyupgrade
+    rev: v3.21.2
+    hooks:
+      - id: pyupgrade
+        args: ["--py310-plus"]
+
+  - repo: https://github.com/myint/docformatter
+    rev: v1.7.7
+    hooks:
+      - id: docformatter
+        args: ["--in-place", "--wrap-summaries=120", "--wrap-descriptions=120"]
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-added-large-files

.vscode/extensions.json

@@ -0,0 +1,17 @@
+{
+    // 이 프로젝트에서 필요한 확장 프로그램 목록을 권장합니다.
+    "recommendations": [
+        "ms-python.python", // Python 언어 지원
+        "ryanluker.vscode-coverage-gutters", // code coverage 시각화
+        "streetsidesoftware.code-spell-checker", // 맞춤법 검사기
+        "charliermarsh.ruff", // Python linter Ruff
+        "esbenp.prettier-vscode", // 코드 포매터 Prettier
+        "tamasfe.even-better-toml", // TOML 파일 지원
+        "njpwerner.autodocstring", // Python docstring 자동 생성
+    ],
+
+    // 이 프로젝트에서는 사용하지 않도록 권장하는 확장 프로그램 목록입니다.
+    "unwantedRecommendations": [
+        "ms-python.vscode-pylance" // 충돌 가능성이 있는 포매터
+    ]
+}