add toc_string to API

This is part of the libdiscid 0.6.0 API

Author: JonnyJD

discid/disc.py

@@ -212,6 +212,25 @@ def _get_submission_url(self):
         else:
             return None
 
+    try:
+        _LIB.discid_get_toc_string.argtypes = (c_void_p, )
+        _LIB.discid_get_toc_string.restype = c_char_p
+    except AttributeError:
+        pass
+    def _get_toc_string(self):
+        """The TOC suitable as value of the `toc parameter`
+        when accessing the MusicBrainz Web Service.
+        """
+        if self._success:
+            try:
+                result = _LIB.discid_get_toc_string(self._handle)
+            except AttributeError:
+                return None
+            else:
+                return _decode(result)
+        else:
+            return None
+
     _LIB.discid_get_first_track_num.argtypes = (c_void_p, )
     _LIB.discid_get_first_track_num.restype = c_int
     def _get_first_track_num(self):
@@ -292,6 +311,18 @@ def submission_url(self):
             url = url.replace("/bare/cdlookup.html", "/cdtoc/attach")
             return url
 
+    @property
+    def toc_string(self):
+        """The TOC suitable as value of the `toc parameter`
+        when accessing the MusicBrainz Web Service.
+
+        This is a :obj:`unicode` or :obj:`str <python:str>` object
+        and enables fuzzy searching when the actual Disc ID is not found.
+
+        .. seealso:: `MusicBrainz Web Service <http://musicbrainz.org/doc/Development/XML_Web_Service/Version_2#discid>`_
+        """
+        return self._get_toc_string()
+
     @property
     def first_track_num(self):
         """Number of the first track"""

doc/api.rst

@@ -33,6 +33,7 @@ Disc object
    .. autoattribute:: id
    .. autoattribute:: freedb_id
    .. autoattribute:: submission_url
+   .. autoattribute:: toc_string
    .. autoattribute:: first_track_num
    .. autoattribute:: last_track_num
    .. autoattribute:: sectors