dmitryv-backup 2.4.0

data/CHANGELOG

@@ -0,0 +1,125 @@
+BIG UPDATE
+=== 2.4.0 =======================================
+  
+  Ruby on Rails 3 support
+  
+
+PATCH
+=== 2.3.3.1 =====================================
+
+  Fixes an issue when trying to use S3. It would try to create a bucket
+  when one already exists and this raises an error.
+  
+
+UPDATE
+=== 2.3.3 =======================================
+
+  Set final_file to encrypted_file only when encryption is used.
+
+
+UPDATE
+=== 2.3.2 =======================================
+  
+  - Only load 'pony' and 'optparse' when they need to be utilized.
+  - Only uses 'sudo' if BACKUP_PATH is not writable by current user.
+  - With Cloud Files storage, it will automatically create the bucket if it does not yet exist.
+  - Backup's logger will now display the current time when logging. Now also indicates what S3 bucket it
+    is being backed up to, as well as what the filename is.
+  - Backup now supports GPG public key encryption which is a new and more safe way to encrypt your data.
+  
+  
+MINOR UPDATE
+=== 2.3.2.pre3 ==================================
+
+  - Added support for Rackspace Cloud Files. Backups can now also be stored in Rackspace Cloud Files.
+
+
+MINOR UPDATE
+=== 2.3.2.pre2 ==================================
+
+  - Added support for Amazon S3 EEUU and European buckets.
+
+
+BIG UPDATE
+=== 2.3.2.pre ==================================
+
+  - Added Storage Method: Local
+  - Added Adapter: SQLite
+  - exclude option added for Archive Adapter
+  - Internal cleanup
+  - Will try to automatically determine the path to mysqldump and pg_dump utilities
+  - Option to specify which tables to include for the backup
+  - The ability to specify a custom backup (unix environment) installation folder with ENV['BACKUP_PATH']
+  - Fixed dependency issue with SQLite3 Ruby Driver (must be 1.2.5)
+  - Removed Jeweler from Backup, the Gemspec should be manually updated from now on.
+  - Added spec/tests
+
+
+MINOR UPDATE
+=== 2.3.1 ======================================
+
+  - Added Feature: Email notifications
+
+
+PATCH
+=== 2.3.0.3 ====================================
+
+  - Small bug was patched. Error would occur when a list of triggers should be shown
+	
+
+BIG UPDATE
+=== 2.3.0 ====================================
+  
+  - Backup became independent of Ruby on Rails
+  - Backup now supports multiple environments: Rails and Unix
+  - Backup is now executable through the command-line when using the Unix environment
+
+
+SMALL FEATURE UPDATE
+=== 2.2.1 ====================================
+  
+  - use_ssl option added for S3 Storage Method
+  - additional_options option added for MySQL and PostgreSQL Adapters
+
+
+PRETTY BIG UPDATE
+=== 2.2.0 ====================================
+  
+  - Added Storage Methods: FTP and SFTP
+  - Added Adapters: PostgreSQL and Custom
+  - Added more options to the MySQL Adapter
+  - A couple of bug fixes
+
+
+MINOR UPDATE
+=== 2.1.2 ====================================
+  
+  - The backup generator will now provide you with a step-by-step guide to getting up and running
+  - Updated the generator itself
+  - Removed SQLite3 dependencies
+  
+
+2 TABLES 2 1
+=== 2.1.1 ====================================
+  
+  - Backup will from now on only utilize one table, instead of one for each storage method
+  - Still backwards compatible to 2.1.0
+  
+
+FIXED A CRUCIAL BUG
+=== 2.1.0 ====================================
+
+  - Problem with Backup::Record. It tried to connect to the SQLite3 database.
+
+
+MAJOR RELEASE
+=== 2.0.0 ====================================
+
+  - Should be a lot more backwards compatible with every update I do.
+  - Does not depend on the separate local SQLite3 file any longer.
+  - Will provide a db migration file for your Rails Application to store backup record data in.
+  - Does not use YAML files to do configuration any longer.
+  - Uses a SINGLE ruby file for "all" configuration (config/backup.rb) using elegant block notations!
+  - Uses a SINGLE rake task to handle the initialization of any backup setting.
+  - Can now configure an unlimited amount of customizable backup settings and run them each "individually"!
+  - HIGHLY IMPROVED USABILITY!

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Michael van Rooijen - Final Creation (http://michaelvanrooijen.com/)
+
+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,180 @@
+# Backup
+
+## A Backup Ruby Gem
+
+__Backup__ is a Ruby Gem written for __Unix__ and __Ruby on Rails (2 and 3)__ environments. It can be used both with and without the Ruby on Rails framework! This gem offers a quick and simple solution to backing up databases such as MySQL/PostgreSQL/SQLite and Files/Folders. All backups can be transferred to Amazon S3, Rackspace Cloud Files, any remote server you have access to (using either SCP, SFTP or regular FTP), or a Local server. Backup handles Compression, Archiving, Encryption, Backup Cleaning (Cycling) and supports Email Notifications.
+
+## Written for Environments
+
+* UNIX (Ubuntu, OSX, etc.)
+* Ruby on Rails 3
+* Ruby on Rails 2
+
+## Authors/Maintainers
+
+* [Meskyanichi - Michael van Rooijen](http://github.com/meskyanichi)
+* [Fernandoluizao - Fernando Migliorini Luizão](http://github.com/fernandoluizao)
+
+## Backup's Current Capabilities
+
+### Storage Methods
+
+* Amazon S3
+* Rackspace Cloud Files
+* Remote Server (Available Protocols: SCP, SFTP, FTP)
+* Local server (Example Locations: Another Hard Drive, Network path)
+
+### Adapters
+
+* MySQL
+* PostgreSQL
+* SQLite
+* Archive (Any files and/or folders)
+* Custom (Anything you can produce using the command line)
+
+### Archiving
+
+Handles archiving for the __Archive__ and __Custom__ adapters.
+
+### Encryption
+
+Handles encryption of __all__ backups for __any__ adapter.
+To decrypt a "Backup encrypted file" you can use Backup's built-in utility command:
+
+    sudo backup --decrypt /path/to/encrypted/file.enc
+
+### Backup Cleaning
+
+With Backup you can very easily specify how many backups you would like to have stored (per backup procedure!) on your Amazon S3, Remote or Local server. When the limit you specify gets exceeded, the oldest backup will automatically be cleaned up.
+
+### Email Notifications
+
+You will be able to specify whether you would like to be notified by email when a backup successfully been stored.
+Simply fill in the email configuration block and set "notify" to true inside the backup procedure you would like to be notified of.
+
+### Quick Example of a Single Backup Setting/Procedure inside the Backup Configuration File
+
+    backup 'mysql-backup-s3' do
+      adapter :mysql do
+        user      'user'
+        password  'password'
+        database  'database'
+      end
+      storage :s3 do
+        access_key_id     'access_key_id'
+        secret_access_key 'secret_access_key'
+        bucket            '/bucket/backups/mysql/'
+        use_ssl           true
+      end
+      keep_backups 25
+      encrypt_with_password 'my_password'
+      notify true
+    end
+  
+Everything above should be pretty straightforward, so now, using the __trigger__ we specified between
+the `backup` and `do` you can execute this backup procedure like so:
+
+__Rails Environment__
+
+    rake backup:run trigger=mysql-backup-s3
+
+__Unix Environment__
+
+    sudo backup --run mysql-backup-s3
+
+That's it. This was a simple example of how it works.
+
+## Interested in trying out Backup?
+
+### Getting started with Backup for the *Unix Environment*
+
+[http://wiki.github.com/meskyanichi/backup/getting-started-unix](http://wiki.github.com/meskyanichi/backup/getting-started-unix)
+
+
+### Getting started with Backup for the *Rails Environment*
+
+[http://wiki.github.com/meskyanichi/backup/getting-started-ruby-on-rails](http://wiki.github.com/meskyanichi/backup/getting-started-ruby-on-rails)
+
+
+### Production Mode __RAILS_ENV___
+
+[http://wiki.github.com/meskyanichi/backup/production-mode](http://wiki.github.com/meskyanichi/backup/production-mode)
+
+
+### Encrypting and Decrypting
+
+[http://wiki.github.com/meskyanichi/backup/encrypting-and-decrypting](http://wiki.github.com/meskyanichi/backup/encrypting-and-decrypting)
+
+
+### Backup Configuration File (All Adapters, Storage Methods, Mail Settings and Options)
+
+[http://wiki.github.com/meskyanichi/backup/configuration-file](http://wiki.github.com/meskyanichi/backup/configuration-file)
+
+
+### Unix Utility Commands and Rails Rake Tasks
+
+[http://wiki.github.com/meskyanichi/backup/utility-commands](http://wiki.github.com/meskyanichi/backup/utility-commands)
+
+[http://wiki.github.com/meskyanichi/backup/rake-tasks](http://wiki.github.com/meskyanichi/backup/rake-tasks)
+
+
+### Automatic Backups
+
+[http://wiki.github.com/meskyanichi/backup/automatic-backups](http://wiki.github.com/meskyanichi/backup/automatic-backups)
+
+
+### Capistrano Recipes
+
+[http://wiki.github.com/meskyanichi/backup/capistrano-recipes](http://wiki.github.com/meskyanichi/backup/capistrano-recipes)
+
+
+### Capistrano, Whenever!
+
+[http://wiki.github.com/meskyanichi/backup/capistrano-whenever](http://wiki.github.com/meskyanichi/backup/capistrano-whenever)
+
+
+### Understanding "The Backup Database"
+
+[http://wiki.github.com/meskyanichi/backup/the-backup-database](http://wiki.github.com/meskyanichi/backup/the-backup-database)
+
+
+### Trouble Shooting
+
+[http://wiki.github.com/meskyanichi/backup/troubleshooting](http://wiki.github.com/meskyanichi/backup/troubleshooting)
+
+
+### Requirements
+
+[http://wiki.github.com/meskyanichi/backup/requirements](http://wiki.github.com/meskyanichi/backup/requirements)
+
+
+### Resources
+
+[http://wiki.github.com/meskyanichi/backup/resources](http://wiki.github.com/meskyanichi/backup/resources)
+
+
+### Requests
+
+If anyone has any requests, please send us a message or post it in the [issue log](http://github.com/meskyanichi/backup/issues)!
+
+
+### Suggestions?
+
+Send us a message! Fork the project!
+
+
+### Found a Bug?
+
+[Report it](http://github.com/meskyanichi/backup/issues)
+
+
+### Contributors
+
+* [dtrueman](http://github.com/dtrueman)
+* [Nathan L Smith](http://github.com/smith)
+* [Francesc Esplugas](http://github.com/fesplugas)
+* [wakiki](http://github.com/wakiki)
+* [Dan Hixon](http://github.com/danhixon)
+* [Adam Greene](http://github.com/skippy)
+
+__Michael van Rooijen | Final Creation. ([http://michaelvanrooijen.com](http://michaelvanrooijen.com))__

data/VERSION

@@ -0,0 +1 @@
+2.4.0

data/bin/backup

@@ -0,0 +1,108 @@
+#!/usr/bin/env ruby
+
+require 'optparse'
+require 'backup'
+
+Backup::System.boot!
+
+include Backup::Environment::UnixConfiguration::Commands
+include Backup::Environment::UnixConfiguration::Helpers
+
+options = {}
+
+optparse = OptionParser.new do |opts|
+  
+  opts.banner = "\nUsage: backup [options]\n "
+  
+  opts.on('-r', '--run [trigger]', "Runs backup process by trigger") do |trigger|
+    confirm_configuration_file_existence
+    puts "Running: #{trigger}."
+    Backup::Setup.new(trigger, @backup_procedures).initialize_adapter
+  end
+  
+  opts.on('-f', '--find [trigger]', "Finds backup records by trigger") do |trigger|
+    confirm_configuration_file_existence
+    puts "Finding backup records with trigger: #{trigger}."
+    backup = Backup::Setup.new(trigger, @backup_procedures)
+    records = backup.procedure.record_class.all( :conditions => {:trigger => trigger} )
+
+    if options[:table]
+      puts Hirb::Helpers::AutoTable.render(records)
+    else
+      records.each do |record|
+        puts record.to_yaml
+      end
+    end
+  end
+  
+  opts.on('-t', '--truncate [trigger]', "Truncates backup records for specified trigger") do |trigger|
+    puts "Truncating backup records with trigger: #{trigger}."
+    Backup::Record::Base.destroy_all :trigger => trigger
+  end
+  
+  opts.on('-d', '--destroy [trigger]', "Destroys backup records and files for specified trigger") do |trigger|
+    confirm_configuration_file_existence
+    puts "Destroying backup records with trigger: #{trigger}."
+    backup = Backup::Setup.new(trigger, @backup_procedures)
+    backup.procedure.record_class.destroy_all_backups( backup.procedure, trigger )
+  end
+  
+  opts.on('--truncate-all', "Truncates all backup records") do
+    puts "Truncating all backup records."
+    Backup::Record::Base.destroy_all
+  end
+
+  opts.on('--destroy-all', "Destroys all backup records and files") do
+    confirm_configuration_file_existence
+    puts "Destroying all backup records."
+    backup = Backup::Setup.new(false, @backup_procedures)
+    backup.procedures.each do |backup_procedure|
+      backup_procedure.record_class.destroy_all_backups( backup_procedure, backup_procedure.trigger )
+    end
+  end
+
+  opts.on('--decrypt [file]', "Decrypts a \"Backup\" encrypted file") do |file|
+    puts "Attempting to decrypt: #{file}."
+    %x{ openssl enc -des-cbc -d -in #{file} -out #{file.gsub('.enc', '')} }
+  end
+  
+  options[:table] = false
+  opts.on('--table', "Shows records in table format") do |format|
+    options[:table] = true
+  end
+
+  opts.on('--setup', "Sets up Backup") do
+    setup
+  end
+  
+  opts.on('--reset', "Reinstalls Backup (This will remove ALL current settings!)") do
+    reset
+  end
+  
+  opts.on('--remove', "Removes Backup (This will remove ALL current settings!)") do
+    remove
+  end
+  
+  opts.on('-v', '--version', 'Displays installed Backup version') do
+    File.open(File.join(File.dirname(__FILE__), '..', 'VERSION')) do |file|
+      puts "Backup version #{file.read}"
+    end
+    exit
+  end  
+
+  opts.on('-h', '--help', 'Display help screen') do
+    puts opts
+    puts "\n "
+    exit
+  end  
+  
+end
+
+begin
+  optparse.parse!
+rescue OptionParser::InvalidOption
+  puts "\nInvalid Option. See the list of available options below.\n"
+  puts optparse
+  puts "\n "
+  exit
+end

data/generators/backup/backup_generator.rb

@@ -0,0 +1,69 @@
+class BackupGenerator < Rails::Generator::Base
+
+  # This method gets initialized when the generator gets run.
+  # It will receive an array of arguments inside @args
+  def initialize(runtime_args, runtime_options = {})
+    super
+  end
+  
+  # Processes the file generation/templating
+  # This will automatically be run after the initialize method
+  def manifest
+    record do |m|
+      
+      # Generates the Rake Tasks and Backup Database
+      m.directory "lib/tasks"
+      m.file      "backup.rake", "lib/tasks/backup.rake"
+
+      # Generates the configuration file
+      m.directory "config"
+      m.file      "backup.rb", "config/backup.rb"
+      
+      # Generates the database migration file
+      m.migration_template "create_backup_tables.rb",
+                           "db/migrate",
+                           :migration_file_name => "create_backup_tables"
+      
+      # Outputs the generators message to the terminal
+      puts message
+    end
+  end
+  
+  def message
+    <<-MESSAGE
+    
+    
+    ==============================================================
+    Backup's files have been generated!
+    ==============================================================
+    
+    1: Add the "Backup" gem to the config/environment.rb file!
+    
+      config.gem "backup"
+    
+    
+    2: Migrate the database!
+
+      rake db:migrate
+    
+    
+    3: Set up some "Backup Settings" inside the backup configuration file!
+
+      config/backup.rb
+      
+    
+    4: Run the backups! Enjoy.
+    
+      rake backup:run trigger="your-specified-trigger"
+      
+    
+    For More Information:
+    http://github.com/meskyanichi/backup
+    
+    ==============================================================
+    
+    
+    MESSAGE
+  end
+  
+end