はじめに

Pythonでのデータ検証や型安全性を向上させるには、シンプルで使いやすいツールが求められます。その中でもPydanticは、型アノテーションを活用してデータを検証し、信頼性の高いデータモデルを提供する強力なライブラリです。

Pydanticは以下のようなシチュエーションで役立ちます：

APIリクエストデータの検証
設定値や環境変数の読み取り
型安全なデータ変換

本記事では、Pydanticの基本的な使い方から、実践的な活用方法までをわかりやすく解説します。

Pydanticとは
1. Pydanticの概要
2. Pydanticのメリット
Pydanticのインストール
Pydanticの基本的な使い方
Pydanticの応用
Pydanticを使う際の注意点
まとめ

Pydanticとは

Pydanticの概要

Pydanticは、Pythonの型アノテーションを活用して、データのバリデーション（検証）や型安全なモデルを提供するライブラリです。主な特徴は次の通りです：

型アノテーションを利用: 型アノテーションを基にデータの検証を行います。
高速: 標準ライブラリのdataclassesをベースにし、Cythonで最適化されています。
シンプルな構文: 直感的な使い方が可能で、学習コストが低いです。

Pydanticのメリット

型安全性の向上
データ型の不一致を防ぎ、エラーを早期に検出できます。
データ検証の簡略化
データの整形や検証ロジックをモデルに集約できます。
幅広い活用例
APIリクエストの検証、設定ファイルの管理、データ変換など、多用途に利用可能です。

Pydanticのインストール

以下のコマンドでPydanticをインストールします：

pip install pydantic

インストール後、バージョンを確認します：

python -c "import pydantic; print(pydantic.VERSION)"

Pydanticの基本的な使い方

基本的なモデル作成

PydanticのBaseModelを継承してデータモデルを定義します。

例：基本的なモデル

from pydantic import BaseModel

class User(BaseModel):
    name: str
    age: int

user = User(name="Alice", age=30)
print(user)

出力例：

name='Alice' age=30

データ検証

Pydanticは、渡されたデータの型が正しいかを自動的に検証します。

例：検証エラー

user = User(name="Alice", age="thirty")

このコードを実行すると、次のエラーが発生します：

pydantic.error_wrappers.ValidationError: 1 validation error for User
age
  value is not a valid integer (type=type_error.integer)

デフォルト値とオプショナル型

Optional型とデフォルト値を使用して、値が省略可能なフィールドを定義できます。

例：デフォルト値とOptional型

from typing import Optional

class User(BaseModel):
    name: str
    age: Optional[int] = None

user = User(name="Bob")
print(user)

出力例：

name='Bob' age=None

Pydanticの応用

ネストされたモデル

モデルの中に別のモデルをフィールドとして定義できます。

例：ネストされたモデル

class Address(BaseModel):
    city: str
    postal_code: str

class User(BaseModel):
    name: str
    address: Address

user = User(name="Alice", address={"city": "Tokyo", "postal_code": "100-0001"})
print(user)

出力例：

name='Alice' address=Address(city='Tokyo', postal_code='100-0001')

データの変換

Pydanticは、データ型を自動で変換する機能を持っています。

例：型の自動変換

class User(BaseModel):
    name: str
    age: int

user = User(name="Alice", age="30")  # 文字列を整数に変換
print(user)

出力例：

name='Alice' age=30

環境変数の読み取り

BaseSettingsを使用して環境変数を読み取ることができます。

例：環境変数を使用した設定

from pydantic import BaseSettings

class Config(BaseSettings):
    app_name: str
    debug: bool

config = Config(app_name="MyApp", debug=True)
print(config)