faker_maker 1.1.6 → 1.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 395554b9ccca5e191c6c18e6230b67742ea18748bc95d9a8c9be05444c59718e
-  data.tar.gz: e0e019dd3cb8cd8d0f4a41f169d40fdb12edfbe1d49fcc9b91132943ad7f3815
+  metadata.gz: 11bf4bb970ba80be62323b929fc2b6aba156abb1aee757b911d9663f58e081e4
+  data.tar.gz: c345ab60315a80d82f879f179c18e93ea81ba4ebd2751b0a4269c337a0a3a0ed
 SHA512:
-  metadata.gz: 37d07c0cfaf000360f64e17c078bb45559215e79f13ba5ba06602cac46760955b36913c51bc9ffa5ba2e825ebe133eb862610e466123201923808b1295cf831d
-  data.tar.gz: ff68a283137fdade651db7ca7e4c1fc3f5c5e63bfd4d521dbc68b425793cd73a332a2050fd99530e2b49f5c754048af0c7f41204d4fb2f5e7be263334109407b
+  metadata.gz: 95340d9e637a09583f8c9d8b619391cbedb825655b414ec1b1de073beeb041a2eceba65aaf53fd70929fc6d2b80d9d0237290031031b31da6021622ea678ca0f
+  data.tar.gz: 9804e0879fe4b39d66e1409134710c90e7af608c6f14a87c35be65605029e1a54506d9ea0d95d94a590106be9051eafe2525a83d8dfcaaa74dcc765adadf1c32

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,23 @@
+<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)
+  ![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/.keep

@@ -0,0 +1 @@
+

data/docs/_config.yml

@@ -0,0 +1,8 @@
+remote_theme: pmarsceill/just-the-docs
+logo: "https://raw.githubusercontent.com/BillyRuffian/faker_maker/master/docs/logo.png"
+title: Faker Maker
+description: A simple data generator with a straighforward syntax for Ruby
+aux_links:
+  "Faker Maker on GitHub":
+    - "//github.com/BillyRuffian/faker_maker"
+footer_content: "Copyright &copy; 2019-2020 Nigel Brookes-Thomas. Distributed by an <a href=\"https://github.com/BillyRuffian/faker_maker/blob/master/LICENSE.txt\">MIT license.</a>"

data/docs/contributing.md

@@ -0,0 +1,9 @@
+---
+layout: default
+title: Contributing
+nav_order: 3
+---
+
+# Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/BillyRuffian/faker_maker.

data/docs/credits.md

@@ -0,0 +1,9 @@
+---
+layout: default
+title: Credits
+nav_order: 4
+---
+
+# Extra Credit
+
+Unipug logo by [1smr1](https://pixabay.com/users/1smr1-4646356/?utm_source=link-attribution&utm_medium=referral&utm_campaign=image&utm_content=2970825) from [Pixabay](https://pixabay.com/?utm_source=link-attribution&utm_medium=referral&utm_campaign=image&utm_content=2970825).

data/docs/index.md

@@ -0,0 +1,21 @@
+---
+layout: default
+title: Home
+nav_order: 1
+permalink: /
+---
+
+# Factories over fixtures
+{: .fs-9 }
+
+
+FakerMaker is a simple factory builder so you can throw away your fixtures and generate test data instead.
+{: .fs-6 .fw-300 }
+
+---
+
+Sometimes you need generate data; something testers need to do a lot. Often, a bunch of fixtures will be built by hand, carefully maintained and curated, until the API or schema or something changes and all the fixtures need to be pruned before the tests pass again. This drives testers into building fixtures which individually cover lots of acceptance critera just so that they can drive down the number of them they have to maintain until the fixtures don't resemble anything like realistic criteria.
+
+If you're testing a Rails application, you can use the awesome [FactoryBot](https://github.com/thoughtbot/factory_bot) to generate faked model instances but what if you're not using Rails or you don't have model classes or you're testing an API? This is what Faker Maker aims to help with.
+
+It is designed to resemble the Factory Bot gem but without needing an existing class definition to back its object 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).