uv workspacesとpluggyで作る，プラッガブルなPythonエコシステム

2025-04-29T00:00:00+00:00

uv workspacesでスッキリ作るPythonモノレポ</a>では，uv workspacesを使ったモノレポ構成について書いた。この記事はその続編で，モノレポに pluggy</a>を組み合わせて，プラッガブルなPythonエコシステムを作っていく。

この記事で実現したいこと
https://docs.astral.sh/uv/concepts/projects/workspaces/#when-not-to-use-workspaces</a>
プラグインシステムとpluggy
pluggy</a>は，pytestで使われているプラグイン管理ツールで，インタフェースとその拡張ないし実装（プラグイン）を仲介してくれる。拡張を使うアプリケーション（ホストプログラム）は，インタフェースとプラグインマネージャー（後述）だけ知っていれば良い。アプリケーション側を変更せずとも，拡張ライブラリをホストプログラムと同じ環境にpip install</code>するだけで呼べるようになる。
`この記事では，前回作ったモノレポにpluggyを導入して，CLIアプリケーションから拡張ライブラリへの依存を剥がし，ドロップイン方式で拡張ライブラリが実行できるようにしていく。 `
toy projectのサンプルコード</a> </h1> https://github.com/mocobeta/uv-workspaces-eggdishes</a> pluggy入門</a> </h1> pluggyの使い方は少し込み入っていて，公式リファレンスを読んでもとっつきづらいため，実際に自分のプロジェクトに導入しながら手を動かすほうが理解がすすむ。 ということで早速やっていく。 pluggyのインストール</a> </h2> EggDish</code>インタフェースの定義があるコアライブラリにpluggyをインストールする（他のパッケージは，コアライブラリ経由でpluggyの機能が使えるため，インストール不要）。 $ uv add --package eggdishes-core pluggy</code></pre>スペック定義と実装マーカーの公開</a> </h2> プラグインのスペック（仕様）と，その実装を示すマーカーをコアライブラリのhookspecs.py</code>（ファイル名はなんでも良い）に定義する。 # eggdishes-core/src/eggdishes_core/hookspecs.py import pluggy # プラグイン仕様を示すマーカー hookspec = pluggy.HookspecMarker("eggdishes") # プラグイン実装を示すマーカー hookimpl = pluggy.HookimplMarker("eggdishes") # プラグインが実装するべきメソッドインタフェース @hookspec def register_eggdish(recipes): """Register egg dish recipe.""" pass</code></pre> init.py</code> で実装マーカーを公開しておくと，プラグイン側から使いやすい。 # eggdishes-core/src/eggdishes_core/init.py from .hookspecs import hookimpl</code></pre>プラグインマネージャーを書く</a> </h2> プラグインのスペックと実装をつなぐPluginManagerのコードを，同じくコアライブラリに追加する。pluggyを使う上で，たぶんここが一番ややこしいので，細かくコメントをつけてみた。 (2025/5/5 更新) # eggdishes-core/src/eggdishes_core/plugins.py from .lib import EggDish from . import hookspecs from . import fresh_egg import pluggy # EggDish のレジストリ # プラグイン名と，対応する実装クラスのファクトリメソッドを管理する recipes = {} def get_plugin_manager(): # プラグインマネージャーを取得 pm = pluggy.PluginManager("eggdishes") # hookspec(プラグインのインターフェース)を登録 pm.add_hookspecs(hookspecs) # 環境内のプラグインをロード # このentry point名をプラグイン側のpyproject.tomlのentry pointと一致させることで，プラグインとして認識される pm.load_setuptools_entrypoints("eggdishes") # fresh_eggの実装はeggdishes_core自身で定義されているので，明示的に登録する pm.register(fresh_egg) return pm def register_eggdishes(): """Register available recipes to the registry.""" pm = __get_plugin_manager() # 環境内のすべてのプラグインフックを呼び出す pm.hook.register_eggdish(recipes=__recipes) def get_available_recipes(): """Return a list of available egg dish recipes.""" return __recipes.keys() def get_recipe(name) -> EggDish | None: """Return the recipe for the given egg dish name.""" recipe = __recipes.get(name) if recipe: return recipe() return None</code></pre>プラグインを書く</a> </h2> コアライブラリ内で定義したデフォルト実装FreshEgg</code>をプラグインとして登録する。 # eggdishes-core/src/eggdishes_core/fresh_egg.py from .lib import EggDish import eggdishes_core class FreshEgg(EggDish): name = "採れたて卵" def recipe(self): return "ご飯に新鮮な卵とかつお節をのせて、醤油をかけて召し上がれ！" # プラグイン実装 @eggdishes_core.hookimpl def register_eggdish(recipes): def create(): return FreshEgg() recipes["fresh"] = create</code></pre> ここまででpluggyの使い方の説明がだいたい終わったのだけれど，おわかりいただけただろうか...。初見でぱっとわかるかというと正直厳しいと思う（私はわかったと言えるまでに数時間はかかった）が，スペック定義，プラグインマネージャー，プラグイン実装のコードを突き合わせて追いかけると，頭が整理できてくると思う。 アプリケーション（ホストプログラム）の変更</a> </h2> CLIツール(eggdishes-main</code>)のほうにも手を入れて，拡張クラスへの依存をすべて剥がし，コアライブラリが提供するプラグインシステムを使うように変更する。また，環境内で利用可能なプラグインをリストするlist</code>コマンドを追加する。 $ cat eggdishes-main/pyproject.toml [project] ... dependencies = ["click>=8.1.8", "eggdishes-core"]</code></pre># eggdishes-main/src/eggdishes_main/cli.py import click from eggdishes_core.plugins import register_eggdishes, get_available_recipes, get_recipe @click.group() def cli(): pass @cli.command( "list", help="List available egg dish recipes." ) def list_recipes(): register_eggdishes() available_recipes = get_available_recipes() click.echo("Available egg dish recipes:") for recipe in available_recipes: click.echo(f"- {recipe}") @cli.command( "recipe", help="Show the recipe for an egg dish." ) @click.argument( "dish", type=str, default="fresh", ) def show_recipe(dish: str): register_eggdishes() recipe = get_recipe(dish) if recipe: click.echo(f"Recipe for {recipe.name}:") click.echo(recipe.recipe()) else: click.echo(f"No recipe found for {dish}.")</code></pre> 前の記事での完成形だったバージョン0.2.0</code> の eggdishes-main/pyproject.toml</code></a>, eggdishes-main/src/eggdishes_main/cli.py</code></a> と比較すると違いがわかりやすいと思う。 dependency graphも確認しておく。 $ uv tree Resolved 14 packages in 68ms eggdishes v0.4.0 ├── pyright v1.1.400 (group: dev) │ ├── nodeenv v1.9.1 │ └── typing-extensions v4.13.2 └── ruff v0.11.7 (group: dev) eggdishes-boiled v0.4.0 └── eggdishes-core v0.4.0 └── pluggy v1.5.0 eggdishes-main v0.4.0 ├── click v8.1.8 └── eggdishes-core v0.4.0 () eggdishes-poached v0.4.0 └── eggdishes-core v0.4.0 () eggdishes-scrambled v0.4.0 └── eggdishes-core v0.4.0 () eggdishes-sunnysideup v0.4.0 └── eggdishes-core v0.4.0 ()</code></pre>動作確認</a> </h2> ここまでで，動作を一度確認する。プラグインはコアに含まれるFreshEgg</code>しか登録されていない。 $ uv sync --package eggdishes-main $ uv run eggdishes list Available egg dish recipes: - fresh $ uv run eggdishes recipe fresh Recipe for 採れたて卵: ご飯に新鮮な卵とかつお節をのせて、醤油をかけて召し上がれ！ $ uv run eggdishes recipe spam No recipe found for spam.</code></pre>pluggy実践編（プラグイン追加）</a> </h1> ここからは，拡張ライブラリ（eggdishes-</code>）を全部プラグイン化していく。デフォルト実装FreshEgg</code>をプラグイン化したのと同じように，拡張コード内にhookimpl</code>マーカーをつけた実装を追加するだけ。たとえばBoiledEgg</code>の場合： from eggdishes_core.lib import EggDish import eggdishes_core class BoiledEgg(EggDish): name = "Boiled Egg" def recipe(self): # snip @eggdishes_core.hookimpl def register_eggdish(recipes): def create(): return BoiledEgg() recipes["boiled"] = create</code></pre> また，このパッケージがプラグインであることをプラグインマネージャーに通知するために，pyproject.toml</code>に以下2行を追加する。 $ cat eggdishes-boiled/pyproject.toml ... # プラグインのentry pointを登録 [project.entry-points."eggdishes"] "boiled" = "eggdishes_boiled.boiled_egg"</code></pre> プラグインパッケージ側の変更は以上。 動作確認（プラグイン全部入り版）</a> </h2> すべての拡張ライブラリパッケージを同じ要領でプラグイン化したら，パッケージをビルドして動作確認する。 $ uv build --all-packages</code></pre> ドロップインでプラグインが動作するかは実際にpip install</code>してみないと確認できないので，適当な環境を作ってwheelをインストールする。 $ mkdir -p ~/temp/eggdishes-test $ cd ~/temp/eggdishes-test $ python -m venv .venv $ . .venv/bin/activate $ pip install <path-to-eggdishes-repo>/dist/.whl</code></pre> こんな感じで，インストールしたプラグインが全て認識されるはず。 $ eggdishes list Available egg dish recipes: - fresh - sunnysideup - poached - boiled - scrambled $ eggdishes recipe sunnysideup Recipe for Sunny Side Up Egg: 1. フライパンを温める 中火でフライパンを軽く温め、油かバターを入れて広げます。 2. 卵をそっと割り入れる 黄身が割れないように優しく！できれば小さい器に一度割ってからフライパンへ流し込むと安心。 3. 弱火にして水を加える 卵の白身が広がったら、すぐに火を弱火にしてフライパンの端から水を加えます。 4. すぐふたをする 加えた水が蒸気になって卵を包み込みます。ふたをして、約1〜2分蒸し焼きに。 5. 様子を見ながら火を止める 白身が固まって、黄身がまだぷるんぷるんしていたらOK！ 早めに火を止めて余熱で少しだけ火を通すと、絶妙な半熟に仕上がります。 6. 塩・こしょうで味付けする 完成！</code></pre> ここまでのコードは0.5.0</a>としてタグを打っているので，全体感はこのタグのソースツリーを参照してほしい。 まとめ</a> </h1> uv workspacesとpluggyを使うと， 関連する複数パッケージをモノレポで管理する</li> 粗結合・プラッガブルなアプリケーションフレームワークを作る</li> </ol> ことができた。 プラグインのコードはもちろん，モノレポ内で管理されていなくても良い。「フレームワークとデフォルトプラグインをコア開発者が提供して，他の開発者が自作プラグインを作って公開できる」というようなエコシステムまで視野に入れると，このスキームの威力が発揮される。

