1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
|
.. _Typer Comparison:
================
Typer Comparison
================
Much of Cyclopts was inspired by the excellent `Typer`_ library.
Despite its popularity, Typer has some traits that I (and others) find less than ideal.
Part of this stems from Typer's age, with its first release in late 2019, soon after Python 3.8's release.
Because of this, most of its API was initially designed around assigning proxy default values to function parameters.
This made the decorated command functions difficult to use outside of Typer.
With the introduction of :obj:`~.typing.Annotated` in python3.9, type-hints were able to be directly annotated, allowing for the removal of these proxy defaults.
Additionally, Typer is built on top of `Click`_.
This makes it difficult for newcomers to figure out which elements are Typer-related and which elements are click-related.
It's also hard to tell whether the following criticisms stem from Typer, or the underlying Click.
For better-or-worse, Cyclopts uses its own internal parsing strategy, gaining complete control over the process.
This section was written about the current version of Typer: ``v0.9.0``.
.. toctree::
:maxdepth: 1
:caption: Topics
argument_vs_option/README.rst
positional_or_keyword/README.rst
choices/README.rst
default_command/README.rst
docstring/README.rst
decorator_parentheses/README.rst
optional_list/README.rst
keyword_multiple_values/README.rst
flag_negation/README.rst
help_defaults/README.rst
validation/README.rst
union_support/README.rst
version_flag/README.rst
documentation/README.rst
.. _Typer: https://typer.tiangolo.com
.. _Click: https://click.palletsprojects.com
|
