https://github.com/yeongseon/azure-functions-doctor-python
Pre-deploy diagnostic CLI for Azure Functions Python v2 — Part of the Azure Functions Python DX Toolkit
https://github.com/yeongseon/azure-functions-doctor-python
azure azure-functions cli diagnostics dx-toolkit python serverless
Last synced: about 2 months ago
JSON representation
Pre-deploy diagnostic CLI for Azure Functions Python v2 — Part of the Azure Functions Python DX Toolkit
- Host: GitHub
- URL: https://github.com/yeongseon/azure-functions-doctor-python
- Owner: yeongseon
- License: mit
- Created: 2025-05-26T05:43:53.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-04-26T12:24:02.000Z (about 2 months ago)
- Last Synced: 2026-04-26T13:12:32.076Z (about 2 months ago)
- Topics: azure, azure-functions, cli, diagnostics, dx-toolkit, python, serverless
- Language: Python
- Homepage: https://yeongseon.github.io/azure-functions-doctor-python/
- Size: 45.8 MB
- Stars: 19
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.ja.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Support: SUPPORT.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Azure Functions Doctor
[](https://pypi.org/project/azure-functions-doctor/)
[](https://pypi.org/project/azure-functions-doctor/)
[](https://github.com/yeongseon/azure-functions-doctor/actions/workflows/ci-test.yml)
[](https://github.com/yeongseon/azure-functions-doctor/actions/workflows/release.yml)
[](https://github.com/yeongseon/azure-functions-doctor/actions/workflows/security.yml)
[](https://codecov.io/gh/yeongseon/azure-functions-doctor)
[](https://pre-commit.com/)
[](https://yeongseon.github.io/azure-functions-doctor/)
[](LICENSE)
他の言語: [English](README.md) | [한국어](README.ko.md) | [简体中文](README.zh-CN.md)
Azure Functions Doctor は、**Azure Functions Python v2 プログラミングモデル**で構築されたプロジェクトのための診断 CLI ツールです。
このツールは、ローカルプロジェクトにおける以下のような一般的な問題をチェックします：
- サポートされていない Python バージョン
- `host.json` または `requirements.txt` の欠如
- `azure-functions` 依存関係の欠如
- 仮想環境（virtual environments）の欠如
- Azure Functions Core Tools の欠如
- 不完全なローカル開発環境のセットアップ
## Why Use It
Azure Functions Python プロジェクトのセットアップには、複数の設定ファイル、依存関係、ツールが必要です。いずれか一つでも欠けると、分かりにくいランタイムエラーが発生します。`azure-functions-doctor` は厳選されたルールセットに基づいてプロジェクトをチェックし、問題が本番環境に到達する前に報告します。
## Scope
このリポジトリは、デコレータベースの Azure Functions Python v2 プログラミングモデルのみを対象としています。
- サポートされているモデル: `@app.route()` などのデコレータを使用した `func.FunctionApp()`
- サポートされていないモデル: 従来の `function.json` ベースの Python v1 プロジェクト
## Installation
PyPI からインストール：
```bash
pip install azure-functions-doctor
```
ソースからインストール：
```bash
git clone https://github.com/yeongseon/azure-functions-doctor.git
cd azure-functions-doctor
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
```
## Quick Start
現在のプロジェクトで doctor を実行：
```bash
azure-functions doctor
```
特定のプロジェクトパスを指定して実行：
```bash
azure-functions doctor --path ./examples/v2/http-trigger
```
必須項目のみをチェックするプロファイルを使用：
```bash
azure-functions doctor --profile minimal
```
CI 用に JSON 形式で出力：
```bash
azure-functions doctor --format json
```
## Demo
以下のデモは、VHS を使用して [`demo/doctor-demo.tape`](demo/doctor-demo.tape) から生成されました。
代表的なサンプルプロジェクトと、意図的にエラーを発生させたコピーに対して実際の `azure-functions doctor` CLI を実行し、成功と失敗の対比を示しています。
最終的なターミナルの状態は、素早く確認できるように静止画像としてもキャプチャされています。
## Features
デフォルトのルールセットは以下を検証します：
- Azure Functions Python v2 デコレータの使用
- Python バージョン
- 仮想環境の有効化
- Python 実行ファイルの利用可能性
- `requirements.txt`
- `azure-functions` 依存関係の宣言
- `host.json`
- `local.settings.json`（オプション）
- Azure Functions Core Tools の存在とバージョン（オプション）
- Durable Functions ホスト設定（オプション）
- Application Insights 設定（オプション）
- `extensionBundle` 設定（オプション）
- ASGI/WSGI callable の公開（オプション）
- プロジェクトツリー内の一般的な不要ファイル（オプション）
## Examples
- [examples/v2/http-trigger/README.md](examples/v2/http-trigger/README.md)
- [examples/v2/multi-trigger/README.md](examples/v2/multi-trigger/README.md)
## Requirements
- Python 3.10+
- 開発ワークフローのための Hatch
- ローカル実行のために Azure Functions Core Tools v4+ を推奨
## Documentation
- [docs/index.md](docs/index.md)
- [docs/usage.md](docs/usage.md)
- [docs/rules.md](docs/rules.md)
- [docs/diagnostics.md](docs/diagnostics.md)
- [docs/development.md](docs/development.md)
## Ecosystem
- [azure-functions-validation](https://github.com/yeongseon/azure-functions-validation) — リクエストとレスポンスのバリデーション
- [azure-functions-openapi](https://github.com/yeongseon/azure-functions-openapi) — OpenAPI と Swagger UI
- [azure-functions-langgraph](https://github.com/yeongseon/azure-functions-langgraph) — LangGraph デプロイアダプター
- [azure-functions-logging](https://github.com/yeongseon/azure-functions-logging) — 構造化ロギング
- [azure-functions-scaffold](https://github.com/yeongseon/azure-functions-scaffold) — プロジェクトスキャフォールディング
- [azure-functions-durable-graph](https://github.com/yeongseon/azure-functions-durable-graph) — Durable Functions ベースのグラフランタイム *(計画中)*
- [azure-functions-python-cookbook](https://github.com/yeongseon/azure-functions-python-cookbook) — レシピとサンプル
## Disclaimer
このプロジェクトは独立したコミュニティプロジェクトであり、Microsoft と提携・承認・保守関係にはありません。
Azure および Azure Functions は Microsoft Corporation の商標です。
## License
MIT