nene2-python 1.0.0__tar.gz

nene2_python-1.0.0/.env.example

@@ -0,0 +1,44 @@
+# アプリケーション設定
+APP_ENV=local
+APP_DEBUG=false
+APP_NAME=nene2-python
+
+# 認証設定
+# list型フィールドは JSON 配列形式で書く（プレーン文字列は JSONDecodeError になる）
+BEARER_TOKEN_ENABLED=false
+BEARER_TOKENS=[]
+# BEARER_TOKENS=["token-1","token-2"]
+
+API_KEY_ENABLED=false
+API_KEYS=[]
+# API_KEYS=["key-1","key-2"]
+
+# CORS設定
+CORS_ENABLED=false
+CORS_ORIGINS=[]
+# CORS_ORIGINS=["https://example.com","https://app.example.com"]
+
+# データベース設定
+# sqlite: インメモリ（テスト用）
+# DB_ADAPTER=sqlite
+# DB_NAME=:memory:
+
+# sqlite: ファイル永続化
+# DB_ADAPTER=sqlite
+# DB_NAME=data/nene2.db
+
+# MySQL
+# DB_ADAPTER=mysql
+# DB_NAME=nene2
+# DB_HOST=localhost
+# DB_PORT=3306
+# DB_USER=nene2
+# DB_PASSWORD=secret
+
+# デフォルト値
+DB_ADAPTER=sqlite
+DB_NAME=:memory:
+DB_HOST=localhost
+DB_PORT=3306
+DB_USER=
+DB_PASSWORD=

nene2_python-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,44 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.14"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: pytest (with coverage)
+        run: uv run pytest
+
+      - name: mypy
+        run: uv run mypy src/
+
+      - name: ruff check
+        run: uv run ruff check src/ tests/
+
+      - name: ruff format
+        run: uv run ruff format --check src/ tests/
+
+      - name: pip-audit
+        run: uv run pip-audit

nene2_python-1.0.0/.github/workflows/docs.yml

@@ -0,0 +1,55 @@
+name: Docs
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Build Docs
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build VitePress site
+        run: npm run docs:build
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: .vitepress/dist
+
+  deploy:
+    name: Deploy to GitHub Pages
+    needs: build
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy
+        id: deployment
+        uses: actions/deploy-pages@v4

nene2_python-1.0.0/.github/workflows/publish.yml

@@ -0,0 +1,96 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+
+      - name: Build
+        run: uv build
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-testpypi:
+    name: Publish to TestPyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/nene2-python
+    permissions:
+      id-token: write
+    steps:
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to TestPyPI
+        run: uv publish --publish-url https://test.pypi.org/legacy/ --trusted-publishing always
+
+  publish-pypi:
+    name: Publish to PyPI
+    needs: publish-testpypi
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/nene2-python
+    permissions:
+      id-token: write
+    steps:
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        run: uv publish --trusted-publishing always
+
+  github-release:
+    name: Create GitHub Release
+    needs: publish-pypi
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          generate_release_notes: true

nene2_python-1.0.0/.gitignore

@@ -0,0 +1,18 @@
+__pycache__/
+*.py[cod]
+.venv/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+dist/
+*.egg-info/
+*.db
+.env
+.env.local
+.coverage
+data/
+docs/openapi.yaml
+# VitePress
+node_modules/
+.vitepress/cache/
+.vitepress/dist/

nene2_python-1.0.0/.vitepress/config.mts

