Metadata-Version: 2.1
Name: PyGuitarPro
Version: 0.9
Summary: Read, write, and manipulate GP3, GP4 and GP5 files.
Home-page: https://github.com/Perlence/PyGuitarPro
Author: Sviatoslav Abakumov
Author-email: dust.harvesting@gmail.com
License: LGPL-3.0-only
Project-URL: Documentation, https://pyguitarpro.readthedocs.io/
Project-URL: Code, https://github.com/Perlence/PyGuitarPro
Project-URL: Issue tracker, https://github.com/Perlence/PyGuitarPro/issues
Description: PyGuitarPro
        ===========
        
        .. image:: https://img.shields.io/pypi/v/pyguitarpro.svg?style=flat
           :alt: PyPI Package latest release
           :target: https://pypi.org/project/PyGuitarPro/
        
        
        Introduction
        ------------
        
        PyGuitarPro is a package to read, write and manipulate GP3, GP4 and GP5 files. Initially PyGuitarPro is a Python port
        of `AlphaTab <https://www.alphatab.net/>`_ which is a Haxe port of `TuxGuitar <https://tuxguitar.herac.com.ar/>`_.
        
        This package helps you achieve several goals you might find yourself yearning to do in a day-to-day tabber life:
        
        - transpose a track without messing the fingering.
        
        - add first string to the track without messing the fingering.
        
        - map percussion notes to different values.
        
        Reading ``.gp*`` files is as easy as:
        
        .. code-block:: python
        
           import guitarpro
           curl = guitarpro.parse('Mastodon - Curl of the Burl.gp5')
        
        Writing ``.gp*`` files isn't that hard as well:
        
        .. code-block:: python
        
           guitarpro.write(curl, 'Mastodon - Curl of the Burl 2.gp5')
        
        All objects representing GP entities are hashable and comparable. This gives the great opportunity to apply *diff*
        algorithm to tabs, or even *diff3* algorithm to merge tablatures.
        
        To anyone wanting to create their the best guitar tablature editor in Python this package will be the good thing to
        start with.
        
        
        Examples
        --------
        
        Several usage examples are included in the ``/examples`` folder. Please feel free to add your own examples, or improve
        on some of the existing ones, and then submit them via pull request.
        
        To run one of the examples in your local environment, simply:
        
        .. code-block:: sh
        
           cd pyguitarpro
           python examples/transpose.py --help
        
        
        Installation
        ------------
        
        Install PyGuitarPro from PyPI:
        
        .. code-block:: sh
        
           pip install PyGuitarPro
        
        To install development version of PyGuitarPro:
        
        .. code-block:: sh
        
           git clone https://github.com/Perlence/PyGuitarPro.git
           cd pyguitarpro
           pip install -e .
        
        
        Documentation
        -------------
        
        Package documentation is located at `Read the Docs <https://pyguitarpro.readthedocs.io/>`_.
        
        
        Licensing
        ---------
        
        Please see the file called ``LICENSE``.
        
        .. vim: tw=120 cc=121
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Artistic Software
Classifier: Topic :: Multimedia :: Sound/Audio
Requires-Python: >=3.7
Description-Content-Type: text/x-rst