uv workspacesでスッキリ作るPythonモノレポ

2025-04-27T00:00:00+00:00

この記事で言いたいこと
イントロダクション </a> </h1>
uv</a>。
uvには，workspaces</a>という，マルチパッケージをサポートするための機能がある。Cargoにある同名の機能</a>からインスパイアされたもので，Rustを使っている人には馴染み深いコンセプトだろう。
これまで，Pythonでモノレポ構成を作るための，これといって決め手となるソリューションはなかったように思う。Bazelは小規模プロジェクトで使うには正直とっつきづらく，Poetryでも頑張ればできると思うのだけれど，Poetryそのものはマルチパッケージ構成をサポートしていないためdependency groupを駆使するなどしなければならず，一筋縄ではいかない。
uvのworkspacesならRust(Cargo)のようにスッキリとモノレポ管理ができるのでは，と思って試したところ，いい感じにできそうだったので，少し詳細に手順と構成をまとめておく。 
要件（実現したいこと）
サンプルコード</a> </h1> workspacesの説明をするためのtoy projectを用意した。 コードは mocobeta/uv-workspaces-eggdishes</a> に置いてある。 機能とパッケージ構成</a> </h2> サンプルコードの機能と構成はこんな感じ。 卵料理のレシピを教えてくれるCLIツール</li> 拡張性のため，複数の卵料理のレシピと，CLIアプリケーションを個別パッケージで管理するコアライブラリパッケージ(eggdishes-core</code>)にベースクラスEggDish</code>とそのデフォルト実装FreshEgg</code>を配置</li> いくつかの拡張ライブラリパッケージ(eggdishes-</code>)にEggDish</code>のサブクラス（例: BoiledEgg</code>）を配置して，コアライブラリとは独立して管理する</li> アプリケーションパッケージ(eggdishes-main</code>)にCLIのコードを配置</li> </ul> </li> アプリケーションパッケージから，コアライブラリとその拡張ライブラリのクラスを呼べる</li> </ul> toy projectなのでかなり簡略化しているけれど，現実のプロジェクトでもよくある構成を想定している。 Getting Started</a> </h1> 早速リポジトリを作っていく。最初にコアライブラリとアプリケーションの2つのサブパッケージを用意して，workspacesの基本的な使い方を確認してから，そのあとで拡張パッケージを追加していく。 プロジェクトの初期化</a> </h2> ルートプロジェクト（ルートパッケージ）を作って，その下にサブパッケージを作る。 $ mkdir eggdishes $ cd eggdishes $ uv init --bare # ルートパッケージの初期化. bareで作っておく. $ uv init --package eggdishes-core --lib # ライブラリパッケージをworkspacesのメンバーとして追加 $ uv init --package eggdishes-main --app # アプリケーションパッケージをworkspacesのメンバーとして追加</code></pre> コマンドから想像できる通り，init</code>する時に与える--package</code>オプションが，workspacesを構成する「パッケージ」を指定するオプションで，パッケージを指定して操作する時は必ずこのオプションを与える。 この時点で，ディレクトリ構成はこうなっている。（uvバージョンは0.5.29） $ tree . ├── eggdishes-core │ ├── pyproject.toml │ ├── README.md │ └── src │ └── eggdishes_core │ ├── init.py │ └── py.typed ├── eggdishes-main │ ├── pyproject.toml │ ├── README.md │ └── src │ └── eggdishes_main │ └── init.py ├── pyproject.toml └── uv.lock</code></pre> ルートディレクトリ直下のpyproject.toml</code>, eggdishes-core/pyproject.toml</code>, egggdishes-main/pyproject.toml</code>の3つのパッケージ設定ファイルができている。 サブパッケージに依存関係を追加する</a> </h2> 3rd partyの依存を追加 eggdishes-main</code>はCLIアプリケーションの想定なので，click</a>を依存に追加する。 # eggdishes-mainパッケージにclickへの依存を追加 $ uv add --package eggdishes-main click</code></pre> パッケージ間の依存関係の追加 eggdishes-main</code>からeggdishes-core</code>のコードを呼べるようにするため，パッケージ間の依存関係を追加する。そのためのコマンドはないのでeggdishes-main/pyproject.toml</code>を直接編集する。 $ vi eggdishes-main/pyproject.toml [project] ... dependencies = ["click>=8.1.8", "eggdishes-core"] # dependencyにeggdishes-coreを追加 ... [tool.uv.sources] eggdishes-core = { workspace = true } # eggdishes-coreがworkspacesで管理されるメンバーであることを示す</code></pre> この段階で，3つのpyproject.toml</code>はこんな感じになる（一部不要なプロパティを削除したり，編集している）。 # ルートパッケージの設定 $ cat ./pyproject.toml [project] name = "eggdishes" version = "0.1.0" description = "Egg Recipe CLI" requires-python = ">=3.13" dependencies = [] [tool.uv.workspace] members = ["eggdishes-core", "eggdishes-main"] # workspaceのメンバー定義 # eggdishes-coreパッケージの設定 $ cat eggdishes-core/pyproject.toml [project] name = "eggdishes-core" version = "0.1.0" description = "core module for eggdishes" readme = "README.md" dependencies = [] [build-system] requires = ["hatchling"] build-backend = "hatchling.build" # eggdishes-mainパッケージの設定 $ cat eggdishes-main/pyproject.toml [project] name = "eggdishes-main" version = "0.1.0" description = "application module for eggdishes" readme = "README.md" dependencies = ["click>=8.1.8", "eggdishes-core"] [project.scripts] eggdishes = "eggdishes_main:main" # CLIコマンド eggdishes を定義 [build-system] requires = ["hatchling"] build-backend = "hatchling.build"</code></pre> 大事なことは，各パッケージはそれぞれでdependency graphを管理できるということ。 ただし，プロジェクト全体では1つのlockfileしか持たないため，全体として整合している必要があり，パッケージ間でコンフリクトする依存関係は書けない。 In a workspace, each package defines its own pyproject.toml, but the workspace shares a single lockfile, ensuring that the workspace operates with a consistent set of dependencies. </blockquote> https://docs.astral.sh/uv/concepts/projects/workspaces/</a> この制約があることで，個人的にはモノレポが満たしていてほしい性質が担保される（依存関係がコンフリクトしているモノレポは管理がつらいし，そもそもモノレポ管理の必要性が疑わしい気がする）。 なお，ここではルートパッケージでPythonバージョンを>=3.13</code>で統一しているが，required-python</code>はサブパッケージごとに定義できるため，パッケージごとに異なるPythonバージョンを指定することもできる。モノレポ内で，違うPythonバージョンはあまり使いたくないけれど，やむにやまれぬ事情でどうしてもパッケージごとに異なるPythonバージョンを指定したい時はあるかもしれない。 dependency graphの確認</a> </h2> ここまでで，まだアプリケーションコードは1行も書いていないけれど基本となるプロジェクト構成が整ったので，tree</code>, sync</code> コマンドでdependency graphを確認しておく。 $ uv tree Resolved 5 packages in 1ms eggdishes v0.1.0 eggdishes-main v0.1.0 ├── click v8.1.8 └── eggdishes-core v0.1.0</code></pre> 想定通りの依存グラフができている。 sync</code>コマンドの動作も確認しておく。sync</code>は，手元のPython環境をpyproject.toml</code>と一致させるコマンドだが，ここでは3つのパッケージがあるため，--package</code>オプションを指定することで環境の切り替えができる。 # eggdishesパッケージ(root)とsync $ uv sync $ uv pip freeze # 依存ライブラリなし # eggdishes-coreパッケージとsync $ uv sync --package eggdishes-core $ uv pip freeze -e file:///home/moco/repo/eggdishes/eggdishes-core # eggdishes-mainパッケージとsync $ uv sync --package eggdishes-main $ uv pip freeze click==8.1.8 -e file:///home/moco/repo/eggdishes/eggdishes-core -e file:///home/moco/repo/eggdishes/eggdishes-main</code></pre> tree</code>コマンドの結果と整合している。 アプリのコードを書く</a> </h2> まずはコアライブラリのコードを書いていく。 # eggdishes-core/src/eggdishes_core/lib.py from abc import ABC, abstractmethod class EggDish(ABC): name: str @abstractmethod def recipe(self) -> str: """Return the recipe for the egg dish.""" pass # eggdishes-core/src/eggdishes_core/fresh_egg.py from .lib import EggDish class FreshEgg(EggDish): name = "採れたて卵" def recipe(self): return "ご飯に新鮮な卵とかつお節をのせて、醤油をかけて召し上がれ！"</code></pre> コードの内容自体はまったく重要ではないのだけど，EggDish</code>という抽象クラスと，それを拡張したFreshEgg</code>というデフォルト実装クラスがある。recipe()</code>メソッドの実装によって振る舞いが変わる。 CLIアプリのほうはこんな感じで。 # eggdishes-main/src/eggdishes_main/init.py from .cli import cli # エントリーポイントとなるmainメソッド def main() -> None: cli() # eggdishes-main/src/eggdishes_main/cli.py import click from eggdishes_core.fresh_egg import FreshEgg @click.group() def cli(): pass # recipe コマンドで，FreshEgg.recipe()の内容を表示する @cli.command( "recipe", help="Show the recipe for an egg dish." ) def show_recipe(): """Show the recipe for a fresh egg dish.""" egg_dish = FreshEgg() click.echo(f"Recipe for {egg_dish.name}:") click.echo(egg_dish.recipe())</code></pre>1stバージョンが完成</a> </h2> ここまでで，1stバージョンのアプリが動作するようになる。 uv run eggdishes recipe</code>でテスト実行する。CLIコマンドeggdishes</code>はeggdishes-main</code>で定義しているので，sync</code>でeggdishes-main</code>とsyncしておくのを忘れないように。 $ uv sync --package eggdishes-main $ uv run eggdishes recipe Recipe for 採れたて卵: ご飯に新鮮な卵とかつお節をのせて、醤油をかけて召し上がれ！</code></pre> なおここまでのスナップショットを0.1.0</a>としてタグを打っておいたので，全体が見たい場合はこのタグのソースツリーを参照してほしい。 プロジェクトを拡張する</a> </h1> ここまででworkspacesの基本の説明が終わったので，ここからは，いろんな卵料理のレシピを追加するための拡張ライブラリを書いていく。 サブパッケージを追加する</a> </h2> スクランブルエッグ(eggdishes-scrambled</code>)，目玉焼き(eggdishes-sunnysideup</code>)，ポーチドエッグ(eggdishes-poached</code>)，ゆで卵(eggdishes-boiled</code>)の4つの拡張パッケージを追加する。 $ uv init --package eggdishes-scrambled --lib $ uv init --package eggdishes-sunnysideup --lib $ uv init --package eggdishes-poached --lib $ uv init --package eggdishes-boiled --lib $ tree -L2 . ├── eggdishes-boiled │ ├── pyproject.toml │ ├── README.md │ └── src ├── eggdishes-core │ ├── pyproject.toml │ ├── README.md │ └── src ├── eggdishes-main │ ├── pyproject.toml │ ├── README.md │ └── src ├── eggdishes-poached │ ├── pyproject.toml │ ├── README.md │ └── src ├── eggdishes-scrambled │ ├── pyproject.toml │ ├── README.md │ └── src ├── eggdishes-sunnysideup │ ├── pyproject.toml │ ├── README.md │ └── src ├── pyproject.toml ├── README.md └── uv.lock # workspacesのメンバーに，新規作成したパッケージが追加されている $ cat ./pyproject.toml ... [tool.uv.workspace] members = [ "eggdishes-core", "eggdishes-main", "eggdishes-scrambled", "eggdishes-sunnysideup", "eggdishes-poached", "eggdishes-boiled", ]</code></pre>サブパッケージの依存関係を更新</a> </h2> eggdishes-boiled</code>はeggdishes-core</code>に依存するので，依存関係を追加する。 $ vi eggdishes-boiled/pyproject.toml [project] ... dependencies = ["eggdishes-core"] [tool.uv.sources] eggdishes-core = { workspace = true }</code></pre> その他の拡張パッケージも同様。 また，eggdishes-main</code>はすべての拡張パッケージを呼び出すため，eggdishes-main/pyproject.toml</code>に以下を追加。 $ vi eggdishes-main/pyproject.toml [project] ... dependencies = [ "click>=8.1.8", "eggdishes-core", "eggdishes-boiled", "eggdishes-poached", "eggdishes-scrambled", "eggdishes-sunnysideup", ] [tool.uv.sources] eggdishes-core = { workspace = true } eggdishes-boiled = { workspace = true } eggdishes-poached = { workspace = true } eggdishes-scrambled = { workspace = true } eggdishes-sunnysideup = { workspace = true }</code></pre>拡張ライブラリパッケージのコード例</a> </h2> 拡張ライブラリに追加するファイルは1つだけで，EggDish</code>のサブクラスを生やす。 # eggdishes-boiled/src/eggdishes_boiled/boiled_egg.py from eggdishes_core.lib import EggDish class BoiledEgg(EggDish): name = "Boiled Egg" def recipe(self): return """ 1. 卵を常温に戻す 冷蔵庫から出したばかりの卵はヒビが入りやすいので、10〜20分ほど室温に置きます。 2. 鍋に卵を並べる 卵同士がぶつからないように注意しながら鍋に並べます。 3. 水を入れる 卵がしっかり浸るくらいまで水を注ぎます。 4. 火にかける 中火で加熱し、沸騰させます。 5. 茹で時間を調整する 沸騰したらタイマーをセット！お好みの仕上がりに合わせて茹で時間を変えます。 - 半熟（とろとろ）：6〜7分 - 半熟（ねっとり）：8〜9分 - 固ゆで（しっかり）：10〜12分 6. 冷水にとる 茹で上がったらすぐに冷水（または氷水）に移して冷やします。殻がむきやすくなります。 完成！ """</code></pre> のような感じで，他の拡張パッケージについても，同様にEggDish</code>の実装クラスをそれぞれ生やしておく。 CLIアプリケーションのほうは，追加した拡張をインポートして，recipe</code>コマンドの引数に応じて挙動が切り替えられるようにする。 # eggdishes-main/src/eggdishes_main/cli.py import click from eggdishes_core.fresh_egg import FreshEgg from eggdishes_boiled.boiled_egg import BoiledEgg from eggdishes_poached.poached_egg import PoachedEgg from eggdishes_scrambled.scrambled_egg import ScrambledEgg from eggdishes_sunnysideup.sunnysideup_egg import SunnysideUpEgg @click.group() def cli(): pass @cli.command( "recipe", help="Show the recipe for an egg dish." ) @click.argument( "dish", type=click.Choice(["boiled", "poached", "scrambled", "sunnysideup", "fresh"]), default="fresh", ) def show_recipe(dish: str): """Show the recipe for a fresh egg dish.""" egg_dish = None if dish == "boiled": egg_dish = BoiledEgg() elif dish == "poached": egg_dish = PoachedEgg() elif dish == "scrambled": egg_dish = ScrambledEgg() elif dish == "sunnysideup": egg_dish = SunnysideUpEgg() else: egg_dish = FreshEgg() click.echo(f"Recipe for {egg_dish.name}:") click.echo(egg_dish.recipe())</code></pre>2ndバージョンが完成</a> </h2> 2ndバージョンのコードは0.2.0</a>としてタグを打っているので，全体感はこのタグのソースツリーを参照してほしい。 recipe</code>コマンドの引数に応じて挙動が変わることを確認する。 $ uv sync --package eggdishes-main # 引数に boiled を指定して recipe コマンドを実行 $ uv run eggdishes recipe boiled Recipe for Boiled Egg: 1. 卵を常温に戻す 冷蔵庫から出したばかりの卵はヒビが入りやすいので、10〜20分ほど室温に置きます。 2. 鍋に卵を並べる 卵同士がぶつからないように注意しながら鍋に並べます。 3. 水を入れる 卵がしっかり浸るくらいまで水を注ぎます。 4. 火にかける 中火で加熱し、沸騰させます。 5. 茹で時間を調整する 沸騰したらタイマーをセット！お好みの仕上がりに合わせて茹で時間を変えます。 - 半熟（とろとろ）：6〜7分 - 半熟（ねっとり）：8〜9分 - 固ゆで（しっかり）：10〜12分 6. 冷水にとる 茹で上がったらすぐに冷水（または氷水）に移して冷やします。殻がむきやすくなります。 完成！ # 引数に scrambled を指定して recipe コマンドを実行 $ uv run eggdishes recipe scrambled Recipe for Scrambled Egg: 1. 卵をよく溶く ボウルに卵を割り入れ、牛乳（または生クリーム）と一緒によく混ぜます。白身と黄身がしっかりなじむように。 2. フライパンにバターを溶かす 中火より少し弱い火で、バターをゆっくり溶かします。 3. 卵液を流し入れる バターが溶けたら卵液を一気に流し入れます。 4. やさしくかき混ぜる 菜箸やゴムベラで、フライパンの外側から中心に向かってゆっくり混ぜます。 ※焦らず、火が強すぎないよう注意！ 5. 半熟状態で火を止める 卵が半熟でとろっとしてきたら火を止め、余熱で仕上げます。ふわふわ派はここで止めるのがポイント！ 6. 塩・こしょうで味付け 最後に軽く塩・こしょうをふる 完成！</code></pre>その他の話題</a> </h1> その他，雑多なトピックを補足しておく。 workspacesの標準ディレクトリ構成</a> </h2> プロジェクト内にサブパッケージをどう配置するかについての縛りはないので，自由に配置できる。ただし，workspacesの公式ドキュメンテーションでは，<project-root>/packages/</code>以下にサブパッケージを配置する例が書かれているので，この記事のようにルートディレクトリ直下にパッケージを置かずに，pakcages/eggdishes-core</code>のように一段下げて配置するのが標準か推奨構成と思われる。サンプルコードを書いたあとで気づいた。。。 dev dependency</a> </h2> ruff</code>やpyright</code>のような開発ツールは，ルートのdev dependency groupに追加すればOK。 $ uv add pyright --dev $ uv add ruff --dev $ cat ./pyproject.toml ... [dependency-groups] dev = [ "pyright>=1.1.400", "ruff>=0.11.7", ] $ uv run pyright 0 errors, 0 warnings, 0 informations $ uv run ruff check All checks passed!</code></pre>final dependency graph</a> </h2> ここまでのステップをすべて実行した最終的な依存グラフはこうなる。スッキリ！ $ uv tree Resolved 13 packages in 5ms eggdishes v0.2.0 ├── pyright v1.1.400 (group: dev) │ ├── nodeenv v1.9.1 │ └── typing-extensions v4.13.2 └── ruff v0.11.7 (group: dev) eggdishes-main v0.2.0 ├── click v8.1.8 ├── eggdishes-boiled v0.2.0 │ └── eggdishes-core v0.2.0 ├── eggdishes-core v0.2.0 ├── eggdishes-poached v0.2.0 │ └── eggdishes-core v0.2.0 ├── eggdishes-scrambled v0.2.0 │ └── eggdishes-core v0.2.0 └── eggdishes-sunnysideup v0.2.0 └── eggdishes-core v0.2.0</code></pre>パッケージビルドと配布</a> </h2> PyPIなどに公開する場合は，シングルパッケージの時と同じくbuild</code>とpublish</code>で。 # --all-pakcagesオプションを指定してbuildすると，workspaces内のすべてのパッケージが一気にビルドされる $ uv build --all-packages ... Successfully built dist/eggdishes_boiled-0.2.0.tar.gz Successfully built dist/eggdishes_boiled-0.2.0-py2.py3-none-any.whl Successfully built dist/eggdishes_core-0.2.0.tar.gz Successfully built dist/eggdishes_core-0.2.0-py2.py3-none-any.whl Successfully built dist/eggdishes_main-0.2.0.tar.gz Successfully built dist/eggdishes_main-0.2.0-py2.py3-none-any.whl Successfully built dist/eggdishes_poached-0.2.0.tar.gz Successfully built dist/eggdishes_poached-0.2.0-py2.py3-none-any.whl Successfully built dist/eggdishes_scrambled-0.2.0.tar.gz Successfully built dist/eggdishes_scrambled-0.2.0-py2.py3-none-any.whl Successfully built dist/eggdishes_sunnysideup-0.2.0.tar.gz Successfully built dist/eggdishes_sunnysideup-0.2.0-py2.py3-none-any.whl # --packageオプションを指定して，パッケージごとのビルドも可 $ uv build --package eggdishes-core Building source distribution... Building wheel from source distribution... Successfully built dist/eggdishes_core-0.2.0.tar.gz Successfully built dist/eggdishes_core-0.2.0-py2.py3-none-any.whl</code></pre># 配布 (PyPI等のパッケージインデックスへ公開) $ uv publish --index <INDEX> --token <TOKEN> dist/</code></pre>所感</a> </h1> 少し丁寧にuv workspacesの機能と動作を試してみて，個人的に理想に近いモノレポ構成が実現できそうな感触をもった。プロジェクトが一定の規模に成長すると，モノレポとして一定のコントロールを効かせながら，かつ実装と依存関係をサブ機能（サブパッケージ）ごとに分けて分割管理したいケースがよくある。今後使う機会が増えそう。 続編があります: uv workspacesとpluggyで作る，プラッガブルなPythonエコシステム</a>

Keep Building by @mocobeta

Qwen3-Coderを個人開発用途で使おうと頑張ってみた

環境</a> </h2> ハードウェア</a> </h3> PC: GMKtec EVO-X2</li> プロセッサ: AMD Ryzen AI Max+ 395</li> 内蔵GPU: Radeon 8060S</li>

ハードウェア</a> </h3> PC: GMKtec EVO-X2</li> プロセッサ: AMD Ryzen AI Max+ 395</li> 内蔵GPU: Radeon 8060S</li>

ソフトウェア</a> </h3> OS: Ubuntu 24.04</li> Graphics API: Vulkan</li> LLMサーバー: Ollama</li>

コードもプロンプトも書かないIssue駆動開発 〜Linear MCPとCodexとReview AgentとAgent Skillと〜

使うもの</a> </h2> Linear / Linear MCP Jira, Notion でも代替可だけど，Linearのほうがストレスフリー＆タスク管理効率が高い</li> </ul> </li>

FAQ: 実際のところ時間効率はどう？</a> </h2> 体感で：</p> スピード：設計（調査・計画含む）と実装フェーズは１０倍以上</li>

自宅ワークスペース環境2026

ガジェット（と家具）リスト</a> </h2> デスク: 清水材木店 タモ無垢材のオーダーデスク。 幅130cm, 奥行き80cm。 一生使うと決めて購入。大事に使います！</li> </ul> </li>

