Skip to content


Subversion checkout URL

You can clone with
Download ZIP
29 lines (21 sloc) 1.58 KB

Submitting an issue

The more details you can give, the better. The tail of your gmusicapi.log often has useful information, too.

Building docs locally

Sphinx is used to generate the docs, and they can be built locally if you'd like to view your edits.

First, get a dev environment set up (if you're unsure, there are steps below). Then, install Sphinx: pip install sphinx.

Building the docs requires make: cd docs, then make html.

If there weren't any problems, the docs are in ./build/html. You can serve them up locally with python -m SimpleHTTPServer, then view them in your web browser at

Submitting code

Generally, the develop branch is used for upstream integration; when in doubt, make pull requests against it.

One exception: the docs are built dynamically against the current state of master, so doc-only improvements that still apply to the current release can use master directly. These kind of changes usually get merged into develop after a release.

Checking out a dev environment

You can do this however you like, but generally you want to use virtualenv:

  • $ git clone
  • $ cd gmusicapi/
  • $ virtualenv --no-site-packages venv-gmapi
  • $ source venv-gmapi/bin/activate
  • $ pip install -e . # this installs the package as editable; changes to the source are reflected when running
  • $ git checkout develop
  • # hack away
  • $ python -m gmusicapi.test.run_tests
  • $ deactivate # when you're finished
Jump to Line
Something went wrong with that request. Please try again.