faker_maker 1.1.6 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 395554b9ccca5e191c6c18e6230b67742ea18748bc95d9a8c9be05444c59718e
-  data.tar.gz: e0e019dd3cb8cd8d0f4a41f169d40fdb12edfbe1d49fcc9b91132943ad7f3815
+  metadata.gz: '085b4651f6fd8681a1544f7fcc1c3ec05709f2709c701268c16efaf09b4ce06d'
+  data.tar.gz: bdabf0075d7453c39a24554c659e859781c15b1fc7880b5115134e38438fe756
 SHA512:
-  metadata.gz: 37d07c0cfaf000360f64e17c078bb45559215e79f13ba5ba06602cac46760955b36913c51bc9ffa5ba2e825ebe133eb862610e466123201923808b1295cf831d
-  data.tar.gz: ff68a283137fdade651db7ca7e4c1fc3f5c5e63bfd4d521dbc68b425793cd73a332a2050fd99530e2b49f5c754048af0c7f41204d4fb2f5e7be263334109407b
+  metadata.gz: 19b799c28b8409657e9f8abe28eaaa6dabf6caefc66055e894c843994a9a8b1f66aedc35a356a0da5e620bd8d12cd25dc5cf077393e4dea80f17b9d1cb048c48
+  data.tar.gz: 3a288478c6afff7c15a3246bc445fcad61a93679fbe345503bcb782d254eb08ea72a825b794699dfb18dad7a1b0522ee5d6a5beb24452b476bd8f365a6449c67

data/.rubocop.yml

@@ -13,4 +13,34 @@ Metrics/BlockLength:
     - "**/*_spec.rb"
 
 Layout/TrailingWhitespace:
+  Enabled: true
+
+Layout/SpaceAroundMethodCallOperator:
+  Enabled: true
+
+Lint/RaiseException:
+  Enabled: true
+
+Lint/StructNewOverride:
+  Enabled: true
+
+Style/ExponentialNotation:
+  Enabled: true
+
+Style/HashEachMethods:
+  Enabled: true
+
+Style/HashTransformKeys:
+  Enabled: true
+ 
+Style/HashTransformValues:
+  Enabled: true
+
+Metrics/AbcSize:
+  Enabled: false
+
+Metrics/MethodLength:
+  Enabled: false
+
+Lint/MissingSuper:
   Enabled: false

