bakker 1.0.0

data/Manifest.txt

@@ -0,0 +1,8 @@
+History.txt
+Manifest.txt
+README.txt
+COPYING.txt
+Rakefile
+bin/bakker
+lib/bakker.rb
+spec/bakker_spec.rb

data/README.txt

@@ -0,0 +1,136 @@
+= Bakker
+
+* Project: https://rubyforge.org/projects/aef/
+* RDoc: http://aef.rubyforge.org/bakker/
+
+== DESCRIPTION:
+
+Bakker was created to help with simple task of renaming or copying files for
+quick backup purposes. For instance by creating a copy of a list of files
+while adding .bak to the copies filenames. Bakker gives you control over the
+extension to be added to or removed from the file and whether it should be
+moved or copied.
+
+== FEATURES/PROBLEMS:
+
+* Usable as library and commandline tool
+* Tested and fully working on:
+  * Ubuntu Linux 8.10 i386_64 (Ruby 1.8.7 and 1.9.1p0)
+  * On Windows XP i386 (Ruby 1.8.6)
+* On Windows XP i386 (Ruby 1.8.6) there were some problems testing the
+  environment variable choices. Two tests are failing but the programs seems
+  to work correctly. If anyone finds the problem, please contact me.
+* The commandline tool doesn't work with Ruby 1.9.x because the user-choices gem
+  is not yet updated. A patch is available here:
+  https://rubyforge.org/tracker/index.php?func=detail&aid=24307&group_id=4192&atid=16176
+
+== SYNOPSIS:
+
+=== Commandline
+
+The following command renames config.ini to config.ini.bak. You can type the
+same command a second time to revert the action:
+
+  bakker config.ini
+
+Instead of renaming you can create a copy of config.xml by using the following
+command:
+
+  bakker -a copy config.ini
+
+To change the extension which will be appended or removed from the filename use
+the following command:
+
+  bakker -e .backup
+
+In a directory with the follwing contents:
+
+  demo1
+  demo2.bak
+  demo3.bak
+
+if you use the command:
+
+  bakker *
+
+you get the following list of files (because by default Bakker toggles the
+extension):
+
+  demo1.bak
+  demo2
+  demo3
+
+if you now want every file in the folder to have a .bak extension use the
+following command:
+
+  bakker -m add *
+
+the result will look like this:
+
+  demo1.bak
+  demo2.bak
+  demo3.bak
+
+Instead of using the add-mode you could have used the remove-mode like this:
+
+  bakker -m remove *
+
+Then the result would have looked like this:
+
+  demo1
+  demo2
+  demo3
+
+Bakker also includes a verbose mode which will inform you of any file transfer
+in the console:
+
+  bakker -v config.ini
+
+You can specify default values for extension, action, mode and even for the
+verbose mode by using environment variables. Notice that you can still override
+these by using commandline switches. A list of the variables:
+
+* BAKKER_MODE
+* BAKKER_ACTION
+* BAKKER_EXTENSION
+* BAKKER_VERBOSE
+
+=== Library
+
+Load the gem:
+
+  require 'bakker'
+
+Call Bakker:
+
+  Bakker.process('config.ini', '.backup', :add, :copy)
+
+== REQUIREMENTS:
+
+* user-choices (for commandline tool only)
+* rspec (for testing only)
+* sys-uname (for testing only)
+
+== INSTALL:
+
+* gem install bakker
+* gem install user-choices (only for commandline tool)
+
+== LICENSE:
+
+Copyright 2009 Alexander E. Fischer <aef@raxys.net>
+
+This file is part of Bakker.
+
+Bakker 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 3 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, see <http://www.gnu.org/licenses/>.

data/Rakefile

@@ -0,0 +1,15 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/bakker.rb'
+
+Hoe.new('bakker', Bakker::VERSION) do |p|
+  p.rubyforge_name = 'aef'
+  p.developer('Alexander E. Fischer', 'aef@raxys.net')
+  p.extra_dev_deps = %w{user-choices sys-uname}
+  p.testlib = 'spec'
+  p.test_globs = ['spec/**/*_spec.rb']
+end
+
+# vim: syntax=Ruby

data/bin/bakker

