fubon-cli 0.1.3__tar.gz

fubon_cli-0.1.3/.editorconfig

@@ -0,0 +1,27 @@
+# Encoding declaration
+# ----- Editor/IDE Configuration -----
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+# Python files
+[*.py]
+indent_style = space
+indent_size = 4
+
+# JSON files
+[*.json]
+indent_style = space
+indent_size = 2
+
+# YAML files
+[*.{yml,yaml}]
+indent_style = space
+indent_size = 2
+
+# Markdown
+[*.md]
+trim_trailing_whitespace = false

fubon_cli-0.1.3/.flake8

@@ -0,0 +1,25 @@
+[flake8]
+max-line-length = 100
+max-complexity = 10
+exclude =
+    .git,
+    __pycache__,
+    .venv,
+    venv,
+    .pytest_cache,
+    .mypy_cache,
+    build,
+    dist,
+    *.egg-info,
+    .github
+
+ignore =
+    E203,
+    E501,
+    W503,
+    W504
+
+per-file-ignores =
+    __init__.py:F401,F403
+    tests/*:D100,D101,D104
+

fubon_cli-0.1.3/.github/workflows/ci.yml

@@ -0,0 +1,143 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12']
+      fail-fast: false
+
+    name: Test Python ${{ matrix.python-version }} on ${{ matrix.os }}
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install fubon_neo (Linux)
+      if: matrix.os == 'ubuntu-latest'
+      run: |
+        python -m pip install --upgrade pip
+        pip install setuptools-scm
+        pip install ./wheels/fubon_neo-2.2.8-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
+
+    - name: Install fubon_neo (Windows)
+      if: matrix.os == 'windows-latest'
+      run: |
+        python -m pip install --upgrade pip
+        pip install setuptools-scm
+        pip install ./wheels/fubon_neo-2.2.8-cp37-abi3-win_amd64.whl
+
+    - name: Install fubon_neo (macOS)
+      if: matrix.os == 'macos-latest'
+      run: |
+        python -m pip install --upgrade pip
+        pip install setuptools-scm
+        # Try ARM first, fall back to x86_64
+        pip install ./wheels/fubon_neo-2.2.8-cp37-abi3-macosx_11_0_arm64.whl || \
+        pip install ./wheels/fubon_neo-2.2.8-cp37-abi3-macosx_10_12_x86_64.whl
+
+    - name: Install project dependencies
+      run: |
+        pip install -e ".[dev]"
+
+    - name: Lint with flake8
+      run: |
+        # Stop the build if there are Python syntax errors or undefined names
+        flake8 fubon_cli --count --select=E9,F63,F7,F82 --show-source --statistics
+        # Exit-zero treats all errors as warnings
+        flake8 fubon_cli --count --exit-zero --max-complexity=10 --max-line-length=100 --statistics
+      continue-on-error: true
+
+    - name: Type check with mypy
+      run: |
+        mypy fubon_cli || true
+      continue-on-error: true
+
+    - name: Test with pytest
+      run: |
+        pytest -v --tb=short --cov=fubon_cli --cov-report=xml --cov-report=term-missing
+
+    - name: Upload coverage to Codecov
+      uses: codecov/codecov-action@v3
+      with:
+        files: ./coverage.xml
+        flags: unittests
+        name: codecov-umbrella
+        fail_ci_if_error: false
+
+  code-quality:
+    runs-on: ubuntu-latest
+    name: Code Quality Checks
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install black isort ruff bandit safety
+
+    - name: Check code formatting with Black
+      run: black --check fubon_cli tests || true
+
+    - name: Check import ordering with isort
+      run: isort --check-only fubon_cli tests || true
+
+    - name: Run Ruff linter
+      run: ruff check fubon_cli || true
+
+    - name: Security check with Bandit
+      run: bandit -r fubon_cli -f json -o bandit-report.json || true
+
+    - name: Check dependencies with Safety
+      run: safety check --json || true
+
+  build:
+    needs: [test, code-quality]
+    runs-on: ubuntu-latest
+    name: Build Package
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - name: Install build dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build setuptools-scm
+
+    - name: Build package
+      run: |
+        python -m build
+
+    - name: Upload build artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: dist
+        path: dist/
+        retention-days: 5

fubon_cli-0.1.3/.github/workflows/release.yml

@@ -0,0 +1,159 @@
+name: Release
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Release version'
+        required: true
+        default: 'patch'
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+
+jobs:
+  # 版本管理和標籤建立
+  version:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    outputs:
+      tag: ${{ steps.version_output.outputs.tag }}
+      version: ${{ steps.version_output.outputs.version }}
+
+    steps:
+    - uses: actions/checkout@v6
+      with:
+        fetch-depth: 0
+
+    - name: Set up Python
+      uses: actions/setup-python@v6
+      with:
+        python-version: "3.11"
+
+    - name: Install setuptools-scm
+      run: |
+        python -m pip install --upgrade pip
+        pip install setuptools-scm
+
+    - name: Get version from tag
+      if: github.event_name == 'release'
+      id: get_version_tag
+      run: |
+        VERSION=${GITHUB_REF#refs/tags/v}
+        echo "VERSION=$VERSION" >> $GITHUB_ENV
+        echo "TAG_VERSION=v$VERSION" >> $GITHUB_ENV
+
+    - name: Bump version and create tag
+      if: github.event_name == 'workflow_dispatch'
+      id: bump_version
+      run: |
+        git config --local user.email "action@github.com"
+        git config --local user.name "GitHub Action"
+
+        # Get current version from setuptools-scm
+        CURRENT_VERSION=$(python -c "import setuptools_scm; print(setuptools_scm.get_version().split('+')[0])")
+        echo "Current version: $CURRENT_VERSION"
+
+        # Extract version parts
+        IFS='.' read -r major minor patch <<< "$CURRENT_VERSION"
+        patch=${patch%%-*}  # Remove suffix like -dev0
+
+        # Bump version based on input
+        if [ "${{ github.event.inputs.version }}" = "major" ]; then
+          NEW_VERSION="$((major + 1)).0.0"
+        elif [ "${{ github.event.inputs.version }}" = "minor" ]; then
+          NEW_VERSION="$major.$((minor + 1)).0"
+        else
+          NEW_VERSION="$major.$minor.$((patch + 1))"
+        fi
+
+        echo "New version: $NEW_VERSION"
+        echo "VERSION=$NEW_VERSION" >> $GITHUB_ENV
+        echo "TAG_VERSION=v$NEW_VERSION" >> $GITHUB_ENV
+
+        # Create and push tag
+        git tag "v$NEW_VERSION"
+        git push origin "v$NEW_VERSION"
+
+    - name: Set version output
+      id: version_output
+      run: |
+        echo "tag=${{ env.TAG_VERSION }}" >> $GITHUB_OUTPUT
+        echo "version=${{ env.VERSION }}" >> $GITHUB_OUTPUT
+
+  # 發布到 PyPI
+  pypi-release:
+    needs: version
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write
+      contents: read
+
+    steps:
+    - uses: actions/checkout@v6
+      with:
+        ref: ${{ needs.version.outputs.tag }}
+        fetch-depth: 0
+
+    - name: Set up Python
+      uses: actions/setup-python@v6
+      with:
+        python-version: "3.11"
+
+    - name: Install build dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine setuptools-scm
+
+    - name: Build package
+      run: python -m build
+
+    - name: Check package
+      run: twine check dist/*
+
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        password: ${{ secrets.PYPI_API_TOKEN }}
+        print-hash: true
+
+  # 建立 GitHub Release
+  github-release:
+    needs: [version, pypi-release]
+    runs-on: ubuntu-latest
+    if: github.event_name == 'workflow_dispatch'
+    permissions:
+      contents: write
+
+    steps:
+    - uses: actions/checkout@v6
+      with:
+        ref: ${{ needs.version.outputs.tag }}
+
+    - name: Download artifacts
+      uses: actions/download-artifact@v4
+      with:
+        name: dist
+        path: dist/
+      continue-on-error: true
+
+    - name: Create Release Notes
+      run: |
+        echo "## Release ${{ needs.version.outputs.version }}" > release_notes.md
+        echo "" >> release_notes.md
+        echo "Published to [PyPI](https://pypi.org/project/fubon-cli/${{ needs.version.outputs.version }}/)" >> release_notes.md
+
+    - name: Create GitHub Release
+      uses: softprops/action-gh-release@v1
+      with:
+        tag_name: ${{ needs.version.outputs.tag }}
+        body_path: release_notes.md
+        files: dist/*
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

fubon_cli-0.1.3/.gitignore

@@ -0,0 +1,62 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+# *.whl
+.env
+*.pem
+*.pfx
+*.p12
+*.cert
+_whl_extract/
+.session.json
+venv/
+.venv/
+log/
+
+# Testing
+.pytest_cache/
+.coverage
+coverage.xml
+htmlcov/
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Version
+fubon_cli/_version.py
+
+# Build artifacts
+*.egg-info/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+# wheels/
+pip-wheel-metadata/
+share/python-wheels/
+
+# Development
+.ruff_cache/
+.pre-commit-config.yaml.bak
+bandit-report.json
+
+# Temporary files
+*.tmp
+*.temp
+*.backup
+*.bak
+

fubon_cli-0.1.3/.gitignore_extra

@@ -0,0 +1,14 @@
+exclude: |
+    (?x)^(
+        \.venv/|
+        venv/|
+        __pycache__/|
+        \.pytest_cache/|
+        \.mypy_cache/|
+        \.git/|
+        build/|
+        dist/|
+        .*\.egg-info/|
+        htmlcov/|
+        coverage.xml
+    )

fubon_cli-0.1.3/.mypy.ini

@@ -0,0 +1,15 @@
+[mypy]
+python_version = 3.8
+check_untyped_defs = True
+warn_return_any = True
+warn_unused_configs = True
+warn_redundant_casts = True
+warn_unused_ignores = True
+disallow_untyped_defs = False
+ignore_missing_imports = True
+
+[mypy-tests.*]
+ignore_errors = True
+
+[mypy-setuptools_scm]
+ignore_missing_imports = True

fubon_cli-0.1.3/.pre-commit-config.yaml

@@ -0,0 +1,38 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+        args: ["--maxkb=1000"]
+      - id: check-json
+      - id: check-merge-conflict
+      - id: check-toml
+
+  - repo: https://github.com/psf/black
+    rev: 23.12.0
+    hooks:
+      - id: black
+        language_version: python3
+
+  - repo: https://github.com/PyCQA/isort
+    rev: 5.13.2
+    hooks:
+      - id: isort
+        args: ["--profile", "black"]
+
+  - repo: https://github.com/PyCQA/flake8
+    rev: 6.1.0
+    hooks:
+      - id: flake8
+        args: ["--max-line-length=100"]
+        additional_dependencies: []
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.7.1
+    hooks:
+      - id: mypy
+        additional_dependencies: ["types-all"]
+        args: ["--ignore-missing-imports"]

fubon_cli-0.1.3/CHANGELOG.md

@@ -0,0 +1,39 @@
+# Changelog
+
+所有對此項目的重大更改都將記錄在此文件中。
+
+該項目遵循 [Semantic Versioning](https://semver.org/)。
+
+## [Unreleased]
+
+### Added
+- 初始版本發布
+- CLI 基本命令框架
+- 版本管理機制
+
+### Changed
+- 完整的項目配置
+- GitHub Actions CI/CD
+
+### Fixed
+- N/A
+
+### Deprecated
+- N/A
+
+### Removed
+- N/A
+
+### Security
+- N/A
+
+## [0.1.0] - 2026-02-26
+
+### Added
+- 初始項目設置
+- 基本 CLI 框架
+- 測試環境配置
+- 發布自動化腳本
+
+[Unreleased]: https://github.com/mofesto/fubon-cli/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/mofesto/fubon-cli/releases/tag/v0.1.0