remotebackup 0.5.0

data/History.txt

@@ -0,0 +1,4 @@
+== 0.0.1 2008-06-23
+
+* 1 major enhancement:
+  * Initial release

data/License.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2008 FIXME full name
+
+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/Manifest.txt

@@ -0,0 +1,27 @@
+History.txt
+License.txt
+Manifest.txt
+PostInstall.txt
+README.txt
+Rakefile
+config/hoe.rb
+config/requirements.rb
+lib/remotebackup.rb
+lib/remotebackup/version.rb
+bin/remote_backup
+bin/restore_backup
+script/console
+script/destroy
+script/generate
+script/txt2html
+setup.rb
+tasks/deployment.rake
+tasks/environment.rake
+tasks/website.rake
+test/test_helper.rb
+test/test_remotebackup.rb
+website/index.html
+website/index.txt
+website/javascripts/rounded_corners_lite.inc.js
+website/stylesheets/screen.css
+website/template.html.erb

data/PostInstall.txt

@@ -0,0 +1,7 @@
+
+For more information on remotebackup, see http://remotebackup.rubyforge.org
+
+NOTE: Change this information in PostInstall.txt 
+You can also delete it if you don't want it.
+
+

data/README.txt

@@ -0,0 +1,149 @@
+= remote_backup
+
+* http://net-ssh.rubyforge.org/remotebackup
+
+== DESCRIPTION:
+
+remote ssh backup is backup files on remote server with ssh. It's not required any program on remote server.Only download files which changed size or mday. And you can restore not only last version but also past version. 
+
+== FEATURES/PROBLEMS:
+* Transfer files or entire directory trees  from a remote host via SCP
+* Configurete server,path,user,password and ignore directory or files  by xml. 
+* remote_backup makes backup file tree information by yaml named yyyymmdd.yml in repository + backup name
+* restore_backup read backup file tree information and reconstruct from repository to outputdir.
+* Make backup file tree information when more than one files are changed on remote server from last backup.
+* Download  files  changed size or mday from last backup.
+* backup target are file,symbolic link and directory (not device,socket,pipe)
+* restore whichever version by specified backup file tree information.
+* Only Linux or BSD (not windows)
+
+
+== SYNOPSIS:
+
+In a nutshell:
+To use remote_backup,you should prepare backup configuretion by xml such below.
+<backups>
+	<backup>
+		<name>backup name</name>
+		<server>server name</server>
+		<user>user name</user>
+		<password>user name</password>
+		<path>path for backup</path>
+		<ignore_list>
+			<ignore>regular expression for not backup </ignore>
+											:
+		</ignore_list>
+	</backup>
+				:
+</backups>
+
+/backups 
+	mandatory. root directory. It has children of backup informations
+/backups/backup
+	mandatory. unit of backup information
+/backups/backup/name
+	mandatory. backup information name
+/backups/backup/server
+	mandatory. remote host address.
+/backups/backup/user
+	mandatory.  login name to remote host .
+/backups/backup/password
+	mandatory.  login password to remote host .
+/backups/backup/path
+	mandatory.  path for begin to backup on remote host.
+/backups/backup/ignore_list
+	option.  parent of ignore entity.
+/backups/backup/ignore
+	option.  don't wish file or directory name under backup path.
+
+command
+	remote_backup [-f filename] [-o output repository directory]
+
+	filename:
+		file name written backup information. if not specified default is ./backup.xml
+	output directory:
+		repository directory.  if not specified default is .(current directory)
+		Backup file is stored and  backup file tree information yaml is maked in repository directory 
+		+ backup name.  
+
+	restore_backup -f filename -o output directory
+		filename:
+			backup file tree information yaml which locate repository directory + backup name + yyyymmdd.yaml
+		output directory:
+			directory you want to make backup tree. 
+
+== REQUIREMENTS:
+
+* Net::SSH 2
+* Net::SCP
+
+== INSTALL:
+
+* gem install remote-backup (might need sudo privileges)
+
+Or, you can do it the hard way (without Rubygems):
+
+* tar xzf net-backup-*.tgz
+* cd remote-backup-*
+* ruby setup.rb config
+* ruby setup.rb install (might need sudo privileges)
+
+== LICENSE:
+Ruby is copyrighted free software by Yukihiro Matsumoto <matz@netlab.co.jp>.
+You can redistribute it and/or modify it under either the terms of the GPL
+(see COPYING.txt file), or the conditions below:
+
+  1. You may make and give away verbatim copies of the source form of the
+     software without restriction, provided that you duplicate all of the
+     original copyright notices and associated disclaimers.
+
+  2. You may modify your copy of the software in any way, provided that
+     you do at least ONE of the following:
+
+       a) place your modifications in the Public Domain or otherwise
+          make them Freely Available, such as by posting said
+	  modifications to Usenet or an equivalent medium, or by allowing
+	  the author to include your modifications in the software.
+
+       b) use the modified software only within your corporation or
+          organization.
+
+       c) rename any non-standard executables so the names do not conflict
+	  with standard executables, which must also be provided.
+
+       d) make other distribution arrangements with the author.
+
+  3. You may distribute the software in object code or executable
+     form, provided that you do at least ONE of the following:
+
+       a) distribute the executables and library files of the software,
+	  together with instructions (in the manual page or equivalent)
+	  on where to get the original distribution.
+
+       b) accompany the distribution with the machine-readable source of
+	  the software.
+
+       c) give non-standard executables non-standard names, with
+          instructions on where to get the original software distribution.
+
+       d) make other distribution arrangements with the author.
+
+  4. You may modify and include the part of the software into any other
+     software (possibly commercial).  But some files in the distribution
+     are not written by the author, so that they are not under this terms.
+
+     They are gc.c(partly), utils.c(partly), regex.[ch], st.[ch] and some
+     files under the ./missing directory.  See each file for the copying
+     condition.
+
+  5. The scripts and library files supplied as input to or produced as 
+     output from the software do not automatically fall under the
+     copyright of the software, but belong to whomever generated them, 
+     and may be sold commercially, and may be aggregated with this
+     software.
+
+  6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+     IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+     PURPOSE.
+

