README.txt

============
Music Theory
============

"Music Theory" (**musictheory**) is a package designed to investigate the 
question "Which chords go with which scales?" A couple of years ago, 
the author was very interested and obsessed in the question, and decided
to put his Python skills to the task. Along the way, the **musictheory** 
package was redesigned to be more flexible and extendible. 

The package has roughly the same philosophy as `Music Set Theory 
<http://www.jaytomlin.com/music/settheory/help.html>`_ but uses different
terminology.

Documentation
-------------

The best thing to do is look at the source code. It contains an *excess*
of documentation strings. Hopefully it makes things clearer.

Installation
------------

You can get the application from PyPI through the command::

    pip install musictheory

Testing
-------

Testing can be performed by executing the following code in the setup directory:

    python -m test.test_all

License
-------

The software has been released using a 3 clause Berkeley Software 
Distribution (BSD) license. See LICENSE.txt for more information.

Versions
--------

* 0.1 (May 1th 2011) - Create setup script for files.

* 0.2 (May 11th 2011) - Remove bugs for working with chordgenerator.

* 0.3 (June 6th 2011) - Add license information. Add more scales.

* 0.4 (April 24th 2013) - Try to make a half-decent PyPI package.

* 0.5 (August 14th 2014) - Add some experimental suspended chords.

* 0.6 (December 6th 2020) - Updated for Python 3.0 compatibility.

Copyright
---------

The **musictheory** is copyright (c) 2008-2020 `Peter Murphy <http://www.pkmurphy.com.au/>`_ 
<peterkmurphy@gmail.com>.