faker_maker 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '085b4651f6fd8681a1544f7fcc1c3ec05709f2709c701268c16efaf09b4ce06d'
-  data.tar.gz: bdabf0075d7453c39a24554c659e859781c15b1fc7880b5115134e38438fe756
+  metadata.gz: 6355e061188d88ab10d97dae93595abccbf2a73346b6220c265c9241198f93ba
+  data.tar.gz: 487700e0d8e88f4fb69d00796bb4d644263e7c91af91eea188caa7eaf82861c5
 SHA512:
-  metadata.gz: 19b799c28b8409657e9f8abe28eaaa6dabf6caefc66055e894c843994a9a8b1f66aedc35a356a0da5e620bd8d12cd25dc5cf077393e4dea80f17b9d1cb048c48
-  data.tar.gz: 3a288478c6afff7c15a3246bc445fcad61a93679fbe345503bcb782d254eb08ea72a825b794699dfb18dad7a1b0522ee5d6a5beb24452b476bd8f365a6449c67
+  metadata.gz: e2e50d6ffa61e8164163d2157a65d8a3b93b24e442028e0e04951b25f8e298693bd3a8c6ff3ff948442c38c972f427ec05017020dd120b0cfeefdbb02ebd82b8
+  data.tar.gz: 4c1ae45972c019f0929b1c0337b20ebe4f92ecaa040811f515934d50ce38e826956c994a3043d1f8a27928921930a32980d4bff29fceffbb0c8a7a82f1d4ebd6

data/.github/dependabot.yml

@@ -0,0 +1,7 @@
+version: 2
+updates:
+- package-ecosystem: bundler
+  directory: "/"
+  schedule:
+    interval: daily
+  open-pull-requests-limit: 10

data/.rubocop.yml

@@ -43,4 +43,7 @@ Metrics/MethodLength:
   Enabled: false
 
 Lint/MissingSuper:
-  Enabled: false
+  Enabled: false
+
+AllCops:
+  NewCops: enable

data/Guardfile

@@ -17,7 +17,7 @@
 #
 # 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
+# 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'

data/docs/usage/audit_logs.md

@@ -0,0 +1,47 @@
+---
+layout: default
+title: Audit (History) Logs
+parent: Usage
+nav_order: 10
+---
+
+_(since 1.3.0)_
+
+# Audit logs
+
+It might be useful to collect the history of all the fakes generated by your factories. FakerMaker allows you to stream (or write to a file) all the instances it builds for you. This is optional and disabled by default.
+
+## Enable logging
+
+By default audit logging is disabled. The default output stream is `STDOUT`. The output target can either be an object that responds to `puts`, or be a string which will be interpreted as a file location to use to write to. If file path string is used, it will be opened in 'append' mode.
+
+```ruby
+FakerMaker.configure do |config|
+  config.audit = true
+  config.audit_destination = '/tmp/faker_maker_audit_logs'
+end
+```
+
+## Audit streams
+
+Immediately after each object is built and after the post-build hooks have completed, the instance details will be logged in line-delimited JSON (JSONL), to the stream or file. Each line is contained in an envelope containing the following metadata:
+
+* The timestamp at the time of logging
+* The name of factory
+* The class name of the object the factory instantiated
+
+For example, given the factory:
+
+```ruby
+FakerMaker.factory :user do 
+  name {'Patsy Stone'}
+  email {'patsy@fabulous.co.uk'}
+  admin {false}
+end
+```
+
+The audit log, on build, would look like:
+
+```
+{"timestamp":"2023-05-15T15:46:30+01:00","factory":"user","class":"User","body":{"name":"Patsy Stone","email":"patsy@fabulous.co.uk","admin":false}}
+```

data/faker_maker.gemspec

@@ -41,20 +41,18 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_dependency 'activesupport', '>= 5.2', '< 7'
+  spec.add_dependency 'activesupport', '>= 5.2', '< 8'
 
   spec.add_development_dependency 'bundler',       '~> 2.0'
   spec.add_development_dependency 'faker',         '~> 2.1'
   spec.add_development_dependency 'guard',         '~> 2.16'
-  spec.add_development_dependency 'guard-bundler', '~> 2.2'
+  spec.add_development_dependency 'guard-bundler', '~> 3.0'
   spec.add_development_dependency 'guard-rubocop', '~> 1.3'
   spec.add_development_dependency 'guard-rspec',   '~> 4.7'
   spec.add_development_dependency 'pry',           '~> 0.12'
   spec.add_development_dependency 'rake',          '~> 13.0'
   spec.add_development_dependency 'rspec',         '~> 3.8'
   spec.add_development_dependency 'rubocop',       '~> 1.0'
-  spec.add_development_dependency 'simplecov',     '~> 0.16'
-  spec.add_development_dependency 'coveralls',     '~> 0.8'
 
-  spec.required_ruby_version = '>= 2.6'
+  spec.required_ruby_version = '>= 3.0'
 end

data/lib/faker_maker/attribute.rb

@@ -8,7 +8,7 @@ module FakerMaker
     def initialize( name, block = nil, options = {} )
       assert_valid_options options
       @name = name
-      @block = block || proc { nil }
+      @block = block || proc {}
       @cardinality = options[:has] || 1
       @translation = options[:json]
       @omit = *options[:omit]
@@ -34,7 +34,7 @@ module FakerMaker
     def omit?( value )
       case value
       when nil
-        @omit.include? :nil
+        @omit.include?( :nil ) || @omit.include?( nil )
       when '', [], {}
         @omit.include? :empty
       else

data/lib/faker_maker/auditable.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+# FakerMaker module for generating Fakes
+module FakerMaker
+  # Mix-in module which provides the auditable functionality
+  module Auditable
+    def audit(instance)
+      envelope = audit_envelope(class: instance.class.name, body: instance.as_json)
+      audit_stream.puts(JSON.generate(envelope))
+      audit_stream.flush if audit_stream.respond_to?(:flush)
+    rescue StandardError => e
+      warn "FakerMaker Warning: #{e.class}: \"#{e.message}\" occurred. FakerMaker will disable audit logging. " \
+           'Further warnings supressed.'
+      FakerMaker.configuration.audit = false
+    end
+
+    private
+
+    def audit_stream
+      destination = FakerMaker.configuration.audit_destination
+      return destination if destination.respond_to?(:puts)
+
+      file_destination = File.new(destination, 'a')
+      FakerMaker.configuration.audit_destination = file_destination
+    end
+
+    def audit_envelope(**overrides)
+      {
+        timestamp: DateTime.now.iso8601,
+        factory: name.to_s,
+        **overrides
+      }
+    end
+  end
+end

data/lib/faker_maker/configuration.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+# FakerMaker module for generating Fakes
+module FakerMaker
+  # Configuration class, holds all the config options for FM
+  class Configuration
+    attr_writer :audit
+    attr_accessor :audit_destination
+
+    def initialize
+      @audit = false
+      @audit_destination = $stdout
+    end
+
+    def audit?
+      @audit
+    end
+  end
+
+  # Mixin to provide configuraton methods to an extending or implementing class
+  module Configurable
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configuration=(config)
+      @configuration = config
+    end
+
+    def configure
+      yield(configuration) if block_given?
+    end
+  end
+end

data/lib/faker_maker/factory.rb

@@ -4,6 +4,7 @@
 module FakerMaker
   # Factories construct instances of a fake
   class Factory
+    include Auditable
     attr_reader :name, :class_name, :parent
 
     def initialize( name, options = {} )
@@ -48,6 +49,7 @@ module FakerMaker
       populate_instance instance, attributes
       yield instance if block_given?
       after_build if respond_to? :after_build
+      audit(@instance) if FakerMaker.configuration.audit?
       instance
     end
 
@@ -103,7 +105,7 @@ module FakerMaker
     end
 
     def find_attribute( name = '' )
-      attributes.filter { |a| [a.name, a.translation, @naming_strategy&.name(name)].include? name }.first
+      attributes.filter { |a| [a.name, a.translation, @naming_strategy&.name(a.name)].include? name }.first
     end
 
     protected

