pywebexec 1.0.0

Simple Python HTTP Exec Server

pywebexec

Simple Python HTTP(S) API/Web Command Launcher

Install

$ pip install pywebexec

Quick start

• start http server serving current directory executables listening on 0.0.0.0 port 8080

$ pywebexec

• Launch commands with params/view live output/Status using browser

features

• Serve executables in a directory
• Launch commands with params from web browser or API call
• Follow live output
• Stop command
• Relaunch command
• HTTPS support
• HTTPS self-signed certificate generator
• Can be started as a daemon (POSIX)
• uses gunicorn to serve http/https
• compatible Linux/MacOS

Customize server

$ pywebexec --dir ~/myscripts --listen 0.0.0.0 --port 8080
$ pywebexec -d ~/myscripts -l 0.0.0.0 -p 8080

Basic auth user/password

$ pywebexec --user myuser [--password mypass]
$ pywebfs -u myuser [-P mypass]

Generated password is given if no --pasword option

HTTPS server

• Generate auto-signed certificate and start https server

$ pywebfs --gencert
$ pywebfs --g

• Start https server using existing certificate

$ pywebfs --cert /pathto/host.cert --key /pathto/host.key
$ pywebfs -c /pathto/host.cert -k /pathto/host.key

Launch server as a daemon

$ pywebexec start
$ pywebexec status
$ pywebexec stop

• log of server are stored in directory [.config/].pywebexec/pywebexec_<listen>:<port>.log

Launch command through API

# curl http://myhost:8080/run_script -H 'Content-Type: application/json' -X POST -d '{ "script_name":"myscript", "param":["param1", ...]}

API reference

method	route	params/payload	returns
POST	/run_command	command: str params: array[str]	command_id: uuid message: str
POST	/stop_command/command_id		message: str
GET	/command_status/command_id		command_id: uuid command: str params: array[str] start_time: isotime end_time: isotime status: str exit_code: int
GET	/command_output/command_id		output: str status: str
GET	/commands		array of command_id: uuid command: str start_time: isotime end_time: isotime status: str exit_code: int
GET	/executables		array of str