itch 1.0.2

data/LICENSE.txt

@@ -0,0 +1,340 @@
+		    GNU GENERAL PUBLIC LICENSE
+		       Version 2, June 1991
+
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.
+                       59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+			    Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+License is intended to guarantee your freedom to share and change free
+software--to make sure the software is free for all its users.  This
+General Public License applies to most of the Free Software
+Foundation's software and to any other program whose authors commit to
+using it.  (Some other Free Software Foundation software is covered by
+the GNU Library General Public License instead.)  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+this service if you wish), that you receive source code or can get it
+if you want it, that you can change the software or use pieces of it
+in new free programs; and that you know you can do these things.
+
+  To protect your rights, we need to make restrictions that forbid
+anyone to deny you these rights or to ask you to surrender the rights.
+These restrictions translate to certain responsibilities for you if you
+distribute copies of the software, or if you modify it.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must give the recipients all the rights that
+you have.  You must make sure that they, too, receive or can get the
+source code.  And you must show them these terms so they know their
+rights.
+
+  We protect your rights with two steps: (1) copyright the software, and
+(2) offer you this license which gives you legal permission to copy,
+distribute and/or modify the software.
+
+  Also, for each author's protection and ours, we want to make certain
+that everyone understands that there is no warranty for this free
+software.  If the software is modified by someone else and passed on, we
+want its recipients to know that what they have is not the original, so
+that any problems introduced by others will not reflect on the original
+authors' reputations.
+
+  Finally, any free program is threatened constantly by software
+patents.  We wish to avoid the danger that redistributors of a free
+program will individually obtain patent licenses, in effect making the
+program proprietary.  To prevent this, we have made it clear that any
+patent must be licensed for everyone's free use or not licensed at all.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+		    GNU GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License applies to any program or other work which contains
+a notice placed by the copyright holder saying it may be distributed
+under the terms of this General Public License.  The "Program", below,
+refers to any such program or work, and a "work based on the Program"
+means either the Program or any derivative work under copyright law:
+that is to say, a work containing the Program or a portion of it,
+either verbatim or with modifications and/or translated into another
+language.  (Hereinafter, translation is included without limitation in
+the term "modification".)  Each licensee is addressed as "you".
+
+Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running the Program is not restricted, and the output from the Program
+is covered only if its contents constitute a work based on the
+Program (independent of having been made by running the Program).
+Whether that is true depends on what the Program does.
+
+  1. You may copy and distribute verbatim copies of the Program's
+source code as you receive it, in any medium, provided that you
+conspicuously and appropriately publish on each copy an appropriate
+copyright notice and disclaimer of warranty; keep intact all the
+notices that refer to this License and to the absence of any warranty;
+and give any other recipients of the Program a copy of this License
+along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and
+you may at your option offer warranty protection in exchange for a fee.
+
+  2. You may modify your copy or copies of the Program or any portion
+of it, thus forming a work based on the Program, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+    a) You must cause the modified files to carry prominent notices
+    stating that you changed the files and the date of any change.
+
+    b) You must cause any work that you distribute or publish, that in
+    whole or in part contains or is derived from the Program or any
+    part thereof, to be licensed as a whole at no charge to all third
+    parties under the terms of this License.
+
+    c) If the modified program normally reads commands interactively
+    when run, you must cause it, when started running for such
+    interactive use in the most ordinary way, to print or display an
+    announcement including an appropriate copyright notice and a
+    notice that there is no warranty (or else, saying that you provide
+    a warranty) and that users may redistribute the program under
+    these conditions, and telling the user how to view a copy of this
+    License.  (Exception: if the Program itself is interactive but
+    does not normally print such an announcement, your work based on
+    the Program is not required to print an announcement.)
+
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Program,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works.  But when you
+distribute the same sections as part of a whole which is a work based
+on the Program, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Program.
+
+In addition, mere aggregation of another work not based on the Program
+with the Program (or with a work based on the Program) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+  3. You may copy and distribute the Program (or a work based on it,
+under Section 2) in object code or executable form under the terms of
+Sections 1 and 2 above provided that you also do one of the following:
+
+    a) Accompany it with the complete corresponding machine-readable
+    source code, which must be distributed under the terms of Sections
+    1 and 2 above on a medium customarily used for software interchange; or,
+
+    b) Accompany it with a written offer, valid for at least three
+    years, to give any third party, for a charge no more than your
+    cost of physically performing source distribution, a complete
+    machine-readable copy of the corresponding source code, to be
+    distributed under the terms of Sections 1 and 2 above on a medium
+    customarily used for software interchange; or,
+
+    c) Accompany it with the information you received as to the offer
+    to distribute corresponding source code.  (This alternative is
+    allowed only for noncommercial distribution and only if you
+    received the program in object code or executable form with such
+    an offer, in accord with Subsection b above.)
+
+The source code for a work means the preferred form of the work for
+making modifications to it.  For an executable work, complete source
+code means all the source code for all modules it contains, plus any
+associated interface definition files, plus the scripts used to
+control compilation and installation of the executable.  However, as a
+special exception, the source code distributed need not include
+anything that is normally distributed (in either source or binary
+form) with the major components (compiler, kernel, and so on) of the
+operating system on which the executable runs, unless that component
+itself accompanies the executable.
+
+If distribution of executable or object code is made by offering
+access to copy from a designated place, then offering equivalent
+access to copy the source code from the same place counts as
+distribution of the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+  4. You may not copy, modify, sublicense, or distribute the Program
+except as expressly provided under this License.  Any attempt
+otherwise to copy, modify, sublicense or distribute the Program is
+void, and will automatically terminate your rights under this License.
+However, parties who have received copies, or rights, from you under
+this License will not have their licenses terminated so long as such
+parties remain in full compliance.
+
+  5. You are not required to accept this License, since you have not
+signed it.  However, nothing else grants you permission to modify or
+distribute the Program or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Program (or any work based on the
+Program), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+  6. Each time you redistribute the Program (or any work based on the
+Program), the recipient automatically receives a license from the
+original licensor to copy, distribute or modify the Program subject to
+these terms and conditions.  You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties to
+this License.
+
+  7. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Program at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Program by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Program.
+
+If any portion of this section is held invalid or unenforceable under
+any particular circumstance, the balance of the section is intended to
+apply and the section as a whole is intended to apply in other
+circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system, which is
+implemented by public license practices.  Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+  8. If the distribution and/or use of the Program is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Program under this License
+may add an explicit geographical distribution limitation excluding
+those countries, so that distribution is permitted only in or among
+countries not thus excluded.  In such case, this License incorporates
+the limitation as if written in the body of this License.
+
+  9. The Free Software Foundation may publish revised and/or new versions
+of the General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+Each version is given a distinguishing version number.  If the Program
+specifies a version number of this License which applies to it and "any
+later version", you have the option of following the terms and conditions
+either of that version or of any later version published by the Free
+Software Foundation.  If the Program does not specify a version number of
+this License, you may choose any version ever published by the Free Software
+Foundation.
+
+  10. If you wish to incorporate parts of the Program into other free
+programs whose distribution conditions are different, write to the author
+to ask for permission.  For software which is copyrighted by the Free
+Software Foundation, write to the Free Software Foundation; we sometimes
+make exceptions for this.  Our decision will be guided by the two goals
+of preserving the free status of all derivatives of our free software and
+of promoting the sharing and reuse of software generally.
+
+			    NO WARRANTY
+
+  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
+OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
+TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
+REPAIR OR CORRECTION.
+
+  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
+REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
+OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
+TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
+YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
+PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+		     END OF TERMS AND CONDITIONS
+
+	    How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+convey the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 2 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program; if not, write to the Free Software
+    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program is interactive, make it output a short notice like this
+when it starts in an interactive mode:
+
+    Gnomovision version 69, Copyright (C) year name of author
+    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, the commands you use may
+be called something other than `show w' and `show c'; they could even be
+mouse-clicks or menu items--whatever suits your program.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a "copyright disclaimer" for the program, if
+necessary.  Here is a sample; alter the names:
+
+  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
+  `Gnomovision' (which makes passes at compilers) written by James Hacker.
+
+  <signature of Ty Coon>, 1 April 1989
+  Ty Coon, President of Vice
+
+This General Public License does not permit incorporating your program into
+proprietary programs.  If your program is a subroutine library, you may
+consider it more useful to permit linking proprietary applications with the
+library.  If this is what you want to do, use the GNU Library General
+Public License instead of this License.

data/README.txt

@@ -0,0 +1,93 @@
+== Synopsis
+
+itch - Control Helper for ITunes - Perform operations on iTunes tracks.
+
+
+== Usage
+
+itch [--help] [--library] [--current-playlist] [--playlist name] [--all-playlists] [--create-playlist [name]] [--delete-playlist [name]] [--current-track] [--selected-tracks] [--all-tracks] [--find string] [--visible-find string] [--find-artist string] [--find-album string] [--find-composer string] [--find-track-name string] [--print-info format] [--play-found] [--set-artist string] [--set-album string] [--set-bpm number] [--set-comment string] [--set-composer string] [--set-disc-count number] [--set-disc-number number] [--set-enabled] [--set-disabled] [--set-eq string] [--set-genre string] [--set-grouping string] [--set-name string] [--set-play-count number] [--set-rating number] [--set-skip-count number] [--set-track-count number] [--set-track-number number] [--set-volume-adjustment string] [--set-year number] [--volume number] [--volume-down [number]] [--volume-up [number]] [--mute] [--unmute] [--scan-to number] [--scan-backwards [number]] [--scan-forwards [number]] [--next-track] [--pause] [--play] [--play-file name] [--play-pause] [--previous-track] [--stop] [--add-file name] [--open-url url] [--goto-store-home-page] [--update-ipod] [--quit]
+
+
+== Description
+
+Allows control of iTunes for Windows via a command line.
+It provides all basic media controls such as play, pause, stop, next/previous track, and volume adjustment.
+In addition, you can search for tracks in any given playlist and perform operations on them, or retrieve information regarding them.
+You can also add tracks to the library, sync your iPod, and perform a variety of other operations.
+
+
+== Examples
+
+Get help:
+
+	itch --help
+
+Start up iTunes [if necessary] and begin playing:
+
+	itch --play
+
+Find and play a song:
+
+	itch --find "mookid" --play-found
+
+Find all songs from an artist, show basic info on them, and play the first found:
+
+	itch --find "aphex twin" --print-info "%a - %A - %t - %n" --play-found
+
+
+== Building from Source
+
+The setup should be fairly standard for anyone familiar with Rake.  There are a few external dependencies; see below for links.
+
+Get the source from the project site.
+
+Change into the project directory.  Run "rake -T" for a list of targets.  You'll need RubyScript2Exe to build a Windows executable, or NSIS to build a Windows installer.  Building a gem should work out of the box.  "rake" builds an installer and a gem by default.
+
+
+== See Also
+
+Project Site: http://code.google.com/p/itunes-control/
+
+Nullsoft Scriptable Install System: http://nsis.sourceforge.net/
+
+RubyScript2Exe: http://www.erikveen.dds.nl/rubyscript2exe/index.html
+
+iTunes: http://www.apple.com/itunes/
+
+
+== Thanks
+
+Thanks to Eden Li and Gary Wright for various Ruby advice and assistance.
+
+
+== Author
+
+Copyright Jay McGavren, chicgeekaz@hotmail.com
+
+
+== License
+
+This program is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+
+Please see the LICENSE.txt file for the full license.
+
+
+== Legal
+
+iTunes is a trademark of Apple Inc.
+
+Windows is a registered trademark of Microsoft Corporation in the United States and other countries.
+
+itch is not endorsed, licensed, or sponsored by Apple Inc or Microsoft Corporation.

data/bin/itch

@@ -0,0 +1,26 @@
+#!/usr/bin/ruby
+
+begin
+	require 'itch'
+rescue LoadError
+	require 'rubygems'
+	require 'itch'
+end
+
+#Create an iTunes controller.
+helper = Itch.new(Itch.create_itunes_interface)
+
+#Get program options.
+config = helper.parse_options(ARGV)
+#Set default options.
+config = helper.set_default_options(config)
+#Get playlists that tracks will be selected from.
+playlists = helper.get_playlists(config)
+#Delete requested playlists.
+helper.delete_playlists(config)
+#Get tracks for processing.
+tracks = helper.get_tracks(config, playlists)
+#Process general commands.
+helper.perform_general_operations(config)
+#Process commands for specified tracks.
+helper.perform_track_operations(config, tracks)

data/lib/itch.rb

@@ -0,0 +1,369 @@
+#!/usr/bin/ruby
+
+
+require 'optparse'
+require 'win32ole'
+
+
+#A helper that controls the iTunes application.
+class Itch
+
+
+	#The COM/OLE interface to iTunes.
+	attr_reader :interface
+	
+	
+	#Create a new helper, and assign it an iTunes interface to use.
+	def initialize(itunes_interface)
+		@interface = itunes_interface
+	end
+	
+	
+	#Create an OLE/COM link to iTunes.
+	def Itch.create_itunes_interface
+		WIN32OLE.new('iTunes.Application') or raise "Couldn't take control of iTunes."
+	end
+	
+	
+	#Parse arguments and get a configuration.
+	def parse_options(arguments)
+
+		#Config will hold parsed option values.
+		config = Hash.new
+
+		#Define valid options with descriptions.
+		options = OptionParser.new
+		options.on("--help", TrueClass, "Display program help.") {
+			puts options.to_s
+			exit
+		}
+		options.on("--library", TrueClass, "Operation will include the entire iTunes library.  Used by default unless other libraries are selected.") {|value| config['library'] = value}
+		options.on("--current-playlist", TrueClass, "Operation will include the current playlist.") {|value| config['current-playlist'] = value}
+		options.on("--playlist name", Object, "Operation will include the named playlist.  (This option can occur more than once.)") {|value| (config['playlist'] ||= []) << value}
+		options.on("--all-playlists", TrueClass, "Operation will include all playlists.") {|value| config['all-playlists'] = value}
+		options.on("--create-playlist name", Object, "Create a playlist with the specified name and include it in the operation.  (This option can occur more than once.)") {|value| (config['create-playlist'] ||= []) << value}
+		options.on("--delete-playlist name", Object, "Delete the playlist with the specified name.  (This option can occur more than once.)") {|value| (config['delete-playlist'] ||= []) << value}
+		options.on("--current-track", TrueClass, "Operation will inclue the current track.") {|value| config['current-track'] = value}
+		options.on("--selected-tracks", TrueClass, "Operation will include the selected tracks.") {|value| config['selected-tracks'] = value}
+		options.on("--all-tracks", TrueClass, "Operation will include all tracks in the specified playlist(s).") {|value| config['all-tracks'] = value}
+		options.on("--find string", Object, "Operation will include all tracks in the specified playlist(s) where any field matches the specified string.  (This option can occur more than once.)") {|value| (config['find'] ||= []) << value}
+		options.on("--visible-find string", Object, "Operation will include all tracks in the specified playlist(s) where any visible field matches the specified string.  (This option can occur more than once.)") {|value| (config['visible-find'] ||= []) << value}
+		options.on("--find-artist string", Object, "Operation will include all tracks in the specified playlist(s) where the artist matches the specified string.  (This option can occur more than once.)") {|value| (config['find-artist'] ||= []) << value}
+		options.on("--find-album string", Object, "Operation will include all tracks in the specified playlist(s) where the album matches the specified string.  (This option can occur more than once.)") {|value| (config['find-album'] ||= []) << value}
+		options.on("--find-composer string", Object, "Operation will include all tracks in the specified playlist(s) where the composer matches the specified string.  (This option can occur more than once.)") {|value| (config['find-composer'] ||= []) << value}
+		options.on("--find-track-name string", Object, "Operation will include all tracks in the specified playlist(s) where the track name matches the specified string.  (This option can occur more than once.)") {|value| (config['find-track-name'] ||= []) << value}
+		options.on("--print-info format", Object, "For each track, print information in the given format.  If the following strings appear in the given format, they will be replaced with the corresponding track information:", 
+			%q#"%a": artist#,
+			%q#"%e": encoding#,
+			%q#"%A": album#,
+			%q#"%b": BPM (beats per minute)#,
+			%q#"%c": composer#,
+			%q#"%C": comment#,
+			%q#"%d": disc number#,
+			%q#"%D": disc count#,
+			%q#"%E": Enabled status ("enabled" or "disabled")#,
+			%q#"%l": location (file name/URL)#,
+			%q#"%p": play count#,
+			%q#"%q": equalizer#,
+			%q#"%g": genre#,
+			%q#"%G": grouping#,
+			%q#"%n": name (title)#,
+			%q#"%r": rating#,
+			%q#"%s": skip count#,
+			%q#"%t": track number#,
+			%q#"%T": track count#,
+			%q#"%v": volume adjustment#,
+			%q#"%y": year#,
+			%q#"%%": percent sign#
+		) {|value| config['print-info'] = value}
+		options.on("--play-found", TrueClass, "Play the first of the selected tracks.") {|value| config['play-found'] = value}
+		options.on("--set-artist name", Object, "Set the artist for each track.") {|value| config['set-artist'] = value}
+		options.on("--set-album name", Object, "Set the album for each track.") {|value| config['set-album'] = value}
+		options.on("--set-bpm number", Integer, "Set the beats per minute for each track.") {|value| config['set-bpm'] = value}
+		options.on("--set-comment string", Object, "Set the comment for each track.") {|value| config['set-comment'] = value}
+		options.on("--set-composer string", Object, "Set the composer for each track.") {|value| config['set-composer'] = value}
+		options.on("--set-disc-number number", Integer, "For each track, set the disc number.  (Used with multi-disc albums.)") {|value| config['set-disc-number'] = value}
+		options.on("--set-disc-count number", Integer, "For each track, set the number of discs in the album.  (Used with multi-disc albums.)") {|value| config['set-disc-count'] = value}
+		options.on("--set-enabled", TrueClass, "Enable the check box for each track.") {|value| config['set-enabled'] = value}
+		options.on("--set-disabled", TrueClass, "Disable the check box for each track.") {|value| config['set-disabled'] = value}
+		options.on("--set-eq name", Object, "Set the equalizer to the named preset.  Use 'None' to disable.") {|value| config['set-eq'] = value}
+		options.on("--set-genre name", Object, "Set the genre for each track.") {|value| config['set-genre'] = value}
+		options.on("--set-grouping string", Object, "Set the grouping for each track.") {|value| config['set-grouping'] = value}
+		options.on("--set-name name", Object, "Set the name (title) for each track.") {|value| config['set-name'] = value}
+		options.on("--set-play-count number", Integer, "Set the play count for each track.") {|value| config['set-play-count'] = value}
+		options.on("--set-rating number", Integer, "Set the rating for each track.  Valid values are 0 through 5.") {|value| config['set-rating'] = value}
+		options.on("--set-skip-count number", Integer, "Set the skip count for each track.") {|value| config['set-skip-count'] = value}
+		options.on("--set-track-number number", Integer, "For each track, set its album track number.") {|value| config['set-track-number'] = value}
+		options.on("--set-track-count number", Integer, "For each track, set the number of tracks on its album.") {|value| config['set-track-count'] = value}
+		options.on("--set-volume-adjustment percent", Integer, "Set the volume adjustment percentage for each track, from -100 to 100.  Negative numbers decrease the volume, positive numbers increase it.  0 means no adjustment.") {|value| config['set-volume-adjustment'] = value}
+		options.on("--set-year number", Integer, "Set the year of publication for each track.") {|value| config['set-year'] = value}
+		options.on("--volume number", Integer, "Set the volume to X percentage points.") {|value| config['volume'] = value}
+		options.on("--volume-down [number]", Integer, "Decrease the volume by X percentage points (default 10).") {|value| config['volume-down'] = value || 10}
+		options.on("--volume-up [number]", Integer, "Increase the volume by X percentage points (default 10).") {|value| config['volume-up'] = value || 10}
+		options.on("--mute", TrueClass, "Mute the audio.") {|value| config['mute'] = value}
+		options.on("--unmute", TrueClass, "Unmute the audio.") {|value| config['unmute'] = value}
+		options.on("--scan-to seconds", Integer, "Scan to an offset X seconds within the current track.") {|value| config['scan-to'] = value}
+		options.on("--scan-backwards [seconds]", Integer, "Scan backwards X seconds within the current track (default 10).") {|value| config['scan-backwards'] = value || 10}
+		options.on("--scan-forwards [seconds]", Integer, "Scan forwards X seconds within the current track (default 10).") {|value| config['scan-forwards'] = value || 10}
+		options.on("--next-track", TrueClass, "Go to the next track.") {|value| config['next-track'] = value}
+		options.on("--pause", TrueClass, "Pause playback.") {|value| config['pause'] = value}
+		options.on("--play", TrueClass, "Play the current track.") {|value| config['play'] = value}
+		options.on("--play-file name", Object, "Play the specified file or folder.") {|value| config['play-file'] = value}
+		options.on("--play-pause", TrueClass, "If currently paused, begin playing.  If currently playing, pause playback.") {|value| config['play-pause'] = value}
+		options.on("--previous-track", TrueClass, "Go to the previous track.") {|value| config['previous-track'] = value}
+		options.on("--stop", TrueClass, "Stop playback.") {|value| config['stop'] = value}
+		options.on("--add-file name", Object, "Add the specified file or folder to the library.") {|value| (config['add-file'] ||= []) << value}
+		options.on("--open-url url", Object, "Open the given URL.") {|value| config['open-url'] = value}
+		options.on("--goto-store-home-page", TrueClass, "Go to the Store.") {|value| config['goto-store-home-page'] = value}
+		options.on("--update-ipod", TrueClass, "Update the iPod.") {|value| config['update-ipod'] = value}
+		options.on("--quit", TrueClass, "Exit iTunes.") {|value| config['quit'] = value}
+		
+		#Parse the options, printing usage if parsing fails.
+		options.parse(arguments) rescue puts "#{$!}\nType '#{$0} --help' for valid options."
+		
+		config
+		
+	end
+
+
+	#Set defaults for an existing set of options.
+	def set_default_options(config=Hash.new)
+
+		config['library'] = true unless (
+			config.has_key?('library') or
+			config.has_key?('current-playlist') or
+			config.has_key?('playlist') or
+			config.has_key?('all-playlists') or
+			config.has_key?('create-playlist')
+		)
+		
+		config
+		
+	end
+
+	#Get playlists that will be operated on.
+	def get_playlists (config)
+	
+		playlists = Array.new
+		playlists.push(@interface.LibraryPlaylist) if config['library']
+		if config['current-playlist']
+			playlists.push(@interface.CurrentPlaylist) or raise "Can't find current playlist."
+		end
+		if config['all-playlists']
+			if library_playlists = @interface.LibrarySource.Playlists
+				library_playlists.each {|playlist| playlists.push(playlist)}
+			else
+				raise "No playlists found."
+			end
+		end
+		with_option_values('playlist', config) do |name|
+			playlists.push(find_playlist(name)) or raise "Can't find playlist #{name}"
+		end
+		
+		#If creation of playlist(s) requested, create them and add to the collection.
+		with_option_values('create-playlist', config) do |name|
+			playlists.push(@interface.CreatePlaylist(name)) or raise "Can't create playlist #{name}"
+		end
+		
+		playlists
+		
+	end
+
+	
+	#Delete specified playlists.
+	def delete_playlists (config)
+		with_option_values('delete-playlist', config) do |name|
+			find_playlist(name).delete
+		end
+	end
+	
+	
+	#Find requested tracks.
+	def get_tracks (config, playlists)
+	
+		tracks = Array.new
+		
+		#Add current track to list if desired.
+		if config['current-track']
+			tracks.push(@interface.CurrentTrack) or raise "Can't find current track."
+		end
+		
+		#Add highlighted tracks to list if desired.
+		if config['selected-tracks']
+			if selected_tracks = @interface.SelectedTracks
+				selected_tracks.each {|track| tracks.push(track)}
+			else
+				raise "No tracks selected."
+			end
+		end
+		
+		#Find tracks in selected playlists.
+		for playlist in playlists
+		
+			#If all tracks are to be processed, select them all.
+			if config['all-tracks']
+				playlist.Tracks.each {|track| tracks.push(track)}
+			#Otherwise, see if user wishes to search for tracks.
+			else
+				search_playlist = lambda {|option, field_id|
+					with_option_values(option, config) do |terms|
+						if (results = playlist.Search(terms, field_id))
+							results.each {|track| tracks.push(track)}
+						end
+					end
+				}
+				search_playlist.call('find', 0)
+				search_playlist.call('visible-find', 1)
+				search_playlist.call('find-artist', 2)
+				search_playlist.call('find-album', 3)
+				search_playlist.call('find-composer', 4)
+				search_playlist.call('find-track-name', 5)
+			end
+			
+			#Import files to library and add resulting tracks to list.
+			with_option_values('add-file', config) do |path|
+				tracks.concat(add_file(path, playlist))
+			end
+			
+		end
+		
+		tracks
+		
+	end
+	
+	
+	#Perform the operations specified in the config that affect iTunes itself.
+	def perform_general_operations (config)
+	
+		specified?(config, 'mute') {@interface.Mute = 1}
+		specified?(config, 'unmute') {@interface.Mute = 0}
+		specified?(config, 'next-track') {@interface.NextTrack}
+		specified?(config, 'scan-backwards') {|v| @interface.PlayerPosition -= v}
+		specified?(config, 'scan-forwards') {|v| @interface.PlayerPosition += v}
+		specified?(config, 'scan-to') {|v| @interface.PlayerPosition = v}
+		specified?(config, 'volume-down') {|v| @interface.SoundVolume -= v}
+		specified?(config, 'volume-up') {|v| @interface.SoundVolume += v}
+		specified?(config, 'volume') {|v| @interface.SoundVolume = v}
+		specified?(config, 'play-file') {|v| @interface.PlayFile(v)}
+		specified?(config, 'open-url') {|v| @interface.OpenURL(v)}
+		specified?(config, 'goto-store-home-page') {@interface.GotoMusicStoreHomePage}
+		specified?(config, 'update-ipod') {@interface.UpdateIPod}
+		specified?(config, 'pause') {@interface.Pause}
+		specified?(config, 'play-pause') {@interface.PlayPause}
+		specified?(config, 'previous-track') {@interface.PreviousTrack}
+		specified?(config, 'stop') {@interface.Stop}
+		specified?(config, 'play') {@interface.Play}
+		specified?(config, 'quit') {@interface.Quit}
+		
+	end
+	
+	
+	#Perform the operations specified in the config that affect the selected tracks.
+	def perform_track_operations (config, tracks)
+		
+		#Operate on selected tracks.
+		for track in tracks
+			specified?(config, 'set-artist') {|v| track.Artist = v}
+			specified?(config, 'set-album') {|v| track.Album = v}
+			specified?(config, 'set-bpm') {|v| track.BPM = v}
+			specified?(config, 'set-comment') {|v| track.Comment = v}
+			specified?(config, 'set-composer') {|v| track.Composer = v}
+			specified?(config, 'set-disc-count') {|v| track.DiscCount = v}
+			specified?(config, 'set-disc-number') {|v| track.DiscNumber = v}
+			specified?(config, 'set-enabled') {|v| track.Enabled = true}
+			specified?(config, 'set-disabled') {|v| track.Enabled = false}
+			specified?(config, 'set-eq') {|v| track.EQ = v}
+			specified?(config, 'set-genre') {|v| track.Genre = v}
+			specified?(config, 'set-grouping') {|v| track.Grouping = v}
+			specified?(config, 'set-name') {|v| track.Name = v}
+			specified?(config, 'set-play-count') {|v| track.PlayedCount = v}
+			specified?(config, 'set-rating') {|v| track.Rating = v * 20} #Rating is stored as a number from 1-100 internally, but 1-5 in interface.
+			specified?(config, 'set-skip-count') {|v| track.SkippedCount = v}
+			specified?(config, 'set-track-count') {|v| track.TrackCount = v}
+			specified?(config, 'set-track-number') {|v| track.TrackNumber = v}
+			specified?(config, 'set-volume-adjustment') {|v| track.VolumeAdjustment = v}
+			specified?(config, 'set-year') {|v| track.Year = v}
+			specified?(config, 'print-info') {|v| puts track_info(track, v)}
+			specified?(config, 'set-artist') {|v| track.Artist = v}
+			#TODO: Re-implement add-to-playlist.
+		end
+		
+		#Play first of selected tracks if requested.
+		specified?(config, 'play-found') {tracks[0].Play unless tracks.empty?}
+		
+	end
+	
+	
+	#Take the specified format string with %x flags, and substitute info from the given track.
+	def track_info (track, format)
+	
+		#Double percent signs should not be substituted, so work around them.
+		segments = format.split(/%%/)
+		
+		#Substitute track info for markers.
+		output_segments = segments.map do |segment|
+			segment.gsub!(/%a/) {track.Artist}
+			segment.gsub!(/%e/) {track.KindAsString} #The encoding.
+			segment.gsub!(/%A/) {track.Album}
+			segment.gsub!(/%b/) {track.BPM.to_s}
+			segment.gsub!(/%c/) {track.Composer}
+			segment.gsub!(/%C/) {track.Comment}
+			segment.gsub!(/%d/) {track.DiscNumber.to_s}
+			segment.gsub!(/%D/) {track.DiscCount.to_s}
+			segment.gsub!(/%E/) {track.Enabled == 1 ? 'enabled' : 'disabled'}
+			segment.gsub!(/%l/) {track.Location}
+			segment.gsub!(/%p/) {track.PlayedCount.to_s}
+			segment.gsub!(/%q/) {track.EQ}
+			segment.gsub!(/%g/) {track.Genre}
+			segment.gsub!(/%G/) {track.Grouping}
+			segment.gsub!(/%n/) {track.Name}
+			segment.gsub!(/%r/) {(track.Rating.to_i / 20).to_s}
+			segment.gsub!(/%s/) {track.SkippedCount.to_s}
+			segment.gsub!(/%t/) {track.TrackNumber.to_s}
+			segment.gsub!(/%T/) {track.TrackCount.to_s}
+			segment.gsub!(/%v/) {track.VolumeAdjustment.to_s}
+			segment.gsub!(/%y/) {track.Year.to_s}
+			segment
+		end
+
+		#Replace double percent signs with single percent signs and return.
+		output = output_segments.join('%')
+		output += '%' if format =~ /%%$/ #split() doesn't create final empty field if string ends in a delimiter.
+		output
+		
+	end
+		
+		
+	private
+	
+		#Get selected playlist from iTunes.
+		def find_playlist(name)
+			@interface.LibrarySource.Playlists.ItemByName(name) or raise "Can't find playlist '#{name}'"
+		end
+		
+		#Invoke a block with each of the values for the given option in the given configuration.
+		def with_option_values (key, config)
+			if config.has_key?(key)
+				config[key].each {|value| yield value}
+			end
+		end
+		
+		#Add files to each specified playlist.
+		def add_file(path, playlist)
+			#Add the file and retrieve the status (since it's an asynchronous operation).
+			status = playlist.AddFile(path) or raise "Can't find '#{path}'."
+			#Wait for operation to complete.
+			sleep 1 while status.InProgress
+			#Return added track(s).
+			tracks = Array.new
+			status.Tracks.each {|track| tracks.push(track)}
+			tracks
+		end
+		
+		#Perform an action only if the given option was specified.
+		def specified? (config, key)
+			yield config[key] if config.has_key?(key)
+		end
+		
+	
+end

data/test/test_itch.rb

@@ -0,0 +1,312 @@
+#!/usr/bin/ruby
+
+require 'itch'
+require 'test/unit'
+
+class TestItch < Test::Unit::TestCase
+
+	#Mock object to test that proper calls are made...
+	class MockOLE
+		def initialize (name='')
+			@name = name
+		end
+		attr_accessor :calls, :name
+		#Log any called methods and return a new stub that is itself an OLE object.
+		def method_missing (method_id, *arguments)
+			(@calls ||= Array.new) << [method_id.id2name, arguments]
+			(@methods ||= Hash.new)[method_id.id2name] ||= MockOLE.new(method_id.id2name)
+		end
+	end
+
+	#A mock object that returns the name of the accessor as the accessor value.
+	class MockObject
+		def method_missing (method_id, *arguments)
+			method_id.id2name
+		end
+	end
+
+	
+	def setup
+		#Create a Helper to run tests on.
+		@helper = Itch.new(Itch.create_itunes_interface)
+	end
+	
+	
+	def test_parse_options
+		
+		#Test parsing.
+		config = @helper.parse_options [
+			'--all-playlists',
+			'--update-ipod'
+		]
+		assert_not_nil(config['all-playlists'])
+		assert_not_nil(config['update-ipod'])
+		
+		#Test values on options that should occur only once.
+		config = @helper.parse_options [
+			'--set-disc-count', '1',
+			'--set-disc-count', '2', #Override previous value.
+			'--set-disc-number', '1'
+		]
+		assert_equal(2, config['set-disc-count'])
+		assert_equal(1, config['set-disc-number'])
+		
+		#Test default values.
+		config = @helper.parse_options [
+			'--volume-up', 
+			'--volume-down',
+			'--scan-forwards',
+			'--scan-backwards'
+		]
+		assert_equal(10, config['volume-up'])
+		assert_equal(10, config['volume-down'])
+		assert_equal(10, config['scan-forwards'])
+		assert_equal(10, config['scan-backwards'])
+		config = @helper.parse_options [
+			'--volume-up', '11',
+			'--volume-down', '12'
+		]
+		assert_equal(11, config['volume-up'])
+		assert_equal(12, config['volume-down'])
+		
+		#Test gathering of multiple values for same option.
+		config = @helper.parse_options [
+			'--playlist', 'foo',
+			'--playlist', 'bar',
+			'--find', 'baz',
+			'--find', 'eep'
+		]
+		assert(config['playlist'].include?('foo'))
+		assert(config['playlist'].include?('bar'))
+		assert(config['find'].include?('baz'))
+		assert(config['find'].include?('eep'))
+		
+	end
+	
+	
+	def test_set_default_options
+	
+		#Test setting defaults on an empty config.
+		config = @helper.set_default_options
+		assert(config['library'])
+		
+		#Test running on an existing config.
+		config = @helper.set_default_options(
+			{'library' => false}
+		)
+		assert_equal(false, config['library'])
+		
+		#Test using entire library by default.
+		[
+			{'current-playlist' => true},
+			{'playlist' => ['foo', 'bar']},
+			{'all-playlists' => true},
+			{'create-playlist' => ['foo', 'bar']},
+		].each do |options|
+			config = @helper.set_default_options(options)
+			assert_nil(config['library'], config.to_s)
+		end
+		config = @helper.set_default_options({'library' => true}) #Obviously, we shouldn't set library to false if it was explicitly specified.
+		assert(config['library'])
+		config = @helper.set_default_options({'library' => false}) #If library is explicitly set to false, keep it false.
+		assert_equal(false, config['library'])
+		
+	end
+
+
+	def test_create_itunes_interface
+		interface = Itch.create_itunes_interface
+		assert_not_nil(interface.LibraryPlaylist)
+	end
+	
+	
+	def test_get_playlists
+	
+		#Test that the appropriate playlist set is returned for various configs.
+		playlists = @helper.get_playlists({'library' => true})
+		assert_equal('Library', playlists[0].Name)
+# 		playlists = @helper.get_playlists({'current-playlist' => true})
+# 		assert_equal('Party Shuffle', playlists[0].Name)
+		playlists = @helper.get_playlists({'all-playlists' => true})
+		assert_equal('Library', playlists[0].Name)
+		assert_equal('Party Shuffle', playlists[1].Name)
+		playlists = @helper.get_playlists({'create-playlist' => ['foo', 'bar']})
+		assert_equal('foo', playlists[0].Name)
+		assert_equal('bar', playlists[1].Name)
+		playlists = @helper.get_playlists({'playlist' => ['Recently Added', 'My Top Rated']})
+		assert_equal('Recently Added', playlists[0].Name)
+		assert_equal('My Top Rated', playlists[1].Name)
+		
+	end
+
+
+	def test_delete_playlists
+	
+		#Create some temporary playlists.
+		playlists = @helper.get_playlists({'create-playlist' => ['delete1', 'delete2']})
+		#Test that the playlist is deleted.
+		@helper.delete_playlists({'delete-playlist' => ['delete1', 'delete2']})
+		assert_raise(RuntimeError) do
+			@helper.get_playlists({'playlist' => ['delete1']})
+		end
+		assert_raise(RuntimeError) do
+			@helper.get_playlists({'playlist' => ['delete2']})
+		end
+		#Test deleting a missing playlist.
+		assert_raise(RuntimeError) do
+			@helper.delete_playlists({'delete-playlist' => ['delete1']})
+		end
+		
+	end
+	
+	
+	def test_get_tracks
+		#TODO: Re-implement using mock object.
+# 		#Create a playlist to add files to.
+# 		playlists = @helper.get_playlists({'create-playlist' => 'add1'})
+# 		#Test that appropriate tracks are returned for various options.
+# 		tracks = @helper.get_tracks({'add-file' => 'test.mp3'}, playlists)
+# 		assert_equal('J-Hop', tracks[0].Name)
+# 		tracks = @helper.get_tracks({'all-tracks' => true}, playlists)
+# 		assert_equal('J-Hop', tracks[0].Name)
+# 		tracks = @helper.get_tracks({'find' => 'J-Hop'}, playlists)
+# 		assert_equal('J-Hop', tracks[0].Name)
+# 		tracks = @helper.get_tracks({'visible-find' => 'J-Hop'}, playlists)
+# 		assert_equal('J-Hop', tracks[0].Name)
+# 		tracks = @helper.get_tracks({'find-artist' => 'Jay'}, playlists)
+# 		assert_equal('J-Hop', tracks[0].Name)
+# 		tracks = @helper.get_tracks({'find-album' => 'HopJ'}, playlists)
+# 		assert_equal('J-Hop', tracks[0].Name)
+# 		tracks = @helper.get_tracks({'find-composer' => 'MrSymphony'}, playlists)
+# 		assert_equal('J-Hop', tracks[0].Name)
+# 		tracks = @helper.get_tracks({'find-track-name' => 'J-Hop'}, playlists)
+# 		assert_equal('J-Hop', tracks[0].Name)
+	end
+	
+	
+	def test_perform_general_operations
+	
+		@helper.perform_general_operations({'volume' => 50})
+		assert_equal(50, @helper.interface.SoundVolume)
+		@helper.perform_general_operations({'volume-up' => 10})
+		assert_equal(60, @helper.interface.SoundVolume)
+		@helper.perform_general_operations({'volume-down' => 9})
+		assert_equal(51, @helper.interface.SoundVolume)
+		
+	end
+	
+	
+	def test_perform_track_operations
+	
+		track = MockOLE.new
+		
+		#Test generic attribute setting.
+		def test (attribute, track, expected_method)
+			@helper.perform_track_operations({attribute => attribute}, [track])
+			assert_equal([expected_method, [attribute]], track.calls.pop)
+		end
+		test('set-artist', track, 'Artist=')
+		test('set-album', track, 'Album=')
+		test('set-bpm', track, 'BPM=')
+		test('set-comment', track, 'Comment=')
+		test('set-composer', track, 'Composer=')
+		test('set-disc-count', track, 'DiscCount=')
+		test('set-disc-number', track, 'DiscNumber=')
+		test('set-eq', track, 'EQ=')
+		test('set-genre', track, 'Genre=')
+		test('set-grouping', track, 'Grouping=')
+		test('set-name', track, 'Name=')
+		test('set-play-count', track, 'PlayedCount=')
+		test('set-skip-count', track, 'SkippedCount=')
+		test('set-track-count', track, 'TrackCount=')
+		test('set-track-number', track, 'TrackNumber=')
+		test('set-volume-adjustment', track, 'VolumeAdjustment=')
+		test('set-year', track, 'Year=')
+		#Test specialized attribute setting.
+		@helper.perform_track_operations({'set-enabled' => true}, [track])
+		assert_equal(['Enabled=', [true]], track.calls.pop)
+		@helper.perform_track_operations({'set-disabled' => true}, [track])
+		assert_equal(['Enabled=', [false]], track.calls.pop)
+		@helper.perform_track_operations({'set-rating' => 1}, [track])
+		assert_equal(['Rating=', [20]], track.calls.pop) #Rating is stored as a number from 1-100 internally
+		@helper.perform_track_operations({'set-rating' => 5}, [track])
+		assert_equal(['Rating=', [100]], track.calls.pop)
+		
+	end
+	
+	
+	def test_track_info
+	
+		track = MockObject.new
+		
+		#Test that the right attribute is returned for each tag.
+		assert_equal('Artist', @helper.track_info(track, '%a'))
+		assert_equal('KindAsString', @helper.track_info(track, '%e'))
+		assert_equal('Album', @helper.track_info(track, '%A'))
+		def track.BPM
+			120
+		end
+		assert_equal('120', @helper.track_info(track, '%b'))
+		assert_equal('Composer', @helper.track_info(track, '%c'))
+		assert_equal('Comment', @helper.track_info(track, '%C'))
+		def track.DiscNumber
+			1
+		end
+		assert_equal('1', @helper.track_info(track, '%d'))
+		def track.DiscCount
+			2
+		end
+		assert_equal('2', @helper.track_info(track, '%D'))
+		def track.Enabled
+			1
+		end
+		assert_equal('enabled', @helper.track_info(track, '%E'))
+		def track.Enabled
+			0
+		end
+		assert_equal('disabled', @helper.track_info(track, '%E'))
+		def track.Location
+			'C:\content\Orbital\The Altogether (disc 2_ the Remixes, Unr\06 Beelzebeat.mp3'
+		end
+		assert_equal(track.Location, @helper.track_info(track, '%l'))
+		def track.PlayedCount
+			15
+		end
+		assert_equal('15', @helper.track_info(track, '%p'))
+		assert_equal('EQ', @helper.track_info(track, '%q'))
+		assert_equal('Genre', @helper.track_info(track, '%g'))
+		assert_equal('Grouping', @helper.track_info(track, '%G'))
+		assert_equal('Name', @helper.track_info(track, '%n'))
+		def track.Rating
+			100 #Internal rating is a number from 0-100.
+		end
+		assert_equal('5', @helper.track_info(track, '%r'))
+		def track.SkippedCount
+			3
+		end
+		assert_equal('3', @helper.track_info(track, '%s'))
+		def track.TrackNumber
+			2
+		end
+		assert_equal('2', @helper.track_info(track, '%t'))
+		def track.TrackCount
+			12
+		end
+		assert_equal('12', @helper.track_info(track, '%T'))
+		assert_equal('VolumeAdjustment', @helper.track_info(track, '%v'))
+		assert_equal('Year', @helper.track_info(track, '%y'))
+		
+		#Test multiple tags at once.
+		assert_equal('Artist - Album - 2 - Name', @helper.track_info(track, '%a - %A - %t - %n'))
+		
+		#Test substituting % for %%.
+		assert_equal('Artist%Name', @helper.track_info(track, '%a%%%n'))
+		assert_equal('%Name', @helper.track_info(track, '%%%n'))
+		assert_equal('Artist%', @helper.track_info(track, '%a%%'))
+		assert_equal('%Album%', @helper.track_info(track, '%%%A%%'))
+ 		assert_equal('%', @helper.track_info(track, '%%'))
+		
+	end
+	
+	
+end

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.2
+specification_version: 1
+name: itch
+version: !ruby/object:Gem::Version 
+  version: 1.0.2
+date: 2007-04-26 00:00:00 -07:00
+summary: Allows control of iTunes for Windows via a command line.
+require_paths: 
+- lib
+email: chicgeekaz@hotmail.com
+homepage: http://code.google.com/p/itunes-control/
+rubyforge_project: itch
+description: 
+autorequire: itch
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Jay McGavren
+files: 
+- LICENSE.txt
+- README.txt
+- bin/itch
+- lib/itch.rb
+- test/test_itch.rb
+test_files: 
+- test/test_itch.rb
+rdoc_options: 
+- --title
+- Itch -- Control Helper for iTunes
+- --main
+- README.txt
+extra_rdoc_files: 
+- README.txt
+- LICENSE.txt
+executables: 
+- itch
+extensions: []
+
+requirements: 
+- iTunes for Windows
+dependencies: []
+