rosie 0.0.1

data/.gitignore

@@ -0,0 +1 @@
+*~

data/.rvmrc

@@ -0,0 +1 @@
+rvm --create ruby-1.9.2-p0@rosie

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in rosie.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,26 @@
+PATH
+  remote: .
+  specs:
+    rosie (0.0.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.2)
+    rake (0.9.2)
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.4)
+    rspec-expectations (2.6.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.6.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  rake (~> 0.9)
+  rosie!
+  rspec

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Rogers Yun Enterprises LLC (2RYE)
+
+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,58 @@
+# Rosie
+
+## Intro
+
+Backup and restore your MySQL db and dependent local assets (e.g. PaperClip uploads)
+
+Named after Rosie, the maid from the Jetsons (http://en.wikipedia.org/wiki/Rosie_the_Robot_Maid#Rosie).  The gem provides two rake tasks which will backup or restore a MySQL database along with any dependent file system assets (like uploaded files from PaperClip) into a single timestamped file.  
+
+## Requirements
+
+* Rails3
+* MySQL > 5 with commandline tools (mysql, mysqladmin, mysqldump)
+* Unix(ish) system shell with tar
+
+## Installation
+
+Add rosie to your Gemfile:
+
+<pre>
+gem 'rosie'
+</pre>
+
+Use bundler to install it:
+
+<pre>
+bundle install
+</pre>
+
+## Configuration
+
+Configuration values can be set by placing a rosie.yml file in your config directory.  Default keys and values are as follows:
+
+<pre>
+# sample rosie.yml
+#
+backup_dir:backups    
+assets_dir:public/system
+mysql_bin_dir: 
+
+</pre>
+
+* `backup_dir`: This should be specified relative to your Rails root.  This setting would give you `#{Rails.root}/backups`.
+* `assets_dir`: This should be specified relative to your Rails root.  This directory is the one that is holding any system assets you'd like to have backed up along side the database dump.
+* `mysql_bin_dir`: If mysql and mysqldump are not on the path of the user running this rake task, you may need to specify the directory where those commandline applications live.  This should be an absolute path.   By default, Rosie will try to find these in the user's PATH.
+
+## Validation
+
+Tested on OSX 10.6/Ubuntu 11
+
+## Usage
+
+## TODO
+* add ability to backup remote databases (not on localhost)
+* make Rails2.3.x compatible
+* add alternate database support
+
+## Credits
+Developed by Jon Rogers and Jeremy Yun @ 2rye.com

data/lib/rosie/version.rb

@@ -0,0 +1,3 @@
+module Rosie
+  VERSION = '0.0.1'
+end

data/lib/rosie.rb

@@ -0,0 +1,41 @@
+rootpath = File.join(File.dirname(__FILE__),'..')
+require File.join(rootpath, 'lib/rosie/version')
+
+Dir[File.join(rootpath, "lib/tasks/**/*.rake")].each { |ext| load ext } if defined?(Rake)
+
+module Rosie
+  class Config
+    @@allowed_attributes = [:backup_dir, :assets_dir, :mysql_bin_dir, :config_file]
+    
+    attr_accessor *@@allowed_attributes
+
+    def initialize
+      _config = {"backup_dir"=>"backups", "assets_dir"=>"public/system", "mysql_bin_dir"=>nil} 
+      self.config_file = File.join(Rails.root, 'config/rosie.yml')
+      if File.exists? self.config_file
+        _config.merge!(YAML.load(File.open(self.config_file)))
+      end
+      _config.keys.each do |attr|
+        self.send(attr+"=",_config[attr]) if @@allowed_attributes.include? attr.to_sym
+      end
+    end
+    
+    def backup_dir
+      File.join(Rails.root, @backup_dir)
+    end
+    
+    def assets_dir
+      File.join(Rails.root, @assets_dir)
+    end
+
+    def mysql_cmd
+      mysql_bin_dir.present? ? File.join(mysql_bin_dir, 'mysql') : 'mysql'
+    end
+
+    def mysqldump_cmd
+      mysql_bin_dir.present? ? File.join(mysql_bin_dir, 'mysqldump') : 'mysqldump'
+    end
+  end
+
+end
+

data/lib/tasks/rosie.rake

@@ -0,0 +1,102 @@
+require 'find'
+require 'fileutils'
+require 'tmpdir'
+require 'yaml'
+
+rosie = nil
+ts = nil
+
+def get_db_config
+  alldbconf = YAML.load_file( File.join( [Rails.root, 'config','database.yml' ] ))
+  env = Rails.env
+  alldbconf[env]
+end
+
+def get_db_cmdline_args
+  dbcnf = get_db_config
+  args = []
+  # NOTE: Assuming that database is running on localhost
+  # TODO - if you use other args like :socket, or ? they are ignored
+  # we could add host, port etc to make this more flexible
+  [['--user=','username'], ['--password=','password']].each do |entry|
+    if dbcnf[entry[1]].present?
+      args << "#{entry[0]}#{dbcnf[entry[1]]}"
+    end
+  end
+  args
+end
+
+namespace :rosie do
+  task :init do
+    rosie = Rosie::Config.new
+  end
+
+  desc "show config"
+  task :dump_config => :init do
+    puts "Rosie Config: read from #{rosie.config_file}"
+    puts "mysql: #{rosie.mysql_cmd}"
+    puts "mysqldump: #{rosie.mysqldump_cmd}"
+    puts "backup dir: #{rosie.backup_dir}"
+    puts "assets dir: #{rosie.assets_dir}"
+  end
+
+  desc "restore data from backup tarball"
+  task :restore => :init do
+    puts "Restoring data..."    
+    tarball = ENV["datafile"]
+    if tarball.present? 
+      tarball = File.absolute_path(tarball)
+      tmp = File.join(Dir.tmpdir, "rosie-restore")
+      FileUtils.remove_dir(tmp, true)
+      FileUtils.mkdir_p(tmp)
+      if !Dir.exists?(tmp) 
+        msg = "Unable to create a temporary directory.  Please check your file permissions.\nAttempted to create #{tmp}"
+        raise msg
+      end
+      files_before = Dir.entries(tmp)
+      sh "cd #{tmp} && tar -xzf #{tarball}"
+      ts = Dir.entries(tmp).reject{ |f| files_before.include? f }.first
+      unless ts.present?
+        puts "*** Something went wrong while trying to unpack the datafile."
+        exit 1
+      end
+      dbcnf = get_db_config
+      data_dir = File.join(tmp, ts)
+      image_tarball = File.join(data_dir, Dir.entries(data_dir).select{|f| f =~ /#{ts}.*\.tar/}.first)
+      sql_dump = File.join(data_dir, Dir.entries(data_dir).select{|f| f =~ /#{ts}.*\.sql/}.first)
+      args = get_db_cmdline_args
+      sh "tar -C #{rosie.assets_dir} -xf #{image_tarball} && #{rosie.mysql_cmd} #{args.join(' ')} #{dbcnf['database']} < #{sql_dump}"
+      
+    else
+      puts "*** You must specify the datafile from which to restore"
+      puts "*** e.g.  % datafile=/home/me/2011010101.tgz rake rosie:restore"
+      exit 1
+    end
+  end
+
+  desc "backup all data"
+  task :backup => ["rosie:backups:db", "rosie:backups:assets"] do
+    sh "cd #{rosie.backup_dir}/#{ts}/../ && tar -czvf #{ts}.tgz ./#{ts} && rm -rf #{ts}"
+  end
+
+  namespace :backups do
+    task :init => 'rosie:init' do
+      ts = Time.now.strftime('%Y%m%d%H%m%S')
+    end
+
+    task :db => :init do
+      dbcnf = get_db_config
+      db_file = "#{dbcnf['database']}-#{ts}.backup.sql"
+      path = File.join(rosie.backup_dir, ts, db_file)
+      args = get_db_cmdline_args
+      sh "mkdir -p #{rosie.backup_dir}/#{ts} && #{rosie.mysqldump_cmd} #{args.join(' ')} --single-transaction #{dbcnf['database']} > #{path}"
+    end
+
+    task :assets => :init do
+      sh "tar -C #{rosie.assets_dir} -cvf #{rosie.backup_dir}/#{ts}/rosie_backup_#{Rails.env}_#{ts}.tar ."
+    end
+
+  end
+  
+end
+

data/rosie.gemspec

@@ -0,0 +1,23 @@
+$:.push File.expand_path("../lib", __FILE__)
+require "rosie/version"
+
+Gem::Specification.new do |s|
+  s.name        = "rosie"
+  s.version     = Rosie::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Jon Rogers", "Jeremy Yun"]
+  s.email       = ["j@2rye.com"]
+  s.homepage    = "http://github.com/2rye/rosie"
+  s.summary     = "rosie-#{Rosie::VERSION}"
+  s.description = %q{Backup/Restore MySQL database and dependent filesystem assets via rake tasks.}
+
+  s.rubyforge_project = "rosie"
+  
+  s.add_development_dependency('rspec')
+  s.add_development_dependency('rake', '~>0.9')
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification 
+name: rosie
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Jon Rogers
+- Jeremy Yun
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-08-19 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "0.9"
+  type: :development
+  version_requirements: *id002
+description: Backup/Restore MySQL database and dependent filesystem assets via rake tasks.
+email: 
+- j@2rye.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rvmrc
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- lib/rosie.rb
+- lib/rosie/version.rb
+- lib/tasks/rosie.rake
+- rosie.gemspec
+homepage: http://github.com/2rye/rosie
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: rosie
+rubygems_version: 1.8.8
+signing_key: 
+specification_version: 3
+summary: rosie-0.0.1
+test_files: []
+