Quick start

1. Install the package from source: python setup.py install. Worth putting in a virtualenv.

2. Add decide_host to your INSTALLED_APPS setting like this:

INSTALLED_APPS = (
    ...
    'rest_framework',
    'django_filters',
    'decide_host',
)

2. Include the decide_host URLconf in your project urls.py like this:

url(r'^decide/', include(decide_host.urls')),

3. Run python manage.py migrate to create the database tables.

4. Start the development server and point your browser to http://127.0.0.1:8000/decide/api/ to view records and inspect the API.

Importing trial data

If you have trial data in jsonl files that you’d like you import into the database, you can do this very easily. From your project site, run manage.py import_trials -n <name> -a <addr> trials.jsonl. You need to supply the name of the controller (addr) and the procedure (name). The import will not happen if there’s a duplicate in the database, so no need to worry about this.

Combining duplicate subjects

Subject names are set with user input, so there may be multiple records in the database that correspond to the same subject. To combine these records, run manage.py merge_subjects <to_keep> <to_combine>. Multiple names can be give for <to_combine>. It’s easy to mess the database up badly doing this so be sure to take a snapshot!

Development

Recommend using uv for development.

Run uv sync to create a virtual environment and install dependencies. uv sync --no-dev --frozen for deployment.

Testing: uv run pytest. Requires a test database, will use settings from inventory/test/settings.py.