/nPYc-Toolbox

The nPYc-Toolbox defines objects for representing, and implements functions to manipulate and display, metabolic profiling datasets.

Primary LanguagePython

nPYc Toolbox

Build Status codecov Python36 Documentation Status

A Python implementation of the NPC toolchain for import, quality-control, and preprocessing of metabolic profiling datasets.

  • Version 1.0.1a

Source control

Source management is git-flow-like - no development in the master branch!

Development

When merging into the develop branch, all new code must include unit-tests, and these tests should pass.

Dependancies

The nPYc Toolbox is built upon Python 3.6, and most dependencies can be satisfied by installing the Anaconda (v4.4.0 and above) distribution.

Releases

When merging from develop (or hotfix branches) into release, ensure:

  • All references to the debugger are removed
  • All paths are relative and platform agnostic
  • All tests pass

Documentation

Documentation is hosted on Read the Docs.

Documentation is generated via Sphinx Autodoc, documentation markup is in reStructuredText.

To build the documentation locally, cd into the docs directory and run:

make html

To clear the current documentation in order to rebuild after making changes, run:

make clean

Testing

Unit testing is managed via the unittest framework. Test coverage can be found on codecov.io.

To run all tests, cd into the Tests directory and run:

python -m unittest discover -v

Individual test modules can be run with:

python -m `test_filename` -v

Standard measures and codings

When stored internally, and unless explicitly overriden, variables should conform to the units laid out in the Nomenclature of the documentation.