Back to Explore

pydantic/pydantic-settings

GitHub
3 updates · last 90 days2 watchersOpen source

Last release: 3 weeks ago

pydantic-settings is a GitHub project for managing application settings using Pydantic. It’s useful if you want to define and validate configuration (for example, via environment variables) with Pydantic’s data models.

Project status

  • pydantic/pydantic-settings appears actively maintained, with multiple recent updates through 2026-05-16, including several bug-fix and feature-heavy updates in 2025 to 2026.
  • The apparent update cadence is steady, roughly every 1 to 2 months in recent history (for example, v2.13.1 and v2.13.0 in April-February 2026 timeframe, then v2.14.0 and v2.14.1 in May 2026).

AI summary generated 2 weeks ago

AI-generated from public sources. May be inaccurate. Report

Recent updates

  • v2.14.1

    3 weeks ago

    v2.14.1 is a small maintenance release focused on a bug fix for settings models that define a field named `cls`. It also refreshes the dependency lockfile and several GitHub Actions pins as part of Dependabot updates, plus a version bump.

  • v2.14.0

    1 month ago

    v2.14.0 is a bug-fix heavy release for pydantic-settings, centered on CLI parsing, env source resolution, and dotenv handling. It also adds support for reading dotenv files from FIFOs, introduces configurable dotenv filtering, and refreshes dependency and CI tooling.

    Features

  • v2.13.1

    1 month ago

    v2.13.1 is a focused bugfix release for regressions introduced in 2.13.0. It restores correct behavior for bool fields, recursive CLI models, set parsing, nested dict env vars, and parameterized PEP 695 type aliases.

  • v2.13.0

    3 months ago

    v2.13.0 is a feature-heavy release centered on CLI parsing, config source merging, and secret store integrations. It also fixes several resolution bugs around aliases, nested env values, and help text generation, while adding new knobs such as env_prefix_target and new CLI flag modes.

    Features

  • v2.12.0

    6 months ago

    This release adds enum-aware CLI kebab-casing, a new NestedSecretsSettingsSource for nested secret layouts, and several settings-resolution fixes around source precedence, default stripping, and init key restoration. It also drops Python 3.9 support and adds Python 3.14 coverage.

    BreakingFeatures

  • v2.11.0

    8 months ago

    This release is centered on CLI improvements and settings-source enhancements, including CLI serialization, root model support, better alias and type-alias handling, and several provider updates for AWS and Azure. It also tightens a few behaviors around argument parsing, config warnings, and source resolution, while shipping bug fixes and dependency updates.

    BreakingFeatures

  • 2.10.1

    11 months ago

    This is a narrow patch release for pydantic-settings 2.10.1. It fixes an UnboundLocalError in case-insensitive field name replacement and removes an outdated docs reference, with no API or dependency changes visible in the diff.

  • 2.10.0

    11 months ago

    v2.10.0 expands settings-source customization with CLI shortcuts, YAML subsection loading, and new Secret Manager options for AWS, Azure, and GCP. It also fixes several parsing and alias-resolution bugs, updates CI coverage handling, and refreshes project dependencies and docs.

    Features

  • v2.9.1

    5/6/2025

    This is a small patch release for pydantic-settings v2.9.1. It mainly exposes ConfigFileSourceMixin at the top-level sources package and corrects a typo in the GCP Secret Manager error message, with no substantial API redesign visible in the diff.

  • v2.9.0

    4/18/2025

    v2.9.0 drops Python 3.8 support and adds new secret manager integrations (AWS Secrets Manager and GCP Secret Manager). It also introduces `uv` for project management and includes several CLI behavior fixes and improvements. Additionally, internal refactoring (sources module restructure) may affect any code relying on non-public import paths.

    BreakingFeatures