Skip to main content

Flask-based web data proxy for the Humanitarian Exchange Language (HXL)

Project description

Python-/flask-based web proxy for transforming a HXL dataset dynamically. Requires Python3.

User documentation is available at

# Installation

Installation from PyPi:

` pip install hxl-proxy `

Installation from source:

` python install `

Running unit tests:

` python test `

# Configuration

To configure the proxy, make a copy of (e.g. to, and change its values as necessary. The environment variable HXL_PROXY_CONFIG should point to your local config file’s location. More details appear below.

## Caching

Choose and configure your input and output caches as needed, following the examples in the config template. You may need to create local directories or databases, depending on the caching backends you choose.

## P-codes and mapping

For mapping, the Proxy uses a collection of GeoJSON files hosted online. If you want to use a local copy (e.g. for offline demos), clone the GitHub repository at and set the new base URL as the value of PCODE_BASE_URL. Note that the server serving the local copy must implement CORS, since the shapes get loaded on the browser side:

Edit PCODE_COUNTRY_MAP if you’d like to make more countries available in the map dropdown menu.

# Usage

Launching a local server (usually on

` python `

For web deployment, see the hxl-proxy.wsgi.TEMPLATE file and the flask documentation.

For more on HXL, see

For more documentation about the underlying HXL engine and filters, see

Project details

Download files

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

Source Distribution

hxl_proxy-2.1.1.tar.gz (686.7 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page