karr-lab-build-utils

Karr Lab build utilities


Keywords
unit, test, coverage, API, documentation, nose, xunit, junit, unitth, HTML, Coveralls, Sphinx, circleci, continuous-integration, packaging-python, python, unit-testing
License
MIT
Install
pip install karr-lab-build-utils==0.0.8

Documentation

[//]: # ( PyPI package ) Documentation Test results Test coverage Code analysis License Analytics

Karr Lab build utilities

This package performs several aspects of the Karr Lab's build system:

  • Create repositories with our default directory structure and files

    • Files for packaging Python code
    • Sphinx documentation configuration
    • CircleCI build configuration
  • Tests code with Python 2 and 3 using pytest locally, using a Docker image, or using the CircleCI local executor

  • Uploads test reports to our test history server

  • Uploads coverage report to Coveralls

  • Generates HTML API documentation using Sphinx

The build system is primarily designed for:

  • Code that is implemented with Python 2/3
  • Tests that can be run with pytest
  • Code that is documented with Sphinx in Napolean/Google style
  • Continuous integration with CircleCI

Installation

Please see the documentation.

Documentation

Please see the documentation.

License

The build utilities are released under the MIT license.

Development team

This package was developed by Jonathan Karr at the Icahn School of Medicine at Mount Sinai in New York, USA.

Questions and comments

Please contact the Jonathan Karr with any questions or comments.