Translate GP6/GP7 note effects

CHANGES.rst

@@ -1,6 +1,23 @@
 Changelog
 =========
 
+Unreleased
+----------
+
+**Changes:**
+
+- Added reading and writing of GP6 (``.gpx``) and GP7 (``.gp``) files.
+  ``guitarpro.parse`` detects the container format and maps the embedded
+  ``score.gpif`` document into the ``Song`` model; ``guitarpro.write`` rebuilds
+  the container when given ``version=(6, 0, 0)`` / ``(7, 0, 0)`` or a ``.gpx`` /
+  ``.gp`` extension. Coverage is the core musical content (song info, tracks,
+  tunings, measures, voices, beats, durations and notes).
+- Added GP6/GP7 note effects: hammer-on/pull-off, slides, harmonics (natural,
+  artificial, pinch, tap, semi), left/right-hand fingering, accentuation
+  (accent, heavy accent, staccato) and beat text. Bends, grace notes and
+  chord diagrams are not yet translated.
+
+
 Version 0.11
 -------------
 

README.rst

@@ -9,7 +9,8 @@ PyGuitarPro
 Introduction
 ------------
 
-PyGuitarPro is a package to read, write and manipulate GP3, GP4 and GP5 files. Initially PyGuitarPro is a Python port
+PyGuitarPro is a package to read, write and manipulate GP3, GP4 and GP5 files. GP6 (``.gpx``) and GP7 (``.gp``)
+files can also be read and written. Initially PyGuitarPro is a Python port
 of `AlphaTab <https://www.alphatab.net/>`_ which originally was a Haxe port of
 `TuxGuitar <https://sourceforge.net/projects/tuxguitar/>`_.
 

docs/index.rst

@@ -3,7 +3,8 @@
 PyGuitarPro
 ===========
 
-PyGuitarPro is a package to read, write and manipulate GP3, GP4 and GP5 files. Initially PyGuitarPro is a Python port
+PyGuitarPro is a package to read, write and manipulate GP3, GP4 and GP5 files. GP6 (``.gpx``) and GP7 (``.gp``) files
+can also be read and written. Initially PyGuitarPro is a Python port
 of `AlphaTab <https://www.alphatab.net/>`_ which is a Haxe port of `TuxGuitar <https://tuxguitar.herac.com.ar/>`_.
 
 To anyone wanting to create their own the best guitar tablature editor in Python this package will be the good thing to

docs/pyguitarpro/quickstart.rst

@@ -36,7 +36,9 @@ Functions :func:`guitarpro.parse` and :func:`guitarpro.write` support not only f
 
 .. note::
 
-   PyGuitarPro supports only GP3, GP4 and GP5 files. Support for GPX (Guitar Pro 6) files is out of scope of the
-   project.
+   PyGuitarPro reads and writes GP3, GP4, GP5 files, as well as GP6 (``.gpx``) and GP7 (``.gp``) files. GP6/GP7
+   support covers the core musical content (song info, tracks, tunings, measures, voices, beats, durations and
+   notes) but not yet every advanced effect. Write the GP6/GP7 formats by passing ``version=(6, 0, 0)`` or
+   ``version=(7, 0, 0)`` to :func:`guitarpro.write`, or by using a ``.gpx`` / ``.gp`` file extension.
 
 .. vim: tw=120 cc=121