initial commit

Author: Caleb Land

.bnsignore

@@ -0,0 +1,16 @@
+# The list of files that should be ignored by Mr Bones.
+# Lines that start with '#' are comments.
+#
+# A .gitignore file can be used instead by setting it as the ignore
+# file in your Rakefile:
+#
+#   PROJ.ignore_file = '.gitignore'
+#
+# For a project with a C extension, the following would be a good set of
+# exclude patterns (uncomment them if you want to use them):
+# *.[oa]
+# *~
+announcement.txt
+coverage
+doc
+pkg

History.txt

@@ -0,0 +1,4 @@
+== 1.0.0 / 2009-03-18
+
+* 1 major enhancement
+  * Birthday!

README.txt

@@ -0,0 +1,88 @@
+rbsync
+    by Caleb Land
+    http://www.github.com/caleb/rbsync
+
+== DESCRIPTION:
+
+RBSync is a thin Ruby wrapper around rsync. It removes the string building
+from calling rsync from ruby.
+
+== FEATURES/PROBLEMS:
+
+* RBSync is a thin wrapper, so as to expose as much of rsync's power
+as possible
+* RBSync does, however, require that rsync be installed
+
+== SYNOPSIS:
+
+RBSync has a convenience class which makes it easy to sync with rsync's
+archive (-a) flag:
+
+  import 'rubygems'
+  import 'rbsync'
+
+  # Builds a usable rsync command using the -a (archive) flag to rsync
+  rsync = RBSync::RBSync.new '/mysite/', '[email protected]:/var/www/mysite'
+  rsync.archive!
+  rsync.sync
+
+If you want more control, you could specify each flag separately. This command
+is equivalent to the one above:
+
+  rsync = RBSync::RBsync.new '/mysite/', '[email protected]:/var/www/mysite'
+  # turns on rsync's delete flag (--delete)
+  rsync.delete!
+  rsync.recursive!
+  rsync.links!
+  rsync.perms!
+  rsync.times!
+  rsync.group!
+  rsync.owner!
+  rsync.devices!
+  rsync.specials!
+  rsync.sync
+
+You can even use the archive flag and turn off those flags which you don't want:
+  rsync = RBSync::RBsync.new '/mysite/', '[email protected]:/var/www/mysite'
+  rsync.archive!
+
+  # turn off the times (--times) flag
+  ~ rsync.times!
+
+  # turn off the devices (--devices) flag
+  rsync.devices = false
+
+  rsync.sync
+
+== REQUIREMENTS:
+
+* Ruby >= 1.8.7
+
+== INSTALL:
+
+* sudo gem install rbsync
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2009
+
+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.

Rakefile

@@ -0,0 +1,30 @@
+# Look in the tasks/setup.rb file for the various options that can be
+# configured in this Rakefile. The .rake files in the tasks directory
+# are where the options are used.
+
+begin
+  require 'bones'
+  Bones.setup
+rescue LoadError
+  begin
+    load 'tasks/setup.rb'
+  rescue LoadError
+    raise RuntimeError, '### please install the "bones" gem ###'
+  end
+end
+
+ensure_in_path 'lib'
+require 'rbsync'
+
+task :default => 'spec:run'
+
+PROJ.name = 'rbsync'
+PROJ.authors = 'Caleb Land'
+PROJ.email = '[email protected]'
+PROJ.url = 'http://www.github.com/caleb/rbsync'
+PROJ.version = RBSync::VERSION
+PROJ.rubyforge.name = 'rbsync'
+
+PROJ.spec.opts << '--color'
+
+# EOF

bin/rbsync

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+require File.expand_path(
+    File.join(File.dirname(__FILE__), %w[.. lib rbsync]))
+
+# Put your code here
+
+# EOF

lib/rbsync.rb

@@ -0,0 +1,49 @@
+
+module RBSync
+
+  # :stopdoc:
+  VERSION = '1.0.0'
+  LIBPATH = ::File.expand_path(::File.dirname(__FILE__)) + ::File::SEPARATOR
+  PATH = ::File.dirname(LIBPATH) + ::File::SEPARATOR
+  # :startdoc:
+
+  # Returns the version string for the library.
+  #
+  def self.version
+    VERSION
+  end
+
+  # Returns the library path for the module. If any arguments are given,
+  # they will be joined to the end of the libray path using
+  # <tt>File.join</tt>.
+  #
+  def self.libpath( *args )
+    args.empty? ? LIBPATH : ::File.join(LIBPATH, args.flatten)
+  end
+
+  # Returns the lpath for the module. If any arguments are given,
+  # they will be joined to the end of the path using
+  # <tt>File.join</tt>.
+  #
+  def self.path( *args )
+    args.empty? ? PATH : ::File.join(PATH, args.flatten)
+  end
+
+  # Utility method used to require all files ending in .rb that lie in the
+  # directory below this file that has the same name as the filename passed
+  # in. Optionally, a specific _directory_ name can be passed in such that
+  # the _filename_ does not have to be equivalent to the directory.
+  #
+  def self.require_all_libs_relative_to( fname, dir = nil )
+    dir ||= ::File.basename(fname, '.*')
+    search_me = ::File.expand_path(
+        ::File.join(::File.dirname(fname), dir, '**', '*.rb'))
+
+    Dir.glob(search_me).sort.each {|rb| require rb}
+  end
+
+end  # module RBSync
+
+RBSync.require_all_libs_relative_to(__FILE__)
+
+# EOF

spec/rbsync_spec.rb

@@ -0,0 +1,7 @@
+
+require File.join(File.dirname(__FILE__), %w[spec_helper])
+
+describe RBSync do
+end
+
+# EOF

spec/spec_helper.rb

@@ -0,0 +1,16 @@
+
+require File.expand_path(
+    File.join(File.dirname(__FILE__), %w[.. lib rbsync]))
+
+Spec::Runner.configure do |config|
+  # == Mock Framework
+  #
+  # RSpec uses it's own mocking framework by default. If you prefer to
+  # use mocha, flexmock or RR, uncomment the appropriate line:
+  #
+  # config.mock_with :mocha
+  # config.mock_with :flexmock
+  # config.mock_with :rr
+end
+
+# EOF