data/Rakefile

@@ -0,0 +1,4 @@
+require 'config/requirements'
+require 'config/hoe' # setup Hoe + all gem configuration
+
+Dir['tasks/**/*.rake'].each { |rake| load rake }

data/bin/remote_backup

@@ -0,0 +1,55 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require "optparse"
+require 'logger'
+require 'remotebackup'
+
+$log = Logger.new(File.open("backup_error.log","w"))
+def msg_out(str)
+	if $verbose
+		puts str
+	end
+end
+def opt_parse()
+	begin 
+		parser = OptionParser.new do |opt|
+			opt.banner = "Usage: #{File.basename($0)} [Option]"
+			opt.on("-f","--file config",String,'location config file. default ./backup.xml') {|o|
+				$config_file = o
+			}
+			opt.on("-o","--outputdir Output Directory",String,"Directory for output. Default #{ENV['HOME']}") {|o|
+				$config_out_dir = o
+			}
+			opt.on("-v","--verbose","verbose message"){
+				$verbose = true 
+			}
+			opt.on("-h","--help","print this message and quit") {|o|
+				puts opt.help
+				exit 0
+			}
+			opt.parse!(ARGV)
+		end
+	rescue OptionParser::ParseError => err
+		$stderr.puts err.message
+		exit 1
+	end
+	unless $config_file 
+		$config_file = "./backup.xml"
+	end
+	unless $config_out_dir
+		$config_out_dir = "."
+	end
+	if !File.file?($config_file)
+		$stderr.puts "config #{$config_file} is not exist."
+		$stderr.puts parser.help
+		exit 1
+	end
+	if !FileTest.directory?($config_out_dir)
+		$stderr.puts "output directory #{$config_out_dir} is not directory."
+		$stderr.puts parser.help
+		exit 1
+	end
+end
+opt_parse
+bk=Remotebackup::Backup.new($config_file,$config_out_dir)
+bk.start

data/bin/restore_backup

@@ -0,0 +1,59 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require "optparse"
+require 'logger'
+require 'remotebackup'
+
+$log = log = Logger.new(File.open("restore_error.log","w"))
+def msg_out(str)
+	if $verbose
+		puts str
+	end
+end
+def opt_parse()
+	begin 
+		parser = OptionParser.new do |opt|
+			opt.banner = "Usage: #{File.basename($0)} [Option]"
+			opt.on("-f","--file info",String,'file info yaml.') {|o|
+				$config_file = o
+			}
+			opt.on("-o","--outputdir output_directory",String,"Directory for output.") {|o|
+				$config_out_dir = o
+			}
+			opt.on("-v","--verbose","verbose message"){
+				$verbose = true 
+			}
+			opt.on("-h","--help","print this message and quit") {|o|
+				puts opt.help
+				exit 0
+			}
+			opt.parse!(ARGV)
+		end
+	rescue OptionParser::ParseError => err
+		$stderr.puts err.message
+		exit 1
+	end
+	unless $config_file
+		$stderr.puts "Error:You shoud specified file info yml file with -f."
+		$stderr.puts parser.help
+		exit 1
+	end
+	unless $config_out_dir
+		$stderr.puts "Error:You shoud specified output dir with -o."
+		$stderr.puts parser.help
+		exit 1
+	end
+	if !File.file?($config_file)
+		$stderr.puts "Error:file info yaml #{$config_file} is not exist."
+		$stderr.puts parser.help
+		exit 1
+	end
+	if FileTest.directory?($config_out_dir)
+		$stderr.puts "Error:output directory #{$config_out_dir} is already exist."
+		$stderr.puts parser.help
+		exit 1
+	end
+end
+opt_parse
+rs=RemoteBackup::Restore.new($config_file,$config_out_dir)
+rs.start