data/Guardfile

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+## Uncomment and set this to only include directories you want to watch
+# directories %w(app lib config test spec features) \
+#  .select{|d| Dir.exist?(d) ? d : UI.warning("Directory #{d} does not exist")}
+
+## Note: if you are using the `directories` clause above and you are not
+## watching the project directory ('.'), then you will want to move
+## the Guardfile to a watched dir and symlink it back, e.g.
+#
+#  $ mkdir config
+#  $ mv Guardfile config/
+#  $ ln -s config/Guardfile .
+#
+# and, you'll have to watch "config/Guardfile" instead of "Guardfile"
+
+# Note: The cmd option is now required due to the increasing number of ways
+#       rspec may be run, below are examples of the most common uses.
+#  * bundler: 'bundle exec rspec'
+#  * bundler binstubs: 'bin/rspec'
+#  * spring: 'bin/rspec' (This will use spring if running and you have
+#                          installed the spring binstubs per the docs)
+#  * zeus: 'zeus rspec' (requires the server to be started separately)
+#  * 'just' rspec: 'rspec'
+
+# rubocop:disable Metrics/BlockLength
+guard :rspec, cmd: 'bundle exec rspec -f progress' do
+  require 'guard/rspec/dsl'
+  dsl = Guard::RSpec::Dsl.new(self)
+
+  # Feel free to open issues for suggestions and improvements
+
+  # RSpec files
+  rspec = dsl.rspec
+  watch(rspec.spec_helper) { rspec.spec_dir }
+  watch(rspec.spec_support) { rspec.spec_dir }
+  watch(rspec.spec_files)
+
+  # Ruby files
+  ruby = dsl.ruby
+  dsl.watch_spec_files_for(ruby.lib_files)
+
+  # Rails files
+  rails = dsl.rails(view_extensions: %w[erb haml slim])
+  dsl.watch_spec_files_for(rails.app_files)
+  dsl.watch_spec_files_for(rails.views)
+
+  watch(rails.controllers) do |m|
+    [
+      rspec.spec.call("routing/#{m[1]}_routing"),
+      rspec.spec.call("controllers/#{m[1]}_controller"),
+      rspec.spec.call("acceptance/#{m[1]}")
+    ]
+  end
+
+  # Rails config changes
+  watch(rails.spec_helper)     { rspec.spec_dir }
+  watch(rails.routes)          { "#{rspec.spec_dir}/routing" }
+  watch(rails.app_controller)  { "#{rspec.spec_dir}/controllers" }
+
+  # Capybara features specs
+  watch(rails.view_dirs)     { |m| rspec.spec.call("features/#{m[1]}") }
+  watch(rails.layouts)       { |m| rspec.spec.call("features/#{m[1]}") }
+
+  # Turnip features and steps
+  watch(%r{^spec/acceptance/(.+)\.feature$})
+  watch(%r{^spec/acceptance/steps/(.+)_steps\.rb$}) do |m|
+    Dir[File.join("**/#{m[1]}.feature")][0] || 'spec/acceptance'
+  end
+end
+# rubocop:enable Metrics/BlockLength
+
+guard :rubocop do
+  watch(/.+\.rb$/)
+  watch(%r{(?:.+/)?\.rubocop(?:_todo)?\.yml$}) { |m| File.dirname(m[0]) }
+end
+
+guard :bundler do
+  require 'guard/bundler'
+  require 'guard/bundler/verify'
+  helper = Guard::Bundler::Verify.new
+
+  files = ['Gemfile']
+  files += Dir['*.gemspec'] if files.any? { |f| helper.uses_gemspec?(f) }
+
+  # Assume files are symlinked from somewhere
+  files.each { |file| watch(helper.real_path(file)) }
+end

data/README.md

@@ -1,285 +1,24 @@
+<h1 align="center">
+  <img src="https://raw.githubusercontent.com/BillyRuffian/faker_maker/master/img/unipug.svg?sanitize=true" alt="Faker Maker" height="200">
+  <br>
+  Faker Maker
+  <br>
+</h1>
 
