seamusabshere-gdocs_bootstrap 0.0.1

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Seamus Abshere
+
+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,44 @@
+= gdocs_bootstrap
+
+<tt>
+class FuelType
+  gdoc_bootstrap :url => 'http://spreadsheets.google.com/pub?key=p70r3FHguhimIdBKyVz3iPA&output=csv&gid=0'
+end
+</tt>
+
+This lets you bootstrap your ActiveRecord models with Google Docs spreadsheets.
+
+<tt>
+>> FuelType.bootstrap!
+=> true
+</tt>
+
+== Spreadsheet structure
+
+The first column is always the key.
+
+All of the other columns will be included as attributes, based on the column headers.
+
+<tt>
+name          emission_factor   units
+coal          5246.89           lbs/short ton
+natural gas   1.25              pounds / therm (nat gas)
+fuel oil      22.51             lbs/gallon
+</tt>
+
+would generate
+
+<tt>
+a = FuelType.find_or_create_by_name('coal')
+a.update_attributes(:name => 'coal', :emission_factor => '5246.89', :units => 'lbs/short ton')
+
+a = FuelType.find_or_create_by_name('natural gas')
+a.update_attributes(:name => 'coal', :emission_factor => '1.25', :units => 'pounds / therm (nat gas)')
+
+a = FuelType.find_or_create_by_name('fuel oil')
+a.update_attributes(:name => 'coal', :emission_factor => '22.51', :units => 'lbs/gallon')
+</tt>
+
+== Copyright
+
+Copyright (c) 2009 Seamus Abshere. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,56 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "gdocs_bootstrap"
+    gem.summary = %Q{TODO}
+    gem.email = "seamus@abshere.net"
+    gem.homepage = "http://github.com/seamusabshere/gdocs_bootstrap"
+    gem.authors = ["Seamus Abshere"]
+
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/*_test.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION.yml')
+    config = YAML.load(File.read('VERSION.yml'))
+    version = "#{config[:major]}.#{config[:minor]}.#{config[:patch]}"
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "gdocs_bootstrap #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+

data/VERSION.yml

@@ -0,0 +1,4 @@
+--- 
+:major: 0
+:minor: 0
+:patch: 1

data/lib/gdocs_bootstrap.rb

@@ -0,0 +1,92 @@
+require 'rubygems'
+require 'fastercsv'
+require 'open-uri'
+require 'active_support'
+
+class GdocsBootstrap
+  attr_accessor :url, :target_class_name, :key_sprintf # set in options
+  attr_accessor :key_name, :headers, :dictionary, :width
+  
+  def bootstrap!
+    load_dictionary unless dictionary_loaded?
+    dictionary.each do |k, v|
+      instance_of_target_class = target_class.send("find_or_create_by_#{key_name}", v[key_name])
+      instance_of_target_class.update_attributes(v.except(key_name))
+    end
+    true
+  end
+  
+  private
+    
+  def initialize(options = {})
+    @url = options[:url]
+    @target_class_name = options[:target_class_name]
+    @key_sprintf = options[:key_sprintf] || '%s'
+  end
+
+  def dictionary_loaded?
+    !dictionary.nil?
+  end
+  
+  def load_dictionary
+    self.dictionary = {}
+    open(url) do |data|
+      FasterCSV.parse(data, :headers => :first_row) do |row|
+        self.width ||= row.fields.size
+        self.key_name ||= row.headers[0].to_sym
+        self.headers ||= row.headers
+        next if row.fields[0].blank?
+        key = interpret_key(row.fields[0])
+        dictionary[key] = interpret_columns(row.fields[0..width])
+      end
+    end
+  end
+  
+  def interpret_key(k)
+    k = k.to_s.strip
+    k = k.to_i if /\%[0-9\.]*d/.match(key_sprintf)
+    key_sprintf % k
+  end
+  
+  def interpret_columns(columns)
+    memo = {}
+    columns.each_with_index do |column, index|
+      # puts "memo.merge!(headers[#{index}].to_sym => column) as memo.merge!(#{headers[index].to_sym} => #{column})"
+      memo.merge!(headers[index].to_sym => column)
+    end
+    memo
+  end
+  
+  def target_class
+    target_class_name.constantize
+  end
+end
+
+module ActiveRecord
+  module GdocsBootstrapExt
+    def self.included(klass)
+      klass.class_eval do
+        self.class_inheritable_accessor :gdocs_bootstraps
+        extend ClassMethods
+      end
+    end
+
+    module ClassMethods
+      def gdocs_bootstrap(options = {})
+        self.gdocs_bootstraps ||= []
+        options[:target_class_name] ||= self.class_name
+        gdocs_bootstraps << GdocsBootstrap.new(options)
+      end
+      
+      def clear_bootstraps
+        self.gdocs_bootstraps = []
+      end
+      
+      def bootstrap!
+        gdocs_bootstraps.each { |b| b.bootstrap! }
+      end
+    end
+  end
+end
+
+ActiveRecord::Base.send :include, ActiveRecord::GdocsBootstrapExt

data/test/gdocs_bootstrap_ext_test.rb

@@ -0,0 +1,34 @@
+require 'test_helper'
+
+class GdocsBootstrapExtTest < Test::Unit::TestCase
+  def setup
+    GdocsBootstrapTestHelper::Initializer.setup_database
+  end
+  
+  def teardown
+    Scrum.clear_bootstraps
+    GdocsBootstrapTestHelper::Initializer.teardown_database
+  end
+
+  def test_should_mixin_methods
+    assert Scrum.respond_to?(:gdocs_bootstrap)
+    assert Scrum.respond_to?(:clear_bootstraps)
+    assert Scrum.respond_to?(:bootstrap!)
+  end
+
+  def test_should_set_target_class
+    GdocsBootstrap.expects(:new).with(:target_class_name => 'Scrum')
+    Scrum.gdocs_bootstrap
+  end
+  
+  def test_should_set_url
+    GdocsBootstrap.expects(:new).with(:target_class_name => 'Scrum', :url => GOOGLE_DOC_URL)
+    Scrum.gdocs_bootstrap :url => GOOGLE_DOC_URL
+  end
+  
+  def test_should_bootstrap
+    Scrum.gdocs_bootstrap :url => GOOGLE_DOC_URL
+    GdocsBootstrap.any_instance.expects(:bootstrap!)
+    Scrum.bootstrap!
+  end
+end

data/test/gdocs_bootstrap_test.rb

@@ -0,0 +1,31 @@
+require 'test_helper'
+
+class GdocsBootstrapTest < Test::Unit::TestCase
+  def setup
+    GdocsBootstrapTestHelper::Initializer.setup_database
+    @bootstrap = GdocsBootstrap.new(:target_class_name => 'Scrum', :url => GOOGLE_DOC_URL)
+  end
+  
+  def teardown
+    Scrum.clear_bootstraps
+    GdocsBootstrapTestHelper::Initializer.teardown_database
+  end
+  
+  def test_should_have_url
+    assert_equal @bootstrap.url, GOOGLE_DOC_URL
+  end
+  
+  def test_should_have_target_class_name
+    assert_equal @bootstrap.target_class_name, 'Scrum'
+  end
+  
+  def test_should_bootstrap_keys
+    Scrum.expects(:find_or_create_by_name).at_least_once.returns(Scrum.new)
+    @bootstrap.bootstrap!
+  end
+  
+  def test_should_bootstrap_values
+    Scrum.any_instance.expects(:update_attributes).at_least_once
+    @bootstrap.bootstrap!
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,65 @@
+module GdocsBootstrapTestHelper
+  module Initializer
+    VENDOR_RAILS = File.expand_path('../../../../rails', __FILE__)
+    OTHER_RAILS = File.expand_path('../../../rails', __FILE__)
+    PLUGIN_ROOT = File.expand_path('../../', __FILE__)
+    
+    def self.rails_directory
+      if File.exist?(VENDOR_RAILS)
+        VENDOR_RAILS
+      elsif File.exist?(OTHER_RAILS)
+        OTHER_RAILS
+      end
+    end
+    
+    def self.load_dependencies
+      if rails_directory
+        $:.unshift(File.join(rails_directory, 'activesupport', 'lib'))
+        $:.unshift(File.join(rails_directory, 'activerecord', 'lib'))
+      else
+        require 'rubygems' rescue LoadError
+      end
+      
+      require 'active_record'
+      require 'test/unit'
+      require 'mocha'
+
+      $LOAD_PATH.unshift(File.dirname(__FILE__))
+      $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+      require 'gdocs_bootstrap'
+    end
+    
+    def self.configure_database
+      ActiveRecord::Base.establish_connection(:adapter => "sqlite3", :dbfile => ":memory:")
+      ActiveRecord::Migration.verbose = false
+    end
+    
+    def self.setup_database
+      ActiveRecord::Schema.define do
+        create_table :scrums do |t|
+          t.string :name
+          t.string :emission_factor
+          t.string :units
+          t.timestamps
+        end
+      end
+    end
+    
+    def self.teardown_database
+      ActiveRecord::Base.connection.tables.each do |table|
+        ActiveRecord::Base.connection.drop_table(table)
+      end
+    end
+    
+    def self.start
+      load_dependencies
+      configure_database
+    end
+  end
+end
+ 
+GdocsBootstrapTestHelper::Initializer.start
+
+class Scrum < ActiveRecord::Base; end
+
+GOOGLE_DOC_URL = 'http://spreadsheets.google.com/pub?key=p70r3FHguhimIdBKyVz3iPA&output=csv&gid=0'

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification 
+name: seamusabshere-gdocs_bootstrap
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Seamus Abshere
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-04-07 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: 
+email: seamus@abshere.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION.yml
+- lib/gdocs_bootstrap.rb
+- test/gdocs_bootstrap_ext_test.rb
+- test/gdocs_bootstrap_test.rb
+- test/test_helper.rb
+has_rdoc: true
+homepage: http://github.com/seamusabshere/gdocs_bootstrap
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: TODO
+test_files: 
+- test/gdocs_bootstrap_ext_test.rb
+- test/gdocs_bootstrap_test.rb
+- test/test_helper.rb