Secure the News
Getting Started with the Development Environment
The installation instructions below assume you have the following software on your machine:
Create a Python2 virtualenv and install molecule/requirements.txt
/.
Then run:
make dev-go
The development environment creates a default superuser (username: test
, password:
test
) that you can use to log in to the Admin interface at /admin
.
To update all the sites in the development environment, run:
make dev-scan
For a full list of all helper commands in the Makefile, run make help
.
Development Fixtures
The createdevdata
management commands loads Site and Scan data from the
fixtures in sites/fixtures/dev.json
. If you change the schema of sites.Site
or sites.Scan
, you will need to update these fixtures, or future
invocations of createdevdata
will fail.
The general process for updating the development fixtures is:
-
Migrate your database to the last migration where the fixtures were updated.
-
Load the fixtures.
-
Run the migrations that you've added.
-
Export the migrated fixtures:
$ python3 manage.py dumpdata sites.{Site,Scan} > sites/fixtures/dev.json
The test suite includes a smoke test for createdevdata
, so you can easily
verify that the command is working without disrupting your own development
environment.
Live reload
The default gulp watch
task uses gulp-livereload
to automatically trigger a
browser refresh when changes to the frontend code are detected. In order to take
advantage of this, you will need to install the LiveReload Chrome
extension.
Once you've installed the extension, simply load the development site in your
browser (localhost:8000
) and click the LiveReload extension icon to initiate
live reloading.
API
If everything is working correctly, you should be able to find an API endpoint
at localhost:8000/api
(it will redirect to the current API version).
The API is read-only and can be used to obtain site metadata and the latest scan
for a given site (e.g., /api/v1/sites
will return a directory, and
/api/v1/sites/bbc.co.uk
will return details about the BBC). Various filters
and sort options are supported; click the "filters" dialog in the UI to explore
them.
To get all scans for a given site, you can use a path like
/api/v1/sites/bbc.co.uk/scans
. This URL can also be found in the all_scans
field for a given site result.
If you run a public site, note that read access to the API is available to any origin via CORS.
The API is implemented using the Django REST framework; documentation for it can be found here: