basiszwo-reflection 0.5.1

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+*.tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/History.rdoc

@@ -0,0 +1,21 @@
+=== current HEAD
+
+* enhancements
+  * Move instead of copy to preserve even more cpu-io-wait
+  * Show the current version (--version)
+  * Rails: Recreate the database before applying a dump
+  * Rails: Run pending migrations after applying a dump
+
+=== 0.4.6 / 2009-11-19
+
+* fixes
+  * Fixed a blocking command call
+    
+=== 0.4.5 / 2009-11-19
+
+* enhancements
+  * Added --force option to skip moments of user-interaction
+  * Replaced FileUtils#methods with its native brothers to gain more speed (and to preserve your cpu)
+  
+* fixes
+  * Fixed no-working repository-pull

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Andreas Wolff
+
+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.rdoc

@@ -0,0 +1,117 @@
+= Reflection
+
+Reflection is designed to keep your development system in sync with your production system's files and database (by dumping).
+It uses a shared git repository to store these files, which allows you to mirror your production environment without the need of 
+direct access to your production servers.
+
+It provides two main command modes:
+
+* Stash: Indented to be run on the server side, adds a specified directory and, optionally, a database dump to a shared Git repository
+* Apply: To be used on a local development machine, gets content from the repository, copies it to a specified directory and optionally loads the database dump into your local database
+
+
+== Get it
+
+Reflection is a gem, hosted on Gemcutter:
+
+  gem install reflection
+
+
+== Stashing your production data 
+
+==== The simplest form:
+
+  $ reflection --stash --directory /path/to/your/assets --repository git@your-shared-repository.git
+
+This will clone <tt>git@your-shared-repository.git</tt> and add the directory <tt>/path/to/your/assets</tt> to the repository. 
+Reflection keeps a local version of your repository in HOME/.reflection/stash. So the next time you run the command, there is no need of cloning it again.
+
+
+==== Now, lets include a database dump
+
+  $ reflection  --stash \ 
+                --directory /path/to/your/assets \ 
+                --repository git@your-shared-repository.git \ 
+                --rails /rails/root \
+                --rails-env production
+
+This does the same as above, but additionally dumps your production database and adds the fresh dump to your repository.
+
+
+==== I'm lazy..
+
+You too, aren't you? So Reflection allows you to store all command line options in a config file.
+
+
+  $ reflection  --stash \ 
+                --directory /path/to/your/assets \ 
+                --repository git@your-shared-repository.git \ 
+                --rails /rails/root \ 
+                --rails-env production \ 
+                --write /path/to/your/config
+
+
+The next time you want to run the same command as above (useful for cron), you could simply call Reflection with:
+
+  $ reflection /path/to/your/config
+
+
+== Getting the production stuff on your local development machine
+
+This works exactly the same as describe above, but you would use --apply instead of --stash:
+
+  $ reflection  --apply \ 
+                --directory /path/to/your/assets \ 
+                --repository git@your-shared-repository.git \ 
+                --rails /rails/root \ 
+                --rails-env development
+
+This clones or pulls <tt>git@your-shared-repository.git</tt> (again, Reflection keeps a version of your Repository in HOME/.reflection/apply), copies the content to the specified directory (e.g. rails/application/public/assets) and optionally loads the dump into your database. 
+
+As you may have noticed, the Reflection command above got called with <tt>--rails-env development</tt>, which loads the dump in your development database (as defined by /rails/root/config/database.yml).
+
+
+==== A little productivity hint
+
+If you have a <tt>reflection.yml</tt> config file in your current application-development-directory, syncing your server-production environment is as easy as running:
+
+  $ reflection
+  
+
+== reflection --help
+
+  $ reflection --help
+  Usage: reflection --COMMAND --repository=GIT_REPO --directory=PATH
+   -or-
+  Usage: reflection /path/to/reflection-config-file.yml
+ 
+  On the server side:
+      -s, --stash                      Store your assets and/or a database dump in a git-repository.
+  On the client side:
+      -a, --apply                      Apply assets and/or a database dump loaded from a git-repository.
+ 
+  Required options for both:
+      -r, --repository GIT_URL         A Git repository(url) to be used as storage
+      -d, --directory PATH             Path to your asset directory
+ 
+  Additional options for both:
+          --rails [RAILS_ROOT]         Enable dumping/applying of a Rails managed MySQL database
+          --rails-env [ENV]            Rails environment to instrument
+          --write [FILE]               Create a configuration FILE from the current commandline options
+          --force                      Hide tedious warnings
+      -v, --verbose                    Include debug information in output
+          --version                    Show version
+
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add specs for it. This is important so I don't break it in a future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2009 Andreas Wolff. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,75 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "basiszwo-reflection"
+    gem.summary = %Q{Keep your development machine in sync with production.}
+    gem.description = %Q{
+      Reflection is designed to keep your development system in sync with your production system's files and database (by dumping).
+      It uses a shared git repository to store these files, which allows you to mirror your production environment without the need of 
+      direct access to your production servers.
+    }
+    gem.email = "stefan@ninjaconcept.com"
+    gem.homepage = "http://github.com/basiszwo/reflection"
+    gem.authors = ["Stefan Botzenhart", "Andreas Wolff"]
+    gem.add_development_dependency "rspec", ">= 1.2.9"
+    gem.add_dependency "git", ">= 1.2.5"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+begin
+  require 'reek/adapters/rake_task'
+  Reek::RakeTask.new do |t|
+    t.fail_on_error = true
+    t.verbose = false
+    t.source_files = 'lib/**/*.rb'
+  end
+rescue LoadError
+  task :reek do
+    abort "Reek is not available. In order to run reek, you must: sudo gem install reek"
+  end
+end
+
+begin
+  require 'roodi'
+  require 'roodi_task'
+  RoodiTask.new do |t|
+    t.verbose = false
+  end
+rescue LoadError
+  task :roodi do
+    abort "Roodi is not available. In order to run roodi, you must: sudo gem install roodi"
+  end
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "reflection #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/Reflection.gemspec

