taffy 1.0.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a5bf0ec96d13e39c428d1cefc0d512c18cf00d63
-  data.tar.gz: 83f113d30021a166a9ccf3496253f9e418d4ea73
+  metadata.gz: 727ec7db507261872cfb085e9f2cb700ce306432
+  data.tar.gz: 0372a2d4f1751c73fffdbe78f9bfe98e2b0e1bd0
 SHA512:
-  metadata.gz: 6abd3d0c624c8b9b022285fecd2c58b9783c0194055eb973d3450933303b72c78462b725238243d2191fd2534c3e1f906785f268bd172661a49be7018f300d5a
-  data.tar.gz: 05e2ceddb7183f239accddbb279c3f50f06cc598f8635a64aecff6fe889a7cb7e77bc27bcca468b5f210d2f991fadb6a0c90e922a3232773f475cf561ed32e31
+  metadata.gz: 6df863135ca65cc7c494029d0a706042f4fe1009ef66d02d2132f5408b5fb7b1e63beb676e891c134a8c8025715b9a79f4d150c3bc71feb62bae5f7eab074036
+  data.tar.gz: b9ee4171e030a1d3d45fdbb3b12bc21e86ee90c46ce757a511dae335ce517a39e83e05b888660be601c59925760707683fd1fe5f732a37ccac3aa6fe5c1914f5

data/README.md

@@ -1,9 +1,9 @@
 Taffy
 =====
