drafter 0.1.0

data/.document

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

data/Gemfile

@@ -0,0 +1,19 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+gem "activerecord"
+gem "sqlite3"
+gem "debugger"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+	gem "minitest", ">= 0"
+	gem "bundler", "~> 1.0.0"
+	gem "jeweler", "~> 1.6.4"
+	gem "rcov", ">= 0"
+	gem 'turn'
+	gem 'carrierwave'
+	gem "minitest-rails-shoulda"
+end

data/Gemfile.lock

@@ -0,0 +1,127 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    actionmailer (3.2.8)
+      actionpack (= 3.2.8)
+      mail (~> 2.4.4)
+    actionpack (3.2.8)
+      activemodel (= 3.2.8)
+      activesupport (= 3.2.8)
+      builder (~> 3.0.0)
+      erubis (~> 2.7.0)
+      journey (~> 1.0.4)
+      rack (~> 1.4.0)
+      rack-cache (~> 1.2)
+      rack-test (~> 0.6.1)
+      sprockets (~> 2.1.3)
+    activemodel (3.2.8)
+      activesupport (= 3.2.8)
+      builder (~> 3.0.0)
+    activerecord (3.2.8)
+      activemodel (= 3.2.8)
+      activesupport (= 3.2.8)
+      arel (~> 3.0.2)
+      tzinfo (~> 0.3.29)
+    activeresource (3.2.8)
+      activemodel (= 3.2.8)
+      activesupport (= 3.2.8)
+    activesupport (3.2.8)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    ansi (1.4.2)
+    arel (3.0.2)
+    builder (3.0.0)
+    carrierwave (0.6.2)
+      activemodel (>= 3.2.0)
+      activesupport (>= 3.2.0)
+    columnize (0.3.6)
+    debugger (1.1.1)
+      columnize (>= 0.3.1)
+      debugger-linecache (~> 1.1)
+      debugger-ruby_core_source (~> 1.1)
+    debugger-linecache (1.1.1)
+      debugger-ruby_core_source (>= 1.1.1)
+    debugger-ruby_core_source (1.1.2)
+    erubis (2.7.0)
+    git (1.2.5)
+    hike (1.2.1)
+    i18n (0.6.0)
+    jeweler (1.6.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    journey (1.0.4)
+    json (1.7.4)
+    mail (2.4.4)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.19)
+    minitest (3.2.0)
+    minitest-matchers (1.1.3)
+      minitest (>= 2.5.0)
+    minitest-rails (0.1.3)
+      minitest (~> 3.0)
+      rails (~> 3.0)
+    minitest-rails-shoulda (0.1.0)
+      minitest-matchers (~> 1.1.3)
+      minitest-rails (~> 0.1.0)
+      shoulda-matchers (~> 1.2.0)
+    multi_json (1.3.6)
+    polyglot (0.3.3)
+    rack (1.4.1)
+    rack-cache (1.2)
+      rack (>= 0.4)
+    rack-ssl (1.3.2)
+      rack
+    rack-test (0.6.1)
+      rack (>= 1.0)
+    rails (3.2.8)
+      actionmailer (= 3.2.8)
+      actionpack (= 3.2.8)
+      activerecord (= 3.2.8)
+      activeresource (= 3.2.8)
+      activesupport (= 3.2.8)
+      bundler (~> 1.0)
+      railties (= 3.2.8)
+    railties (3.2.8)
+      actionpack (= 3.2.8)
+      activesupport (= 3.2.8)
+      rack-ssl (~> 1.3.2)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (>= 0.14.6, < 2.0)
+    rake (0.9.2.2)
+    rcov (0.9.11)
+    rdoc (3.12)
+      json (~> 1.4)
+    shoulda-matchers (1.2.0)
+      activesupport (>= 3.0.0)
+    sprockets (2.1.3)
+      hike (~> 1.2)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    sqlite3 (1.3.6)
+    thor (0.16.0)
+    tilt (1.3.3)
+    treetop (1.4.10)
+      polyglot
+      polyglot (>= 0.3.1)
+    turn (0.9.5)
+      ansi
+    tzinfo (0.3.33)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activerecord
+  bundler (~> 1.0.0)
+  carrierwave
+  debugger
+  jeweler (~> 1.6.4)
+  minitest
+  minitest-rails-shoulda
+  rcov
+  sqlite3
+  turn

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 futurechimp
+
+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,19 @@
+= drafter
+
+Description goes here.
+
+== Contributing to drafter
+
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2012 futurechimp. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,53 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "drafter"
+  gem.homepage = "http://github.com/futurechimp/drafter"
+  gem.license = "MIT"
+  gem.summary = %Q{Simple}
+  gem.description = %Q{A}
+  gem.email = "dave.hrycyszyn@headlondon.com"
+  gem.authors = ["futurechimp"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+require 'rcov/rcovtask'
+Rcov::RcovTask.new do |test|
+  test.libs << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+  test.rcov_opts << '--exclude "gems/*"'
+end
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "drafter #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/drafter.gemspec

@@ -0,0 +1,93 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "drafter"
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["futurechimp"]
+  s.date = "2012-08-17"
+  s.description = "A"
+  s.email = "dave.hrycyszyn@headlondon.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "drafter.gemspec",
+    "lib/drafter.rb",
+    "lib/drafter/creation.rb",
+    "lib/drafter/draft.rb",
+    "lib/drafter/draft_upload.rb",
+    "lib/drafter/draft_uploader.rb",
+    "lib/drafter/draftable.rb",
+    "test/drafter/test_creation.rb",
+    "test/drafter/test_draft.rb",
+    "test/drafter/test_draft_upload.rb",
+    "test/drafter/test_draftable.rb",
+    "test/fixtures/bar.txt",
+    "test/fixtures/foo.txt",
+    "test/helper.rb",
+    "test/support/data.rb",
+    "test/support/models.rb",
+    "test/support/schema.rb",
+    "test/support/uploader.rb",
+    "test/test_drafter.rb",
+    "test/watchr.rb"
+  ]
+  s.homepage = "http://github.com/futurechimp/drafter"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.17"
+  s.summary = "Simple"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activerecord>, [">= 0"])
+      s.add_runtime_dependency(%q<sqlite3>, [">= 0"])
+      s.add_runtime_dependency(%q<debugger>, [">= 0"])
+      s.add_development_dependency(%q<minitest>, [">= 0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_development_dependency(%q<turn>, [">= 0"])
+      s.add_development_dependency(%q<carrierwave>, [">= 0"])
+      s.add_development_dependency(%q<minitest-rails-shoulda>, [">= 0"])
+    else
+      s.add_dependency(%q<activerecord>, [">= 0"])
+      s.add_dependency(%q<sqlite3>, [">= 0"])
+      s.add_dependency(%q<debugger>, [">= 0"])
+      s.add_dependency(%q<minitest>, [">= 0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<turn>, [">= 0"])
+      s.add_dependency(%q<carrierwave>, [">= 0"])
+      s.add_dependency(%q<minitest-rails-shoulda>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<activerecord>, [">= 0"])
+    s.add_dependency(%q<sqlite3>, [">= 0"])
+    s.add_dependency(%q<debugger>, [">= 0"])
+    s.add_dependency(%q<minitest>, [">= 0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<turn>, [">= 0"])
+    s.add_dependency(%q<carrierwave>, [">= 0"])
+    s.add_dependency(%q<minitest-rails-shoulda>, [">= 0"])
+  end
+end
+

data/lib/drafter/creation.rb

@@ -0,0 +1,57 @@
+module Drafter
+
+	# Takes care of associating and creating Draft objects for the draftable
+  # class.
+  module Creation
+    extend ActiveSupport::Concern
+
+    # Set up the association to the Draft object.
+    included do
+      has_one :draft, :as => :draftable
+    end
+
+    # Build and save the draft when told to do so.
+    def save_draft
+      if self.valid?
+        attrs = self.attributes
+        uploads = build_draft_uploads(attrs)
+        self.build_draft(:data => attrs)
+        self.draft.save!
+        self.draft.draft_uploads << uploads
+        self.draft
+      end
+    end
+
+    private
+
+      # Loop through and create DraftUpload objects for any Carrierwave
+      # uploaders mounted on this draftable object.
+      #
+      # @param [Hash] attrs the attributes to loop through
+      # @return [Array<DraftUpload>] an array of unsaved DraftUpload objects.
+      def build_draft_uploads(attrs)
+        draft_uploads = []
+        attrs.keys.each do |key|
+          if self.send(key).is_a?(CarrierWave::Uploader::Base)
+            draft_uploads << build_draft_upload(key)
+          end
+        end
+        draft_uploads
+      end
+
+      # Get a reference to the CarrierWave uploader mounted on the
+      # current draftable object, grab the file in it, and shove
+      # that file into a new DraftUpload.
+      #
+      # @param [String] key the attribute where the CarrierWave uploader
+      #   is mounted.
+      # @return [DraftUpload] containing the file in the uploader.
+      def build_draft_upload(key)
+        cw_uploader = self.send(key)
+        file = File.new(cw_uploader.file.path) if cw_uploader.file
+        draft_upload = DraftUpload.new(
+          :file_data => file, :draftable_mount_column => key)
+      end
+
+  end
+end

data/lib/drafter/draft.rb

@@ -0,0 +1,92 @@
+# A model to store serialized draft data. Drafts attach themselves
+# polymorphically to any other ActiveRecord class, loop through the
+# target draftable classes's attributes, and store them as a Hash
+# in the :data text field in the database.
+#
+# Drafts can also keep track of the target draftable's CarrierWave uploads,
+# if any exist.
+#
+class Draft < ActiveRecord::Base
+
+	# Validations
+	#
+	validates_presence_of :data
+
+	# Associations
+	#
+  has_many :draft_uploads
+	belongs_to :draftable, :polymorphic => true
+
+
+	# Store serialized data for the associated draftable as a Hash of
+  # attributes.
+	#
+  serialize :data, Hash
+
+  # Approve a draft, setting the attributes of the draftable object to
+  # contain the draft content, saving the draftable, and destroying the draft.
+  #
+  def approve!
+  	draftable = build_draftable
+  	draftable.save!
+  	self.destroy
+  	draftable
+  end
+
+  # Set things up so we can use dot notation to access draft data, e.g.
+  # we can do either @foo.draft.data["title"] or (more neatly) we can
+  # do @foo.draft.title
+  #
+  def method_missing(meth, *args, &block)
+    if self.data.keys.include?(meth.to_s)
+      self.data[meth.to_s]
+    else
+      super
+    end
+  end
+
+
+  private
+
+    # Find the existing draftable, or build a new one, and set it up.
+    #
+  	# @return the existing draftable object, or a new one of the proper
+  	# 	type, with attributes and files hanging off it.
+  	def build_draftable
+  		dr = draftable.nil? ? self.draftable_type.constantize.new : draftable
+      restore_attrs_on(dr)
+      restore_files_on(dr)
+      dr
+  	end
+
+    # Whack the draft data onto the real object.
+    #
+    # @param [Draftable] dr a new or existing draftable to restore from the
+    #   draft attributes.
+    # @return [Draftable] the draftable object populated with the draft attrs.
+    def restore_attrs_on(dr)
+      draftable_columns.each do |key|
+        dr.raw_write_attribute key, self.data[key]
+      end
+      dr
+    end
+
+    # Attach draft files to the real object.
+    #
+    # @param [Draftable] dr a new or existing draftable.
+    # @return [Draftable] the draftable object where CarrierWave uploads
+    #   on the object have been replaced with their draft equivalents.
+    def restore_files_on(dr)
+      draft_uploads.each do |draft_upload|
+        dr.send(draft_upload.draftable_mount_column + "=", draft_upload.file_data)
+      end
+    end
+
+  	# We don't want to copy all the draft's columns into the draftable
+  	# objects attributes.
+  	#
+  	# @return [Array] the draft's columns minus :id, :created_at, :updated_at
+    def draftable_columns
+    	self.data.keys - ['id', 'created_at', 'updated_at']
+    end
+end

data/lib/drafter/draft_upload.rb

@@ -0,0 +1,27 @@
+# Some of the objects we want to keep drafts of will have attached uploads,
+# which are stored using CarrierWave. The simplest thing which can work, I
+# think, is to grab the uploaded data from the draftable object, and store it
+# in its own class, making a note of the original mount column that the file
+# was destined for.
+#
+# The original :file_data is saved in this model, without any processing
+# or modification. When the draft is approved, the Draft will push the
+# :file_data onto the :draftable_mount_column of the draftable object.
+#
+class DraftUpload < ActiveRecord::Base
+
+	# Associations
+	#
+	belongs_to :draft
+
+	# Validations
+	#
+	validates_presence_of :draft
+	validates_presence_of :draftable_mount_column
+	validates_presence_of :file_data
+
+	# Macros
+	#
+	mount_uploader :file_data, DraftUploader
+
+end

data/lib/drafter/draft_uploader.rb

@@ -0,0 +1,8 @@
+# This CarrierWave uploader is used to steal incoming files off of
+# draftable objects, and store them on a DraftUpload for later use.
+#
+class DraftUploader < CarrierWave::Uploader::Base
+
+  storage :file
+
+end

data/lib/drafter/draftable.rb

@@ -0,0 +1,25 @@
+module Drafter
+  # Adds a flag to determine whether a model class is draftable.
+  module Draftable
+    extend ActiveSupport::Concern
+
+    # Overrides the +draftable+ method to first define the +draftable?+ class method before
+    # deferring to the original +draftable+.
+    module ClassMethods
+      def draftable(*args)        
+        class << self
+          def draftable?
+            true
+          end
+        end
+      end
+
+      # For all ActiveRecord::Base models that do not call the +draftable+ method, the +draftable?+
+      # method will return false.
+      def draftable?
+        false
+      end
+    end
+
+  end
+end

data/lib/drafter.rb

@@ -0,0 +1,29 @@
+require 'active_support/concern'
+require 'active_support/dependencies/autoload'
+require 'active_support/core_ext/module/delegation'
+require 'active_record'
+
+require 'lib/drafter/draft_uploader'
+
+module Drafter
+  extend ActiveSupport::Concern
+  extend ActiveSupport::Autoload
+
+  autoload :Creation
+  autoload :Draft
+  autoload :Draftable
+  autoload :DraftUpload
+
+  class << self
+    delegate :config, :configure, :to => Draft
+    delegate :config, :configure, :to => DraftUpload
+  end
+
+  included do
+  	include Creation
+    include Draftable
+  end
+
+end
+
+ActiveRecord::Base.class_eval{ include Drafter }

data/test/drafter/test_creation.rb

@@ -0,0 +1,140 @@
+require 'helper'
+
+class TestCreation < Minitest::Unit::TestCase
+
+	describe "Saving a draft of" do
+		describe "a new draftable article" do
+			before do
+				@article_count = Article.count
+				@draft_count = Draft.count
+				@draft_upload_count = DraftUpload.count
+				@article = Article.new(
+					:text => "original text",
+					:upload => file_upload
+				)
+				@draft = @article.save_draft
+			end
+
+			it "should not create a new draftable" do
+				assert_equal(@article_count, Article.count)
+			end
+
+			it "should create a saved draft object" do
+				assert_equal(@draft_count + 1, Draft.count)
+			end
+
+			it "should return the @draft object" do
+				assert_equal(Draft, @draft.class)
+			end
+
+			it "should save the contents of the :text attribute" do
+				assert_equal "original text", @draft.data["text"]
+			end
+
+			it "should create a DraftUpload object" do
+				assert_equal(@draft_upload_count + 1, DraftUpload.count)
+			end
+
+			it "should add the draft_upload to the Draft's array of them" do
+				assert_equal(1, @draft.draft_uploads.length)
+				assert_equal(DraftUpload.last, @draft.draft_uploads.first)
+			end
+		end
+
+		describe "an existing draftable article" do
+			before do
+				@draft_count = Draft.count
+				@draft_upload_count = DraftUpload.count
+				@article = Article.create!(:text => "original text")
+				@article.text = "draft text"
+			end
+
+			describe "with a file upload" do
+				before do
+					@article.upload = file_upload
+					@draft = @article.save_draft
+				end
+
+				describe "the article" do
+					it "should still have text of 'original text'" do
+						assert_equal("original text", @article.reload.text)
+					end
+
+					it "should have a draft attached" do
+						assert_equal(Draft, @article.draft.class)
+					end
+
+					it "should create a new draft" do
+						assert_equal(@draft_count + 1, Draft.count)
+					end
+				end
+
+				describe "the article's draft" do
+					it "has a serialized :text attribute with content 'draft text'" do
+						assert_equal('draft text', @article.draft.data["text"])
+					end
+
+					it "should create a DraftUpload object" do
+						assert_equal(@draft_upload_count + 1, DraftUpload.count)
+					end
+
+					it "should add the draft_upload to the Draft's array of them" do
+						assert_equal(1, @draft.draft_uploads.length)
+						assert_equal(DraftUpload.last, @draft.draft_uploads.first)
+					end
+				end
+			end
+
+
+			describe "without a file upload" do
+				before do
+					@draft = @article.save_draft
+				end
+
+				describe "the article" do
+					it "should still have text of 'original text'" do
+						assert_equal("original text", @article.reload.text)
+					end
+
+					it "should have a draft attached" do
+						assert_equal(Draft, @article.draft.class)
+					end
+
+					it "should create a new draft" do
+						assert_equal(@draft_count + 1, Draft.count)
+					end
+				end
+
+				describe "the article's draft" do
+					it "has a serialized :text attribute with content 'draft text'" do
+						assert_equal('draft text', @article.draft.data["text"])
+					end
+				end
+			end
+		end
+
+		describe "an invalid article" do
+			before do
+				@draft_count = Draft.count
+				@draft_upload_count = DraftUpload.count
+				@article = Article.create!(:text => "original text")
+				@article.text = ""
+				@article.upload = file_upload
+				@draft = @article.save_draft
+			end
+
+			it "should not create a Draft object" do
+				assert_equal(@draft_count, Draft.count)
+			end
+
+			it "should not create a DraftUpload object" do
+				assert_equal(@draft_upload_count, DraftUpload.count)
+			end
+
+			it "sets up validation errors on the @article" do
+				assert_equal(1, @article.errors.count)
+			end
+		end
+	end
+
+end

data/test/drafter/test_draft.rb

@@ -0,0 +1,104 @@
+require 'helper'
+
+class TestDraft < Minitest::Unit::TestCase
+
+	describe Draft do
+		subject { @draft = Draft.new }
+		describe "validations" do
+		  it { must validate_presence_of(:data) }
+		end
+
+		describe "associations" do
+			it { must belong_to(:draftable) }
+			it { must have_many(:draft_uploads) }
+		end
+	end
+
+	describe "Accessing draft data properties" do
+		before do
+			@draft = Draft.new(:data => {"foo" => "bar"})
+		end
+
+		describe "through the data hash" do
+			it "works" do
+				assert_equal("bar", @draft.data["foo"])
+			end
+		end
+
+		describe "using dot notation" do
+			it "also works" do
+				assert_equal("bar", @draft.foo)
+			end
+		end
+	end
+
+	describe "Approving a draft" do
+		before do
+			@article = Article.new(
+				:text => "initial text",
+				:upload => file_upload)
+		end
+
+		describe "for an article which hasn't yet been saved" do
+			before do
+				@article_count = Article.count
+				@draft = @article.save_draft
+				@draft_count = Draft.count
+				@article = @draft.approve!
+			end
+
+			it "should create an article" do
+				assert_equal(@article_count + 1, Article.count)
+			end
+
+			it "should return the saved article" do
+				assert_equal(Article, @article.class)
+			end
+
+			it "should properly populate all the attributes" do
+				assert_equal("initial text", @article.text)
+			end
+
+			it "should populate all the file uploads" do
+				assert_equal("foo.txt", @article.upload.filename)
+				assert_equal("foo foo foo", File.open(@article.upload.path).read)
+			end
+
+			it "should delete the article's draft" do
+				assert_equal(@draft_count - 1, Draft.count)
+				refute @article.draft
+			end
+		end
+
+		describe "for an article which already exists" do
+			before do
+				@article.save
+				@article_count = Article.count
+				@article.text = "some draft text"
+				@article.upload = file_upload("bar.txt")
+				@draft = @article.save_draft
+				@draft_count = Draft.count
+				@draft.approve!
+			end
+
+			it "shouldn't do anything mental, like creating a new object" do
+				assert_equal(@article_count, Article.count)
+			end
+
+			it "should properly populate all the attributes" do
+				assert_equal("some draft text", @article.text)
+			end
+
+			it "should populate all the file uploads" do
+				assert_equal("bar.txt", @article.upload.filename)
+				assert_equal("bar bar bar", File.open(@article.upload.path).read)
+			end
+
+			it "should delete the article's draft" do
+				assert_equal(@draft_count - 1, Draft.count)
+				refute @article.reload.draft
+			end
+		end
+	end
+
+end

data/test/drafter/test_draft_upload.rb

@@ -0,0 +1,31 @@
+require 'helper'
+
+class TestDraftUpload < Minitest::Unit::TestCase
+
+	describe DraftUpload do
+		subject { DraftUpload.new }
+
+		describe "validations" do
+			it { must validate_presence_of :file_data }			
+			it { must validate_presence_of :draft }
+			it { must validate_presence_of :draftable_mount_column }
+		end
+
+		describe "associations" do
+			it { must belong_to :draft }		
+		end
+
+		describe "uploading files" do
+			it "works" do
+				draft_upload = DraftUpload.new(
+					:file_data => file_upload,
+					:draft => Draft.create(:data => {:foo => :bar}),
+					:draftable_mount_column => :photo
+				)
+				assert draft_upload.save!
+				assert File.exist?(draft_upload.reload.file_data.path)
+			end
+		end
+	end
+
+end

data/test/drafter/test_draftable.rb

@@ -0,0 +1,17 @@
+require 'helper'
+
+class TestDraftable < MiniTest::Unit::TestCase
+
+	describe "A draftable ActiveRecord class" do
+		it "should know it's draftable" do
+			assert Article.draftable?
+		end
+	end
+
+	describe "A non-draftable ActiveRecord class" do
+		it "should know it's not draftable" do
+			refute Comment.draftable?
+		end
+	end
+
+end

data/test/fixtures/bar.txt

@@ -0,0 +1 @@
+bar bar bar

data/test/fixtures/foo.txt

@@ -0,0 +1 @@
+foo foo foo

data/test/helper.rb

@@ -0,0 +1,58 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'minitest/spec'
+require 'debugger'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'active_record'
+require 'carrierwave'
+require 'carrierwave/orm/activerecord'
+require 'drafter'
+require 'turn'
+require 'minitest/matchers'
+require "shoulda/matchers/active_record"
+require "shoulda/matchers/active_model"
+
+# Establish a connection to our test database
+ActiveRecord::Base.establish_connection(
+	:adapter => "sqlite3",
+	:database => File.dirname(__FILE__) + "/drafter.sqlite3")
+
+load File.dirname(__FILE__) + '/support/schema.rb'
+load File.dirname(__FILE__) + '/support/uploader.rb'
+load File.dirname(__FILE__) + '/support/models.rb'
+load File.dirname(__FILE__) + '/support/data.rb'
+
+class MiniTest::Unit::TestCase
+
+  # Pull in shoulda matchers for minitest.
+  #
+  # You need to have the minitest-matchers gem and the minitest-rails-shoulda gem
+  # for this to work.
+  include Shoulda::Matchers::ActiveRecord
+  extend Shoulda::Matchers::ActiveRecord
+  include Shoulda::Matchers::ActiveModel
+  extend Shoulda::Matchers::ActiveModel
+
+  def file_upload(name="foo.txt")
+  	File.new(File.dirname(__FILE__) + "/fixtures/#{name}")
+  end
+
+end
+
+MiniTest::Unit.autorun
+
+Turn.config do |c|
+ c.format  = :outline
+ c.trace   = false
+ c.natural = true
+end

data/test/support/data.rb

@@ -0,0 +1,2 @@
+# Creates an article so we've got a bit of test data.
+Article.create!(:text => "foo")

data/test/support/models.rb

@@ -0,0 +1,17 @@
+# Define models we can test with
+
+# A draftable article class
+class Article < ActiveRecord::Base
+
+  validates_presence_of :text
+
+	draftable
+
+	mount_uploader :upload, Uploader
+
+end
+
+
+# A non-draftable comment class
+class Comment < ActiveRecord::Base
+end

data/test/support/schema.rb

@@ -0,0 +1,27 @@
+# Load up a database schema and force schema creation
+ActiveRecord::Schema.define do
+  self.verbose = false
+
+  create_table :articles, :force => true do |t|
+    t.string :text
+    t.string :upload
+    t.timestamps
+  end
+
+  create_table :drafts, :force => true do |t|
+  	t.text :data
+  	t.references :draftable, :polymorphic => true
+  end
+
+  change_table :drafts do |t|
+    t.index [:draftable_id, :draftable_type]
+    t.index :data
+  end
+
+  create_table :draft_uploads, :force => true do |t|
+    t.references :draft
+    t.string :draftable_mount_column
+    t.string :file_data
+  end
+
+end

data/test/support/uploader.rb

@@ -0,0 +1,8 @@
+class Uploader < CarrierWave::Uploader::Base
+
+  ##
+  # Storage type
+  #
+  storage :file
+
+end

data/test/test_drafter.rb

@@ -0,0 +1,5 @@
+require 'helper'
+
+class TestDrafter < MiniTest::Unit::TestCase
+
+end

data/test/watchr.rb

@@ -0,0 +1,5 @@
+require 'autowatchr'
+
+Autowatchr.new(self) do |config|
+  config.failing_only = true
+end

metadata

@@ -0,0 +1,187 @@
+--- !ruby/object:Gem::Specification
+name: drafter
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- futurechimp
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-08-17 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: &2160790860 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2160790860
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: &2160778900 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2160778900
+- !ruby/object:Gem::Dependency
+  name: debugger
+  requirement: &2160777900 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2160777900
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: &2160776580 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2160776580
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &2160774900 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: *2160774900
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: &2160773980 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.4
+  type: :development
+  prerelease: false
+  version_requirements: *2160773980
+- !ruby/object:Gem::Dependency
+  name: rcov
+  requirement: &2160773220 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2160773220
+- !ruby/object:Gem::Dependency
+  name: turn
+  requirement: &2160772480 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2160772480
+- !ruby/object:Gem::Dependency
+  name: carrierwave
+  requirement: &2160771780 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2160771780
+- !ruby/object:Gem::Dependency
+  name: minitest-rails-shoulda
+  requirement: &2160771260 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2160771260
+description: A
+email: dave.hrycyszyn@headlondon.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- .document
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- drafter.gemspec
+- lib/drafter.rb
+- lib/drafter/creation.rb
+- lib/drafter/draft.rb
+- lib/drafter/draft_upload.rb
+- lib/drafter/draft_uploader.rb
+- lib/drafter/draftable.rb
+- test/drafter/test_creation.rb
+- test/drafter/test_draft.rb
+- test/drafter/test_draft_upload.rb
+- test/drafter/test_draftable.rb
+- test/fixtures/bar.txt
+- test/fixtures/foo.txt
+- test/helper.rb
+- test/support/data.rb
+- test/support/models.rb
+- test/support/schema.rb
+- test/support/uploader.rb
+- test/test_drafter.rb
+- test/watchr.rb
+homepage: http://github.com/futurechimp/drafter
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 3420985019024950732
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.17
+signing_key: 
+specification_version: 3
+summary: Simple
+test_files: []