@@ -0,0 +1,135 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{reflection}
+  s.version = "0.5.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Andreas Wolff"]
+  s.date = %q{2009-12-01}
+  s.default_executable = %q{reflection}
+  s.description = %q{
+      Reflection is designed to keep your development system in sync with your production system's files and database (by dumping).
+      It uses a shared git repository to store these files, which allows you to mirror your production environment without the need of 
+      direct access to your production servers.
+    }
+  s.email = %q{rubyphunk@gmail.com}
+  s.executables = ["reflection"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc",
+     "TODO"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     ".yardoc",
+     "History.rdoc",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "Reflection.gemspec",
+     "TODO",
+     "VERSION",
+     "bin/reflection",
+     "doc/Reflection.html",
+     "doc/Reflection/CLI.html",
+     "doc/Reflection/Command.html",
+     "doc/Reflection/Command/Apply.html",
+     "doc/Reflection/Command/Base.html",
+     "doc/Reflection/Command/Stash.html",
+     "doc/Reflection/Config.html",
+     "doc/Reflection/ConfigArgumentError.html",
+     "doc/Reflection/Directory.html",
+     "doc/Reflection/Directory/Base.html",
+     "doc/Reflection/Directory/Stash.html",
+     "doc/Reflection/Rails.html",
+     "doc/Reflection/Repository.html",
+     "doc/Reflection/Support.html",
+     "doc/Reflection/Support/Home.html",
+     "doc/Reflection/Support/Log.html",
+     "doc/Reflection/Validations.html",
+     "doc/_index.html",
+     "doc/class_list.html",
+     "doc/css/common.css",
+     "doc/css/full_list.css",
+     "doc/css/style.css",
+     "doc/file.README.html",
+     "doc/file_list.html",
+     "doc/index.html",
+     "doc/js/app.js",
+     "doc/js/full_list.js",
+     "doc/js/jquery.js",
+     "doc/method_list.html",
+     "doc/top-level-namespace.html",
+     "lib/reflection.rb",
+     "lib/reflection/cli.rb",
+     "lib/reflection/command.rb",
+     "lib/reflection/command/apply.rb",
+     "lib/reflection/command/base.rb",
+     "lib/reflection/command/stash.rb",
+     "lib/reflection/config.rb",
+     "lib/reflection/directory.rb",
+     "lib/reflection/directory/base.rb",
+     "lib/reflection/directory/stash.rb",
+     "lib/reflection/rails.rb",
+     "lib/reflection/rails/database.rb",
+     "lib/reflection/repository.rb",
+     "lib/reflection/support.rb",
+     "lib/reflection/support/home.rb",
+     "lib/reflection/support/log.rb",
+     "lib/reflection/validations.rb",
+     "spec/reflection/cli_spec.rb",
+     "spec/reflection/command/stash_spec.rb",
+     "spec/reflection/config_spec.rb",
+     "spec/reflection/directory/base_spec.rb",
+     "spec/reflection/directory/stash_spec.rb",
+     "spec/reflection/rails/database_spec.rb",
+     "spec/reflection/rails_spec.rb",
+     "spec/reflection/repository_spec.rb",
+     "spec/reflection/support/home_spec.rb",
+     "spec/reflection/support_spec.rb",
+     "spec/reflection_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/rubyphunk/reflection}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Keep your development machine in sync with production.}
+  s.test_files = [
+    "spec/reflection/cli_spec.rb",
+     "spec/reflection/command/stash_spec.rb",
+     "spec/reflection/config_spec.rb",
+     "spec/reflection/directory/base_spec.rb",
+     "spec/reflection/directory/stash_spec.rb",
+     "spec/reflection/rails/database_spec.rb",
+     "spec/reflection/rails_spec.rb",
+     "spec/reflection/repository_spec.rb",
+     "spec/reflection/support/home_spec.rb",
+     "spec/reflection/support_spec.rb",
+     "spec/reflection_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_runtime_dependency(%q<git>, [">= 1.2.5"])
+    else
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_dependency(%q<git>, [">= 1.2.5"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    s.add_dependency(%q<git>, [">= 1.2.5"])
+  end
+end
+

data/TODO.rdoc

@@ -0,0 +1,38 @@
+= Things To Do
+
+== Fixes
+
+* Rails: Database: Broken Encoding
+
+
+== Enhancements
+
+* Replace CLI handing with Thor (http://github.com/wycats/thor)
+* Add Logger (Reflection::Support.log)
+* Callbacks
+* Remove ruby-git dependency
+
+
+=== Reflectables
+
+* Objects that take care of getting data from or to a system
+* Objects must respond to #apply and #stash
+* Types:
+  * Database (can get information from Rails Apps)
+  * Directories/Files
+
+
+=== Bundles
+
+* Defined in a config file
+* Must have a name
+* Can contain any number of reflectables (databases, directories)
+
+
+=== Buckets
+
+* A place to store stashed data (bundle.stash)
+* Types:
+  * Git
+  * S3
+  * Filesystem

data/VERSION

@@ -0,0 +1 @@
+0.5.1

data/bin/reflection

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+$:.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'reflection'
+
+Reflection::boot!(ARGV)

data/doc/Reflection/CLI.html

@@ -0,0 +1,153 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta name="Content-Type" content="text/html; charset=UTF-8" />
+<title>Module: Reflection::CLI</title>
+<link rel="stylesheet" href="../css/style.css" type="text/css" media="screen" charset="utf-8" />
+<link rel="stylesheet" href="../css/common.css" type="text/css" media="screen" charset="utf-8" />
+
+<script type="text/javascript" charset="utf-8">
+  relpath = '..';
+  if (relpath != '') relpath += '/';
+</script>
+<script type="text/javascript" charset="utf-8" src="../js/jquery.js"></script>
+<script type="text/javascript" charset="utf-8" src="../js/app.js"></script>
+
+  </head>
+  <body>
+    <div id="header">
+      <div id="menu">
+  
+    <a href="../_index.html">Index (C)</a> &raquo; 
+    <a title="Reflection" href="../Reflection.html">Reflection</a>
+     &raquo; 
+    <span class="title">CLI</span>
+  
+</div>
+
+      <div id="search">
+  <a id="class_list_link" href="#">Namespace List</a>
+  <a id="method_list_link" href="#">Method List</a>
+  <a id ="file_list_link" href="#">File List</a>
+</div>
+
+      <div class="clear"></div>
+    </div>
+    
+    <iframe id="search_frame"></iframe>
+    
+    <div id="content"><h1>Module: Reflection::CLI 
+  
+  
+</h1>
+
+<dl class="box">
+  
+  
+    
+  
+    
+  
+  
+    <dt class="r1 last">Defined in:</dt>
+    <dd class="r1 last">lib/reflection/cli.rb</dd>
+  
+</dl>
+<div class="clear"></div>
+
+
+
+
+  <h2>Method Summary</h2>
+  <ul class="summary">
+    
+      <li class="public ">
+  <span class="summary_signature"><a title="run! (class method)" href="#run%21-class_method">+ (Object) <strong>run!</strong>(args = nil) </a>
+  
+  </span>
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"></span>
+  
+</li>
+
+    
+  </ul>
+
+
+
+  <div id="method_details">
+    <h2>Method Details</h2>
+    
+      <div class="method_details first">
+  <p class="signature first" id="run!-class_method">
+  
+    + (<tt>Object</tt>) <strong>run!</strong>(args = nil) 
+  
+
+  
+</p><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/reflection/cli.rb', line 5</span>
+
+<span class='def def kw'>def</span> <span class='run! fid id'>run!</span><span class='lparen token'>(</span><span class='args identifier id'>args</span> <span class='assign token'>=</span> <span class='nil nil kw'>nil</span><span class='rparen token'>)</span>
+  <span class='config identifier id'>config</span> <span class='assign token'>=</span> <span class='Reflection constant id'>Reflection</span><span class='colon2 op'>::</span><span class='Config constant id'>Config</span><span class='dot token'>.</span><span class='parse identifier id'>parse</span><span class='lparen token'>(</span><span class='args identifier id'>args</span><span class='rparen token'>)</span>
+
+  <span class='if if kw'>if</span> <span class='verify_config identifier id'>verify_config</span><span class='lparen token'>(</span><span class='config identifier id'>config</span><span class='rparen token'>)</span> <span class='eq op'>==</span> <span class='false false kw'>false</span>
+    <span class='Reflection constant id'>Reflection</span><span class='colon2 op'>::</span><span class='Support constant id'>Support</span><span class='dot token'>.</span><span class='exit_with_error identifier id'>exit_with_error</span><span class='lparen token'>(</span><span class='string val'>&quot;Ahh ja, missing arguments. Please read 'reflection --help' to get a feeling of how it works.&quot;</span><span class='rparen token'>)</span>
+  <span class='else else kw'>else</span>
+    <span class='case case kw'>case</span> <span class='config identifier id'>config</span><span class='dot token'>.</span><span class='command identifier id'>command</span>
+      <span class='when when kw'>when</span> <span class='symbol val'>:apply</span>
+        <span class='Reflection constant id'>Reflection</span><span class='colon2 op'>::</span><span class='Command constant id'>Command</span><span class='colon2 op'>::</span><span class='Apply constant id'>Apply</span><span class='dot token'>.</span><span class='run! fid id'>run!</span><span class='lparen token'>(</span><span class='config identifier id'>config</span><span class='rparen token'>)</span>
+      <span class='when when kw'>when</span> <span class='symbol val'>:stash</span>
+        <span class='Reflection constant id'>Reflection</span><span class='colon2 op'>::</span><span class='Command constant id'>Command</span><span class='colon2 op'>::</span><span class='Stash constant id'>Stash</span><span class='dot token'>.</span><span class='run! fid id'>run!</span><span class='lparen token'>(</span><span class='config identifier id'>config</span><span class='rparen token'>)</span>
+      <span class='else else kw'>else</span>
+        <span class='Reflection constant id'>Reflection</span><span class='colon2 op'>::</span><span class='Support constant id'>Support</span><span class='dot token'>.</span><span class='exit_with_error identifier id'>exit_with_error</span><span class='lparen token'>(</span><span class='string val'>&quot;Couldn't identify command. Please run 'reflection --help'.&quot;</span><span class='rparen token'>)</span>
+    <span class='end end kw'>end</span>
+  <span class='end end kw'>end</span>
+<span class='end end kw'>end</span>
+</pre>
+    </td>
+  </tr>
+</table>
+</div>
+    
+  </div>
+
+</div>
+    
+    <div id="footer">
+  Generated on Wed Nov 18 18:17:11 2009 by 
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool">yard</a>
+  0.4.0 (ruby-1.8.7).
+</div>
+
+  </body>
+</html>