おまけ</a> </h2> LEDランタン: Barebones エジソンライトスティックLED かわいい</li> </ul> </li> 植物: サンスベリア（ハイドロカルチャー） かわいい</li> </ul> </li> </ul>

エンジニアがPdMとBizDevの人におすすめしたいAIエージェントの入門書

お金に関するリテラシーを学び始めた

Agents SDKとAgentKitを1ヶ月触り続けた所感

OpenAIのEvals APIに入門する

OpenAIのAIサポートbotにエラー報告をすると起こること

AgentKit Evalsで使えるLLM Grader - Score Model Grader

AgentKit Evalsで使えるテキスト比較Grader - String Check GraderとText Similarity Grader

AgentKitでシステムプロンプトの自動最適化 - Prompt optimizer

Hello Datasets! - AgentKitでシステムプロンプトを評価する

Agents SDKはどうやってPython関数（Function tool）をLLMのtoolにしているのか

Agents SDKのエージェントオーケストレーションパターン - 出力ガードレール

Agents SDKのエージェントオーケストレーションパターン - 入力ガードレール

Agents SDKのトークン使用量トラッキング

Agents SDKのエージェントオーケストレーションパターン - LLM as a Judge

Agents SDKのエージェントオーケストレーションパターン - Agents as Tools

Agents SDKのエージェントオーケストレーションパターン - Handoffs (Take 2)

Agents SDKのエージェントオーケストレーションパターン - Handoffs

OpenAI Logsを触る

ChatKitの会話履歴を覗く

ChatKitで添付ファイルをエージェントに渡して解析させる

ChatKitでファイルアップロード機能を実装する

バックエンド</a> </h3> 最低限必要なのは，</p> AttachmentStoreの実装</li> Storeの実装</li> アップロードエンドポイントの実装</li>

エージェントで画像やPDFファイルを解析する - Files APIとAgents SDKとResponses API

Hello ChatKit! ~ ミニマムなチャットWebアプリを作る

コードもプロンプトも書かないIssue駆動開発〜Linear MCPとCodexとReview AgentとAgent Skillと〜

使うもの</a> </h2>

Linear / Linear MCP
Codex
Agent Skills</li> </ul>

</a> </h2>
体感で：</p>
</a> </h2>
すまん</p>

ガジェット（と家具）リスト </a> </h2>

椅子: オカムラ CG-M (肘あり)

おまけ