Skip to content

Commit

Permalink
📝 Updated docs
Browse files Browse the repository at this point in the history
  • Loading branch information
Luttik committed Sep 23, 2021
1 parent 117b5d4 commit f50f9e7
Show file tree
Hide file tree
Showing 3 changed files with 25 additions and 5 deletions.
9 changes: 9 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,15 @@ def foo(bar: Optional[str] = None):
to proper use of optional to improve mypy linting.
- Force consistency in your own code-base:
Enforcing that `None` parameter implies an `Optional` type.
- Explicit is better than implicit — [pep 20](https://www.python.org/dev/peps/pep-0020/)

## In the media:
auto-optional was covered on
[PythonBytes #251](https://pythonbytes.fm/episodes/show/251/a-95-complete-episode-wait-for-it)

> 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`.
Expand Down
19 changes: 14 additions & 5 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# Auto-optional
<img src="/assets/images/logo-with-text.svg" style="width: 100%; margin: 32pt 0" alt="Logo">
<img src="https://raw.githubusercontent.com/Luttik/auto-optional/main/docs/assets/images/logo-with-text.svg" style="width: 100%; margin: 32pt 0" alt="Logo">


<p align="center">
Expand Down Expand Up @@ -31,7 +31,7 @@

**Documentation**: [auto-optional.daanluttik.nl](https://auto-optional.daanluttik.nl)

**Source Code**: [github.com/luttik/auto-optional](https://github.com/Luttik/auto-optional)
**Source Code**: [github.com/luttik/auto-optional](https://github.com/Luttik/auto-optional)

---

Expand All @@ -54,10 +54,19 @@ def foo(bar: Optional[str] = None):

## Why would you want this

- Easily modify external libraries that didn't pay attention
- 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 an `Optional` type.
- Force consistency in your own code-base:
Enforcing that `None` parameter implies an `Optional` type.
- Explicit is better than implicit — [pep 20](https://www.python.org/dev/peps/pep-0020/)

## In the media:
auto-optional was covered on
[PythonBytes #251](https://pythonbytes.fm/episodes/show/251/a-95-complete-episode-wait-for-it)

> 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`.
Expand Down
2 changes: 2 additions & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,8 @@ extra_css:
markdown_extensions:
- pymdownx.highlight
- pymdownx.superfences
- admonition
- pymdownx.superfences
- toc:
permalink: true

Expand Down

0 comments on commit f50f9e7

Please sign in to comment.