Adds the Optional type-hint to arguments where the default value is None
Project description
Auto-optional
auto-optional: adds the Optional type-hint to arguments where the default value is None
Documentation: auto-optional.daanluttik.nl
Source Code: github.com/luttik/auto-optional
What does auto-optional do
The basic purpose of auto-optional is ensuring that whenever a default argument is None
the type annotation is Optional.
For example:
def foo(bar: str = None):
...
Would turn into
from typing import Optional
def foo(bar: Optional[str] = None):
...
Why would you want this
- Easily modify external libraries that didn't pay attention to proper use of optional to improve mypy linting.
- Force consistency in your own code-base:
Enforcing that
None
parameter implies anOptional
type. - Explicit is better than implicit — pep 20
In the media:
auto-optional was covered on PythonBytes #251
I love these little tools that you can run against your code that will just reformat them to be better.
— Michael Kennedy
Install
Install with pip install auto-optional
.
Run
After installing you can run auto-optional using auto-optional [path]
(path is an optional argument).
Things of note
Things that are handled well
- The alternatives to
Optional
are supported, that means both;Union[X, None]
x | None
(allowed since python 10+).
- Existing imports are reused.
import as
andfrom typing import ...
statements are properly handled.
Things that need improvement
For all these points you can leave a thumbs-up if you want it. Also, I welcome pull-requests for these issues.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for auto_optional-0.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 627ad755859507a212b3ba997820c66faae10f275594860a01ee1b81c4b6b388 |
|
MD5 | c864da2fe8e8fd8c029391f64b19521d |
|
BLAKE2b-256 | 7686bf28836959290e191ba2a9ea09c7b1af1015790ecbb1548ee5218190105c |