PyPI · #2953 most downloaded on PyPI

simple-parsing

0.1.91.9M downloads/molebrice/SimpleParsing ↗New releases in your daily digest, changelog included.

A small utility to simplify and clean up argument parsing scripts.

Last release 2 months ago
27 Jul 2026
Release timing varies
gaps range from 8 days to 12 months
Some releases are documented
notes for 19 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
74 releases · first in 2019

Release timeline

74 releases since 2019

20192020202120222023202420252026

Releases

0.1.927 Jul 2026
Fix #322 (Union[Literal, ...]) by @lebrice in #325
What's Changed

Fix #322 (Union[Literal, ...]) by @lebrice in #325

Full Changelog: v0.1.8...v0.1.9
Open source →
0.1.820 Jan 2026
Switch to UV and drop Python 3.8 by @lebrice in https://github.com/lebrice/SimpleParsing/pull/340
What's Changed

Switch to UV and drop Python 3.8 by @lebrice in https://github.com/lebrice/SimpleParsing/pull/340

Move pytest configuration to pyproject.toml by @lebrice in https://github.com/lebrice/SimpleParsing/pull/341

Enable Ruff's default rules by @lebrice in https://github.com/lebrice/SimpleParsing/pull/342

Pass custom help formatter to subparsers (#336) by @zrlf in https://github.com/lebrice/SimpleParsing/pull/339

Bugfix: fix optional positional arguments. by @joshlk in https://github.com/lebrice/SimpleParsing/pull/345

Making add_help optional for parse and parse_known_args functions by @farzad-elastix in https://github.com/lebrice/SimpleParsing/pull/360

New Contributors

@zrlf made their first contribution in https://github.com/lebrice/SimpleParsing/pull/339

@farzad-elastix made their first contribution in https://github.com/lebrice/SimpleParsing/pull/360

Full Changelog: https://github.com/lebrice/SimpleParsing/compare/v0.1.7...v0.1.8

0.1.720 Jan 2025

Fix docstring of the dict_union function by @GaetanLepage in https://github.com/lebrice/SimpleParsing/pull/327

What's Changed

Fix docstring of the dict_union function by @GaetanLepage in https://github.com/lebrice/SimpleParsing/pull/327
Fix #307: Replace logger.info with logger.debug by @bguisard in https://github.com/lebrice/SimpleParsing/pull/328
Try a fix for broken docformatter pre-commit hook by @lebrice in https://github.com/lebrice/SimpleParsing/pull/333
Remove dead code and manage dependencies with poetry by @42nick in https://github.com/lebrice/SimpleParsing/pull/330
Add option to specify config path argument name by @joshlk in https://github.com/lebrice/SimpleParsing/pull/334

New Contributors

@GaetanLepage made their first contribution in https://github.com/lebrice/SimpleParsing/pull/327
@bguisard made their first contribution in https://github.com/lebrice/SimpleParsing/pull/328
@42nick made their first contribution in https://github.com/lebrice/SimpleParsing/pull/330
@joshlk made their first contribution in https://github.com/lebrice/SimpleParsing/pull/334

Full Changelog: https://github.com/lebrice/SimpleParsing/compare/v0.1.6...v0.1.7

Open source →

Additional notes

What's Changed

Fix docstring of the dict_union function by @GaetanLepage in #327
Fix #307: Replace logger.info with logger.debug by @bguisard in #328
Try a fix for broken docformatter pre-commit hook by @lebrice in #333
Remove dead code and manage dependencies with poetry by @42nick in #330
Add option to specify config path argument name by @joshlk in #334

New Contributors

@GaetanLepage made their first contribution in #327
@bguisard made their first contribution in #328
@42nick made their first contribution in #330
@joshlk made their first contribution in #334

Full Changelog: v0.1.6...v0.1.7

Open source →

0.1.65 Sept 2024

Drop python 3.7 + Setup Poetry + CodeCov + Pre-Commit by @lebrice in https://github.com/lebrice/SimpleParsing/pull/300

What's Changed

Drop python 3.7 + Setup Poetry + CodeCov + Pre-Commit by @lebrice in https://github.com/lebrice/SimpleParsing/pull/300
Fix the benchmark workflow by @lebrice in https://github.com/lebrice/SimpleParsing/pull/302
Fix the 'upload' benchmark workflow by @lebrice in https://github.com/lebrice/SimpleParsing/pull/303
Add codecov inline PR comments by @lebrice in https://github.com/lebrice/SimpleParsing/pull/305
Fix is_optional(Literal[None]) by @krzentner in https://github.com/lebrice/SimpleParsing/pull/323
Try to use stdlib tomllib before tomli by @bkad in https://github.com/lebrice/SimpleParsing/pull/318

New Contributors

@krzentner made their first contribution in https://github.com/lebrice/SimpleParsing/pull/323
@bkad made their first contribution in https://github.com/lebrice/SimpleParsing/pull/318

Full Changelog: https://github.com/lebrice/SimpleParsing/compare/v0.1.5...v0.1.6

What's Changed

Drop python 3.7 + Setup Poetry + CodeCov + Pre-Commit by @lebrice in https://github.com/lebrice/SimpleParsing/pull/300
Fix the benchmark workflow by @lebrice in https://github.com/lebrice/SimpleParsing/pull/302
Fix the 'upload' benchmark workflow by @lebrice in https://github.com/lebrice/SimpleParsing/pull/303
Add codecov inline PR comments by @lebrice in https://github.com/lebrice/SimpleParsing/pull/305
Fix is_optional(Literal[None]) by @krzentner in https://github.com/lebrice/SimpleParsing/pull/323
Try to use stdlib tomllib before tomli by @bkad in https://github.com/lebrice/SimpleParsing/pull/318
Try to fix broken(?) python-publish.yml by @lebrice in https://github.com/lebrice/SimpleParsing/pull/324

New Contributors

@krzentner made their first contribution in https://github.com/lebrice/SimpleParsing/pull/323
@bkad made their first contribution in https://github.com/lebrice/SimpleParsing/pull/318

Full Changelog: https://github.com/lebrice/SimpleParsing/compare/v0.1.5...v0.1.6

Open source →

Additional notes

What's Changed

Drop python 3.7 + Setup Poetry + CodeCov + Pre-Commit by @lebrice in #300
Fix the benchmark workflow by @lebrice in #302
Fix the 'upload' benchmark workflow by @lebrice in #303
Add codecov inline PR comments by @lebrice in #305
Fix is_optional(Literal[None]) by @krzentner in #323
Try to use stdlib tomllib before tomli by @bkad in #318

New Contributors

@krzentner made their first contribution in #323
@bkad made their first contribution in #318

Full Changelog: v0.1.5...v0.1.6

What's Changed

Drop python 3.7 + Setup Poetry + CodeCov + Pre-Commit by @lebrice in #300
Fix the benchmark workflow by @lebrice in #302
Fix the 'upload' benchmark workflow by @lebrice in #303
Add codecov inline PR comments by @lebrice in #305
Fix is_optional(Literal[None]) by @krzentner in #323
Try to use stdlib tomllib before tomli by @bkad in #318
Try to fix broken(?) python-publish.yml by @lebrice in #324

New Contributors

@krzentner made their first contribution in #323
@bkad made their first contribution in #318

Full Changelog: v0.1.5...v0.1.6

0.1.531 Jan 2024

Faster import (lazy numpy) by @lebrice in https://github.com/lebrice/SimpleParsing/pull/285

What's Changed

Faster import (lazy numpy) by @lebrice in https://github.com/lebrice/SimpleParsing/pull/285
Add support for TOML config files by @diggerk in https://github.com/lebrice/SimpleParsing/pull/289
Remove the benchmark-comment workflow for now by @lebrice in https://github.com/lebrice/SimpleParsing/pull/291
Disallow extra nonexistent fields by @anivegesana in https://github.com/lebrice/SimpleParsing/pull/290
fix broken link by @stas00 in https://github.com/lebrice/SimpleParsing/pull/292

New Contributors

@diggerk made their first contribution in https://github.com/lebrice/SimpleParsing/pull/289
@anivegesana made their first contribution in https://github.com/lebrice/SimpleParsing/pull/290
@stas00 made their first contribution in https://github.com/lebrice/SimpleParsing/pull/292

Full Changelog: https://github.com/lebrice/SimpleParsing/compare/v0.1.4...v0.1.5

Open source →

Additional notes

What's Changed

Faster import (lazy numpy) by @lebrice in #285
Add support for TOML config files by @diggerk in #289
Remove the benchmark-comment workflow for now by @lebrice in #291
Disallow extra nonexistent fields by @anivegesana in #290
fix broken link by @stas00 in #292

New Contributors

@diggerk made their first contribution in #289
@anivegesana made their first contribution in #290
@stas00 made their first contribution in #292

Full Changelog: v0.1.4...v0.1.5

Open source →

0.1.47 Aug 2023

Simplify and Fix test_decorator.py by @lebrice in https://github.com/lebrice/SimpleParsing/pull/273

What's Changed

Simplify and Fix test_decorator.py by @lebrice in https://github.com/lebrice/SimpleParsing/pull/273
Remove PyTorch as a test dependency by @lebrice in https://github.com/lebrice/SimpleParsing/pull/274
Add replace_subgroups function by @zhiruiluo in https://github.com/lebrice/SimpleParsing/pull/215
add confilct_resolver_max_attempts property by @JonasFrey96 in https://github.com/lebrice/SimpleParsing/pull/272
Increase import performance (lru_cache) and add pytest-benchmark by @lebrice in https://github.com/lebrice/SimpleParsing/pull/279
Add Performance Regression tests to CI by @lebrice in https://github.com/lebrice/SimpleParsing/pull/282

New Contributors

@JonasFrey96 made their first contribution in https://github.com/lebrice/SimpleParsing/pull/272

Full Changelog: https://github.com/lebrice/SimpleParsing/compare/v0.1.3...v0.1.4

Open source →

0.1.36 Jun 2023

Fix AttributeError in field_parsing.py by @lebrice in https://github.com/lebrice/SimpleParsing/pull/251

What's Changed

Fix AttributeError in field_parsing.py by @lebrice in https://github.com/lebrice/SimpleParsing/pull/251
Add lru_cache wrapper in docstring parsing by @lebrice in https://github.com/lebrice/SimpleParsing/pull/252
added example for how to use the flag helper by @LTluttmann in https://github.com/lebrice/SimpleParsing/pull/256
Lazy import of numpy/torch etc. by @breuleux in https://github.com/lebrice/SimpleParsing/pull/253
Fix literals for Python 3.9 by @brentyi in https://github.com/lebrice/SimpleParsing/pull/260
Add test to reproduce #259 by @lebrice in https://github.com/lebrice/SimpleParsing/pull/262
upgrade precommit hooks by @lebrice in https://github.com/lebrice/SimpleParsing/pull/263

New Contributors

@LTluttmann made their first contribution in https://github.com/lebrice/SimpleParsing/pull/256
@breuleux made their first contribution in https://github.com/lebrice/SimpleParsing/pull/253
@brentyi made their first contribution in https://github.com/lebrice/SimpleParsing/pull/260

Full Changelog: https://github.com/lebrice/SimpleParsing/compare/v0.1.2...v0.1.3

Open source →

0.1.2.post127 Apr 2023

Fix AttributeError in field_parsing.py by @lebrice in https://github.com/lebrice/SimpleParsing/pull/251

What's Changed

Fix AttributeError in field_parsing.py by @lebrice in https://github.com/lebrice/SimpleParsing/pull/251
Add lru_cache wrapper in docstring parsing by @lebrice in https://github.com/lebrice/SimpleParsing/pull/252

Full Changelog: https://github.com/lebrice/SimpleParsing/compare/v0.1.2...v0.1.2.post1

Open source →

Additional notes

What's Changed

Fix AttributeError in field_parsing.py by @lebrice in #251
Add lru_cache wrapper in docstring parsing by @lebrice in #252

Full Changelog: v0.1.2...v0.1.2.post1

Open source →

0.1.219 Apr 2023

fix postponed annotation when field is overwritten by @mixilchenko in https://github.com/lebrice/SimpleParsing/pull/228

What's Changed

fix postponed annotation when field is overwritten by @mixilchenko in https://github.com/lebrice/SimpleParsing/pull/228
Fix bad link in docs/README.md by @lebrice in https://github.com/lebrice/SimpleParsing/pull/236
[pre-commit-hook] Change flake8 repo to https://github.com/pycqa/flake8 by @zhiruiluo in https://github.com/lebrice/SimpleParsing/pull/238
Fix #247 by @rhaps0dy in https://github.com/lebrice/SimpleParsing/pull/248
Raise a warning on unsafe/lossy cast to int, float, and bools by @lebrice in https://github.com/lebrice/SimpleParsing/pull/242
Partials - Dynamic Config Dataclasses for arbitrary callables by @lebrice in https://github.com/lebrice/SimpleParsing/pull/156

New Contributors

@rhaps0dy made their first contribution in https://github.com/lebrice/SimpleParsing/pull/248

Full Changelog: https://github.com/lebrice/SimpleParsing/compare/v0.1.1...v0.1.2

Open source →

Additional notes

What's Changed

fix postponed annotation when field is overwritten by @mixilchenko in #228
Fix bad link in docs/README.md by @lebrice in #236
[pre-commit-hook] Change flake8 repo to https://github.com/pycqa/flake8 by @zhiruiluo in #238
Fix #247 by @rhaps0dy in #248
Raise a warning on unsafe/lossy cast to int, float, and bools by @lebrice in #242
Partials - Dynamic Config Dataclasses for arbitrary callables by @lebrice in #156

New Contributors

@rhaps0dy made their first contribution in #248

Full Changelog: v0.1.1...v0.1.2

Open source →

0.1.114 Mar 2023

Add test file for utils.mutable_field function by @lebrice in #218

What's Changed

Add test file for utils.mutable_field function by @lebrice in #218
Add test to illustrate enum serialization, update save/load docstrings by @lebrice in #220
Add support for frozen dataclass instances in subgroups by @lebrice in #224
Make it possible to overwrite a decoding fn for a given type by @lebrice in #232
Improve load/save/to_dict (see description) by @lebrice in #233
Literal types no longer cause a warning on decoding by @norabelrose in #221
Add tests to confirm that #160 and #161 are fixed by @lebrice in #234

New Contributors

@norabelrose made their first contribution in #221

Full Changelog: v0.1.0...v0.1.1

Open source →

0.1.020 Feb 2023

Update the readme to feature the parse api, add tests by @lebrice in https://github.com/lebrice/SimpleParsing/pull/165

What's Changed

Update the readme to feature the parse api, add tests by @lebrice in https://github.com/lebrice/SimpleParsing/pull/165
Add argument prefix to simple_parsing.parse by @JesseFarebro in https://github.com/lebrice/SimpleParsing/pull/175
support dataclasses.InitVar for python>=3.8 by @mixilchenko in https://github.com/lebrice/SimpleParsing/pull/171
Add main decorator for simple parsing of entry functions by @JesseFarebro in https://github.com/lebrice/SimpleParsing/pull/176
Fix typing for sp.main decorator by @JesseFarebro in https://github.com/lebrice/SimpleParsing/pull/177
Apply pre-commit hooks to all files by @lebrice in https://github.com/lebrice/SimpleParsing/pull/178
Also parse field help string from class docstring by @lebrice in https://github.com/lebrice/SimpleParsing/pull/179
Modify forward_refs_to_types to fix issue #181 by @zhiruiluo in https://github.com/lebrice/SimpleParsing/pull/182
Update global namespaces for postponed annotations by @zhiruiluo in https://github.com/lebrice/SimpleParsing/pull/183
Add better support for HuggingFace-style dataclasses by @lebrice in https://github.com/lebrice/SimpleParsing/pull/172
Rework of the subgroups feature + Minor Refactoring by @lebrice in https://github.com/lebrice/SimpleParsing/pull/185
Remove typing-inspect dependency by @lebrice in https://github.com/lebrice/SimpleParsing/pull/193
Add test for Issue 191 (subgroup destinations bug) by @lebrice in https://github.com/lebrice/SimpleParsing/pull/194
Fix confusing default=True bool behavior (Fix #68) by @Conchylicultor in https://github.com/lebrice/SimpleParsing/pull/190
Allow passing functools.partial as entries in the subgroups dict by @lebrice in https://github.com/lebrice/SimpleParsing/pull/196
Fix small bug in type hints of subgroups fn by @lebrice in https://github.com/lebrice/SimpleParsing/pull/200
Reorder some of the methods of ArgumentParser by @lebrice in https://github.com/lebrice/SimpleParsing/pull/202
Fix the Dataclass protocol and make it typing-only by @lebrice in https://github.com/lebrice/SimpleParsing/pull/207
Fix typing of the choice function by @lebrice in https://github.com/lebrice/SimpleParsing/pull/208
Add Python 3.11 Support, rework mutable_field function by @lebrice in https://github.com/lebrice/SimpleParsing/pull/213
Adding the simple_parsing.replace function by @zhiruiluo in https://github.com/lebrice/SimpleParsing/pull/212
[breaking] Rework flag function, restrict nargs on bool fields by @lebrice in https://github.com/lebrice/SimpleParsing/pull/206
Fix error handling issues with replace function by @lebrice in https://github.com/lebrice/SimpleParsing/pull/214
Broaden from_dict applicability to non-Serializable dataclasses by @lebrice in https://github.com/lebrice/SimpleParsing/pull/217

New Contributors

@JesseFarebro made their first contribution in https://github.com/lebrice/SimpleParsing/pull/175
@zhiruiluo made their first contribution in https://github.com/lebrice/SimpleParsing/pull/182
@Conchylicultor made their first contribution in https://github.com/lebrice/SimpleParsing/pull/190

Full Changelog: https://github.com/lebrice/SimpleParsing/compare/v0.0.21...v0.1.0

Open source →

0.0.21.post16 Dec 2022

Update the readme to feature the parse api, add tests by @lebrice in https://github.com/lebrice/SimpleParsing/pull/165

What's Changed

Update the readme to feature the parse api, add tests by @lebrice in https://github.com/lebrice/SimpleParsing/pull/165
Add argument prefix to simple_parsing.parse by @JesseFarebro in https://github.com/lebrice/SimpleParsing/pull/175
support dataclasses.InitVar for python>=3.8 by @mixilchenko in https://github.com/lebrice/SimpleParsing/pull/171
Add main decorator for simple parsing of entry functions by @JesseFarebro in https://github.com/lebrice/SimpleParsing/pull/176
Fix typing for sp.main decorator by @JesseFarebro in https://github.com/lebrice/SimpleParsing/pull/177
Apply pre-commit hooks to all files by @lebrice in https://github.com/lebrice/SimpleParsing/pull/178
Also parse field help string from class docstring by @lebrice in https://github.com/lebrice/SimpleParsing/pull/179
Modify forward_refs_to_types to fix issue #181 by @zhiruiluo in https://github.com/lebrice/SimpleParsing/pull/182

New Contributors

@JesseFarebro made their first contribution in https://github.com/lebrice/SimpleParsing/pull/175
@zhiruiluo made their first contribution in https://github.com/lebrice/SimpleParsing/pull/182

Full Changelog: https://github.com/lebrice/SimpleParsing/compare/v0.0.21...v0.0.21.post1

Open source →

0.0.2119 Oct 2022

Fields with default value of None are treated as optional (even if type annotation is wrong) by @lebrice in https://github.com/lebrice/SimpleParsing/p

What's Changed

Fields with default value of None are treated as optional (even if type annotation is wrong) by @lebrice in https://github.com/lebrice/SimpleParsing/pull/151
Drop support for Python 3.6 by @lebrice in https://github.com/lebrice/SimpleParsing/pull/153
Add support for simple Literal fields by @lebrice in https://github.com/lebrice/SimpleParsing/pull/152
Export enums in main package init by @lebrice in https://github.com/lebrice/SimpleParsing/pull/155
Add pre-commit and run on all files by @lebrice in https://github.com/lebrice/SimpleParsing/pull/154
Add better support for setting defaults from Config files by @lebrice in https://github.com/lebrice/SimpleParsing/pull/158
Fix bug in docstring parsing, docstrings inherit from bases by @lebrice in https://github.com/lebrice/SimpleParsing/pull/164
Add parse to all for simple_parsing.parse by @lebrice in https://github.com/lebrice/SimpleParsing/pull/170

Full Changelog: https://github.com/lebrice/SimpleParsing/compare/v0.0.20...v0.0.21

Open source →

0.0.207 Jun 2022

force_full_path option to use always full paths to fields as option string by @ivanprado in https://github.com/lebrice/SimpleParsing/pull/117

What's Changed

force_full_path option to use always full paths to fields as option string by @ivanprado in https://github.com/lebrice/SimpleParsing/pull/117
Include requirements.txt by @thewchan in https://github.com/lebrice/SimpleParsing/pull/128
Fix a bug introduced in #117. It affects the DASH option in the nested mode by @ivanprado in https://github.com/lebrice/SimpleParsing/pull/129
Add support for multiple nested argument subgroups by @lebrice in https://github.com/lebrice/SimpleParsing/pull/136
[subgroups] Fix bugs and save chosen subgroup name in namespace by @lebrice in https://github.com/lebrice/SimpleParsing/pull/140
Fix ser/deserialization for enums and Path by @ivanprado in https://github.com/lebrice/SimpleParsing/pull/137
Fix issue with old-style annotation and postponed types by @lebrice in https://github.com/lebrice/SimpleParsing/pull/146
Fix issue 107 (decoding of 'False' -> True) by @lebrice in https://github.com/lebrice/SimpleParsing/pull/147
argparse.SUPPRESS-like functionality for advanced uses by @idoby in https://github.com/lebrice/SimpleParsing/pull/124
Use the globals of the dataclass module when evaluating forward type annotations by @lebrice in https://github.com/lebrice/SimpleParsing/pull/148

New Contributors

@thewchan made their first contribution in https://github.com/lebrice/SimpleParsing/pull/128

Full Changelog: https://github.com/lebrice/SimpleParsing/compare/v0.0.19.post1...v0.0.19.post2

Open source →

0.0.19.post120 Apr 2022

Fix bug with new Union syntax with postponed type annotations by @lebrice in https://github.com/lebrice/SimpleParsing/pull/112

What's Changed

Fix bug with new Union syntax with postponed type annotations by @lebrice in https://github.com/lebrice/SimpleParsing/pull/112
Fix typos by @kianmeng in https://github.com/lebrice/SimpleParsing/pull/116
Fix nesting defaults (based on #113) by @lebrice in https://github.com/lebrice/SimpleParsing/pull/115
Add support for python 3.10, fix tests by @lebrice in https://github.com/lebrice/SimpleParsing/pull/114
Testing out GitHub actions instead of travis by @lebrice in https://github.com/lebrice/SimpleParsing/pull/121
Update badge on README by @lebrice in https://github.com/lebrice/SimpleParsing/pull/122
Try to run actions on PRs from forks too by @lebrice in https://github.com/lebrice/SimpleParsing/pull/125
Removed unnecessary state in ConflictResolver object. by @idoby in https://github.com/lebrice/SimpleParsing/pull/123
Fix #126, deserialization with postponed type ants by @lebrice in https://github.com/lebrice/SimpleParsing/pull/127

New Contributors

@kianmeng made their first contribution in https://github.com/lebrice/SimpleParsing/pull/116

Full Changelog: https://github.com/lebrice/SimpleParsing/compare/v0.0.19...v0.0.19.post1

Open source →

0.0.1819 Jan 2022

This is the first step towards my ultimate goal, which is to have multiple, independent, optional subparsers. Doesn't sound like much now, but this wo

Simple release: Adds optional subparsers.

This is the first step towards my ultimate goal, which is to have multiple, independent, optional subparsers. Doesn't sound like much now, but this would be a killer feature, which would really help simple-parsing step above the subparser limitations of argparse.

This would be especially useful when creating command-line APIs for ML applications, when you might need a subparser for each type of model, or for each type of dataset, or for each type of optimizer, etc etc.

This is best achieved using subparsers, however the current API is a bit clumsy. Here is the roadmap for that feature:

Optional subparsers (This release)
- See this test file if you're curious
Multiple independant subparsers on a single dataclass (Next release)
- See this WIP example if you're curious
Multiple, inter-dependant subparsers (stretch goal)
- (e.g. where the default value is dependant on the types of other fields)

Let me know what you think!

What's Changed

Add FrozenSerializable, fix tests by @lebrice in https://github.com/lebrice/SimpleParsing/pull/102
Add Optional Subparsers by @lebrice in https://github.com/lebrice/SimpleParsing/pull/104

Full Changelog: https://github.com/lebrice/SimpleParsing/compare/v0.0.17...v0.0.18

Open source →