A python3-based tool to generate and email statistical reports from Dataverse using the native API and database queries.
As with Miniverse, the reports require access to the Dataverse database.
python3 -m venv venv
source venv/bin/activate
pip install pipenv
pipenv install
cp config/application.yml.sample config/application.yml
dataverse_api_host: ''
dataverse_api_key: ''
dataverse_db_host: ''
dataverse_db_username: ''
dataverse_db_password: ''
work_dir: '/tmp'
log_path: 'logs'
log_file: 'dataverse-reports.log'
log_level: 'INFO'
smtp_host: 'localhost'
smtp_auth: ''
smtp_port: 25
smtp_username: 'username'
smtp_password: 'password'
from_email: ''
admin_emails:
- email1
- email2
from_email: ''
accounts:
account1:
name: Account 1
identifier: account1_identifier
contacts:
- email1
- email2
account2:
name: Account 2
identifier: account2_identifier
contacts:
- email1
Set parameters for API and database connections, as well as the SMTP configuration. Accounts list refers to top-level dataverses on which reports based at the institutional level will begin.
NOTE: The accounts section can be left blank if your Dataverse instance is not set up with separate institutions as top-level dataverses. In that case, your reports will be for everything from the root dataverse on down and sent to all admins.
NOTE: All of the following commands assume that the user is in the virtual environment.
Usage: run.py [options]
Options:
-h, --help show this help message and exit
-c CONFIG_FILE, --config=CONFIG_FILE
Configuration file
-r REPORTS, --report(s)=REPORTS
Report type(s) to generate. Options = dataverse,
dataset, user, all.
-g GROUPING, --group=GROUPING
Grouping of results. Options = institutions, all
-o OUTPUT_DIR, --output_dir=OUTPUT_DIR
Directory for results files.
-e, --email Email reports to liaisons?
python run.py -c config/application.yml -r all -g all -o $HOME/reports -e
python run.py -c config/application.yml -r dataverse -g institutions -o $HOME/reports -e
python run.py -c config/application.yml -r dataset -g all -o $HOME/reports -e
python run.py -c config/application.yml -r user -g institutions -o $HOME/reports -e