data/config/hoe.rb

@@ -0,0 +1,73 @@
+require 'remotebackup/version'
+
+AUTHOR = 'FIXME full name'  # can also be an array of Authors
+EMAIL = "FIXME email"
+DESCRIPTION = "description of gem"
+GEM_NAME = 'remotebackup' # what ppl will type to install your gem
+RUBYFORGE_PROJECT = 'remotebackup' # The unix name for your project
+HOMEPATH = "http://#{RUBYFORGE_PROJECT}.rubyforge.org"
+DOWNLOAD_PATH = "http://rubyforge.org/projects/#{RUBYFORGE_PROJECT}"
+EXTRA_DEPENDENCIES = [
+#  ['activesupport', '>= 1.3.1']
+]    # An array of rubygem dependencies [name, version]
+
+@config_file = "~/.rubyforge/user-config.yml"
+@config = nil
+RUBYFORGE_USERNAME = "unknown"
+def rubyforge_username
+  unless @config
+    begin
+      @config = YAML.load(File.read(File.expand_path(@config_file)))
+    rescue
+      puts <<-EOS
+ERROR: No rubyforge config file found: #{@config_file}
+Run 'rubyforge setup' to prepare your env for access to Rubyforge
+ - See http://newgem.rubyforge.org/rubyforge.html for more details
+      EOS
+      exit
+    end
+  end
+  RUBYFORGE_USERNAME.replace @config["username"]
+end
+
+
+REV = nil
+# UNCOMMENT IF REQUIRED:
+# REV = YAML.load(`svn info`)['Revision']
+VERS = Remotebackup::VERSION::STRING + (REV ? ".#{REV}" : "")
+RDOC_OPTS = ['--quiet', '--title', 'remotebackup documentation',
+    "--opname", "index.html",
+    "--line-numbers",
+    "--main", "README",
+    "--inline-source"]
+
+class Hoe
+  def extra_deps
+    @extra_deps.reject! { |x| Array(x).first == 'hoe' }
+    @extra_deps
+  end
+end
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+$hoe = Hoe.new(GEM_NAME, VERS) do |p|
+  p.developer(AUTHOR, EMAIL)
+  p.description = DESCRIPTION
+  p.summary = DESCRIPTION
+  p.url = HOMEPATH
+  p.rubyforge_name = RUBYFORGE_PROJECT if RUBYFORGE_PROJECT
+  p.test_globs = ["test/**/test_*.rb"]
+  p.clean_globs |= ['**/.*.sw?', '*.gem', '.config', '**/.DS_Store']  #An array of file patterns to delete on clean.
+
+  # == Optional
+  p.changes = p.paragraphs_of("History.txt", 0..1).join("\n\n")
+  #p.extra_deps = EXTRA_DEPENDENCIES
+
+    #p.spec_extras = {}    # A hash of extra values to set in the gemspec.
+  end
+
+CHANGES = $hoe.paragraphs_of('History.txt', 0..1).join("\\n\\n")
+PATH    = (RUBYFORGE_PROJECT == GEM_NAME) ? RUBYFORGE_PROJECT : "#{RUBYFORGE_PROJECT}/#{GEM_NAME}"
+$hoe.remote_rdoc_dir = File.join(PATH.gsub(/^#{RUBYFORGE_PROJECT}\/?/,''), 'rdoc')
+$hoe.rsync_args = '-av --delete --ignore-errors'
+$hoe.spec.post_install_message = File.open(File.dirname(__FILE__) + "/../PostInstall.txt").read rescue ""

data/config/requirements.rb

@@ -0,0 +1,15 @@
+require 'fileutils'
+include FileUtils
+
+require 'rubygems'
+%w[rake hoe newgem rubigen net/ssh net/scp].each do |req_gem|
+  begin
+    require req_gem
+  rescue LoadError
+    puts "This Rakefile requires the '#{req_gem}' RubyGem."
+    puts "Installation: gem install #{req_gem} -y"
+    exit
+  end
+end
+
+$:.unshift(File.join(File.dirname(__FILE__), %w[.. lib]))

data/lib/remotebackup/version.rb

@@ -0,0 +1,9 @@
+module Remotebackup
+  module VERSION #:nodoc:
+    MAJOR = 0
+    MINOR = 5
+    TINY  = 0
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+end