Add zerve https://github.com/jsks/zerve

Rename

plugins/zerve/README.md

@@ -0,0 +1,40 @@
+zerve
+=====
+
+zsh httpd plugin
+
+**zerve** is a spinoff from [czhttpd](http://github.com/jsks/czhttpd) and was inspired by the approach taken by [zshttpd](http://zshwiki.org/home/code/scripts/zshttpd). It's meant to do one thing and one thing only: easily share files on a local network from the commandline. It supports dynamic directory listing and uses zle as a non-blocking event handler.
+
+####To install:
+- Source the script in your `.zshrc`. E.g.:
+```
+. ~/.config/zsh/scripts/zerve.zsh
+```
+- For proper mime-type support also install `file`
+
+####Usage:
+- Simply issue the command **zerve** within the directory you wish to serve or optionally specify the location of document root:
+```
+zerve ~/
+```
+- To stop zerve:
+```
+zerve stop
+```
+
+####Configuration:
+- To change the tcp port zerve listens on use the global variable _ZRV_PORT:
+```
+export _ZRV_PORT=8000
+```
+- Similarly, to edit the string added to $PROMPT:
+```
+export _ZRV_PROMPT="H:$_ZRV_DOCROOT[$_ZRV_PORT]-$PROMPT"
+```
+
+#### Caveats
+- Although zle is non-blocking, the handler used to deal with each incoming request is not. To lessen the amount of time that input in the terminal is blocked **zerve** closes each connection after every request.
+    - The solution would be to fork the handler as a subshell; however, under such a scenario `zle -F` seems to occasionally hang until there is user input. TODO: Come up with a better fix to not block terminal input.
+- There is no limit to the number of concurrent connections.
+
+