docs(CLI): Update to argparse

Author: tony

docs/cli/completion.md

@@ -4,6 +4,16 @@
 
 Convert between YAML and JSON
 
+```{eval-rst}
+.. argparse::
+    :module: tmuxp.cli
+    :func: create_parser
+    :prog: tmuxp
+    :path: convert
+```
+
+## Usage
+
 ````{tab} YAML -> JSON
 
 ```console
@@ -22,12 +32,3 @@ $ tmuxp convert /path/to/file.json
 
 tmuxp automatically will prompt to convert `.yaml` to `.json` and
 `.json` to `.yaml`.
-
-## Reference
-
-```{eval-rst}
-.. click:: tmuxp.cli.convert:command_convert
-    :prog: tmuxp convert
-    :commands: convert
-    :nested: full
-```

docs/cli/convert.md

@@ -7,6 +7,16 @@
 Use to collect all relevant information for submitting an issue to
 the project.
 
+```{eval-rst}
+.. argparse::
+    :module: tmuxp.cli
+    :func: create_parser
+    :prog: tmuxp
+    :path: debug-info
+```
+
+## Usage
+
 ```console
 
 $ tmuxp debug-info
@@ -17,12 +27,3 @@ environment:
 ...
 
 ```
-
-## Reference
-
-```{eval-rst}
-.. click:: tmuxp.cli.debug_info:command_debug_info
-    :prog: tmuxp debug-info
-    :commands: debug-info
-    :nested: full
-```

docs/cli/debug-info.md

@@ -1,10 +1,13 @@
 (edit-config)=
 
+(cli-edit)=
+
 # tmuxp edit
 
 ```{eval-rst}
-.. click:: tmuxp.cli.edit:command_edit
-    :prog: tmuxp edit
-    :commands: edit
-    :nested: full
+.. argparse::
+    :module: tmuxp.cli
+    :func: create_parser
+    :prog: tmuxp
+    :path: edit
 ```

docs/cli/edit.md

@@ -1,7 +1,19 @@
 (cli-freeze)=
 
+(cli-freeze-reference)=
+
 # tmuxp freeze
 
+```{eval-rst}
+.. argparse::
+    :module: tmuxp.cli
+    :func: create_parser
+    :prog: tmuxp
+    :path: freeze
+```
+
+## Usage
+
 Freeze sessions
 
 ```console
@@ -23,12 +35,3 @@ Tmuxp will offer to save your session state to `.json` or `.yaml`.
 If no session is specified, it will default to the attached session.
 
 If the `--force` argument is passed, it will overwrite any existing config file with the same name.
-
-(cli-freeze-reference)=
-
-```{eval-rst}
-.. click:: tmuxp.cli.freeze:command_freeze
-    :prog: tmuxp freeze
-    :commands: freeze
-    :nested: full
-```

docs/cli/freeze.md

@@ -7,9 +7,11 @@
 ## From teamocil
 
 ```{eval-rst}
-.. click:: tmuxp.cli.import_config:command_import_teamocil
-    :prog: tmuxp import teamocil
-    :nested: full
+.. argparse::
+    :module: tmuxp.cli
+    :func: create_parser
+    :prog: tmuxp
+    :path: import teamocil
 ```
 
 ````{tab} YAML
@@ -33,9 +35,11 @@ $ tmuxp import teamocil /path/to/file.json
 ## From tmuxinator
 
 ```{eval-rst}
-.. click:: tmuxp.cli.import_config:command_import_tmuxinator
-    :prog: tmuxp import tmuxinator
-    :nested: short
+.. argparse::
+    :module: tmuxp.cli
+    :func: create_parser
+    :prog: tmuxp
+    :path: import tmuxinator
 ```
 
 ````{tab} YAML

docs/cli/import.md

@@ -32,9 +32,19 @@ debug-info
 
 ```
 
-```{toctree}
-:caption: More
-:maxdepth: 1
+(cli-main)=
+
+(tmuxp-main)=
+
+## Command: `tmuxp`
+
+```{eval-rst}
+.. argparse::
+    :module: tmuxp.cli
+    :func: create_parser
+    :prog: tmuxp
+    :nosubcommands:
 
-completion
+    subparser_name : @replace
+        See :ref:`cli-ls`
 ```

docs/cli/index.md

@@ -2,8 +2,20 @@
 
 (tmuxp-load)=
 
+(tmuxp-load-reference)=
+
 # tmuxp load
 
+```{eval-rst}
+.. argparse::
+    :module: tmuxp.cli
+    :func: create_parser
+    :prog: tmuxp
+    :path: load
+```
+
+## Usage
+
 You can load your tmuxp file and attach the vim session via a few
 shorthands:
 
@@ -136,14 +148,3 @@ $ tmuxp load [filename] --log-file [log_filename]
 ```console
 $ tmuxp --log-level [LEVEL] load [filename] --log-file [log_filename]
 ```
-
-## Reference
-
-(tmuxp-load-reference)=
-
-```{eval-rst}
-.. click:: tmuxp.cli.load:command_load
-    :prog: tmuxp load
-    :commands: load
-    :nested: full
-```

docs/cli/load.md

@@ -1,10 +1,15 @@
+(cli-ls)=
+
 (ls-config)=
 
 # tmuxp ls
 
+List sesssions.
+
 ```{eval-rst}
-.. click:: tmuxp.cli.ls:command_ls
-    :prog: tmuxp ls
-    :commands: ls
-    :nested: full
+.. argparse::
+    :module: tmuxp.cli
+    :func: create_parser
+    :prog: tmuxp
+    :path: ls
 ```

docs/cli/ls.md

@@ -1,12 +1,15 @@
 (cli-shell)=
 
+(tmuxp-shell)=
+
 # tmuxp shell
 
 ```{eval-rst}
-.. click:: tmuxp.cli.shell:command_shell
-    :prog: tmuxp shell
-    :commands: shell
-    :nested: none
+.. argparse::
+    :module: tmuxp.cli
+    :func: create_parser
+    :prog: tmuxp
+    :path: shell
 ```
 
 ## Directly enter commands
@@ -15,8 +18,6 @@
 $ tmuxp shell -c 'python code'
 ```
 
-## Example
-
 ```{image} ../_static/tmuxp-shell.gif
 :width: 100%
 ```