Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

A webbased wrapper for the argument parser in Python

Project description

warped can be used to execute single Python file and Python modules. It captures calls to the argparse module of Python and renders a web GUI based on the options and arguments defined. It also displays the output of the program inside the web GUI and allows you to stop, pause and resume the program, as well as downloading the output.

Install

Either get a stable version from PyPI, or install the current version from git

# Installation from PyPI
pip install warped

# Installation from git
pip install git+https://git.k-fortytwo.de/christofsteel/warped/

Usage

warped [-h] [--port PORT] [--host HOST] [--module] file

a Webbased frontend for ARgparse in Python

positional arguments:
file                  File to run

optional arguments:
-h, --help            show this help message and exit
--port PORT, -p PORT  The port to listen on (default 5000)
--host HOST           The host to bind to (default 0.0.0.0)
--module, -m          If set, loads a module instead of a file

Sample

To test the capabilities of warped an example module was included. You can run it like this:

warped -m warped.samples.hooked

Since warped also makes use of the argparse module, warped itself can be //warped//.

warped -m warped.hook

How does it work?

When warped is executed, it starts a flask webserver. The javascript of the website reads the /arguments resource of the server, where the configuration of the argparser returned. In a seperate process the given program is executed using the runpy library, redirecting sys.stdin and sys.stdout to a multiprocessing.Queue, which can be read by the warp process to display it via the web GUI.

Additionally, warped adds an entry for argparse in the sys.modules list. Python looks first looks at this list, everytime a module is imported, to avoid importing a module multiple times. This custom argparse module behaves similar to the original argparse module. In fact with the exception of the ArgumentParser.parse_args() method, it works exactly like the original. Once the program calls the parse_args() method, it blocks and waits for user interaction via the web GUI. Once the user submits the data, the process continues.

Project details


Release history Release notifications

This version
History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

History Node

0.1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
warped-0.1.3-py3-none-any.whl (681.8 kB) Copy SHA256 hash SHA256 Wheel py3 May 31, 2017
warped-0.1.3.tar.gz (522.1 kB) Copy SHA256 hash SHA256 Source None May 31, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page