postmanとopenapi
をテンプレートにして作成
[
トップ
] [
新規
|
一覧
|
単語検索
|
最終更新
|
ヘルプ
]
開始行:
#contents
* 始めに [#qcaea1a3]
最近postmanをつかう現場が増えてきたように思う
curlコマンドでいいじゃないかとか思っていた。
結合テストで、メンバーが人力のテスト項目を作って、「ふー...
とかおもってたら、案の定大変で、大人数が手伝わされる羽目...
あー、あの時、自動化をするように、メンバーを説得できてい...
そこで、寝る前にそのあたりの技術について考察を書いてから...
* テスト項目エクセルに書くメリット、デメリット [#i53b63e6]
エクセルは汎用的なところがメリットだ。パソコンの知識が低...
しかし、そこに書いてある内容をつかって打鍵しようとなると...
もともと、API定義書にはテストに必要な情報を詰め込まれてい...
リクエストのパラメータだったり、レスポンスのパラメータだ...
* API定義書とテスト仕様書のギャップについて考える [#n18a8...
API定義書は正常な予期されたデータ、テストは異常系の予期さ...
たとえば、APIであるパラメータが数値であって範囲が指定され...
* 自分が目指せそうなゴールを考えてみる [#oecd6640]
** テストケースの面について自動生成を考えてみる [#m92c9c64]
API定義書から、テストをすべて生成することは可能だろうか?
正常系のサンプルデータがあれば、正常系だけは生成できそう...
異常系はある程度のスケルトンはつくれそうだが、そこから先...
将来的にはAI補完させることができそうな気がする。
さらに、設計書をAIに読ませることができるようになれば、も...
** テストケースの自動生成の成果物 [#h6c6351d]
エクセル形式で出力したいか?
いや、自動的に実行できるのが良いと思う。
** curlコマンドの提供をうけれる状態の場合について考える [...
特殊な状況下ではあるが、バックエンドが別会社であり、opena...
の提供をうけれるとする。(今、自分がそういう状態なのだ
curlコマンドはopenapiの定義にかなり近いが、テストのために...
このすこしのズレが、テストケースの本質のように思う。これ...
*** curlコマンドのテストケース部分の自動認識についての考...
手順的には以下のものになるだろう
step1 openapiのパース
step2 curlコマンドのパース
step3 openapiのパース結果からcurlコマンドを予測
step4 step3の予測結果から、curlコマンドのパース結果の違い...
step5 step4の違いから、テストの意図を認識させる
*** まてまて、curlコマンドもらえる今の状況について考える ...
curlコマンドもらえるんなら、それをエクセルのテストケース...
いいじゃないか?
もしかして、いまの現場のメンバーは、もらったcurlコマンド...
なんか、諸悪の根源は、エクセルに日本語かかせたがる、
知識のないリーダ層に問題がありそうだな。
老害ということばもあるが、自分の経験上、文系の社内政治が...
そのような害悪の根源になっている感じがする。
大企業のような組織が大きくなればなるほど、そういうのが多...
きょうは、このへんにして寝るとする
* postman [#pfa1268e]
** 公式ドキュメント [#pc197271]
https://learning.postman.com/docs/getting-started/introdu...
*** postman script [#n33d74ee]
https://learning.postman.com/docs/writing-scripts/script-...
*** リンク集 [#f8ea007e]
postmanにapi定義を読み込ませてテストする的な解説ページが...
https://kageura.hatenadiary.jp/entry/postmancollection
https://qiita.com/yito-gxp/items/09787d9a98717e701d32
https://ren.nosuke.me/blog/202003/20200303/
** postmanlabs [#d26b26c7]
postmanが提供しているライブラリとか
https://github.com/postmanlabs
*** postmanがopenapiのver3.1に対応した話 [#y48d2e20]
https://blog.postman.com/postman-now-supports-openapi-3-1/
これは、結構政治的な要素を含んだ話で、これまでopenapi3.0....
openapi-generatorが主導的だったようにおもう、しかしopenap...
schemeの構造がjson-schemeを採用するようになったのである。
openapi-generatorは、対応できていない段階で、openapi3.1.0...
postmanがjavascriptベースでつくられており、jsonでopenapi3...
json-schemeのほうが、モデルの継承とかがまだ、十分対応でき...
それよりかは、json-schemeのパーサーがつかえるほうがいいよ...
だれか、openapi-generatorのパーサーのメンテしてくれないか...
*** その他のopenapi-generatorへの妨害と思われる箇所 [#p24...
実はopenapi-generatorのプロジェクトをパースしようとすると...
じぶんとしては、タイミング的に考えて、postman勢の政治的解...
** postmanの解説動画 [#h4043846]
https://www.youtube.com/watch?v=YRzpziA35Mg
* パーサーの比較 [#k7fbadab]
** OpenAPIParser [#uf11615c]
openapi-generatorは、io.swagger.parser.OpenAPIParserをつ...
https://mvnrepository.com/artifact/io.swagger.parser.v3/s...
** swagger-api/swagger-parser [#n6dba138]
2022/06に、OAS3.1に対応
https://github.com/swagger-api/swagger-parser/releases/ta...
** きになる技術 [#we73e8d9]
JsonスキーマをTSで出力
https://github.com/bcherny/json-schema-to-typescript
終了行:
#contents
* 始めに [#qcaea1a3]
最近postmanをつかう現場が増えてきたように思う
curlコマンドでいいじゃないかとか思っていた。
結合テストで、メンバーが人力のテスト項目を作って、「ふー...
とかおもってたら、案の定大変で、大人数が手伝わされる羽目...
あー、あの時、自動化をするように、メンバーを説得できてい...
そこで、寝る前にそのあたりの技術について考察を書いてから...
* テスト項目エクセルに書くメリット、デメリット [#i53b63e6]
エクセルは汎用的なところがメリットだ。パソコンの知識が低...
しかし、そこに書いてある内容をつかって打鍵しようとなると...
もともと、API定義書にはテストに必要な情報を詰め込まれてい...
リクエストのパラメータだったり、レスポンスのパラメータだ...
* API定義書とテスト仕様書のギャップについて考える [#n18a8...
API定義書は正常な予期されたデータ、テストは異常系の予期さ...
たとえば、APIであるパラメータが数値であって範囲が指定され...
* 自分が目指せそうなゴールを考えてみる [#oecd6640]
** テストケースの面について自動生成を考えてみる [#m92c9c64]
API定義書から、テストをすべて生成することは可能だろうか?
正常系のサンプルデータがあれば、正常系だけは生成できそう...
異常系はある程度のスケルトンはつくれそうだが、そこから先...
将来的にはAI補完させることができそうな気がする。
さらに、設計書をAIに読ませることができるようになれば、も...
** テストケースの自動生成の成果物 [#h6c6351d]
エクセル形式で出力したいか?
いや、自動的に実行できるのが良いと思う。
** curlコマンドの提供をうけれる状態の場合について考える [...
特殊な状況下ではあるが、バックエンドが別会社であり、opena...
の提供をうけれるとする。(今、自分がそういう状態なのだ
curlコマンドはopenapiの定義にかなり近いが、テストのために...
このすこしのズレが、テストケースの本質のように思う。これ...
*** curlコマンドのテストケース部分の自動認識についての考...
手順的には以下のものになるだろう
step1 openapiのパース
step2 curlコマンドのパース
step3 openapiのパース結果からcurlコマンドを予測
step4 step3の予測結果から、curlコマンドのパース結果の違い...
step5 step4の違いから、テストの意図を認識させる
*** まてまて、curlコマンドもらえる今の状況について考える ...
curlコマンドもらえるんなら、それをエクセルのテストケース...
いいじゃないか?
もしかして、いまの現場のメンバーは、もらったcurlコマンド...
なんか、諸悪の根源は、エクセルに日本語かかせたがる、
知識のないリーダ層に問題がありそうだな。
老害ということばもあるが、自分の経験上、文系の社内政治が...
そのような害悪の根源になっている感じがする。
大企業のような組織が大きくなればなるほど、そういうのが多...
きょうは、このへんにして寝るとする
* postman [#pfa1268e]
** 公式ドキュメント [#pc197271]
https://learning.postman.com/docs/getting-started/introdu...
*** postman script [#n33d74ee]
https://learning.postman.com/docs/writing-scripts/script-...
*** リンク集 [#f8ea007e]
postmanにapi定義を読み込ませてテストする的な解説ページが...
https://kageura.hatenadiary.jp/entry/postmancollection
https://qiita.com/yito-gxp/items/09787d9a98717e701d32
https://ren.nosuke.me/blog/202003/20200303/
** postmanlabs [#d26b26c7]
postmanが提供しているライブラリとか
https://github.com/postmanlabs
*** postmanがopenapiのver3.1に対応した話 [#y48d2e20]
https://blog.postman.com/postman-now-supports-openapi-3-1/
これは、結構政治的な要素を含んだ話で、これまでopenapi3.0....
openapi-generatorが主導的だったようにおもう、しかしopenap...
schemeの構造がjson-schemeを採用するようになったのである。
openapi-generatorは、対応できていない段階で、openapi3.1.0...
postmanがjavascriptベースでつくられており、jsonでopenapi3...
json-schemeのほうが、モデルの継承とかがまだ、十分対応でき...
それよりかは、json-schemeのパーサーがつかえるほうがいいよ...
だれか、openapi-generatorのパーサーのメンテしてくれないか...
*** その他のopenapi-generatorへの妨害と思われる箇所 [#p24...
実はopenapi-generatorのプロジェクトをパースしようとすると...
じぶんとしては、タイミング的に考えて、postman勢の政治的解...
** postmanの解説動画 [#h4043846]
https://www.youtube.com/watch?v=YRzpziA35Mg
* パーサーの比較 [#k7fbadab]
** OpenAPIParser [#uf11615c]
openapi-generatorは、io.swagger.parser.OpenAPIParserをつ...
https://mvnrepository.com/artifact/io.swagger.parser.v3/s...
** swagger-api/swagger-parser [#n6dba138]
2022/06に、OAS3.1に対応
https://github.com/swagger-api/swagger-parser/releases/ta...
** きになる技術 [#we73e8d9]
JsonスキーマをTSで出力
https://github.com/bcherny/json-schema-to-typescript
ページ名: