From 3e2676f7dcafbec3c8e481e6ebfb2454bd3c232c Mon Sep 17 00:00:00 2001
From: Celestino Gomes <tinorj@gmail.com>
Date: Fri, 24 Sep 2021 17:37:09 -0300
Subject: [PATCH] feat(python): add `pyserver` alias to start an HTTP server
 (#10217)

Closes #10217
---
 plugins/python/README.md         | 20 +++++++++++---------
 plugins/python/python.plugin.zsh |  3 +++
 2 files changed, 14 insertions(+), 9 deletions(-)

diff --git a/plugins/python/README.md b/plugins/python/README.md
index b95ffe679..eeaa1148a 100644
--- a/plugins/python/README.md
+++ b/plugins/python/README.md
@@ -3,17 +3,19 @@
 The plugin adds several aliases for useful [python](https://www.python.org/) commands.
 
 To use it, add `python` to the plugins array of your zshrc file:
-```
+
+```zsh
 plugins=(... python)
 ```
 
 ## Aliases
 
-| Command          | Description                                                                     |
-|------------------|---------------------------------------------------------------------------------|
-| `py`             | Runs `python`                                                                   |
-| `ipython`        | Runs the appropriate `ipython` version according to the activated virtualenv    |
-| `pyfind`         | Finds .py files recursively in the current directory                            |
-| `pyclean [dirs]` | Deletes byte-code and cache files from a list of directories or the current one |
-| `pygrep <text>`  | Looks for `text` in .py files                                                   |
-| `pyuserpaths`    | Add --user site-packages to PYTHONPATH, for all installed python versions.      |
+| Command          | Description                                                                           |
+| ---------------- | ------------------------------------------------------------------------------------- |
+| `py`             | Runs `python`                                                                         |
+| `ipython`        | Runs the appropriate `ipython` version according to the activated virtualenv          |
+| `pyfind`         | Finds .py files recursively in the current directory                                  |
+| `pyclean [dirs]` | Deletes byte-code and cache files from a list of directories or the current one       |
+| `pygrep <text>`  | Looks for `text` in .py files                                                         |
+| `pyuserpaths`    | Add --user site-packages to PYTHONPATH, for all installed python versions.            |
+| `pyserver`       | Starts an http.server on the current directory. Use `--directory` for a different one |
diff --git a/plugins/python/python.plugin.zsh b/plugins/python/python.plugin.zsh
index 276eb6f91..896fae3ca 100644
--- a/plugins/python/python.plugin.zsh
+++ b/plugins/python/python.plugin.zsh
@@ -48,3 +48,6 @@ alias pygrep='grep -nr --include="*.py"'
 
 # Run proper IPython regarding current virtualenv (if any)
 alias ipython="python -c 'import IPython; IPython.terminal.ipapp.launch_new_instance()'"
+
+# Share local directory as a HTTP server
+alias pyserver="python -m http.server"