@@ -0,0 +1,284 @@
+import { defineConfig } from 'vitepress'
+
+function navEn() {
+  return [
+    { text: 'Tutorial',     link: '/tutorials/getting-started', activeMatch: '/tutorials/' },
+    { text: 'How-to',       link: '/how-to/add-new-domain',     activeMatch: '/how-to/' },
+    { text: 'Explanation',  link: '/explanation/architecture',  activeMatch: '/explanation/' },
+    { text: 'Reference',    link: '/reference/configuration',   activeMatch: '/reference/' },
+    {
+      text: 'v1.0.0',
+      items: [
+        { text: 'Changelog',   link: 'https://github.com/hideyukiMORI/nene2-python/blob/main/CHANGELOG.md' },
+        { text: 'Releases',    link: 'https://github.com/hideyukiMORI/nene2-python/releases' },
+        { text: 'PHP NENE2',   link: 'https://hideyukimori.github.io/NENE2/' },
+      ],
+    },
+  ]
+}
+
+function navJa() {
+  return [
+    { text: 'チュートリアル', link: '/ja/tutorials/getting-started', activeMatch: '/ja/tutorials/' },
+    { text: 'ハウツー',       link: '/ja/how-to/add-new-domain',     activeMatch: '/ja/how-to/' },
+    { text: '解説',           link: '/ja/explanation/architecture',  activeMatch: '/ja/explanation/' },
+    { text: 'リファレンス',   link: '/ja/reference/configuration',   activeMatch: '/ja/reference/' },
+    {
+      text: 'v1.0.0',
+      items: [
+        { text: '変更履歴',  link: 'https://github.com/hideyukiMORI/nene2-python/blob/main/CHANGELOG.md' },
+        { text: 'リリース', link: 'https://github.com/hideyukiMORI/nene2-python/releases' },
+        { text: 'PHP NENE2', link: 'https://hideyukimori.github.io/NENE2/' },
+      ],
+    },
+  ]
+}
+
+function sidebarEn() {
+  return {
+    '/tutorials/': [{
+      text: 'Tutorials',
+      items: [
+        { text: 'Getting started',        link: '/tutorials/getting-started' },
+        { text: 'Implement a new domain', link: '/tutorials/first-domain' },
+      ],
+    }],
+    '/how-to/': [{
+      text: 'How-to guides',
+      items: [
+        { text: 'Start a new project',           link: '/how-to/new-project' },
+        { text: 'Add a new domain',              link: '/how-to/add-new-domain' },
+        { text: 'Implement a SQLAlchemy repository', link: '/how-to/sqlalchemy-repository' },
+        { text: 'Configure auth',                link: '/how-to/configure-auth' },
+        { text: 'Set up MCP',                    link: '/howto/mcp-setup' },
+        { text: 'Run tests',                     link: '/how-to/run-tests' },
+      ],
+    }],
+    '/explanation/': [{
+      text: 'Explanation',
+      items: [
+        { text: 'Architecture',      link: '/explanation/architecture' },
+        { text: 'Design philosophy', link: '/explanation/design-philosophy' },
+      ],
+    }, {
+      text: 'ADR',
+      collapsed: true,
+      items: [
+        { text: 'ADR-0001 Toolchain',         link: '/adr/0001-toolchain' },
+        { text: 'ADR-0002 Clean Architecture', link: '/adr/0002-clean-architecture' },
+        { text: 'ADR-0003 Security First',     link: '/adr/0003-security-first' },
+        { text: 'ADR-0004 AI First',           link: '/adr/0004-ai-first-design' },
+        { text: 'ADR-0005 Logging',            link: '/adr/0005-logging' },
+        { text: 'ADR-0006 Rate Limiting',      link: '/adr/0006-rate-limiting' },
+        { text: 'ADR-0009 MCP Design',         link: '/adr/0009-mcp-design' },
+        { text: 'ADR-0010 AsyncUseCase',       link: '/adr/0010-async-use-case' },
+      ],
+    }],
+    '/reference/': [{
+      text: 'Reference',
+      items: [
+        { text: 'Configuration',     link: '/reference/configuration' },
+        { text: 'Framework modules', link: '/reference/framework-modules' },
+        { text: 'REST API',          link: '/reference/api' },
+      ],
+    }],
+    '/adr/': [{
+      text: 'Architecture Decision Records',
+      items: [
+        { text: 'ADR-0001 Toolchain',         link: '/adr/0001-toolchain' },
+        { text: 'ADR-0002 Clean Architecture', link: '/adr/0002-clean-architecture' },
+        { text: 'ADR-0003 Security First',     link: '/adr/0003-security-first' },
+        { text: 'ADR-0004 AI First',           link: '/adr/0004-ai-first-design' },
+        { text: 'ADR-0005 Logging',            link: '/adr/0005-logging' },
+        { text: 'ADR-0006 Rate Limiting',      link: '/adr/0006-rate-limiting' },
+        { text: 'ADR-0009 MCP Design',         link: '/adr/0009-mcp-design' },
+        { text: 'ADR-0010 AsyncUseCase',       link: '/adr/0010-async-use-case' },
+      ],
+    }],
+  }
+}
+
+function sidebarJa() {
+  return {
+    '/ja/tutorials/': [{
+      text: 'チュートリアル',
+      items: [
+        { text: 'はじめての nene2-python', link: '/ja/tutorials/getting-started' },
+        { text: '新しいドメインを実装する', link: '/ja/tutorials/first-domain' },
+      ],
+    }],
+    '/ja/how-to/': [{
+      text: 'ハウツーガイド',
+      items: [
+        { text: '新しいドメインを追加する',            link: '/ja/how-to/add-new-domain' },
+        { text: 'SQLAlchemy リポジトリを実装する',    link: '/ja/how-to/sqlalchemy-repository' },
+        { text: '認証を設定する',                     link: '/ja/how-to/configure-auth' },
+        { text: 'MCP セットアップ',                   link: '/ja/howto/mcp-setup' },
+        { text: 'テストを実行する',                   link: '/ja/how-to/run-tests' },
+      ],
+    }],
+    '/ja/explanation/': [{
+      text: '解説',
+      items: [
+        { text: 'アーキテクチャ概要',        link: '/ja/explanation/architecture' },
+        { text: '設計思想と PHP との対応',   link: '/ja/explanation/design-philosophy' },
+      ],
+    }],
+    '/ja/reference/': [{
+      text: 'リファレンス',
+      items: [
+        { text: '設定リファレンス',             link: '/ja/reference/configuration' },
+        { text: 'フレームワークモジュール',     link: '/ja/reference/framework-modules' },
+        { text: 'REST API',                     link: '/ja/reference/api' },
+      ],
+    }],
+  }
+}
+
+export default defineConfig({
+  title: 'NENE2 Python',
+  description: 'FastAPI + Clean Architecture + MCP. Python 3.12+. AI-ready from day one.',
+  base: process.env.GITHUB_ACTIONS ? '/nene2-python/' : '/',
+  srcDir: './docs',
+  outDir: './.vitepress/dist',
+  cleanUrls: true,
+  ignoreDeadLinks: true,
+
+  head: [
+    ['meta', { name: 'theme-color', content: '#ffd43b' }],
+    ['link', { rel: 'icon', href: 'data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100"><text y=".9em" font-size="90">🐍</text></svg>' }],
+  ],
+
+  locales: {
+    root: {
+      label: 'English',
+      lang: 'en',
+      themeConfig: {
+        nav: navEn(),
+        sidebar: sidebarEn(),
+        editLink: {
+          pattern: 'https://github.com/hideyukiMORI/nene2-python/edit/main/docs/:path',
+          text: 'Edit this page on GitHub',
+        },
+        footer: {
+          message: 'Released under the MIT License.',
+          copyright: 'Copyright © 2026 hideyukiMORI',
+        },
+      },
+    },
+    ja: {
+      label: '日本語',
+      lang: 'ja',
+      themeConfig: {
+        nav: navJa(),
+        sidebar: sidebarJa(),
+        editLink: {
+          pattern: 'https://github.com/hideyukiMORI/nene2-python/edit/main/docs/:path',
+          text: 'GitHub でこのページを編集',
+        },
+        footer: {
+          message: 'MIT ライセンスの下でリリースされています。',
+          copyright: 'Copyright © 2026 hideyukiMORI',
+        },
+      },
+    },
+    fr: {
+      label: 'Français',
+      lang: 'fr',
+      themeConfig: {
+        nav: [
+          { text: 'Tutoriel',   link: '/fr/tutorials/getting-started' },
+          { text: 'v1.0.0',     items: [{ text: 'Releases', link: 'https://github.com/hideyukiMORI/nene2-python/releases' }] },
+        ],
+        sidebar: {
+          '/fr/': [{ text: 'Tutoriels', items: [{ text: 'Premiers pas', link: '/fr/tutorials/getting-started' }] }],
+        },
+        editLink: {
+          pattern: 'https://github.com/hideyukiMORI/nene2-python/edit/main/docs/:path',
+          text: 'Éditer cette page sur GitHub',
+        },
+        footer: {
+          message: 'Publié sous la licence MIT.',
+          copyright: 'Copyright © 2026 hideyukiMORI',
+        },
+      },
+    },
+    zh: {
+      label: '简体中文',
+      lang: 'zh-CN',
+      themeConfig: {
+        nav: [
+          { text: '教程',   link: '/zh/tutorials/getting-started' },
+          { text: 'v1.0.0', items: [{ text: 'Releases', link: 'https://github.com/hideyukiMORI/nene2-python/releases' }] },
+        ],
+        sidebar: {
+          '/zh/': [{ text: '教程', items: [{ text: '快速开始', link: '/zh/tutorials/getting-started' }] }],
+        },
+        editLink: {
+          pattern: 'https://github.com/hideyukiMORI/nene2-python/edit/main/docs/:path',
+          text: '在 GitHub 上编辑此页面',
+        },
+        footer: {
+          message: '根据 MIT 许可证发布。',
+          copyright: 'Copyright © 2026 hideyukiMORI',
+        },
+      },
+    },
+    'pt-br': {
+      label: 'Português (Brasil)',
+      lang: 'pt-BR',
+      themeConfig: {
+        nav: [
+          { text: 'Tutorial', link: '/pt-br/tutorials/getting-started' },
+          { text: 'v1.0.0',   items: [{ text: 'Releases', link: 'https://github.com/hideyukiMORI/nene2-python/releases' }] },
+        ],
+        sidebar: {
+          '/pt-br/': [{ text: 'Tutoriais', items: [{ text: 'Primeiros passos', link: '/pt-br/tutorials/getting-started' }] }],
+        },
+        editLink: {
+          pattern: 'https://github.com/hideyukiMORI/nene2-python/edit/main/docs/:path',
+          text: 'Editar esta página no GitHub',
+        },
+        footer: {
+          message: 'Lançado sob a Licença MIT.',
+          copyright: 'Copyright © 2026 hideyukiMORI',
+        },
+      },
+    },
+    de: {
+      label: 'Deutsch',
+      lang: 'de',
+      themeConfig: {
+        nav: [
+          { text: 'Tutorial', link: '/de/tutorials/getting-started' },
+          { text: 'v1.0.0',   items: [{ text: 'Releases', link: 'https://github.com/hideyukiMORI/nene2-python/releases' }] },
+        ],
+        sidebar: {
+          '/de/': [{ text: 'Tutorials', items: [{ text: 'Erste Schritte', link: '/de/tutorials/getting-started' }] }],
+        },
+        editLink: {
+          pattern: 'https://github.com/hideyukiMORI/nene2-python/edit/main/docs/:path',
+          text: 'Diese Seite auf GitHub bearbeiten',
+        },
+        footer: {
+          message: 'Veröffentlicht unter der MIT-Lizenz.',
+          copyright: 'Copyright © 2026 hideyukiMORI',
+        },
+      },
+    },
+  },
+
+  themeConfig: {
+    siteTitle: '🐍 NENE2',
+    socialLinks: [
+      { icon: 'github', link: 'https://github.com/hideyukiMORI/nene2-python' },
+    ],
+    search: { provider: 'local' },
+    outline: { level: [2, 3] },
+  },
+
+  markdown: {
+    theme: { light: 'github-light', dark: 'one-dark-pro' },
+    lineNumbers: true,
+  },
+})