はてなブックマーク

トラストハブ AI チームの中村です。 つい先日、FastAPI から v0.115.0 がリリースされました。 これにより、FastAPI のクエリパラメータの宣言に Pydantic モデルが使えるようになりました。 本記事では、今回リリースされた新機能の具体的な使用方法を、それが特に威力を発揮できそうなユースケースに沿って解説していこうと思います。 新機能の概要 今回のリリースで、FastAPI のクエリパラメータの指定に Pydantic モデルが使えるようになりました。Pydantic モデルは強力な型ヒントとバリデーション機能を提供するので、今後はクエリパラメータの型チェック、制約条件の設定、そしてデータの正規化などが容易に実装できるようになります。また、クエリだけではなくヘッダーや Cookie の宣言も同じく Pydantic モデルが適用できるようになったので、これらも同

弊社（トラストハブ）では、バックエンドのプログラミング言語として TypeScript、ウェブフレームワークとしてNestJSを採用しています。本記事では、NestJSの特長を生かした、実際に弊社で採用されている例外処理の戦略について述べます。 その try-catch、意味がありますか？ TypeScriptのコードにおいて、try-catch が使われている場面をたびたび見かけます。 try-catch で囲う意図としては以下のようなものがあると思います。 例外をハンドリングすることで処理を継続したい。 例外の型によって処理を分岐したい。 例外の内容をログに出力したい。 例外をハンドリングする必要がありますか 例外は、例外的な状態なので例外なのです。 例外が発生した多くの場合、書かれたコードでは処理を継続できない状況が発生します。処理を継続できない状況において、例外を catch して

弊社(トラストハブ)では、すべてのプロダクトのAPIにGraphQLを採用しています。 しかし、私が入社した時点では、GraphQLの設計に課題がありました。Query, Mutationの設計に統一性がなく、REST的な設計の名残も見られました。そのため、GraphQLの利点を十分に活かせていない箇所が多く存在していました。 自分は以前から業務でGraphQLを使ったAPIを作るために、海外でのGraphQLに関するドキュメントや、Shopify GraphQL APIドキュメントを読んで実践してきたので、この部分で貢献できると思いました。 そこで入社後にまずGraphQLのAPIをこういうルールで作ってみませんか？と提案するドキュメントを書いて、新規で作られるAPIについてはそのルールを使うようメンバーに布教する活動を行っていました。今では、ほとんどのコードではAPIの設計に統一性を持

API経由でメール送信をするためのサービスといえば、SendGrid, Amazon SES, Postmarkのような名前が出てくるかと思います。 そんな中、弊社(トラストハブ)でも利用しているResendというサービスがとても使いやすいので紹介します。また、記事後半でResendを日本で使うにあたり重要なアップデートがあったので、どんな点が変わったかを紹介します。 そもそもResendとはどんなサービスか Resendは後発サービスなだけあり、開発体験の良さに主眼が置かれて開発されています。テストでメールが送信できていることを確認する機能や、ログを確認する機能など、細かいところが使い勝手が良いなと感じています。 SDK・設定がシンプル 公式でたくさんの言語のSDKが用意されています。また、フレームワークごとに組み込むためのドキュメントも充実しています。 Knowledge Baseを見