taffy 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a5bf0ec96d13e39c428d1cefc0d512c18cf00d63
+  data.tar.gz: 83f113d30021a166a9ccf3496253f9e418d4ea73
+SHA512:
+  metadata.gz: 6abd3d0c624c8b9b022285fecd2c58b9783c0194055eb973d3450933303b72c78462b725238243d2191fd2534c3e1f906785f268bd172661a49be7018f300d5a
+  data.tar.gz: 05e2ceddb7183f239accddbb279c3f50f06cc598f8635a64aecff6fe889a7cb7e77bc27bcca468b5f210d2f991fadb6a0c90e922a3232773f475cf561ed32e31

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2015 Brandon Mulcahy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,55 @@
+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.
+
+Installation
+------------
+	gem install taffy
+
+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
+
+Examples
+--------
+Tag an audio file with a title:
+
+	taffy -t "Queen of the Mole People" 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
+
+Etymology
+---------
+Taffy tags audio files for you.

data/bin/taffy

@@ -0,0 +1,104 @@
+#!/usr/bin/env ruby
+
+require 'optparse'
+require 'taglib'
+
+VERSION = [1, 0, 0]
+
+FIELDS = [
+  ['l', 'album',   String],
+  ['r', 'artist',  String],
+  ['c', 'comment', String],
+  ['g', 'genre',   String],
+  ['t', 'title',   String],
+  ['n', 'track',   Integer],
+  ['y', 'year',    Integer],
+]
+
+actions = []
+status = 0
+
+options = OptionParser.new do |opts|
+  opts.banner += " file ..."
+
+  opts.separator ""
+  opts.separator "Tag options:"
+
+  FIELDS.each do |f|
+    short = "-#{f[0]}#{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) }
+    end
+  end
+
+  opts.separator ""
+  opts.separator "If no tag options are given, file tags are printed instead."
+  opts.separator ""
+  opts.separator "Other options:"
+
+  opts.on_tail("-h", "--help", "Show this message") do
+    puts opts
+    exit
+  end
+
+  opts.on_tail("--version", "Show version") do
+    puts VERSION.join('.')
+    exit
+  end
+end
+
+begin
+  options.parse!
+rescue OptionParser::ParseError => err
+  warn(err)
+  exit(1)
+end
+
+if ARGV.empty?
+  puts options
+  exit(1)
+end
+
+def print_info(filename, tag)
+  puts filename
+
+  FIELDS.each do |f|
+    value = tag.send(f[1])
+    puts "#{f[1]}:#{' ' * (8 - f[1].size)}#{value}" if value && value != 0
+  end
+
+  puts
+end
+
+ARGV.each do |filename|
+  TagLib::FileRef.open(filename) do |fileref|
+    if fileref.null?
+      warn("Could not open file: #{filename}")
+      status = 2
+      next
+    end
+
+    if actions.empty?
+      print_info(filename, fileref.tag)
+    else
+      actions.each { |action| action.call(fileref.tag) }
+      fileref.save
+    end
+  end
+end
+
+exit(status)

data/taffy.gemspec

@@ -0,0 +1,17 @@
+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 \
+                   metadata.".squeeze(' ')
+  s.authors     = ['Brandon Mulcahy']
+  s.email       = 'brandon@jangler.info'
+  s.files       = `git ls-files`.split
+  s.homepage    = 'https://github.com/jangler/taffy'
+  s.license     = 'MIT'
+
+  s.executables << 'taffy'
+  s.add_runtime_dependency 'taglib-ruby', '~> 0.7', '>= 0.7.0'
+  s.required_ruby_version = '>= 2.0.0'
+end

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification
+name: taffy
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Brandon Mulcahy
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-04-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: taglib-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.7.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.7.0
+description: A command-line interface for reading and writing audio metadata.
+email: brandon@jangler.info
+executables:
+- taffy
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- bin/taffy
+- taffy.gemspec
+homepage: https://github.com/jangler/taffy
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: command-line media tagging interface
+test_files: []