opendors 0.1.dev18

Library for creating and interacting with OpenDORS datasets.

opendors

Library for creating and interacting with the OpenDORS dataset.

Installation

Install directly from PyPI: pip install opendors.

Install from source (requires Poetry):

# Clone git repository & change into clone directory
git clone [e-mail]:drus_st/opendorslib.git
cd opendorslib

# Install with poetry
poetry install

If you want to use the repository workflow rule, you also need to install Ruby with the github-linguist and licensee gems.

This repository contains a definition for a conda environment that you can use to install these extra dependencies: conda-environment.yml. To install the dependencies, do:

mamba env create -n opendors --file conda-environment.yml
mamba activate opendors
gem install github-linguist
gem install licensee

Keep the environment activated to use the repository rule.

Usage

opendors provides both an API for creating an OpenDORS dataset, and a CLI tool to interact with an OpenDORS dataset.

usage: opendors [-h] [-c] [-v] {schema,filter,stats,merge} ...

Utilities to work with OpenDORS datasets.

positional arguments:
  {schema,filter,stats,merge}
                        Available commands
    schema              Exports the JSON schema for the opendors model to 'schema.json'.
    filter              Filters a given dataset by programming language and/or before/after dates.
    stats               Gather statistics on a given OpenDORS dataset.
    merge               Merge OpenDORS datasets into a single file.

options:
  -h, --help            show this help message and exit
  -c, --compressed      Export as unindented JSON
  -v, --verbose         Print tracebacks on error

Build Python package

Run poetry build.

To publish to PyPI, run poetry publish. You need to have a PyPI API token configured to do this.

Run tests

Tests can be run locally as follows:

poetry run pytest tests/

Test coverage

Coverage (with branch coverage) can be displayed as follows:

poetry run python -m pytest tests --cov=opendors --cov-branch --cov-report=html --cov-report=term

Static code analysis

Run prospector to analyse the code.