Commit graph

26 commits

Author SHA1 Message Date
Sebastián Ramírez
c750f8206e
Refactor and document handling pretty exceptions (#422)
* ♻️ Rename pretty_errors_ to pretty_exceptions_ to avoid confusion with validation errors

*  Add source examples for pretty_exceptions

* 📝 Add docs for pretty exceptions

* 🔧 Add Exceptions docs to MkDocs

*  Add tests for tutorial about exceptions

*  Update trackeback tests, remove tests covered by tutorial

*  Fix test for module
2022-07-12 21:06:51 +02:00
Sebastián Ramírez
51646dfee0
📝 Add Jina's QA Bot to the docs to help people that want to ask quick questions (#368)
Co-authored-by: yanlong.wang <yanlong.wang@naiver.org>
Co-authored-by: Han Xiao <han.xiao@jina.ai>
2022-03-05 20:04:13 +01:00
Sebastián Ramírez
b01f3bbca8
⬆️ Upgrade MkDocs Material, MDX-Include, and MkDocs structure (#356) 2022-02-13 17:35:53 +01:00
Sebastián Ramírez
15380ddc07
Add support for help for CLI arguments (#123)
*  Implement custom TyperCommand and TyperArgument

to support help in CLI Arguments

*  Update data models to store help for CLI Arguments

*  Add help to typer.Argument()

*  Use new TyperCommand and TyperArgument classes by default

to support CLI Arguments with help

*  Update failing test

*  Make showing default values default to true and support arguments hidden from help text

*  Add docs for CLI arguments with defaults, help, and new features

* 📝 Update CLI options with new show_default=True by default

* 📝 Add example of CLI arguments with tuples

* 📝 Update docs with new generated help text for CLI arguments

* 📝 Use Optional for None example in micro-intro to types

*  Add tests for new CLI argument features from docs examples

*  Update tests with new generated help text for CLI arguments

*  Add tests for CLI arguments with tuple defaults

* 🔧 Update MkDocs with new sections

*  make show_envvar default to True

*  Add docs for envvar in CLI arguments

*  Add tests for CLI arguments with env vars from docs

* 🎨 Add format to CLI usage examples in docs

* 🔧 Add section about CLI arguments with env vars to MkDocs

* 📝 Fix link in docs with new structure

* 🎨 Fix format in first-steps
2020-06-24 21:05:21 +02:00
Sebastián Ramírez
ce9e08d8e7
Upgrade Material-Mkdocs (#90)
*  Upgrade Material-Mkdocs

* 🐛 Fix Mkdocs config bug

*  Upgrade Mkdocs-material configs
2020-04-18 12:38:12 +02:00
Sebastián Ramírez
0830c023b9
📝 Add docs section, build a package from scratch (#71)
* 📝 Add docs section, build a package from scratch

* 📝 Update Package docs

* ✏️ Fix internal links
2020-03-19 13:42:23 +01:00
Sebastián Ramírez
48698ff2ad
📝 Add docs for using Click with Typer (#70)
* 📝 Add docs for using Click with Typer

*  Add tests for integrating Click and Typer
2020-03-19 10:30:42 +01:00
Sebastián Ramírez
5a6379ffc6
Add docs for testing, password, version, context. Extra tests, include callback and autocompletion PR (#68)
*  Implement custom handling for callbacks with types

*  Implement type-based handling for completion functions

*  Add examples for custom completion

* 📝 Add docs for custom autocompletion

*  Add tests for autocompletion

*  Document using the context

*  Add tests for using the context

*  Add tests init for context

* 🔧 Update Mypy config

*  Add extra tests for completion

* ✏️ Fix format, typos, and minor texts

*  Update docs for printing, include stdout, stderr, and stdin

* ✏️ Add references to FastAPI, fix typos

* ✏️ Fix typo in Typer CLI

* 📝 Update docs for version

* 📝 Update docs for callbacks

* 📝 Update references to stdout/stderr in autocompletion

* 📝 Add docs for password in CLI option

* 📝 Add docs and tests for Testing

* 📝 Add new sections to docs

* 🎨 Fix formatting
2020-03-18 21:17:47 +01:00
Sebastián Ramírez
96731c43be
Docs for Typer CLI (#64)
*  Add docs for Typer CLI

* 📝 Update references to Typer CLI in docs

* 🔧 Update tests to check files and linting before tests, to error out early

* 📝 Sync README.md with docs/index.md
2020-03-11 17:16:49 +01:00
Sebastián Ramírez
9bed3f169d
Add support for mermaid visualizations (#56) 2020-03-08 18:57:46 +01:00
Sebastián Ramírez
17b1748108 📝 Add all the latest docs to MkDocs 2020-01-05 22:24:27 +01:00
Sebastián Ramírez
b36c75b5a7 Add SubCommands sections 2020-01-04 02:25:02 +01:00
Sebastián Ramírez
bc4709cc9d 📝 Add docs for launching applications 2020-01-02 19:09:36 +01:00
Sebastián Ramírez
fb46cc056c 📝 Add docs for get_app_dir() 2020-01-02 18:42:36 +01:00
Sebastián Ramírez
4f26f45134 📝 Add docs for progressbar 2020-01-02 18:17:21 +01:00
Sebastián Ramírez
541ef46319 📝 Add docs for asking with a prompt 2020-01-02 16:59:09 +01:00
Sebastián Ramírez
aadca21c0b 📝 Add docs for printing and terminating 2020-01-02 15:22:10 +01:00
Sebastián Ramírez
d8a5236c08 ♻️ Refactor docs structure and add CLI option names 2020-01-02 12:49:28 +01:00
Sebastián Ramírez
073a72469c 📝 Add docs for CLI parameter types 2019-12-31 22:14:18 +01:00
Sebastián Ramírez
b88351643d 📝 Add docs and examples for Commands 2019-12-30 14:23:31 +01:00
Sebastián Ramírez
f6b61af6ae 📝 Add docs for CLI Arguments 2019-12-29 17:08:31 +01:00
Sebastián Ramírez
345446321e 📝 Add CLI Options docs and examples 2019-12-29 10:23:31 +01:00
Sebastián Ramírez
5cefc1b099 📝 Update short description in MkDocs 2019-12-28 15:27:46 +01:00
Sebastián Ramírez
941e86dbe5 🐛 Make Tutorial intro be the index, to have a tutorial root 2019-12-27 00:04:19 +01:00
Sebastián Ramírez
e3327b088b Add custom termynal handling for docs, with fenced code 2019-12-26 21:04:38 +01:00
Sebastián Ramírez
eb9cc378ef 🔧 Add MkDocs config 2019-12-24 14:01:30 +01:00