PyPI · #79 most downloaded on PyPI

pydantic-settings

2.15.0359M downloads/mopydantic/pydantic-settings ↗New releases in your daily digest, changelog included.

Settings management using Pydantic

Last release 1 months ago
07 Aug 2026
Ships fairly regularly
a new release about every 2 months
Nearly every release is documented
notes for 34 of 36 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
45 releases · first in 2019

Release timeline

45 releases since 2019

20192020202120222023202420252026

Releases

2.15.07 Aug 2026
case_sensitive now applies to init kwargs and config-file sources ( #900 ). InitSettingsSource and the JSON/TOML/YAML config sources previously ignore
Highlights

Behavior changes

case_sensitive now applies to init kwargs and config-file sources (#900). InitSettingsSource and the JSON/TOML/YAML config sources previously ignored case_sensitive. Since it defaults to False, case-insensitive matching is now the default for these sources — e.g. Settings(TeSt=...) now populates a test field where it previously did not. Nested keys are still matched case-sensitively.

Fields with unresolved forward references now emit a warning (#901). Settings sources can silently fail to resolve such fields; they now raise IncompleteFieldDefinitionWarning telling you to call model_rebuild(). If you have filterwarnings = error configured, this may surface as a new failure.

Non-JSON env values for strict fields now raise ValidationError (#926) instead of a less specific error.

New features

Show environment variable names in CLI help via cli_show_env_vars=True (#860), so generated --help output doubles as configuration documentation.

PYDANTIC_SETTINGS_DEBUG for debugging settings resolution (#906, #913). Set it to a truthy value with DEBUG logging enabled to see each source's contribution in priority order, which source won for each value, and which env_file/secret files were probed, loaded, or skipped — the long-standing "why isn't my .env being picked up?" question.

toml_table_header for regular TOML files (#882, #886, #887), letting you root settings at a nested table in any TOML file, not just pyproject.toml.

Traversable support for JSON/TOML/YAML file sources (#902), so you can load config packaged inside a distribution — including files inside a zip or wheel — via importlib.resources.files(...) without casting to Path.

GCP: project_id can come from an earlier settings source (#878), rather than only from the constructor or GOOGLE_CLOUD_PROJECT.

Bug fixes

Fix env vars not loading on Windows with case_sensitive=True (#894). Windows upper-cases os.environ keys, so fields raised Field required instead of picking up their values.

Read secret files as UTF-8 instead of the platform locale encoding (#917). On Windows code pages such as cp1252 this silently corrupted non-ASCII secrets.

Fix AliasPath on nested model fields not JSON-decoding env values (#898).

Fix case-insensitive matching for optional nested models (#905).

Fix dotenv extras being wrongly claimed by a complex field sharing a name prefix (#912) — e.g. dbx_token being swallowed by a db: dict field.

Fix nested_model_default_partial_update=True corrupting discriminated unions (#876).

Fix Secret subclasses crashing when loaded from the environment (#920).

Fix enum names not parsing through nested annotations such as Optional[Annotated[MyEnum, ...]] with env_parse_enums=True (#910).

An empty yaml_config_section now falls back to defaults instead of raising AttributeError: 'NoneType' object has no attribute 'keys' (#914).

NestedSecretsSettingsSource no longer follows symlinks pointing outside secrets_dir (#889).

GCP: skip the list_secrets call when case_sensitive=True (#862), lowering the required IAM permissions to just roles/secretmanager.secretAccessor.

AWS: types-boto3[secretsmanager] is no longer required at runtime (#880).

Documentation

Document JSON parsing of complex env values, plus a comma-separated-values recipe (#919).

Recommend an async settings loading pattern (#908).

Clarify behavior when an unprefixed value is present in a dotenv file (#895).

Clarify environment variable helper descriptions (#867) and fix assorted typos (#904).

All changes (including dependency bumps and internal maintenance)
What's Changed

Update documentation link for Pydantic settings by @hramezani in #863

Bump the python-packages group with 4 updates by @dependabot[bot] in #865

docs: clarify environment variable helper descriptions by @vip892766gma in #867

Bump the python-packages group with 4 updates by @dependabot[bot] in #870

Bump the python-packages group with 4 updates by @dependabot[bot] in #875

Skip list_secrets call when case_sensitive=True by @ecerulm in #862

GoogleSecretManagerSettingsSource: read project_id from previous sources by @ecerulm in #878

Bump the python-packages group with 3 updates by @dependabot[bot] in #883

fix: move SecretsManagerClient type import under TYPE_CHECKING by @gavin913-lss in #880

Skip partial update merging for discriminated union fields by @hramezani in #876

Support using a table header as root when reading a TOML file by @whyscream in #882

Bump the python-packages group with 4 updates by @dependabot[bot] in #885

Don't complain about missing table headers in a TOML file that isn't there by @whyscream in #886

Address issues in toml table header implementation by @whyscream in #887

Bump the python-packages group with 2 updates by @dependabot[bot] in #888

Prevent NestedSecretsSettingsSource from following symlinks outside secrets_dir by @hramezani in #889

Add 'Part of the Pydantic Stack' footer to README by @strawgate in #891

Bump the python-packages group with 3 updates by @dependabot[bot] in #893

Add support for showing environment variable names in CLI help text by @brad-alexander in #860

Fix loading env vars on Windows with case_sensitive=True by @hramezani in #894

Bump the github-actions group with 3 updates by @dependabot[bot] in #896

Bump the python-packages group with 3 updates by @dependabot[bot] in #897

Add explicit callout for the case where the unprefixed value is in dotenv by @martinky24 in #895

Fix AliasPath on nested model fields not decoding env values (#670) by @hramezani in #898

Support case_sensitive in InitSettingsSource and config file sources by @hramezani in #900

Warn when using fields not fully resolved at instantiation by @Viicos in #901

Support Traversable for json/toml/yaml config file sources (#299) by @hramezani in #902

docs: fix typos in docs and source comments by @maxtaran2010 in #904

Apply case-insensitive field matching to optional nested models (#903) by @hramezani in #905

Bump boto3 from 1.43.36 to 1.43.40 in the python-packages group by @dependabot[bot] in #907

Add PYDANTIC_SETTINGS_DEBUG for debugging settings sources (#538) by @hramezani in #906

docs: recommend async settings loading pattern by @w3lld1 in #908

fix: parse enum names through nested annotations by @Sanjays2402 in #910

Fix dotenv extras being claimed by complex fields sharing a name prefix by @ritsth in #912

Add debug logging for env_file and secret file resolution by @hramezani in #913

docs: document JSON parsing of complex env values + comma-separated recipe by @hrithvikakb in #919

fix: coerce empty yaml_config_section to an empty mapping instead of crashing by @chuenchen309 in #914

Bump the python-packages group with 3 updates by @dependabot[bot] in #915

fix: read secret files as UTF-8 instead of the locale encoding by @dchaudhari7177 in #917

Bump the python-packages group with 4 updates by @dependabot[bot] in #921

Bump the github-actions group with 4 updates by @dependabot[bot] in #925

Bump the python-packages group with 4 updates by @dependabot[bot] in #924

fix: treat Secret subclasses as non-complex fields (#716) by @Rony-ZenAlden in #920

fix: raise ValidationError for non-JSON env values on strict fields by @shuvamk in #926

test: move function-local imports to the top of test modules by @hramezani in #927

Bump the python-packages group with 4 updates by @dependabot[bot] in #929

Prepare release 2.15.0 by @hramezani in #930

New Contributors

@vip892766gma made their first contribution in #867

@ecerulm made their first contribution in #862

@gavin913-lss made their first contribution in #880

@whyscream made their first contribution in #882

@strawgate made their first contribution in #891

@brad-alexander made their first contribution in #860

@martinky24 made their first contribution in #895

@maxtaran2010 made their first contribution in #904

@w3lld1 made their first contribution in #908

@Sanjays2402 made their first contribution in #910

@ritsth made their first contribution in #912

@hrithvikakb made their first contribution in #919

@chuenchen309 made their first contribution in #914

@dchaudhari7177 made their first contribution in #917

@Rony-ZenAlden made their first contribution in #920

@shuvamk made their first contribution in #926

Full Changelog: v2.14.1...v2.15.0

One column per quarter.

Additional notes

v2.15.0 Latest

Latest

Compare

Choose a tag to compare

Open source →

2.14.219 Jun 2026

This is a security patch release.

What's Changed

This is a security patch release.

Prevent NestedSecretsSettingsSource from following symlinks outside secrets_dir by @hramezani in #889
Prepare release 2.14.2 by @hramezani in #890

Security

Fixes GHSA-4xgf-cpjx-pc3j: NestedSecretsSettingsSource with secrets_nested_subdir=True could follow a symbolic link inside secrets_dir pointing outside it, reading out-of-tree files into settings values and bypassing the secrets_dir_max_size cap. Affected versions: >= 2.12.0, < 2.14.2.

Full Changelog: v2.14.1...v2.14.2

Open source →

Additional notes

v2.14.2

Compare

Choose a tag to compare

Open source →

2.14.18 May 2026

Bump the python-packages group with 4 updates by @dependabot [bot] in #850

What's Changed

Bump the python-packages group with 4 updates by @dependabot[bot] in #850
Bump the python-packages group with 5 updates by @dependabot[bot] in #854
Bump the github-actions group with 3 updates by @dependabot[bot] in #853
Bump the python-packages group with 2 updates by @dependabot[bot] in #856
Fix field named cls conflicting with classmethod parameter by @hramezani in #858
Prepare release 2.14.1 by @hramezani in #859

Full Changelog: v2.14.0...v2.14.1

Open source →

Additional notes

v2.14.1

Compare

Choose a tag to compare

Open source →

2.14.020 Apr 2026

Fix parsing env vars into Optional Strict types by @hramezani in #792

What's Changed

Fix parsing env vars into Optional Strict types by @hramezani in #792
Fix RecursionError with mutually recursive models in CLI by @hramezani in #794
Fix env_file from model_config ignored in CliApp.run() (#795) by @hramezani in #796
Update dependencies by @hramezani in #798
Add Dependabot configuration by @hramezani in #801
Bump samuelcolvin/check-python-version from 4.1 to 5 by @dependabot[bot] in #802
Bump actions/upload-artifact from 4 to 7 by @dependabot[bot] in #803
Bump actions/checkout from 4 to 6 by @dependabot[bot] in #804
Bump astral-sh/setup-uv from 5 to 7 by @dependabot[bot] in #805
Bump actions/setup-python from 5 to 6 by @dependabot[bot] in #806
Ignore chardet and group GitHub Actions in Dependabot by @hramezani in #808
Bump actions/download-artifact from 4 to 8 in the github-actions group by @dependabot[bot] in #809
Bump the python-packages group with 2 updates by @dependabot[bot] in #810
Support reading .env files from FIFOs (e.g. 1Password Environments) by @JacobHayes in #776
Fix AliasChoices ignored when changing provider priority by @hramezani in #813
fix: resolve KeyError in run_subcommand for underscore field names by @bradykieffer in #799
Bump the python-packages group with 3 updates by @dependabot[bot] in #814
Fix Literal[numeric Enum] coercion for CLI and env vars by @m9810223 in #811
Fix nested discriminated unions not discovered by env/CLI providers by @hramezani in #816
Bump the python-packages group with 3 updates by @dependabot[bot] in #820
CLI ensure env nested max split internally. by @kschwab in #821
Bump the python-packages group with 4 updates by @dependabot[bot] in #824
Migrate boto3-stubs to types-boto3 by @hramezani in #831
Fix CLI not recognizing field name with validate_by_name and AliasChoices by @hramezani in #826
Allow customisation of the dotevn setting source to filter variables by @CaselIT in #832
Bump the python-packages group with 3 updates by @dependabot[bot] in #833
Introduce yamlfmt by @Viicos in #836
Bump boto3 from 1.42.82 to 1.42.83 in the python-packages group by @dependabot[bot] in #837
Introduce zizmor by @Viicos in #838
Fix CliPositionalArg[list[CustomType]] crash for custom types by @hramezani in #839
Add note about Mypy plugin for BaseSettings.__init__() by @Viicos in #842
Fix cli_ignore_unknown_args=True not working on subcommands by @hramezani in #844
Bump the python-packages group with 4 updates by @dependabot[bot] in #847
Fix CLI descriptions lost under python -OO by falling back to json_schema_extra by @hramezani in #843
Prepare release 2.14.0 by @hramezani in #848

New Contributors

@dependabot[bot] made their first contribution in #802
@JacobHayes made their first contribution in #776
@bradykieffer made their first contribution in #799
@CaselIT made their first contribution in #832

Full Changelog: v2.13.1...v2.14.0

Open source →

Additional notes

v2.14.0

Compare

Choose a tag to compare

Open source →

2.13.119 Feb 2026

Fix regression for bool fields since 2.13.0 by @hramezani in #784

What's Changed

Fix regression for bool fields since 2.13.0 by @hramezani in #784
Fix RecursionError with self-referential models in CliApp by @hramezani in #783
Fix CLI parsing error for set field types since 2.13.0 (#787) by @hramezani in #788
Fix AttributeError with nested env vars for dict fields (#785) by @hramezani in #786
Fix JSON decoding for parameterized PEP 695 type aliases by @hramezani in #780
v2.13.1 by @hramezani in #790

Full Changelog: v2.13.0...v2.13.1

Open source →

Additional notes

v2.13.1

Compare

Choose a tag to compare

Open source →

2.13.015 Feb 2026

fix: Deterministic alias selection when using validate_by_name by @chbndrhnns in #707

What's Changed

fix: Deterministic alias selection when using validate_by_name by @chbndrhnns in #707
add deep merge functionality to config file sources by @pmeier in #698
Add support for AWS Secrets Manager VersionId parameter by @jcyamacho in #708
bugfix: Return None for inaccessible GCP Secret Manager secrets by @zaphod72 in #712
Bugfix for cli_kebab_case="all" and CliImplicitFlag[bool] by @Digity101 in #702
Unpack type alisases when looking for NoDecode by @tselepakis in #695
CliToggleFlag and CliDualFlag by @kschwab in #717
Fix for CLI duplicate enum field values. by @kschwab in #722
fixed load nested config from env by @Sube-py in #723
Add non-Path files support (for example Traversable) and open files using Path.open method by @mahenzon in #724
add one more traversable test by @mahenzon in #725
CLI fix fox external list args. by @kschwab in #727
fix: handle case-insensitive retrieval in GoogleSecretManagerSettingsSource by @ezwiefel in #730
CLI test fixes for help text formatting. by @kschwab in #735
Avoid conflicts with the NAME environment variable in WSL by @kzrnm in #747
fix: When restoring init kwargs, use deterministic order by @chbndrhnns in #746
Add env_prefix_target by @kzrnm in #749
Remove (default: …) in the help message for CliToggleFlag by @kzrnm in #740
Add support for CLI serialize styles. by @kschwab in #755
Add support for overriding default help on CLI internal parser. by @kschwab in #758
CLI format_help method support by @kschwab in #759
feat(gcp): support SecretVersion annotation for per-field secret versioning by @ezwiefel in #763
Allow snake_case_conversion with env_prefix for Azure Key Vault source by @cstarkers in #762
fix: Only override preferred_key when no value was found by @chbndrhnns in #767
Update deps by @hramezani in #768
CLI coerce numeric types. by @kschwab in #769
CLI Union Discriminator Choices in Help by @kschwab in #764
Add nested path support for yaml_config_section (fixes #772) by @hugo-romero-mm in #773
Prepare release 2.13.0 by @hramezani in #777

New Contributors

@pmeier made their first contribution in #698
@jcyamacho made their first contribution in #708
@zaphod72 made their first contribution in #712
@Digity101 made their first contribution in #702
@Sube-py made their first contribution in #723
@mahenzon made their first contribution in #724
@kzrnm made their first contribution in #747
@cstarkers made their first contribution in #762
@hugo-romero-mm made their first contribution in #773

Full Changelog: v2.12.0...v2.13.0

Open source →

Additional notes

v2.13.0

Compare

Choose a tag to compare

Open source →

2.12.010 Nov 2025

Support for enum kebab case. by @kschwab in #686

What's Changed

Support for enum kebab case. by @kschwab in #686
Apply source order: init > env > dotenv > secrets > defaults and pres… by @chbndrhnns in #688
Add NestedSecretsSettings source by @makukha in #690
Strip non-explicit default values. by @kschwab in #692
Coerce env vars if strict is True. by @kschwab in #693
Restore init kwarg names before returning final state dictionary. by @kschwab in #700
Drop Python3.9 support by @hramezani in #699
Adapt test_protected_namespace_defaults for dev. Pydantic by @musicinmybrain in #637
Add Python 3.14 by @hramezani in #704
Prepare release 2.12 by @hramezani in #705

New Contributors

@chbndrhnns made their first contribution in #688

Full Changelog: v2.11.0...v2.12.0

Open source →

Additional notes

v2.12.0

Compare

Choose a tag to compare

Open source →

2.11.024 Sept 2025

CLI Serialize Support by @kschwab in #643

What's Changed

CLI Serialize Support by @kschwab in #643
Inspect type aliases to determine if an annotation is complex by @tselepakis in #644
Revert "fix: Respect 'cli_parse_args' from model_config with settings_customise_sources (#611)" by @hramezani in #655
Remove parsing of command line arguments from CliSettingsSource.__init__. by @trygve-baerland in #656
turn off allow_abbrev on subparsers by @mroch in #658
CLI Serialization Fixes by @kschwab in #649
Fix PydanticModel type checking. by @kschwab in #659
Avoid env_prefix falling back to env vars without prefix by @tselepakis in #648
Warn if model_config sets unused keys for missing settings sources by @HomerusJa in #663
Included endpoint_url kwarg in AWSSecretsManagerSettingsSource class by @adrianohrl in #664
Fix typo ("Accesing") in the "Adding sources" docs by @deepyaman in #668
CLI Windows Path Fix by @kschwab in #669
Cli root model support by @kschwab in #677
Snake case conversion in Azure Key Vault by @AndreuCodina in #680
Make InitSettingsSource resolution deterministic by @enrico-stauss in #681
Update deps by @hramezani in #683

New Contributors

@tselepakis made their first contribution in #644
@trygve-baerland made their first contribution in #656
@mroch made their first contribution in #658
@HomerusJa made their first contribution in #663
@adrianohrl made their first contribution in #664
@deepyaman made their first contribution in #668
@enrico-stauss made their first contribution in #681

Full Changelog: 2.10.1...v2.11.0

Open source →

Additional notes

v2.11.0

Compare

Choose a tag to compare

Open source →

2.10.124 Jun 2025

Fix UnboundLocalError error in _replace_field_names_case_insensitively by @hramezani in #639

What's Changed

Fix UnboundLocalError error in _replace_field_names_case_insensitively by @hramezani in #639
Remove unknown file reference in documentation by @Viicos in #640
Prepare release 2.10.1 by @hramezani in #642

Full Changelog: 2.10.0...2.10.1

Open source →

Additional notes

What's Changed

Fix UnboundLocalError error in _replace_field_names_case_insensitively by @hramezani in https://github.com/pydantic/pydantic-settings/pull/639
Remove unknown file reference in documentation by @Viicos in https://github.com/pydantic/pydantic-settings/pull/640
Prepare release 2.10.1 by @hramezani in https://github.com/pydantic/pydantic-settings/pull/642

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/2.10.0...2.10.1

Open source →

Additional notes

v2.10.1

Compare

Choose a tag to compare

Open source →

2.10.021 Jun 2025

Fix running tests when azure-keyvault-secrets is not installed by @CyberTailor in #601

What's Changed

Fix running tests when azure-keyvault-secrets is not installed by @CyberTailor in #601
Fix running tests when google-cloud-secret-manager is not installed by @CyberTailor in #602
Support loading a specific nested key from YAML in YamlConfigSettingsSource by @Seunghan-Jung in #603
Fix CLI suppression for model group help by @kschwab in #604
Fix missing DEFAULT_PATH import by @hramezani in #606
Fix case-insensitive handling of nested aliases in EnvironmentSettingsSource by @d15ky in #608
Azure Key Vault case insensitive support and dash-underscore translation by @d15ky in #607
fix: Respect 'cli_parse_args' from model_config with settings_customise_sources by @karta9821 in #611
Bump astral-sh/setup-uv by @hramezani in #612
Update packages by @hramezani in #613
Update README.md by @hramezani in #616
Fix CI badge by @hramezani in #617
Update dependencies by @hramezani in #618
Fix coverage report by @hramezani in #619
Fix _consume_object_or_array on unbalanced brackets in JSON strings by @andryak in #621
add region as a parameter to aws secret manager by @barakor-vs in #622
Expose GCP Secret Manager case sensitive option by @bellmatthewf in #626
Update deps by @hramezani in #633
feat: Add cli_shortcuts to CLI settings by @karta9821 in #624
Expose AWS Secrets Manager case sensitive option by @femiadebayo in #629
Prepare release 2.10.0 by @hramezani in #635

New Contributors

@Seunghan-Jung made their first contribution in #603
@d15ky made their first contribution in #608
@karta9821 made their first contribution in #611
@andryak made their first contribution in #621
@barakor-vs made their first contribution in #622
@bellmatthewf made their first contribution in #626
@femiadebayo made their first contribution in #629

Full Changelog: v2.9.1...2.10.0

Open source →

Additional notes

What's Changed

Fix running tests when azure-keyvault-secrets is not installed by @CyberTailor in https://github.com/pydantic/pydantic-settings/pull/601
Fix running tests when google-cloud-secret-manager is not installed by @CyberTailor in https://github.com/pydantic/pydantic-settings/pull/602
Support loading a specific nested key from YAML in YamlConfigSettingsSource by @Seunghan-Jung in https://github.com/pydantic/pydantic-settings/pull/603
Fix CLI suppression for model group help by @kschwab in https://github.com/pydantic/pydantic-settings/pull/604
Fix missing DEFAULT_PATH import by @hramezani in https://github.com/pydantic/pydantic-settings/pull/606
Fix case-insensitive handling of nested aliases in EnvironmentSettingsSource by @d15ky in https://github.com/pydantic/pydantic-settings/pull/608
Azure Key Vault case insensitive support and dash-underscore translation by @d15ky in https://github.com/pydantic/pydantic-settings/pull/607
fix: Respect 'cli_parse_args' from model_config with settings_customise_sources by @karta9821 in https://github.com/pydantic/pydantic-settings/pull/611
Bump astral-sh/setup-uv by @hramezani in https://github.com/pydantic/pydantic-settings/pull/612
Update packages by @hramezani in https://github.com/pydantic/pydantic-settings/pull/613
Update README.md by @hramezani in https://github.com/pydantic/pydantic-settings/pull/616
Fix CI badge by @hramezani in https://github.com/pydantic/pydantic-settings/pull/617
Update dependencies by @hramezani in https://github.com/pydantic/pydantic-settings/pull/618
Fix coverage report by @hramezani in https://github.com/pydantic/pydantic-settings/pull/619
Fix _consume_object_or_array on unbalanced brackets in JSON strings by @andryak in https://github.com/pydantic/pydantic-settings/pull/621
add region as a parameter to aws secret manager by @barakor-vs in https://github.com/pydantic/pydantic-settings/pull/622
Expose GCP Secret Manager case sensitive option by @bellmatthewf in https://github.com/pydantic/pydantic-settings/pull/626
Update deps by @hramezani in https://github.com/pydantic/pydantic-settings/pull/633
feat: Add cli_shortcuts to CLI settings by @karta9821 in https://github.com/pydantic/pydantic-settings/pull/624
Expose AWS Secrets Manager case sensitive option by @femiadebayo in https://github.com/pydantic/pydantic-settings/pull/629
Prepare release 2.10.0 by @hramezani in https://github.com/pydantic/pydantic-settings/pull/635

New Contributors

@Seunghan-Jung made their first contribution in https://github.com/pydantic/pydantic-settings/pull/603
@d15ky made their first contribution in https://github.com/pydantic/pydantic-settings/pull/608
@karta9821 made their first contribution in https://github.com/pydantic/pydantic-settings/pull/611
@andryak made their first contribution in https://github.com/pydantic/pydantic-settings/pull/621
@barakor-vs made their first contribution in https://github.com/pydantic/pydantic-settings/pull/622
@bellmatthewf made their first contribution in https://github.com/pydantic/pydantic-settings/pull/626
@femiadebayo made their first contribution in https://github.com/pydantic/pydantic-settings/pull/629

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.9.1...2.10.0

Additional notes

v2.10.0

Compare

Choose a tag to compare

Open source →

2.9.118 Apr 2025

fix: Expose ConfigFileSourceMixing on top level sources/__init__.py by @jbw-vtl in https://github.com/pydantic/pydantic-settings/pull/597

What's Changed

fix: Expose ConfigFileSourceMixing on top level sources/init.py by @jbw-vtl in https://github.com/pydantic/pydantic-settings/pull/597
Fix typo in gcp secret manager error message by @christian-heusel in https://github.com/pydantic/pydantic-settings/pull/598
Prepare release 2.9.1 by @hramezani in https://github.com/pydantic/pydantic-settings/pull/600

New Contributors

@jbw-vtl made their first contribution in https://github.com/pydantic/pydantic-settings/pull/597
@christian-heusel made their first contribution in https://github.com/pydantic/pydantic-settings/pull/598

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.9.0...v2.9.1

Open source →

2.9.018 Apr 2025

Drop support for Python 3.8 by @Viicos in https://github.com/pydantic/pydantic-settings/pull/560

What's Changed

Drop support for Python 3.8 by @Viicos in https://github.com/pydantic/pydantic-settings/pull/560
Switch to typing-inspection by @Viicos in https://github.com/pydantic/pydantic-settings/pull/556
Introduce uv for Project Management by @KanchiShimono in https://github.com/pydantic/pydantic-settings/pull/547
Refactor sources.py into a subpackage (#546) by @ezwiefel in https://github.com/pydantic/pydantic-settings/pull/548
chore: cleanup by @CodeWithEmad in https://github.com/pydantic/pydantic-settings/pull/563
Fix typo in documentation by @CodeWithEmad in https://github.com/pydantic/pydantic-settings/pull/564
Add support for AWS Secrets Manager by @mavwolverine in https://github.com/pydantic/pydantic-settings/pull/532
Fix minor typo: conotations => connotations by @svenevs in https://github.com/pydantic/pydantic-settings/pull/577
Azure Key Vault: Don't load disabled secret by @AndreuCodina in https://github.com/pydantic/pydantic-settings/pull/578
Add support for GCP Secret Manager by @ezwiefel in https://github.com/pydantic/pydantic-settings/pull/567
CLI JSON Optional Default by @kschwab in https://github.com/pydantic/pydantic-settings/pull/581
Fix for env nested enum. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/589
CLI submodel suppress. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/587
Cli retrieve unknown args by @kschwab in https://github.com/pydantic/pydantic-settings/pull/588
Update pydantic by @hramezani in https://github.com/pydantic/pydantic-settings/pull/593
Fix check in CI by @hramezani in https://github.com/pydantic/pydantic-settings/pull/595

New Contributors

@ezwiefel made their first contribution in https://github.com/pydantic/pydantic-settings/pull/548
@CodeWithEmad made their first contribution in https://github.com/pydantic/pydantic-settings/pull/563
@mavwolverine made their first contribution in https://github.com/pydantic/pydantic-settings/pull/532
@svenevs made their first contribution in https://github.com/pydantic/pydantic-settings/pull/577

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.8.1...v2.9.0

Open source →

2.8.127 Feb 2025

Fix for init source kwarg alias resolution. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/550

What's Changed

Fix for init source kwarg alias resolution. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/550
Revert usage of positional only argument in BaseSettings.__init__ by @Viicos in https://github.com/pydantic/pydantic-settings/pull/557
Revert use of object instead of Any by @Viicos in https://github.com/pydantic/pydantic-settings/pull/559
Prepare release 2.8.1 by @hramezani in https://github.com/pydantic/pydantic-settings/pull/558

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.8.0...v2.8.1

Open source →

2.8.021 Feb 2025

CLI support for optional and variadic positional args by @kschwab in https://github.com/pydantic/pydantic-settings/pull/519

What's Changed

CLI support for optional and variadic positional args by @kschwab in https://github.com/pydantic/pydantic-settings/pull/519
Improve env_prefix config doc by @hramezani in https://github.com/pydantic/pydantic-settings/pull/523
Add env_nested_max_split setting by @gsakkis in https://github.com/pydantic/pydantic-settings/pull/534
Avoid using Any in BaseSettings signature to avoid mypy errors by @Viicos in https://github.com/pydantic/pydantic-settings/pull/529
Asynchronous CLI methods in CliApp by @KanchiShimono in https://github.com/pydantic/pydantic-settings/pull/533
Don't explode env vars if env_nested_delimiter is empty by @gsakkis in https://github.com/pydantic/pydantic-settings/pull/540
Prepare release 2.8.0 by @hramezani in https://github.com/pydantic/pydantic-settings/pull/541

New Contributors

@gsakkis made their first contribution in https://github.com/pydantic/pydantic-settings/pull/534
@KanchiShimono made their first contribution in https://github.com/pydantic/pydantic-settings/pull/533

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.7.1...v2.8.0

Open source →

2.7.131 Dec 2024

Move preferred alias resolution to private method by @kschwab in https://github.com/pydantic/pydantic-settings/pull/507

What's Changed

Move preferred alias resolution to private method by @kschwab in https://github.com/pydantic/pydantic-settings/pull/507
Prepare release 2.7.1 by @hramezani in https://github.com/pydantic/pydantic-settings/pull/511

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.7.0...v2.7.1

Open source →

2.7.013 Dec 2024

Fix test_protected_namespace_defaults with -Wdefault by @CyberTailor in https://github.com/pydantic/pydantic-settings/pull/462

What's Changed

Fix test_protected_namespace_defaults with -Wdefault by @CyberTailor in https://github.com/pydantic/pydantic-settings/pull/462
Make tests more robust to the running environment by @CyberTailor in https://github.com/pydantic/pydantic-settings/pull/464
Fix rendering of annotations in code example by @Viicos in https://github.com/pydantic/pydantic-settings/pull/470
Fix alias resolution for default settings source. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/468
Use the class name in the __repr__ implementations by @dlax in https://github.com/pydantic/pydantic-settings/pull/465
Fix default help text for union of submodels. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/472
Add support for CliMutuallyExclusiveGroup. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/473
Disable abbreviations on internal parser. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/477
Fix Secret field parsing by @hramezani in https://github.com/pydantic/pydantic-settings/pull/478
Fix alias resolution to use preferred key. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/481
Strip annotated when getting submodels during CLI parsing. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/490
Removing return type from the function in test by @hramezani in https://github.com/pydantic/pydantic-settings/pull/491
Relax default protected_namespaces by @hramezani in https://github.com/pydantic/pydantic-settings/pull/483
Add support for CLI kebab case flag. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/489
Change reference of default values validation in documentation by @Viicos in https://github.com/pydantic/pydantic-settings/pull/496
Improve field value parsing by adding NoDecode and ForceDecode annotations by @hramezani in https://github.com/pydantic/pydantic-settings/pull/492
Fix attribute error on Python 3.9 with typing.Sequence by @hramezani in https://github.com/pydantic/pydantic-settings/pull/497
Prepare release 2.7.0 by @hramezani in https://github.com/pydantic/pydantic-settings/pull/499

New Contributors

@CyberTailor made their first contribution in https://github.com/pydantic/pydantic-settings/pull/462
@dlax made their first contribution in https://github.com/pydantic/pydantic-settings/pull/465

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.6.1...v2.7.0

Open source →

2.6.11 Nov 2024

Add Python 3.13 support by @hramezani in https://github.com/pydantic/pydantic-settings/pull/450

What's Changed

Add Python 3.13 support by @hramezani in https://github.com/pydantic/pydantic-settings/pull/450
Fixes #452 - Adding support for populate_by_name by @hozn in https://github.com/pydantic/pydantic-settings/pull/454
Refactor path_type_label by @aberenda-optifino in https://github.com/pydantic/pydantic-settings/pull/458
Revert "Fix context not passed to field validators bug (#417)" by @hramezani in https://github.com/pydantic/pydantic-settings/pull/459

New Contributors

@hozn made their first contribution in https://github.com/pydantic/pydantic-settings/pull/454
@aberenda-optifino made their first contribution in https://github.com/pydantic/pydantic-settings/pull/458

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.6.0...v2.6.1

Open source →

2.6.017 Oct 2024

Fix nested model field with alias parsing by @hramezani in https://github.com/pydantic/pydantic-settings/pull/400

What's Changed

Fix nested model field with alias parsing by @hramezani in https://github.com/pydantic/pydantic-settings/pull/400
Fix PathType typing in case of sequence by @just-maiyak in https://github.com/pydantic/pydantic-settings/pull/402
Add cli_ignore_unknown_args config option. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/405
Fix AzureKeyVaultSettingsSource problem in case of field with underscore by @hramezani in https://github.com/pydantic/pydantic-settings/pull/415
Add cli_flag_prefix_char config option. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/418
Fix nested model AliasChoices in validation alias by @hramezani in https://github.com/pydantic/pydantic-settings/pull/411
Add CLI App Support by @kschwab in https://github.com/pydantic/pydantic-settings/pull/389
Fix context not passed to field validators bug by @hramezani in https://github.com/pydantic/pydantic-settings/pull/417
Fix a regression in dotenv optional nested field by @hramezani in https://github.com/pydantic/pydantic-settings/pull/423
Put tests for non-default sources in separate files by @makukha in https://github.com/pydantic/pydantic-settings/pull/429
Update nested model partial update docs example. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/433
Add support for suppressing fields from CLI help. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/436
Fix bug in dotenv source when there is env with and without prefix by @hramezani in https://github.com/pydantic/pydantic-settings/pull/440
Prepare release 2.6.0 by @hramezani in https://github.com/pydantic/pydantic-settings/pull/444

New Contributors

@just-maiyak made their first contribution in https://github.com/pydantic/pydantic-settings/pull/402

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.5.2...v2.6.0

Open source →

2.5.211 Sept 2024

Second fix for the TypeError bug introduced in 2.5 by @hramezani in https://github.com/pydantic/pydantic-settings/pull/396

What's Changed

Second fix for the TypeError bug introduced in 2.5 by @hramezani in https://github.com/pydantic/pydantic-settings/pull/396

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.5.1...v2.5.2

Open source →

2.5.111 Sept 2024

Fix TypeError introduced in 2.5 by @hramezani in https://github.com/pydantic/pydantic-settings/pull/392

What's Changed

Fix TypeError introduced in 2.5 by @hramezani in https://github.com/pydantic/pydantic-settings/pull/392

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.5.0...v2.5.1

Open source →

2.5.010 Sept 2024

Fix a bug in nested vanila dataclass by @hramezani in https://github.com/pydantic/pydantic-settings/pull/357

What's Changed

Fix a bug in nested vanila dataclass by @hramezani in https://github.com/pydantic/pydantic-settings/pull/357
CLI Improve Docstring Help Text by @kschwab in https://github.com/pydantic/pydantic-settings/pull/359
Cli fix default or none object help text by @kschwab in https://github.com/pydantic/pydantic-settings/pull/364
Determine RootModel complexity from root type by @user1584 in https://github.com/pydantic/pydantic-settings/pull/344
Add CLI bool flags by @kschwab in https://github.com/pydantic/pydantic-settings/pull/365
CLI arg list whitespaces fix. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/369
Add nested_model_default_partial_update flag and DefaultSettingsSource by @kschwab in https://github.com/pydantic/pydantic-settings/pull/348
Parse enum fixes. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/367
Fixes CLI help text for function types by @kschwab in https://github.com/pydantic/pydantic-settings/pull/370
Add get_subcommand function. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/341
Cli prefix validation alias fix by @kschwab in https://github.com/pydantic/pydantic-settings/pull/375
CLI ignore external parser list fix by @kschwab in https://github.com/pydantic/pydantic-settings/pull/379
Enable multiple secrets dirs by @makukha in https://github.com/pydantic/pydantic-settings/pull/372
Add CLI subcommand union and alias support by @kschwab in https://github.com/pydantic/pydantic-settings/pull/380
Fix dotenv settings source problem in handling extra variables with same prefix in name by @hramezani in https://github.com/pydantic/pydantic-settings/pull/386

New Contributors

@user1584 made their first contribution in https://github.com/pydantic/pydantic-settings/pull/344
@makukha made their first contribution in https://github.com/pydantic/pydantic-settings/pull/372

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.4.0...v2.5.0

Open source →

2.4.030 Jul 2024Deprecated

Deprecate read_env_file and move it to DotEnvSettingsSource by @WarpedPixel in https://github.com/pydantic/pydantic-settings/pull/318

What's Changed

Fix regex flags accidentally passed as count by @musicinmybrain in https://github.com/pydantic/pydantic-settings/pull/328
Deprecate read_env_file and move it to DotEnvSettingsSource by @WarpedPixel in https://github.com/pydantic/pydantic-settings/pull/318
Fix a bug when loading empty yaml file by @hramezani in https://github.com/pydantic/pydantic-settings/pull/330
feat: Enable access to the current state in settings sources by @VictorColomb in https://github.com/pydantic/pydantic-settings/pull/326
Add support for short options. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/339
Add Azure Key Vault settings source by @AndreuCodina in https://github.com/pydantic/pydantic-settings/pull/272
Add cli_exit_on_error config option by @kschwab in https://github.com/pydantic/pydantic-settings/pull/340

New Contributors

@musicinmybrain made their first contribution in https://github.com/pydantic/pydantic-settings/pull/328
@WarpedPixel made their first contribution in https://github.com/pydantic/pydantic-settings/pull/318
@VictorColomb made their first contribution in https://github.com/pydantic/pydantic-settings/pull/326
@AndreuCodina made their first contribution in https://github.com/pydantic/pydantic-settings/pull/272

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.3.4...v2.4.0

Open source →

2.3.424 Jun 2024

add in-place reloading in docs by @nrolin in https://github.com/pydantic/pydantic-settings/pull/316

What's Changed

add in-place reloading in docs by @nrolin in https://github.com/pydantic/pydantic-settings/pull/316
Nested pydantic dataclasses and doc fixes. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/317
Remove leftover docstring causing warning on pydantic docs build by @sydney-runkle in https://github.com/pydantic/pydantic-settings/pull/321

New Contributors

@nrolin made their first contribution in https://github.com/pydantic/pydantic-settings/pull/316
@sydney-runkle made their first contribution in https://github.com/pydantic/pydantic-settings/pull/321

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.3.3...v2.3.4

Open source →

2.3.313 Jun 2024

Fix an intriduced bug in parsing json field with discriminated union by @hramezani in https://github.com/pydantic/pydantic-settings/pull/312

What's Changed

Fix an intriduced bug in parsing json field with discriminated union by @hramezani in https://github.com/pydantic/pydantic-settings/pull/312
Add CliSettingsSource alias handling for AliasChoices and AliasPath. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/313

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.3.2...v2.3.3

Open source →

2.3.211 Jun 2024

Initialize CLI source on demand. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/305

What's Changed

Initialize CLI source on demand. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/305
Fix command line help from argparse formatting problem by @scottstanie in https://github.com/pydantic/pydantic-settings/pull/307
Fix issue with nested model uppercase field name in case insensitive mode by @hramezani in https://github.com/pydantic/pydantic-settings/pull/309

New Contributors

@scottstanie made their first contribution in https://github.com/pydantic/pydantic-settings/pull/307

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.3.1...v2.3.2

Open source →

2.3.15 Jun 2024

Fix a regression in parsing env value for nested dict by @hramezani in https://github.com/pydantic/pydantic-settings/pull/301

What's Changed

Fix a regression in parsing env value for nested dict by @hramezani in https://github.com/pydantic/pydantic-settings/pull/301

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.3.0...v2.3.1

Open source →

2.3.03 Jun 2024

Add environment parsing support for enums. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/252

What's Changed

Add environment parsing support for enums. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/252
Improve explode_env_vars for better dict handling by @hramezani in https://github.com/pydantic/pydantic-settings/pull/261
add PyprojectTomlConfigSettingsSource by @ITProKyle in https://github.com/pydantic/pydantic-settings/pull/255
Fix broken link in AliasChoices class by @keenranger in https://github.com/pydantic/pydantic-settings/pull/271
Update Pydantic by @hramezani in https://github.com/pydantic/pydantic-settings/pull/273
fix: superfluous deep env conflicts with non-dict model leaf by @diefans in https://github.com/pydantic/pydantic-settings/pull/276
fix: a second level of environment nesting expected a dict by @diefans in https://github.com/pydantic/pydantic-settings/pull/281
Fix an issue when inner types of a discriminated union with a callable discriminator were not correctly identified as complex. by @jenskeiner in https://github.com/pydantic/pydantic-settings/pull/285
Fix a bug when we have case insentive field in nested model by @hramezani in https://github.com/pydantic/pydantic-settings/pull/294
Add CLI Settings Source by @kschwab in https://github.com/pydantic/pydantic-settings/pull/214

New Contributors

@ITProKyle made their first contribution in https://github.com/pydantic/pydantic-settings/pull/255
@keenranger made their first contribution in https://github.com/pydantic/pydantic-settings/pull/271
@diefans made their first contribution in https://github.com/pydantic/pydantic-settings/pull/276
@jenskeiner made their first contribution in https://github.com/pydantic/pydantic-settings/pull/285

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.2.1...v2.3.0

Open source →

2.2.119 Feb 2024

respect env_prefix when extra allowed by @zzstoatzz in https://github.com/pydantic/pydantic-settings/pull/238

What's Changed

respect env_prefix when extra allowed by @zzstoatzz in https://github.com/pydantic/pydantic-settings/pull/238
Replace tomlkit with tomli and remove toml_file_encoding config by @hramezani in https://github.com/pydantic/pydantic-settings/pull/236
Revert "Allow nested env var source to override nested init source." by @hramezani in https://github.com/pydantic/pydantic-settings/pull/243

New Contributors

@zzstoatzz made their first contribution in https://github.com/pydantic/pydantic-settings/pull/238

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.2.0...v2.2.1

Open source →

2.2.016 Feb 2024

Fix documentation and update pydantic and pydantic-core dependancies by @Xunop in https://github.com/pydantic/pydantic-settings/pull/194

What's Changed

Fix documentation and update pydantic and pydantic-core dependancies by @Xunop in https://github.com/pydantic/pydantic-settings/pull/194
Correct a typo in README.md by @felixonmars in https://github.com/pydantic/pydantic-settings/pull/195
feat: ignore empty env vars by @niventc in https://github.com/pydantic/pydantic-settings/pull/198
Allow nested env var source to override nested init source. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/204
Fix typo in explode_env_vars() docstring by @paytonward6 in https://github.com/pydantic/pydantic-settings/pull/207
Add support for parsing environment "None" strings to None. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/206
Ensure extra='forbid' is enforced in DotEnvSettingsSource when env_prefix is specified by @kjithin in https://github.com/pydantic/pydantic-settings/pull/218
Fix for JSON on optional nested types. by @kschwab in https://github.com/pydantic/pydantic-settings/pull/217
Improve docs by @hramezani in https://github.com/pydantic/pydantic-settings/pull/225
feat: adding json, yaml and toml sources by @Smixi in https://github.com/pydantic/pydantic-settings/pull/211
Fix dotenv source extra values parsing provided in dotenv file by @hramezani in https://github.com/pydantic/pydantic-settings/pull/221
Update requirements by @hramezani in https://github.com/pydantic/pydantic-settings/pull/233
Prepare release 2.2.0 by @hramezani in https://github.com/pydantic/pydantic-settings/pull/232

New Contributors

@Xunop made their first contribution in https://github.com/pydantic/pydantic-settings/pull/194
@felixonmars made their first contribution in https://github.com/pydantic/pydantic-settings/pull/195
@niventc made their first contribution in https://github.com/pydantic/pydantic-settings/pull/198
@kschwab made their first contribution in https://github.com/pydantic/pydantic-settings/pull/204
@paytonward6 made their first contribution in https://github.com/pydantic/pydantic-settings/pull/207
@kjithin made their first contribution in https://github.com/pydantic/pydantic-settings/pull/218
@Smixi made their first contribution in https://github.com/pydantic/pydantic-settings/pull/211

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.1.0...v2.2.0

Open source →

2.1.014 Nov 2023

Fix code for mentioned variable in Settings Management by @ikosmala in https://github.com/pydantic/pydantic-settings/pull/146

What's Changed

Fix code for mentioned variable in Settings Management by @ikosmala in https://github.com/pydantic/pydantic-settings/pull/146
Add docs to explain env_prefix does not apply to field alias by @hramezani in https://github.com/pydantic/pydantic-settings/pull/147
Remove old code relatd to optional dotenv by @hramezani in https://github.com/pydantic/pydantic-settings/pull/155
Fix broken links by @hramezani in https://github.com/pydantic/pydantic-settings/pull/160
Add note about nested model should inherit BaseModel by @hramezani in https://github.com/pydantic/pydantic-settings/pull/165
Fix #166 - Add docs for validating default values by @stinovlas in https://github.com/pydantic/pydantic-settings/pull/168
Update links by @hramezani in https://github.com/pydantic/pydantic-settings/pull/170
Fix typo at Environment variable names section by @iagorrr in https://github.com/pydantic/pydantic-settings/pull/173
resolve nested code fence line numbering by @johndutchover in https://github.com/pydantic/pydantic-settings/pull/182
Confirm Python 3.12 support by @hramezani in https://github.com/pydantic/pydantic-settings/pull/174
Drop Python 3.7 by @hramezani in https://github.com/pydantic/pydantic-settings/pull/188

New Contributors

@ikosmala made their first contribution in https://github.com/pydantic/pydantic-settings/pull/146
@stinovlas made their first contribution in https://github.com/pydantic/pydantic-settings/pull/168
@iagorrr made their first contribution in https://github.com/pydantic/pydantic-settings/pull/173
@johndutchover made their first contribution in https://github.com/pydantic/pydantic-settings/pull/182

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.0.3...v2.1.0

Open source →

2.0.314 Aug 2023

Fix _replace_field_names_case_insensitively precondition inconsistency by @AlexVndnblcke in https://github.com/pydantic/pydantic-settings/pull/130

What's Changed

Fix _replace_field_names_case_insensitively precondition inconsistency by @AlexVndnblcke in https://github.com/pydantic/pydantic-settings/pull/130
Check union args to don't consider Optional fields as complex Union by @hramezani in https://github.com/pydantic/pydantic-settings/pull/138

New Contributors

@AlexVndnblcke made their first contribution in https://github.com/pydantic/pydantic-settings/pull/130

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.0.2...v2.0.3

Open source →

2.0.214 Jul 2023

dotenv no error w/ an env key shorter than prefix (#106) by @jvllmr in https://github.com/pydantic/pydantic-settings/pull/107

What's Changed

dotenv no error w/ an env key shorter than prefix (#106) by @jvllmr in https://github.com/pydantic/pydantic-settings/pull/107
Add installation instruction to doc by @hramezani in https://github.com/pydantic/pydantic-settings/pull/111
Add support for adding config through class kwargs by @hramezani in https://github.com/pydantic/pydantic-settings/pull/112
Use pydantic_settings.SettingsConfigDict instead of pydantic.ConfigDict in tests by @hramezani in https://github.com/pydantic/pydantic-settings/pull/119
Add documentation link to README.md by @hramezani in https://github.com/pydantic/pydantic-settings/pull/121
Fix error when no secret file provided for a complex field. by @hramezani in https://github.com/pydantic/pydantic-settings/pull/118
Fix a bug when using BaseSettings with RootModel by @hramezani in https://github.com/pydantic/pydantic-settings/pull/120
Fix typo (fiel_value -> field_value) by @kkirsche in https://github.com/pydantic/pydantic-settings/pull/123
fix typos in pydantic settings module by @kkirsche in https://github.com/pydantic/pydantic-settings/pull/124
Add documentation about compatibility with pydantic 1.x BaseSettings when using dotenv by @SthPhoenix in https://github.com/pydantic/pydantic-settings/pull/127
Separate decoding of complex values into specific method by @dbendall in https://github.com/pydantic/pydantic-settings/pull/128

New Contributors

@jvllmr made their first contribution in https://github.com/pydantic/pydantic-settings/pull/107
@kkirsche made their first contribution in https://github.com/pydantic/pydantic-settings/pull/123
@SthPhoenix made their first contribution in https://github.com/pydantic/pydantic-settings/pull/127
@dbendall made their first contribution in https://github.com/pydantic/pydantic-settings/pull/128

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.0.1...v2.0.2

Open source →

2.0.15 Jul 2023

pydantic V2 is released by @davidhewitt in https://github.com/pydantic/pydantic-settings/pull/99

What's Changed

pydantic V2 is released by @davidhewitt in https://github.com/pydantic/pydantic-settings/pull/99
Add explicit type hint to BaseSettings.model_config by @Viicos in https://github.com/pydantic/pydantic-settings/pull/97
Improve DotenvType to accept str by @hramezani in https://github.com/pydantic/pydantic-settings/pull/96
Use config values as default in PydanticBaseEnvSettingsSource.__init__ by @hramezani in https://github.com/pydantic/pydantic-settings/pull/100
Update to Pydantic 2.0.1 by @hramezani in https://github.com/pydantic/pydantic-settings/pull/101
Prepare for release 2.0.1 by @hramezani in https://github.com/pydantic/pydantic-settings/pull/105

New Contributors

@davidhewitt made their first contribution in https://github.com/pydantic/pydantic-settings/pull/99

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.0.0...v2.0.1

Open source →

2.0.030 Jun 2023

Add mkdocs.yml to run mkdocs locally by @Kludex in https://github.com/pydantic/pydantic-settings/pull/67

What's Changed

Add mkdocs.yml to run mkdocs locally by @Kludex in https://github.com/pydantic/pydantic-settings/pull/67
Add documentation to pyproject by @Kludex in https://github.com/pydantic/pydantic-settings/pull/69
Remove unused plugins from mkdocs.yml by @Kludex in https://github.com/pydantic/pydantic-settings/pull/70
Improve docstrings by @hramezani in https://github.com/pydantic/pydantic-settings/pull/72
✨ Make SettingsConfigDict public by @Kludex in https://github.com/pydantic/pydantic-settings/pull/75
Add enhancements to the index.md by @Kludex in https://github.com/pydantic/pydantic-settings/pull/73
Tweak sources to have case_sensitive and env_prefix usable as args by @Viicos in https://github.com/pydantic/pydantic-settings/pull/76
Update pydantic to 2.0b3 by @hramezani in https://github.com/pydantic/pydantic-settings/pull/83
Add default value to source classes init params by @hramezani in https://github.com/pydantic/pydantic-settings/pull/82
Add Pydantic Json field support by @hramezani in https://github.com/pydantic/pydantic-settings/pull/79
docs: fix link with relative by @m9810223 in https://github.com/pydantic/pydantic-settings/pull/85
Fix code block formatting by @hramezani in https://github.com/pydantic/pydantic-settings/pull/89
Add assignees list to the hooky config by @hramezani in https://github.com/pydantic/pydantic-settings/pull/92

New Contributors

@Viicos made their first contribution in https://github.com/pydantic/pydantic-settings/pull/76
@m9810223 made their first contribution in https://github.com/pydantic/pydantic-settings/pull/85

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.0b1...v2.0.0

Open source →

2.0b223 Jun 2023pre-release

Nothing published for this version

2.0b12 Jun 2023pre-release

Format docs for import by @tpdorsey in https://github.com/pydantic/pydantic-settings/pull/48

What's Changed

Format docs for import by @tpdorsey in https://github.com/pydantic/pydantic-settings/pull/48
Fix fetching env values for nested bytes field by @hramezani in https://github.com/pydantic/pydantic-settings/pull/52
Uprev pydantic to v2.0a4 by @hramezani in https://github.com/pydantic/pydantic-settings/pull/55
Update pydantic and pydantic-core dependancies by @hramezani in https://github.com/pydantic/pydantic-settings/pull/58
Add pytest-examples and make examples in docs testable by @hramezani in https://github.com/pydantic/pydantic-settings/pull/56
Use updated FieldInfo from https://github.com/pydantic/pydantic/pull/5800 by @dmontagu in https://github.com/pydantic/pydantic-settings/pull/59
Update dependencies by @adriangb in https://github.com/pydantic/pydantic-settings/pull/62
Update pydantic to 2.0b1 by @hramezani in https://github.com/pydantic/pydantic-settings/pull/64
Prepare for 2.0a4 release by @hramezani in https://github.com/pydantic/pydantic-settings/pull/65

New Contributors

@tpdorsey made their first contribution in https://github.com/pydantic/pydantic-settings/pull/48
@adriangb made their first contribution in https://github.com/pydantic/pydantic-settings/pull/62

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.0a4...v2.0b1

Open source →

2.0a44 May 2023pre-release

Add Pydantic PyPI classifier by @Kludex in https://github.com/pydantic/pydantic-settings/pull/36

What's Changed

Add Pydantic PyPI classifier by @Kludex in https://github.com/pydantic/pydantic-settings/pull/36
Create py.typed by @Kludex in https://github.com/pydantic/pydantic-settings/pull/45
Considering extra config in dotenv source by @hramezani in https://github.com/pydantic/pydantic-settings/pull/39
Modernize type hints by @hramezani in https://github.com/pydantic/pydantic-settings/pull/46
Prepare for 2.0a4 release by @hramezani in https://github.com/pydantic/pydantic-settings/pull/47

New Contributors

@Kludex made their first contribution in https://github.com/pydantic/pydantic-settings/pull/36

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.0a3...v2.0a4

Open source →

2.0a328 Apr 2023pre-release

Implement proper support for nested complex env values by @hramezani in https://github.com/pydantic/pydantic-settings/pull/22

What's Changed

Implement proper support for nested complex env values by @hramezani in https://github.com/pydantic/pydantic-settings/pull/22
Ignore env_prefix if validation_alias is set by @hramezani in https://github.com/pydantic/pydantic-settings/pull/25
Change the behavior of field_is_complex to be more similar to pydantic v1 by @dmontagu in https://github.com/pydantic/pydantic-settings/pull/31
Adopt pydantic-settings docs for Pydantic V2 by @hramezani in https://github.com/pydantic/pydantic-settings/pull/18
Fix nested model problem when case_sensitive=False by @hramezani in https://github.com/pydantic/pydantic-settings/pull/34
Prepare for 2.0a3 release by @hramezani in https://github.com/pydantic/pydantic-settings/pull/35

New Contributors

@dmontagu made their first contribution in https://github.com/pydantic/pydantic-settings/pull/31

Full Changelog: https://github.com/pydantic/pydantic-settings/compare/v2.0a1...v2.0a3

Open source →

2.0a124 Apr 2023pre-release

Reimplement setting source classes by @hramezani in https://github.com/pydantic/pydantic-settings/pull/15

What's Changed

Reimplement setting source classes by @hramezani in https://github.com/pydantic/pydantic-settings/pull/15
Adopt pydantic-settings with Pydantic V2 by @hramezani in https://github.com/pydantic/pydantic-settings/pull/17
prepare release to use environments by @samuelcolvin in https://github.com/pydantic/pydantic-settings/pull/20
add "check" to ci by @samuelcolvin in https://github.com/pydantic/pydantic-settings/pull/21

New Contributors

@hramezani made their first contribution in https://github.com/pydantic/pydantic-settings/pull/15
@samuelcolvin made their first contribution in https://github.com/pydantic/pydantic-settings/pull/20

Full Changelog: https://github.com/pydantic/pydantic-settings/commits/v2.0a1

Open source →

1.9924 Apr 2023

Nothing published for this version

0.2.53 Jun 2020

Nothing published for this version

0.1.2b09 Sept 2019pre-release

Nothing published for this version

0.1.1b022 Aug 2019pre-release

Nothing published for this version

0.1.0a219 Aug 2019pre-release

Nothing published for this version

0.1.0a119 Aug 2019pre-release

Nothing published for this version

Your coding agent can read these notes before it upgrades. Set up the MCP server →

pydantic-settings

Release timeline

Releases

Highlights

Behavior changes

New features

Bug fixes

Documentation

What's Changed

New Contributors

Choose a tag to compare

What's Changed

Security

Choose a tag to compare

What's Changed

Choose a tag to compare

What's Changed

New Contributors

Choose a tag to compare

What's Changed

Choose a tag to compare

What's Changed

New Contributors

Choose a tag to compare

What's Changed

New Contributors

Choose a tag to compare

What's Changed

New Contributors

Choose a tag to compare

What's Changed

What's Changed

Choose a tag to compare

What's Changed

New Contributors

What's Changed

New Contributors

Choose a tag to compare

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

What's Changed

New Contributors

What's Changed

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

What's Changed

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

What's Changed

New Contributors

What's Changed

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

New Contributors