data/lib/faker_maker/lifecycle_hooks.rb

@@ -4,12 +4,12 @@ module FakerMaker
   module LifecycleHooks
     # Lifecycle hooks which can be called during the building of an instance
     module DefinitionProxy
-      def before_build(&block)
-        @factory.define_singleton_method(:before_build) { yield(self.instance, self) }
+      def before_build
+        @factory.define_singleton_method(:before_build) { yield(instance, self) }
       end
 
-      def after_build(&block)
-        @factory.define_singleton_method(:after_build) { yield(self.instance, self) }
+      def after_build
+        @factory.define_singleton_method(:after_build) { yield(instance, self) }
       end
     end
   end

data/lib/faker_maker/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module FakerMaker
-  VERSION = '1.2.0'
+  VERSION = '1.3.0'
 end

data/lib/faker_maker.rb

@@ -1,11 +1,15 @@
 # frozen_string_literal: true
 
+require 'time'
+
 require 'active_support'
 require 'active_support/core_ext/hash'
 require 'active_support/core_ext/object/json'
 require 'active_support/core_ext/string'
 require 'faker_maker/attribute'
+require 'faker_maker/auditable'
 require 'faker_maker/base'
+require 'faker_maker/configuration'
 require 'faker_maker/lifecycle_hooks'
 require 'faker_maker/definition_proxy'
 require 'faker_maker/factory'
@@ -18,6 +22,7 @@ require 'faker_maker/version'
 # FakerMaker module for generating Fakes
 module FakerMaker
   extend FakerMaker::Base
+  extend FakerMaker::Configurable
 
   class Error < StandardError; end
   class NoSuchFactoryError < StandardError; end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: faker_maker
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Nigel Brookes-Thomas
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-04-14 00:00:00.000000000 Z
+date: 2023-05-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -19,7 +19,7 @@ dependencies:
         version: '5.2'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '7'
+        version: '8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '5.2'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '7'
+        version: '8'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -78,14 +78,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.2'
+        version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.2'
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: guard-rubocop
   requirement: !ruby/object:Gem::Requirement
@@ -170,34 +170,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: simplecov
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.16'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.16'
-- !ruby/object:Gem::Dependency
-  name: coveralls
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.8'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.8'
 description: FakerMaker is a simple factory builder so you can throw away your fixtures
   and generate test data instead.
 email:
@@ -206,8 +178,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".circleci/config.yml"
-- ".coveralls.yml"
+- ".github/dependabot.yml"
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
@@ -229,6 +200,7 @@ files:
 - docs/installation.md
 - docs/logo.png
 - docs/usage/arrays.md
+- docs/usage/audit_logs.md
 - docs/usage/building_instances.md
 - docs/usage/dependencies.md
 - docs/usage/destroying_factories.md
@@ -242,7 +214,9 @@ files:
 - img/unipug.svg
 - lib/faker_maker.rb
 - lib/faker_maker/attribute.rb
+- lib/faker_maker/auditable.rb
 - lib/faker_maker/base.rb
+- lib/faker_maker/configuration.rb
 - lib/faker_maker/definition_proxy.rb
 - lib/faker_maker/factory.rb
 - lib/faker_maker/lifecycle_hooks.rb
@@ -265,14 +239,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.6'
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
 summary: FakerMaker bakes fakes.

data/.circleci/config.yml

@@ -1,13 +0,0 @@
-# Use the latest 2.1 version of CircleCI pipeline processing engine, see https://circleci.com/docs/2.0/configuration-reference/
-version: 2.1
-
-jobs:
-  build:
-    docker:
-      - image: circleci/ruby:2.6.3-stretch-node
-    steps:
-      - checkout
-      - run: gem update --system
-      - run: gem install bundler
-      - run: bundle install
-      - run: bundle exec rake spec

data/.coveralls.yml

@@ -1 +0,0 @@
-repo_token: K7czIqoKhrE9BRBk1ubEToyJkLgTk0frJ