Skip to content

TrackMaven/trackmaven-common

Repository files navigation

A swiss army knife of useful Python utils.

Ranging from list manipulation, to text sanitization and more! Docs are avaible here.

Installation

$ pip install trackmaven-common --extra-index-url https://pypi.fury.io/trackmaven/

If you want to include this on a requirements.txt, use the following syntax...

<other packages>
--extra-index-url https://pypi.fury.io/trackmaven/
trackmaven-common==1.0.0

Development

Inside of a virtualenv, to install the required packages, run

pip install -e .
pip install -r requirements-dev.txt

Or simply run

make setup

This project uses py.test as its test runner. To run the tests

make tests

or you can call py.test directly with...

py.test -vv

To run the test suite against all support Python versions (2.7 and 3.4) run...

tox

Docs

Documentation is generated by Sphinx. If you are unfamiliar with it, check out this handy cheatsheet.

To build the docs, run

make build-docs

To see the docs, after building, run

make serve-docs

Release Checklist

  • Bump version in trackmaven_common/__init__.py
  • Add changes to CHANGELOG.rst
  • Open PR with title "Release <version>"
  • Build + push dist to gemfury.
python setup.py sdist
curl -F package=@<file> https://<gemfury_token>@push.fury.io/trackmaven/