Skip to main content

Application level proxy server

Project description


**Application level proxy server**

Outpost combines proxy, static file serving and application
framework functionality in a single server application.

Advanced options include request debugging and stream filter.

Outpost also supports local javascript application development
in combination with remote web api services. The build in proxy
prevents browsers `Cross Origin Resource Scripting` restrictions
by routing all requests through a single (local) address. In combination
with Chrome or Firefox browsers build in developer tools
Outpost gives a additional option to debug, alter and trace outgoing
and incoming requests before being processed by the browser (or after the
request has been send). Single requests can be stopped based on url
schemes and debugged on the commandline.

Implemented in pure python; with the pyramid web framework.

Please refer to Github for source codes:


- Serves static files from a directory
- Routes webservice requests through the proxy
- Session and cookie support for proxied requests
- Custom filter support
- Single and multiple concurrent connections
- Interactive request hacking and tracing
- Easy installation, runs on any os

Configuration - Basic setup

All configuration options are set in `server.ini` in projects' home folder.

The directory to be served. Either a python module asset path, relative path
or absolute path :: = /home/me/myfiles
server.defaultfile = index.html

The domain to connect to. Ajax calls and urls can use a domain
placeholder to be inserted by outpost before proxying the request.
By default the placeholder is '__domain'. The string will
replaced with the following configuration setting. ::

proxy.domain =

The url prefix used to route request through the proxy. By default
urls starting with `` will be handled by the
proxy ::

proxy.route = __proxy


Short installation description:

- Install Python
- Install Python setuptools and virtualenv
- Create a virtual environment (virtualenv) directory named ‘outpost’ (or use your projects name)
``virtualenv outpost``
- Install outpost from ``bin/pip install outpost``
- Create a new project by using the scaffold ``bin/pcreate -t outpost myApp``
- change into myApp directory ``cd myApp``
- Start the web server ``../bin/pserve server.ini`` (the served directory path is relative)

If you are using a relative directory please make sure you start the webserver from the right
working directory.

Debug Toolbar

You can also use the pyramid debug toolbar to get a request log in the browser.
To enable the toolbar open the ini file and set ``debugtoolbar.enabled = true``

Setting a breakpoint

Change the line in your ini file to match proxied urls you would like to halt and inspect. ::

proxy.trace = signin

Each proxied url containing `signin` will be interrupted and can be inspected in the python debugger
on the commandline.

Basic commands (Take a look at python debugger for all commands):

- n : next step
- c : continue execution

Once you are in the debugger you can print the current requests values and change them (e.g. headers):

- method : http method
- url : the url to send the request to
- **parameter : a dictionary including headers and form values

after receiving the response

- response
- response.headers

Project details

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
outpost-0.3.4.tar.gz (20.2 kB) Copy SHA256 hash SHA256 Source None

Supported by

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