Enable %B (barcode) and %C (catalog number) template variables

Already included but were not allowed.
Improved documentation.

Signed-off-by: JoeLametta <JoeLametta@users.noreply.github.com>

man/whipper-cd-rip.rst

@@ -94,6 +94,8 @@ Template schemes
 
 | - %A: release artist
 | - %S: release sort name
+| - %B: release barcode
+| - %C: release catalog number
 | - %d: disc title
 | - %y: release year
 | - %r: release type, lowercase

whipper/command/cd.py

@@ -54,6 +54,8 @@ filling in the variables and adding the file extension. Variables for both
 disc and track template are:
  - %A: release artist
  - %S: release sort name
+ - %B: release barcode
+ - %C: release catalog number
  - %d: disc title
  - %y: release year
  - %r: release type, lowercase

whipper/common/common.py

@@ -277,9 +277,9 @@ def getRelativePath(targetPath, collectionPath):
 def validate_template(template, kind):
     """Raise exception if disc/track template includes invalid variables."""
     if kind == 'disc':
-        matches = re.findall(r'%[^ARSXdrxy]', template)
+        matches = re.findall(r'%[^ABCRSXdrxy]', template)
     elif kind == 'track':
-        matches = re.findall(r'%[^ARSXadnrstxy]', template)
+        matches = re.findall(r'%[^ABCRSXadnrstxy]', template)
     if '%' in template and matches:
         raise ValueError(kind + ' template string contains invalid '
                          'variable(s): {}'.format(', '.join(matches)))

whipper/common/mbngs.py

@@ -71,6 +71,10 @@ class DiscMetadata:
     :vartype tracks: list of :any:`TrackMetadata`
     :cvar countries: MusicBrainz release countries
     :vartype countries: list or None
+    :cvar catalogNumber: release catalog number
+    :vartype catalogNumber: str or None
+    :cvar barcode: release barcode
+    :vartype barcode: str or None
     """
 
     artist = None

whipper/common/program.py

@@ -176,6 +176,8 @@ class Program:
 
         * ``%A``: release artist
         * ``%S``: release artist sort name
+        * ``%B``: release barcode
+        * ``%C``: release catalog number
         * ``%d``: disc title
         * ``%y``: release year
         * ``%r``: release type, lowercase