pythonの型定義を使ってOpenAPI docを出力してみる。

今回は以前のprotobufの出力を試した記事のOpenAPI doc版。 pythonの型定義を使ってprotobufを出力してみる。近年のOpenAPIの状況近年では、openAPIとの付き合い方もだいぶ落ち着いてきて、夢を見た機能を実装し切るというような気持ちのところは減ってき…

2020-06-06

コード生成中に、裏側でサービスを立ち上げて、通信してあげればN+1を防げる事に気づいた

egoist python

github.com コード生成でのN+1? 以前に、コード生成でのN+1問題の発生というような記事を書いた。コード生成におけるN+1問題とbulk actionとしてのegoist。あるいはMakefileについてこの記事では、bulk action的な実行を解として説明をしていた。元々の問…

2020-05-24

egoistでモジュールを分割できるようにした

python egoist

github.com 定義が多くなってくると、１つのファイルで管理するのが厳しくなってくる。そんなわけで、moduleを分割することを考えてみた。似たような機構はいろいろなWAFにも存在する。例えばflaskならblueprint、fastAPIならAPIRouter。 Flask -- Modular A…

2020-05-20

コード生成におけるN+1問題とbulk actionとしてのegoist。あるいはMakefileについて。

egoist python golang

例えば以下の画像の様な依存関係でコード生成1が行われるとする。入力となるファイルが幾つかあり、例えばjinja2のテンプレートなどで出力先の表現が記述されていて、これによりちょっとしたgoのコードやopenAPI docの一部を生成するというようなタスク。画…

2020-05-19

サブコマンドをincludeで自由に追加できるようにした

python egoist

github.com サブコマンドをincludeで自由に追加できるようにした。デフォルトで利用できるサブコマンド例えば egoist init clikit で生成されるdefinitions.pyは以下の様なサブコマンドを持っている。 describe generate scan usage: definitions.py [-h] …

2020-05-17

-hや--helpでのヘルプメッセージの表示は一瞬で終わってほしいと言う話

python egoist

egoistを作っていて、けっこう気にしているポイントなども記事にしてみることにする。個人的には-hや--helpに時間が掛かるCLIはあまり好きではない。具体的には0.5sくらいでちょっとストレスを感じ、1.0sを越えると、使うたびに感じるストレスがそのツール…

2020-05-16

pythonのクラス定義からUnmarshalJSON()でのvalidation付きのgoのstruct定義を生成する

golang python egoist

github.com pythonのクラス定義からUnmarshalJSON()でのvalidation付きのgoのstruct定義を生成してみる。（より細かなバリエーションは https://github.com/podhmo/egoist/tree/master/examples/e2e/generate-structkit にある）なぜUnmarshalJSON()付きで…