```{include} ../../README.md
:relative-docs: docs/source/
:relative-images:
```

```{toctree}
:hidden:

API <api>
```

```{toctree}
:caption: Concepts
:hidden:

Commands <command>
Args <arg>
Subcommands <subcommand>
Invoke <invoke>
Annotations <annotation>
Parse Vs Invoke <parse_vs_invoke>
```

```{toctree}
:caption: Topics
:hidden:

vs Click / Typer / Argparse <comparison>
Dataclasses/Pydantic/Attrs <class_compatibility>
Rich Integration <rich>
Completions <completion>
Console Output and Exiting <output>
Parser Backends (Cappa/Argparse) <backends>
Testing <testing>
Function/Method Based Commands <functions_and_methods>
Examples (vs click/typer/argparse) <examples/index>
```

```{toctree}
:caption: Advanced Topics
:hidden:

Argument Validation <validation>
Help/Help Inference <help>
Asyncio <asyncio>
Sphinx/Docutils Directive <sphinx>
Shared State <state>
Manual Construction <manual_construction>
```

```{toctree}
:caption: Useful Links
:hidden:

GitHub Repository <https://github.com/dancardin/cappa>
PyPI <https://pypi.org/project/cappa>
Changelog <changelog>
```