genflux-python-sdk/Makefile at main · elith-co-jp/genflux-python-sdk · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
.PHONY: help docs docs-fresh docs-external docs-developer docs-check llms-txt llms-check lint test format

help: ## ヘルプを表示
	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'

# ---------------------------------------------------------------------------
# ドキュメント生成
# ---------------------------------------------------------------------------

docs: ## API Reference を全て生成（3-pass LLM改善: 改善→ハルシネーションチェック→UXレビュー）
	python scripts/generate_api_reference.py --mode all
	@echo ""
	@echo "📖 Generated (LLM-enriched):"
	@echo "   docs/API_REFERENCE.md           (External / SDKユーザー向け)"
	@echo "   docs/DEVELOPER_API_REFERENCE.md (Developer / 開発者向け)"

docs-fresh: ## API Reference を生成（キャッシュなし）
	python scripts/generate_api_reference.py --mode all --no-cache

docs-external: ## External API Reference のみ生成
	python scripts/generate_api_reference.py --mode external

docs-developer: ## Developer API Reference のみ生成
	python scripts/generate_api_reference.py --mode developer

docs-check: ## API Reference の差分チェック（CI用）
	python scripts/generate_api_reference.py --mode all --check

# ---------------------------------------------------------------------------
# LLM ガイド生成
# ---------------------------------------------------------------------------

llms-txt: ## llms.txt / llms-full.txt を生成
	python scripts/generate_llms_txt.py
	@echo ""
	@echo "📖 Generated:"
	@echo "   llms.txt          (LLM向け簡潔版)"
	@echo "   llms-full.txt     (LLM向け詳細版)"

llms-check: ## llms.txt の差分チェック（CI用）
	python scripts/generate_llms_txt.py --check

# ---------------------------------------------------------------------------
# コード品質
# ---------------------------------------------------------------------------

lint: ## Lint チェック（ruff + pyright）
	ruff check src/ tests/ scripts/
	pyright src/

format: ## コードフォーマット（ruff）
	ruff format src/ tests/ scripts/
	ruff check --fix src/ tests/ scripts/

test: ## テスト実行（pytest）
	pytest tests/ -v

# ---------------------------------------------------------------------------
# 開発
# ---------------------------------------------------------------------------

install: ## 開発依存関係のインストール
	uv sync --group dev

build: ## パッケージビルド
	python -m build