-Taffy is a command-line interface for reading and writing audio (and
-video) metadata, as supported by [TagLib](http://taglib.github.io/).
-That means it can edit tags for MP3, Ogg Vorbis, FLAC, WAV, and MP4
-files, along with a few other file formats I've never used.
+Taffy is a command-line tool for reading and writing audio metadata, as
+supported by [TagLib](http://taglib.github.io/). That means it can edit
+tags for MP3, Ogg Vorbis, FLAC, WAV, and MP4 files, along with a few
+other file formats I've never used.
 
 Installation
 ------------
@@ -11,44 +11,53 @@ Installation
 
 Usage
 -----
-	Usage: taffy [options] file ...
-
-	Tag options:
-		-l, --album=ALBUM                Set album tag
-		-r, --artist=ARTIST              Set artist tag
-		-c, --comment=COMMENT            Set comment tag
-		-g, --genre=GENRE                Set genre tag
-		-t, --title=TITLE                Set title tag
-		-n, --track=TRACK                Set track tag
-		-y, --year=YEAR                  Set year tag
-			--no-album                   Clear album tag
-			--no-artist                  Clear artist tag
-			--no-comment                 Clear comment tag
-			--no-genre                   Clear genre tag
-			--no-title                   Clear title tag
-			--no-track                   Clear track tag
-			--no-year                    Clear year tag
-			--clear                      Clear all tags
-
-	If no tag options are given, file tags are printed instead.
-
-	Other options:
-		-h, --help                       Show this message
-			--version                    Show version
+    Usage: taffy [options] file ...
+
+    Tag options:
+        -l, --album ALBUM                Set album tag
+        -r, --artist ARTIST              Set artist tag
+        -c, --comment COMMENT            Set comment tag
+        -g, --genre GENRE                Set genre tag
+        -t, --title TITLE                Set title tag
+        -n, --track TRACK                Set track tag
+        -y, --year YEAR                  Set year tag
+            --no-album                   Clear album tag
+            --no-artist                  Clear artist tag
+            --no-comment                 Clear comment tag
+            --no-genre                   Clear genre tag
+            --no-title                   Clear title tag
+            --no-track                   Clear track tag
+            --no-year                    Clear year tag
+            --clear                      Clear all tags
+
+    Filename options:
+            --rename SPEC                Rename file based on tags
+
+    If no options are given, file tags are printed instead.
+
+    In a filename spec, a sequence such as %R or %r stands for
+    the corresponding tag, in this case the artist name. %R
+    leaves letter case intact, while %r downcases the tag. A
+    sequence such as %_t maps special characters in the tag
+    to the given substitute, in this case an underscore.
+
+    Other options:
+        -h, --help                       Show this message and exit
+            --version                    Show version and exit
 
 Examples
 --------
-Tag an audio file with a title:
-
-	taffy -t "Queen of the Mole People" song.mp3
+Print tags from an audio file:
+	
+	taffy song.mp3
 
 Tag a series of files with an artist, album, and year:
 
 	taffy -r Deerhoof -l "The Man, The King, The Girl" -y 1997 *.mp3
 
-Clear tags from a file:
-	
-	taffy --clear song.mp3
+Tag an audio file, then rename it to "14 - Queen of the Mole People.mp3":
+
+	taffy -n 14 -t "Queen of the Mole People" --rename "%n - %T" song.mp3
 
 Etymology
 ---------

data/bin/taffy

@@ -1,9 +1,11 @@
 #!/usr/bin/env ruby
 
 require 'optparse'
+require 'shellwords'
+
 require 'taglib'
 
-VERSION = [1, 0, 0]
+VERSION = [1, 1, 1]
 
 FIELDS = [
   ['l', 'album',   String],
@@ -16,6 +18,7 @@ FIELDS = [
 ]
 
 actions = []
+rename_spec = nil
 status = 0
 
 options = OptionParser.new do |opts|
@@ -26,19 +29,17 @@ options = OptionParser.new do |opts|
 
   FIELDS.each do |f|
     short = "-#{f[0]}#{f[1].upcase}"
-    long = "--#{f[1]}=#{f[1].upcase}"
+    long = "--#{f[1]} #{f[1].upcase}"
     opts.on(short, long, f[2], "Set #{f[1]} tag") do |x|
       actions << ->(r) { r.send("#{f[1]}=", x) }
     end
   end
-
   FIELDS.each do |f|
     long = "--no-#{f[1]}"
     opts.on(long, "Clear #{f[1]} tag") do
       actions << ->(r) { r.send("#{f[1]}=", f[2] == String ? nil : 0) }
     end
   end
-
   opts.on("--clear", "Clear all tags") do
     FIELDS.each do |f|
       actions << ->(r) { r.send("#{f[1]}=", f[2] == String ? nil : 0) }
@@ -46,17 +47,30 @@ options = OptionParser.new do |opts|
   end
 
   opts.separator ""
-  opts.separator "If no tag options are given, file tags are printed instead."
+  opts.separator "Filename options:"
+
+  opts.on("--rename SPEC", String, "Rename file based on tags") do |spec|
+    rename_spec = spec
+  end
+
+  opts.separator ""
+  opts.separator "If no options are given, file tags are printed instead."
+  opts.separator ""
+  opts.separator "In a filename spec, a sequence such as %R or %r stands for"
+  opts.separator "the corresponding tag, in this case the artist name. %R"
+  opts.separator "leaves letter case intact, while %r downcases the tag. A"
+  opts.separator "sequence such as %_t maps special characters in the tag"
+  opts.separator "to the given substitute, in this case an underscore."
   opts.separator ""
   opts.separator "Other options:"
 
-  opts.on_tail("-h", "--help", "Show this message") do
+  opts.on_tail("-h", "--help", "Show this message and exit") do
     puts opts
     exit
   end
 
-  opts.on_tail("--version", "Show version") do
-    puts VERSION.join('.')
+  opts.on_tail("--version", "Show version and exit") do
+    puts "taffy #{VERSION.join('.')}"
     exit
   end
 end
@@ -84,6 +98,19 @@ def print_info(filename, tag)
   puts
 end
 
+def rename(tag, spec)
+  FIELDS.each do |f|
+    tag_string = tag.send(f[1]).to_s
+    tag_string = tag_string.rjust(2, '0') if f[1] == 'track'
+    spec.gsub!(/%(\W|_)?(#{f[0]}|#{f[0].upcase})/) do |match|
+      sub = $2 == f[0] ? tag_string.downcase : tag_string
+      match.size == 3 ? sub.shellescape.gsub(/\\./, $1) : sub
+    end
+  end
+
+  spec
+end
+
 ARGV.each do |filename|
   TagLib::FileRef.open(filename) do |fileref|
     if fileref.null?
@@ -92,12 +119,17 @@ ARGV.each do |filename|
       next
     end
 
-    if actions.empty?
+    if actions.empty? and !rename_spec
       print_info(filename, fileref.tag)
     else
       actions.each { |action| action.call(fileref.tag) }
       fileref.save
     end
+
+    if rename_spec
+      name = rename(fileref.tag, rename_spec) + File.extname(filename)
+      File.rename(filename, File.join(File.dirname(filename), name))
+    end
   end
 end
 

data/taffy.gemspec

@@ -1,9 +1,9 @@
 Gem::Specification.new do |s|
   s.name        = 'taffy'
-  s.version     = '1.0.0'
-  s.date        = '2015-04-26'
-  s.summary     = 'command-line media tagging interface'
-  s.description = "A command-line interface for reading and writing audio \
+  s.version     = '1.1.1'
+  s.date        = '2015-04-27'
+  s.summary     = 'A command-line audio tagging tool'
+  s.description = "A command-line tool for reading and writing audio \
                    metadata.".squeeze(' ')
   s.authors     = ['Brandon Mulcahy']
   s.email       = 'brandon@jangler.info'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: taffy
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.1
 platform: ruby
 authors:
 - Brandon Mulcahy
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-04-26 00:00:00.000000000 Z
+date: 2015-04-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: taglib-ruby
@@ -30,7 +30,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 0.7.0
-description: A command-line interface for reading and writing audio metadata.
+description: A command-line tool for reading and writing audio metadata.
 email: brandon@jangler.info
 executables:
 - taffy
@@ -64,5 +64,5 @@ rubyforge_project:
 rubygems_version: 2.4.5
 signing_key: 
 specification_version: 4
-summary: command-line media tagging interface
+summary: A command-line audio tagging tool
 test_files: []