-![CircleCI branch](https://img.shields.io/circleci/project/github/BillyRuffian/faker_maker/master.svg?style=flat-square)
-[![CodeFactor](https://www.codefactor.io/repository/github/billyruffian/faker_maker/badge?style=flat-square)](https://www.codefactor.io/repository/github/billyruffian/faker_maker)
-![GitHub tag (latest SemVer)](https://img.shields.io/github/tag/BillyRuffian/faker_maker.svg?style=flat-square)
+<h4 align="center">
+  Factories over Fixtures
+</h4>
 
-# FakerMaker
+<div align="center">
 
-FakerMaker is a simple fixture generator with a concise and straightforward syntax.
+  [![Gem Version](https://badge.fury.io/rb/faker_maker.svg)](https://badge.fury.io/rb/faker_maker)
+  [![Downloads](https://img.shields.io/gem/dt/faker_maker)](https://rubygems.org/gems/faker_maker)
+  ![CircleCI branch](https://img.shields.io/circleci/project/github/BillyRuffian/faker_maker/master.svg?style=flat-square)
+  [![CodeFactor](https://www.codefactor.io/repository/github/billyruffian/faker_maker/badge?style=flat-square)](https://www.codefactor.io/repository/github/billyruffian/faker_maker)
+  ![GitHub tag (latest SemVer)](https://img.shields.io/github/tag/BillyRuffian/faker_maker.svg?style=flat-square)
 
-It is designed to resemble the [FactoryBot](https://github.com/thoughtbot/factory_bot) gem but without needing an existing class definition to back its fixtures and so it goes without saying that it offers no persistence mechanism. Its purpose is to provide a simple framework for generating data to test JSON APIs and is intended to be used with the [Faker](https://github.com/stympy/faker) gem (but has no dependency upon it).
+</div>
 
-## Installation
+FakerMaker is a simple factory builder so you can throw away your fixtures and generate test data instead.
 
-Add this line to your application's Gemfile:
-
-```ruby
-gem 'faker_maker'
-```
-
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
-
-    $ gem install faker_maker
-
-## Usage
-
-FakerMaker generates factories that build disposable objects for testing. Each factory has a name and a set of attributes.
-
-```ruby
-FakerMaker.factory :user do 
-  name {'Patsy Stone'}
-  email {'patsy@fabulous.co.uk'}
-  admin {false}
-end
-```
-
-This will generate a `User` class with the attributes `name`, `email` and `admin` which will always return the same value.
-
-It is possible to explicitly set the name of class which is particularly useful if there is a risk of redefining an existing one.
-
-```ruby
-FakerMaker.factory :user, class: 'EmailUser' do 
-  name {'Patsy Stone'}
-  email {'patsy@fabulous.co.uk'}
-  admin {false}
-end
-```
-
-The class name will always be turned into a Ruby-style class name so `email_user` would become `EmailUser`.
-
-Because of the block syntax in Ruby, defining attributes as `Hash`es requires two sets of curly brackets:
-
-```ruby
-FakerMaker.factory :response do 
-  body { { title: 'First Post', content: 'This is part of a hash' } }
-end
-```
-
-Blocks are executed in the context of their instance. This means you can refer to variables already defined:
-
-```ruby
-FakerMaker.factory :user, class: 'EmailUser' do 
-  title {'Ms'}
-  name {'Patsy Stone'}
-  formal_name {"#{title} #{name}"}
-  email {'patsy@fabulous.co.uk'}
-  admin {false}
-end
-```
-
-### Inheritance
-
-FakerMaker can exploit the Ruby class hierarchy to provide additional specialisation or to override some behaviours:
-
-```ruby
-FakerMaker.factory :vehicle do
-  wheels { 4 }
-  colour { Faker::Color.color_name }
-  engine_capacity { rand( 600..2500 ) }
-end
-
-FakerMaker.factory :motorbike, parent: :vehicle do
-  wheels { 2 }
-  sidecar { [true, false].sample }
-end
-```
-
-This is the equivalent of: 
-
-```ruby
-class Vehicle < Object
-  # ...
-end
-
-class Motorbike < Vehicle
-  # ...
-end
-```
-
-so a motorbike will still have a colour and engine capacity between 600 and 2500.
-
-### Arrays
-
-It is possible to declare an attribute as having multiple values.
-
-```ruby
-FakerMaker.factory :basket do
-  items( has: 10 ) { Faker::Commerce.product_name }
-end
-```
-
-or to pick random number of attributes from a range:
-
-```ruby
-FakerMaker.factory :basket do
-  items( has: 5..20 ) { Faker::Commerce.product_name }
-end
-```
-
-A range always generates an array, even if the range produces 1 items or the range is `0..1`.
-
-It is possible to force an attribute to always be an array, even if only produces one item.
-
-```ruby
-FakerMaker.factory :basket do
-  items( array: true ) { Faker::Commerce.product_name }
-end
-```
-
-You can always use long-form block syntax...
-
-```ruby
-FakerMaker.factory :basket do
-  items has: 5..20 do
-    Faker::Commerce.product_name
-  end
-end
-```
-
-### Organising dependencies
-
-Factory definition files are Plain Ol' Ruby. If you depend on another factory because you either extend from it or use it just add a `require` or (depending on your load path) `require_relative` to the top of your file. 
-
-### JSON field names
-
-JavaScript likes to use camelCase, Ruby's idiom is to use snake_case. This can make make manipulating factory-built objects in ruby ugly. To avoid this, you can call your fields one thing and ask the JSON outputter to rename the field when generating JSON.
-
-```ruby
-FakerMaker.factory :vehicle do
-  wheels { 4 }
-  colour { Faker::Color.color_name }
-  engine_capacity(json: 'engineCapacity') { rand( 600..2500 ) }
-end
-
-v = FM[:vehicle].build
-v.engine_capacity = 125
-```
-
-and calls to `as_json` and `to_json` will report the fieldname as `engineCapacity`.
-
-```ruby
-v.to_json
-
-=> "{\"wheels\":4,\"colour\":\"blue\",\"engineCapacity\":125}"
-```
-
-### Building instances
-
-Instances are Plain Ol' Ruby Objects and the attributes are attached with getters and setters with their values assigned to the value return from their block at build time. 
-
-To build an object:
-
-```ruby
-result = FakerMaker[:basket].build
-```
-
-will generate a new instance using the Basket factory. Because an actual class is defined, you can instantiate an object directly through `Basket.new` but that will not populate any of the attributes.
-
-It's possible to override attributes at build-time, either by passing values as a hash:
-
-```ruby
-result = FakerMaker[:item].build( name: 'Electric Blanket' )
-```
-
-or by passing in a block:
-
-```ruby
-result = FakerMaker[:item].build{ |i| i.name = 'Electric Sheep' }
-```
-
-this is particularly useful for overriding nested values, since all the getters and setters of the embedded objects are already constructed:
-
-```ruby
-result = FakerMaker[:basket].build do |b| 
-  b.items.first.name = 'Neon Badger'
-end
-```
-
-if you're crazy enough to want to do both styles during creation, the values in the block will be preserved, e.g.
-
-```ruby
-result = FakerMaker[:item].build( name: 'Electric Blanket' ) do |i| 
-  i.name = 'Electric Sheep'
-end
-```
-
-then the value of `result.name` is 'Electric Sheep'.
-
-Beware when overriding values in this way: there is no type checking. You will get an exception if you try to set a value to an attribute that doesn't exist but you won't get one if you assign, say, an array of values where you would otherwise have a string and vice versa.
-
-Calling `result.to_json` will give a stringified JSON representation. Because ActiveSupport is used under the covers, `as_json` will give you a `Hash` rather than the stringified version.
-
-As a convenience, you can request a JSON representation directly:
-
-```ruby
-result = FakerMaker[:basket].to_json
-```
-
-As another convenience, `FakerMaker` is also assigned to the variable `FM` to it is possible to write just:
-
-```ruby
-result = FM[:basket].build
-```
-
-### Omitting fields
-
-Sometimes you want a field present, other times you don't. This is often the case when you want to skip fields which have null or empty values.
-
-```ruby
-FakerMaker.factory :user do 
-  name {'Patsy Stone'}
-  email(omit: :nil) {'patsy@fabulous.co.uk'}
-  admin {false}
-end
-
-FM[:user].build.as_json
-=> {:name=>"Patsy Stone", :email=>"patsy@fabulous.co.uk", :admin=>false}
-
-FM[:user].build(email: nil).as_json
-=> {:name=>"Patsy Stone", :admin=>false}
-```
-
-The `omit` modifier can take a single value or an array. If it is passed a value and the attribute equals this value, it will not be included in the output from `as_json` (which returns a Ruby Hash) or in `to_json` methods.
-
-There are three special modifiers:
-
-* `:nil` (symbol) to omit output when the attribute is set to nil
-* `:empty` to omit output when the value is an empty string, an empty array or an empty hash
-* `:always` to never output this attribute.
-
-These can be mixed with real values, e.g.
-
-```ruby
-FakerMaker.factory :user do 
-  name {'Patsy Stone'}
-  email(omit: [:nil, :empty, 'test@foobar.com']) {'patsy@fabulous.co.uk'}
-  admin {false}
-end
-```
-
-### Embedding factories
-
-To use factories with factories, the following pattern is recommended:
-
-```ruby
-FakerMaker.factory :item do
-  name { Faker::Commerce.product_name }
-  price { Faker::Commerce.price }
-end
-
-FakerMaker.factory :basket do
-  items( has: 10 ) { FakerMaker[:item].build }
-end
-```
-
-## Contributing
-
-Bug reports and pull requests are welcome on GitHub at https://github.com/BillyRuffian/faker_maker.
-
-## License
-
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+Read the [documentation here](https://billyruffian.github.io/faker_maker/).

data/_config.yml

@@ -0,0 +1 @@
+theme: jekyll-theme-slate

data/docs/.bundle/config

@@ -0,0 +1,2 @@
+---
+BUNDLE_JOBS: "12"