Transactions Explorer

Generates a static HTML version of the Transactions Explorer.

Prerequisites

This README expects you to have the virtualenv and virtualenvwrapper python packages installed. You can do this with the following command.

pip install virtualenv virtualenvwrapper

Using the app

You need to use a machine that has a web browser installed in order to authenticate with Google. If you're using a GDS machine, this means you should not perform any of these steps in the GDS development VM.

Set up a Python virtualenv, activate it, and then install required packages with pip install -r requirements.txt.

$ cd ~/govuk
$ git clone git@github.com:alphagov/transactions-explorer.git
$ cd transactions-explorer
$ mkvirtualenv transactions-explorer
$ pip install -r requirements.txt

After setting this up for the first time, you just need to run workon transactions-explorer in future.

Fetching data

First, ensure your Cabinet Office email account is authorised to access the Transactions Explorer spreadsheet.

Then:

• Create a new installed application (of type "Native") in the Google APIs console, with "Drive API" service enabled, download the client_secrets.json file and store it in data/
• Fetch the data through either of the methods below:
  • Run python fetch_csv.py. This will authenticate against Google in your browser, then download the Transactions Explorer document to data/services.csv. It can be parametrized with the following arguments:
    • --client-secrets: Google API client secrets JSON file (default: data/client_secrets.json)
    • --oauth-tokens: Google API OAuth tokens file (default: data/tokens.dat)
  • Run ./fetch_data.sh script. It will perform the above task, installing the required dependencies and using the default values.

Generating site

• Generate the site with python create_pages.py. It can be parameterised with the following argument:
  • --services-data: Services CSV datafile (default: data/services.csv)
  • --path-prefix: Prefix for generated URL paths (default: /)
  • --static-digests Path to manifest file containing assets digests (default: None) You can download the current digests from https://assets.digital.cabinet-office.gov.uk/static/manifest.yml
• [alternative] Generate the site with ./build_artefact.sh script. It will run the above command with all the defaults.
• [optional] symlink the contents of assets/javascripts to output/assets/javascripts for faster feedback than running create_pages each time.
• run ./serve.sh
• visit http://localhost:8080.
• dance.

Testing

Unit tests can be run with ./run_tests.sh.

After generating the site as described above you can test it generated correctly by running nosetests (or nosetests -a feature to skip unit tests).