APIクライアントを作ろう! / Let's make API client!

Transcript

1. APIクライアントを作ろう! by  papix  (GaiaX  Co.  Ltd.)
2. papix  (GaiaX  Co.  Ltd.) R&D  Div.  Technical  Basis  Gr. •  Infrastructure  Engineer •  “Reactio”  Engineer •  Recruitment  Officer •  Perl  Community  Specialist •  “Perl  Entrance”  headmaster PAPIX papix _̲_̲papix_̲_̲ takayuki.fukumoto.92 Masteries http://papix.hatenablog.com/ _̲_̲papix_̲_̲ papics  (Free  materials) ※18時50分現在
4. 突然ですが…
5. APIクライアント
6. 作ったことありますか?
7. APIクライアント •  WebサービスのAPIを叩く君 – Twitter  -‐‑‒>  Net::Twitter – ImKayac  -‐‑‒>  WebService::ImKayac::Simple – Mackerel  -‐‑‒>  WebService::Mackerel •  Perlスクリプトからお⼿手軽にWebサービス を利利⽤用できてとても便便利利 •  CPANにもいっぱい公開されている
8. https://reactio.jp/ 先⽇日リリースした 障害対応に特化した コミュニケーションツールという ⾃自社サービス
9. の
10. APIクライアントを作ったので
11. その時に得た(調べた)知⾒見見を 発表しようと思います
12. 名前空間
13. APIクライアントでよく使われる 名前空間を紹介するぜ!!!
14. Net  !!!
15. WebService  !!!
16. WWW  !!!
17. 以上だ!!!!!
18. 名前空間 •  Net – Net::Twitter – Net::Travis::API  ... •  WebService – WebService::ImKayac::Simple – WebService::Livedoor::Weather  ... •  WWW – WWW::Twilio::API – WWW::NHKProgram::API  ...
19. どれ使えばええねん!!!
20. https://pause.perl.org/pause/query?ACTION=pause_̲namingmodules#Net
21. Net  /  WebService  /  WWW •  ネットワークプロトコル – Net •  アプリケーションプロトコル – WebService  or  WWW WebService  or  WWWが良良さそう!
22. 依存ライブラリ
23. 依存ライブラリ •  少ないに越したことはない – ｢重い｣ライブラリに依存するのは避けたい – 利利⽤用者から敬遠される可能性もある •  良良く使われるライブラリ – HTTP  Client:  LWP,  Furl,  HTTP::Tiny  ... – Decoder:  JSON,  XML::LibXML,  XML::Simple  ... – URI,  Class::Accessor::Lite,  Encode,  Carp  ...
24. 依存ライブラリ •  WebService::Simple – Web  ServiceのClientを作る為のシンプルな フレームワーク(yusukebeさん製) – WebService::Simpleを継承して シンプルにクライアントを実装できる •  例例:  WebService::Simple::AWS  ...
25. テスト
26. テスト •  ｢実際のAPIを叩く｣テストを書くのはNG – ネットに繋がっていないとテストが通らない – テストする度度にWebサービスにアクセスが… •  1.  異異常ケースのテストを書く – パラメータが⾜足りない場合とか… – フォーマットが不不正な場合とか… •  2.  APIを叩く部分のmockを作る – 実際にAPIを叩かずにレスポンスを得る
27. Test::Mock::Guard •  任意のメソッドに対するモック
28. Test::Mock::Furl •  Furlのモック – レスポンスを偽装できる – LWPならTest::Mock::LWPなど...
29. 気をつけるべきところ •  ドキュメント – Synopsisで利利⽤用例例を⽰示す – 使えるメソッドやその使い⽅方を⽰示しておく •  サンプルコード – ｢eg｣ディレクトリに配置すれば サンプルコードとして扱ってくれる(MetaCPAN)
30. さいごに
31. APIクライアント作っていこう! •  昨今様々なサービスが開発されている •  API  ClientがCPANにないものもある – 愛⽤用しているサービスのAPI  Clientがないので あれば,  作っていこう! •  みんながお得!!! – ⾃自分も便便利利 – サービス利利⽤用者も便便利利 – サービス提供者も嬉しい
32. おわり ご静聴ありがとうございました!