@@ -0,0 +1,139 @@
+#!/usr/bin/env ruby
+#
+# Copyright 2009 Alexander E. Fischer <aef@raxys.net>
+#
+# This file is part of Bakker.
+#
+# Bakker 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 3 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, see <http://www.gnu.org/licenses/>.
+
+# TODO: If user-choices patch gets accepted, use :one_way => true for --version
+# TODO: If user-choices patch gets accepted, use :upcase for environment variables
+
+# If library is not locally accessible, use gem to include it.
+begin
+  require 'lib/bakker'
+rescue LoadError
+  require 'rubygems'
+  require 'bakker'
+end
+
+# User friendly message if user-choices is not available
+begin
+  require 'user-choices'
+rescue LoadError
+  warn "This command needs the user-choices gem to be installed.\n\nSolution: gem install user-choices"
+  exit false
+end
+
+# Application class for commandline interface
+class Bakker::Application < UserChoices::Command
+  include UserChoices
+
+  # Prepare configuration sources
+  def add_sources(builder)
+    builder.add_source(CommandLineSource, :usage,
+      "Usage: #$PROGRAM_NAME [options] files\n\n",
+      "You can set the default behavior through environment variables:\n",
+      "BAKKER_MODE (#{Bakker::MODES.join(', ')}. Default: #{Bakker::MODES.first})",
+      "BAKKER_ACTION (#{Bakker::ACTIONS.join(', ')}. Default: #{Bakker::ACTIONS.first})",
+      'BAKKER_EXTENSION (Default: .bak)',
+      "BAKKER_VERBOSE (true, false. Default: false)\n"
+    )
+
+    # Hopefully possible with next release of user-choices
+    # builder.add_source(ExtendedEnvironmentSource, :upcase, :with_prefix, 'BAKKER_')
+
+    builder.add_source(EnvironmentSource, :mapping,
+      :mode      => 'BAKKER_MODE',
+      :action    => 'BAKKER_ACTION',
+      :extension => 'BAKKER_EXTENSION',
+      :verbose   => 'BAKKER_VERBOSE'
+    )
+  end
+
+  # Define configuration options
+  def add_choices(builder)
+    builder.add_choice(:mode, :type => Bakker::MODES.map{|item| item.to_s}, :default => Bakker::MODES.first.to_s) do |cli|
+      cli.uses_option('-m', '--mode MODE',
+        "Processing mode. Can be one of: #{Bakker::MODES.join(', ')}. " +
+        "Default: #{Bakker::MODES.first}")
+    end
+
+    builder.add_choice(:action, :type => Bakker::ACTIONS.map{|item| item.to_s}, :default => Bakker::ACTIONS.first.to_s) do |cli|
+      cli.uses_option('-a', '--action ACTION',
+        "Filesystem action. Can be one of: #{Bakker::ACTIONS.join(', ')}. " +
+        "Default: #{Bakker::ACTIONS.first}")
+    end
+
+    builder.add_choice(:extension, :default => Bakker::DEFAULT_EXTENSION) do |cli|
+      cli.uses_option('-e', '--extension EXTENSION',
+        "Suffix to be added/removed"
+      )
+    end
+
+    builder.add_choice(:verbose, :type => :boolean, :default => false) do |cli|
+      cli.uses_switch('-v', '--verbose', 'Log all actions to console')
+    end
+
+    builder.add_choice(:version, :default => false, :type => :boolean) do |cli|
+      cli.uses_switch('--version', 'Display version and licensing information')
+    end
+
+    builder.add_choice(:filenames) {|cli| cli.uses_arglist }
+  end
+
+  # Main program
+  def execute
+    if @user_choices[:version]
+      klass = Bakker
+      puts "\n#{klass.name} #{klass::VERSION}"
+      puts DATA.read; exit
+    end
+    
+    if @user_choices[:filenames].empty?
+      warn 'No files given'; exit false
+    else
+      @user_choices[:filenames].each do |filename|
+        begin
+          Bakker.process(filename, @user_choices[:extension], @user_choices[:mode].to_sym,
+            @user_choices[:action].to_sym, { :verbose => @user_choices[:verbose] })
+        rescue BakkerWarning
+          warn "Ignoring #{filename}: #$!"
+        end
+      end
+    end
+  end
+end
+
+S4tUtils.with_pleasant_exceptions {Bakker::Application.new.execute}
+
+__END__
+
+Project: https://rubyforge.org/projects/aef/
+RDoc: http://aef.rubyforge.org/bakker/
+
+Copyright 2009 Alexander E. Fischer <aef@raxys.net>
+
+Bakker 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 3 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, see <http://www.gnu.org/licenses/>.

data/lib/bakker.rb

@@ -0,0 +1,69 @@
+# Copyright 2009 Alexander E. Fischer <aef@raxys.net>
+#
+# This file is part of Bakker.
+#
+# Bakker 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 3 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, see <http://www.gnu.org/licenses/>
+
+require 'fileutils'
+
+class BakkerWarning < StandardError; end
+
+module Bakker
+  VERSION = '1.0.0'
+  DEFAULT_EXTENSION = '.bak'
+  MODES = [:toggle, :add, :remove]
+  ACTIONS = [:move, :copy]
+
+  # For possible options see FileUtils methods cp() and mv()
+  def self.process(filename, extension = DEFAULT_EXTENSION, mode = MODES.first, action = ACTIONS.first, options = {})
+    raise ArgumentError, 'Action can only be :copy or :move.' unless ACTIONS.include?(action)
+    raise ArgumentError, 'Mode can only be :toggle, :add or :remove.' unless MODES.include?(mode)
+
+    # Regex used for determining if an extension should be added or removed
+    regexp = /#{Regexp.escape(extension)}$/
+
+    # Find out both the basic file name and the extended file name for every
+    # situation possible
+    filename_without_extension = filename.gsub(regexp, '')
+    filename_with_extension = filename_without_extension + extension
+
+    # Check both cases for existence for further processing
+    without_exists = File.exists?(filename_without_extension)
+    with_exists = File.exists?(filename_with_extension)
+
+    # Error if both unextended and extended files or none of them exist
+    #
+    # The mode variable contains symbols :copy or :move which correspond to
+    # methods of class FileUtils which are invoked through the send() method.
+    if without_exists and with_exists
+      raise BakkerWarning, "Both #{filename_without_extension} and #{filename_with_extension} already exist."
+    elsif without_exists and not with_exists
+      if [:toggle, :add].include?(mode)
+        FileUtils.send(action, filename_without_extension, filename_with_extension, options)
+        filename_with_extension
+      else
+        filename_without_extension
+      end
+    elsif not without_exists and with_exists
+      if [:toggle, :remove].include?(mode)
+        FileUtils.send(action, filename_with_extension, filename_without_extension, options)
+        filename_without_extension
+      else
+        filename_with_extension
+      end
+    else
+      raise BakkerWarning, "Neither #{filename_without_extension} nor #{filename_with_extension} found."
+    end
+  end
+end