Metadata-Version: 2.0
Name: pychord
Version: 0.2.2
Summary: A library to handle musical chords in python.
Home-page: https://github.com/yuma-m/pychord
Author: Yuma Mihira
Author-email: info@yurax2.com
License: MIT
Keywords: music chord
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: MIT License

pychord
=======

|Build Status|

Overview
--------

Pychord is a python library to handle musical chords.

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

.. code:: sh

    $ pip install pychord

Usage
-----

Create a Chord
~~~~~~~~~~~~~~

.. code:: python

    >>> from pychord import Chord
    >>> c = Chord("Am7")
    >>> c
    <Chord: Am7>
    >>> c.info()
    """
    Am7
    root=A
    quality=m7
    appended=[]
    on=None
    """

Transpose a Chord
~~~~~~~~~~~~~~~~~

.. code:: python

    >>> c = Chord("Am7/G")
    >>> c.transpose(3)
    >>> c
    <Chord: Cm7/Bb>

Get component notes
~~~~~~~~~~~~~~~~~~~

.. code:: python

    >>> c = Chord("Am7")
    >>> c.components()
    ['A', 'C', 'E', 'G']

Create chord progressions
~~~~~~~~~~~~~~~~~~~~~~~~~

.. code:: python

    >>> from pychord import ChordProgression
    >>> cp = ChordProgression(["C", "G/B", "Am"])
    >>> cp
    <ChordProgression: C | G/B | Am>

    >>> cp.append("Em/G")
    >>> cp
    <ChordProgression: C | G/B | Am | Em/G>

    >>> cp.transpose(+3)
    >>> cp
    <ChordProgression: Eb | Bb/D | Cm | Gm/Bb>

Supported Python Versions
-------------------------

-  2.7
-  3.3 and above

Links
-----

-  PyPI: https://pypi.python.org/pypi/pychord
-  GitHub: https://github.com/yuma-m/pychord

License
-------

-  MIT License

.. |Build Status| image:: https://travis-ci.org/yuma-m/pychord.svg?branch=master
   :target: https://travis-ci.org/yuma-m/pychord


