micro_factory 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 356b1fa9ddde54411da3469053d2bc429331a421
+  data.tar.gz: 59957e93aac11d2367e5d8a4eab4aa5a777dfe41
+SHA512:
+  metadata.gz: c742b9a7eaf73e03632662dfaf6bc1975c21900b851d5bd920acf125b07451fbcdafdeeff91afc64fbfe2a9f5fa5b5502eed6978d58d916fa0c0790da85efefd
+  data.tar.gz: edc047e4281dbd46e93023d371a700a9a2ed18d3f88b0ba0fc0fcc2f213b091a08bd01890acceaab860e0795bf1edb8d9e62c49c181955113396318b85efda6c

data/LICENSE.txt

@@ -0,0 +1,9 @@
+Copyright (c) 2015 Norman Clarke and FlexMinder
+
+MIT License
+
+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,73 @@
+# MicroFactory
+
+MicroFactory is a a tiny factory library for writing tests with Active Record.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'micro_factory'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install micro_factory
+
+## Usage
+
+MicroFactory adds a `factory` method to the class or module you add it to.
+
+The method accepts a class, string or symbol reprenting a class, and a hash of valid attributes for the class.
+
+It then generates three methods you can use to build or create Active Record model instances, and access a hash of valid attributes.
+
+The simplest way to use MicroFactory is by extending it into `ActiveSupport::TestCase`, this makes the factories you create available throughout your test suite.
+
+```ruby
+class ActiveSupport::TestCase
+  extend FlexMinder::Factories
+  factory :State, name: 'Washington', code: 'WA'
+end
+
+class StateTest
+  test 'it should validate the state code' do
+    state = build_state code: 'XX'
+    assert_false state.valid?
+  end
+end
+```
+
+In the given example, MicroFactory would generate the following methods:
+
+* `build_state(attributes = {})` - Make a new state instance, optionally with the given attributes merged into the defaults.
+* `create_state(attributes={})` - The same as `build_state` but saves it.
+* `valid_state_attributes` - Get the default attributes used by the factory methods.
+
+If you don't like the idea of extending ActiveRecord::TestCase, you can put it in your own module to keep it isolated:
+
+```ruby
+module MyFactories
+  extend MicroFactory
+  extend self
+end
+
+MyFactories.factory :State, name: 'Washington', code: 'WA'
+oregon = MyFactories.build_state code: 'OR', name: 'Oregon'
+```
+
+## License
+
+Copyright (c) 2015 Norman Clarke and FlexMinder
+
+MIT License
+
+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/Rakefile

@@ -0,0 +1,9 @@
+require "rake/testtask"
+
+Rake::TestTask.new do |t|
+  t.test_files = FileList['test.rb']
+  t.verbose = true
+end
+
+task :default => :test
+

data/lib/micro_factory.rb

@@ -0,0 +1,21 @@
+module MicroFactory
+  def factory(klass, attributes)
+    name        = klass.to_s
+    underscored = name.gsub(/([a-z])(::)?([A-Z])/, '\1_\3').downcase
+
+    class_eval(<<-END, __FILE__, __LINE__ + 1)
+      def build_#{underscored}(attributes = {})
+        attributes = valid_#{underscored}_attributes.merge(attributes)
+        #{name}.new(attributes)
+      end
+
+      def create_#{underscored}(attributes = {})
+        build_#{underscored}(attributes).tap {|x| x.save!}
+      end
+
+      def valid_#{underscored}_attributes
+        #{attributes.inspect}
+      end
+    END
+  end
+end

data/micro_factory.gemspec

@@ -0,0 +1,18 @@
+Gem::Specification.new do |spec|
+  spec.name          = "micro_factory"
+  spec.version       = '0.0.1'
+  spec.authors       = ["Norman Clarke"]
+  spec.email         = ["norman@njclarke.com"]
+  spec.summary       = "Minimal factories for Active Record."
+  spec.description   = "A bare-minimum factory library for Actie Record."
+  spec.homepage      = "https://github.com/norman/micro_factory"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "test-unit", "~> 3.1", ">= 3.1.2"
+end

data/test.rb

@@ -0,0 +1,44 @@
+gem 'test-unit'
+require 'test/unit'
+require_relative 'lib/micro_factory'
+
+class Stooge
+  attr_accessor :name, :occupation, :saved
+
+  def initialize(attributes)
+    @saved = false
+    attributes.each {|k, v| send("#{k}=", v)}
+  end
+
+  def save!
+    @saved = true
+  end
+end
+
+class MicroFactoryTest < Test::Unit::TestCase
+  def setup
+    @mod = Module.new
+    @mod.extend MicroFactory
+    @mod.extend @mod
+    @mod.factory :Stooge, name: 'Moe Howard', occupation: 'Actor'
+  end
+
+  def test_adds_methods_to_module
+    assert_equal [:build_stooge, :create_stooge, :valid_stooge_attributes], @mod.public_instance_methods
+  end
+
+  def test_valid_attributes
+    assert_equal({name: 'Moe Howard', occupation: 'Actor'}, @mod.valid_stooge_attributes)
+  end
+
+  def test_build
+    stooge = @mod.build_stooge name: 'Larry Fine'
+    assert_equal 'Larry Fine', stooge.name
+    assert_equal 'Actor', stooge.occupation
+  end
+
+  def test_create
+    stooge = @mod.create_stooge
+    assert stooge.saved
+  end
+end

metadata

@@ -0,0 +1,85 @@
+--- !ruby/object:Gem::Specification
+name: micro_factory
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Norman Clarke
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-06-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: test-unit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.1.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.1.2
+description: A bare-minimum factory library for Actie Record.
+email:
+- norman@njclarke.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/micro_factory.rb
+- micro_factory.gemspec
+- test.rb
+homepage: https://github.com/norman/micro_factory
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.7
+signing_key: 
+specification_version: 4
+summary: Minimal factories for Active Record.
+test_files: []
+has_rdoc: