Add --only option as opposite of --skip

README.md

@@ -16,6 +16,9 @@ SYNOPSIS
 COMMANDS
     COMMAND is one of the following:
 
+     version
+       Return version information.
+
      tag
        Tag the audio files with the given Discogs release.
 
@@ -39,8 +42,8 @@ DESCRIPTION
         - The numeric portion of the above, e.g. 16215626
         - A local file URI pointing to a release JSON file
 
-    The SKIP flag can take one or more of the following values, comma-separated:
-        artist, composer, title, position, date, subtrack, album, genre, albumartist
+    The SKIP and ONLY flags can take one or more of the following values, comma-separated:
+        artist, composer, title, position, date, subtracks, album, genre, albumartist
 
         If subtracks are skipped, subtrack titles get appended to their parent track.
 
@@ -57,6 +60,9 @@ FLAGS
     -s, --skip=SKIP
         Type: Optional[]
         Default: None
+    -o, --only=ONLY
+        Type: Optional[]
+        Default: None
 
 NOTES
     You can also use flags syntax for POSITIONAL ARGUMENTS
@@ -70,8 +76,8 @@ SYNOPSIS
     discogs-tag copy SRC <flags>
 
 DESCRIPTION
-    The SKIP flag can take one or more of the following values, comma-separated:
-        artist, composer, title, position, date, subtrack, album, genre, albumartist
+    The SKIP and ONLY flags can take one or more of the following values, comma-separated:
+        artist, composer, title, position, date, subtracks, album, genre, albumartist
 
         If subtracks are skipped, subtrack titles get appended to their parent track.
 
@@ -88,6 +94,9 @@ FLAGS
     -s, --skip=SKIP
         Type: Optional[]
         Default: None
+    -o, --only=ONLY
+        Type: Optional[]
+        Default: None
 
 NOTES
     You can also use flags syntax for POSITIONAL ARGUMENTS

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "discogs-tag"
-version = "1.2.1"
+version = "1.3.0"
 description = "An audio tagger based on Discogs metadata."
 authors = ["infojunkie <[email protected]>"]
 repository = "https://github.com/infojunkie/discogs-tag.py"

src/discogs_tag/cli.py

@@ -32,12 +32,20 @@
 
 AUDIO_EXTENSIONS = ['flac', 'mp3']
 
+def version():
+  """ Return version information. """
+  print(json.dumps({
+    'name': __NAME__,
+    'version': __VERSION__
+  }, indent=4))
+
 def tag(
   release,
   dir='./',
   dry=False,
   ignore=False,
-  skip=None
+  skip=None,
+  only=None
 ):
   """Tag the audio files with the given Discogs release.
 
@@ -46,7 +54,7 @@ def tag(
       - The numeric portion of the above, e.g. 16215626
       - A local file URI pointing to a release JSON file
 
-  The SKIP flag can take one or more of the following values, comma-separated:
+  The SKIP and ONLY flags can take one or more of the following values, comma-separated:
       artist, composer, title, position, date, subtracks, album, genre, albumartist
 
       If subtracks are skipped, subtrack titles get appended to their parent track.
@@ -63,11 +71,12 @@ def copy(
   dir='./',
   dry=False,
   ignore=False,
-  skip=None
+  skip=None,
+  only=None
 ):
   """Copy the audio tags from source to destination folders.
 
-  The SKIP flag can take one or more of the following values, comma-separated:
+  The SKIP and ONLY flags can take one or more of the following values, comma-separated:
       artist, composer, title, position, date, subtracks, album, genre, albumartist
 
       If subtracks are skipped, subtrack titles get appended to their parent track.
@@ -335,13 +344,20 @@ def list_files(dir):
   ]))
 
 def parse_options(options):
-  for skip in SKIP_KEYS:
-    options['skip_' + skip.lower()] = False
   if 'skip' in options and options['skip'] is not None:
+    for skip in SKIP_KEYS:
+      options['skip_' + skip.lower()] = False
     if isinstance(options['skip'], str):
       options['skip'] = [options['skip']]
     for skip in options['skip']:
       options['skip_' + skip.lower()] = True
+  if 'only' in options and options['only'] is not None:
+    for skip in SKIP_KEYS:
+      options['skip_' + skip.lower()] = True
+    if isinstance(options['only'], str):
+      options['only'] = [options['only']]
+    for skip in options['only']:
+      options['skip_' + skip.lower()] = False
   return options
 
 def apply_metadata_track(release, track, audio, n, options):
@@ -407,6 +423,7 @@ def artist_name(artist):
 
 def cli():
   fire.Fire({
+    'version': version,
     'tag': tag,
     'copy': copy,
     'rename': rename