anonymous_active_record 1.0.3 → 1.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b0c82662e8af866d1743315b3a68a9b76fc6658b2a22ed48642b307c204ad067
-  data.tar.gz: 74a221bcf95cb888be5729aef71838919835fb2b20bef8caa0338ab619484542
+  metadata.gz: 122443ea21e04dc844dfc547f12dacc18fa889ebf91b988b580f5c32cd63f547
+  data.tar.gz: 9948435b6b32dd03ad00ff89c1f0740da2ae5f74ebd3b87a2851e48f94ee59d8
 SHA512:
-  metadata.gz: 6737111961bdc7ec78a05bf51cc7c16f7a6f08569a3f96d4f64bc993f9b80cdf1f57c84fa4736ed06b750b92e9b97176ae12a4800dd287d6b19013a1ec0505f1
-  data.tar.gz: 2cb6992f6a210d06d13e5fd4c4a8dacd79a8c3e38b5c1dff04ccb014f3b9c2c07375217417ad743df8c0b65f5cb0f6a888ee65c900d3a3cf9ed8457a8029f832
+  metadata.gz: fd9b89d81ed386ee4e5b988d127bd266bcd546d3c1f5f242da5f2ea4af14be5a5dc307125a87859ee7066033db0c804d4d76f44871f9819167ff2d8eb688e414
+  data.tar.gz: 53f79696142eb5df7bb52470a651caafe1c98170ffe849f324861b17601eeb564ef7764488af91bb430222c9b3579779158564eeb0835a20017b3f7024f6790b

data/CODE_OF_CONDUCT.md

@@ -1,74 +1,133 @@
+
 # Contributor Covenant Code of Conduct
 
 ## Our Pledge
 
-In the interest of fostering an open and welcoming environment, we as
-contributors and maintainers pledge to making participation in our project and
-our community a harassment-free experience for everyone, regardless of age, body
-size, disability, ethnicity, gender identity and expression, level of experience,
-nationality, personal appearance, race, religion, or sexual identity and
-orientation.
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
 
 ## Our Standards
 
-Examples of behavior that contributes to creating a positive environment
-include:
+Examples of behavior that contributes to a positive environment for our
+community include:
 
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
 
-Examples of unacceptable behavior by participants include:
+Examples of unacceptable behavior include:
 
-* The use of sexualized language or imagery and unwelcome sexual attention or
-advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
 * Public or private harassment
-* Publishing others' private information, such as a physical or electronic
-  address, without explicit permission
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
 * Other conduct which could reasonably be considered inappropriate in a
   professional setting
 
-## Our Responsibilities
+## Enforcement Responsibilities
 
-Project maintainers are responsible for clarifying the standards of acceptable
-behavior and are expected to take appropriate and fair corrective action in
-response to any instances of unacceptable behavior.
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
 
-Project maintainers have the right and responsibility to remove, edit, or
-reject comments, commits, code, wiki edits, issues, and other contributions
-that are not aligned to this Code of Conduct, or to ban temporarily or
-permanently any contributor for other behaviors that they deem inappropriate,
-threatening, offensive, or harmful.
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
 
 ## Scope
 
-This Code of Conduct applies both within project spaces and in public spaces
-when an individual is representing the project or its community. Examples of
-representing a project or community include using an official project e-mail
-address, posting via an official social media account, or acting as an appointed
-representative at an online or offline event. Representation of a project may be
-further defined and clarified by project maintainers.
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
 
 ## Enforcement
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at peter.boling@gmail.com. All
-complaints will be reviewed and investigated and will result in a response that
-is deemed necessary and appropriate to the circumstances. The project team is
-obligated to maintain confidentiality with regard to the reporter of an incident.
-Further details of specific enforcement policies may be posted separately.
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
 
-Project maintainers who do not follow or enforce the Code of Conduct in good
-faith may face temporary or permanent repercussions as determined by other
-members of the project's leadership.
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior,  harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
 
 ## Attribution
 
-This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
-available at [http://contributor-covenant.org/version/1/4][version]
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+[https://www.contributor-covenant.org/version/2/0/code_of_conduct.html][v2.0].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available
+at [https://www.contributor-covenant.org/translations][translations].
 
-[homepage]: http://contributor-covenant.org
-[version]: http://contributor-covenant.org/version/1/4/
+[homepage]: https://www.contributor-covenant.org
+[v2.0]: https://www.contributor-covenant.org/version/2/0/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

data/README.md

@@ -11,14 +11,14 @@ Warning: Use of this gem is a **security risk**, due to the use of Ruby's `eval`
 | download rank           |  [![Downloads Today](https://img.shields.io/gem/rd/anonymous_active_record.svg)](https://github.com/pboling/anonymous_active_record) |
 | version                 |  [![Version](https://img.shields.io/gem/v/anonymous_active_record.svg)](https://rubygems.org/gems/anonymous_active_record) |
 | dependencies            |  [![Depfu](https://badges.depfu.com/badges/272ce0df3bc6df5cbea9354e2c3b65af/count.svg)](https://depfu.com/github/pboling/anonymous_active_record?project_id=5614) |
-| continuous integration  |  [![Build Status](https://travis-ci.org/pboling/anonymous_active_record.svg?branch=master)](https://travis-ci.org/pboling/anonymous_active_record) |
+| continuous integration  |  [![Build Status](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Fpboling%2Fanonymous_active_record%2Fbadge&style=flat)](https://actions-badge.atrox.dev/pboling/anonymous_active_record/goto) |
 | test coverage           |  [![Test Coverage](https://api.codeclimate.com/v1/badges/fe504d4ab2fb77cecf7d/test_coverage)](https://codeclimate.com/github/pboling/anonymous_active_record/test_coverage) |
 | maintainability         |  [![Maintainability](https://api.codeclimate.com/v1/badges/fe504d4ab2fb77cecf7d/maintainability)](https://codeclimate.com/github/pboling/anonymous_active_record/maintainability) |
 | code triage             |  [![Open Source Helpers](https://www.codetriage.com/pboling/anonymous_active_record/badges/users.svg)](https://www.codetriage.com/pboling/anonymous_active_record) |
 | FOSSA Licenses | [![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fpboling%2Fanonymous_active_record.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2Fpboling%2Fanonymous_active_record?ref=badge_shield) |
 | homepage                |  [on Github.com][homepage], [on Railsbling.com][blogpage] |
 | documentation           |  [on RDoc.info][documentation] |
-| Spread ~♡ⓛⓞⓥⓔ♡~      |  [🌍 🌎 🌏](https://about.me/peter.boling), [🍚](https://www.crowdrise.com/helprefugeeswithhopefortomorrowliberia/fundraiser/peterboling), [➕](https://plus.google.com/+PeterBoling/posts), [👼](https://angel.co/peter-boling), [🐛](https://www.topcoder.com/members/pboling/), [:shipit:](http://coderwall.com/pboling), [![Tweet Peter](https://img.shields.io/twitter/follow/galtzo.svg?style=social&label=Follow)](http://twitter.com/galtzo) |
+| Spread ~♡ⓛⓞⓥⓔ♡~      |  [🌏](https://about.me/peter.boling), [👼](https://angel.co/peter-boling), [:shipit:](http://coderwall.com/pboling), [![Tweet Peter](https://img.shields.io/twitter/follow/galtzo.svg?style=social&label=Follow)](http://twitter.com/galtzo), [🌹](https://nationalprogressiveparty.org) |
 
 ## Installation
 
@@ -36,6 +36,11 @@ Or install it yourself as:
 
     $ gem install anonymous_active_record
 
+## Compatibility
+
+This gem is compatible with, as of Feb 2021:
+• Ruby 2.4, 2.5, 2.6, 2.7, 3.0, ruby-head
+
 ## Usage
 
 Require the library in your `spec_helper` or other test suite boot file.
@@ -49,7 +54,7 @@ Let's say you want to write specs for a module, `HasBalloon`, which provides a m
 ```ruby
 module HasBalloon
   def has_balloon?
-    name == 'Spot' ? true : false # only Spot has a balloon
+    name == 'Spot' # only Spot has a balloon
   end
 end
 ```
@@ -57,61 +62,62 @@ end
 This won't work [(really!)](https://github.com/rails/rails/issues/8934):
 
 ```ruby
-  let(:ar_with_balloon) do
-    Class.new(ActiveRecord::Base) do
-      attr_accessor :name
-      include HasBalloon
-      def flowery_name
-        "#{b_f}#{name}#{b_f}"
-      end
-      def b_f
-        has_balloon? ? '🎈' : '🌸'
-      end
+let(:ar_with_balloon) do
+  Class.new(ActiveRecord::Base) do
+    attr_accessor :name
+
+    include HasBalloon
+    def flowery_name
+      "#{b_f}#{name}#{b_f}"
+    end
+    def b_f
+      has_balloon? ? '🎈' : '🌸'
     end
   end
+end
 ```
 
 So do this instead:
 
 ```ruby
-  let(:ar_with_balloon) do
-    AnonymousActiveRecord.generate(columns: ['name']) do
-      include HasBalloon
-      def flowery_name
-        "#{b_f}#{name}#{b_f}"
-      end
-      def b_f
-        has_balloon? ? '🎈' : '🌸'
-      end
+let(:ar_with_balloon) do
+  AnonymousActiveRecord.generate(columns: ['name']) do
+    include HasBalloon
+    def flowery_name
+      "#{b_f}#{name}#{b_f}"
+    end
+    def b_f
+      has_balloon? ? '🎈' : '🌸'
     end
   end
-  it 'can test the module' do
-    expect(ar_with_balloon.new(name: 'Spot').flowery_name).to eq('🎈Spot🎈')
-    expect(ar_with_balloon.new(name: 'Not Spot').flowery_name).to eq('🌸Not Spot🌸')
-  end
+end
+it 'can test the module' do
+  expect(ar_with_balloon.new(name: 'Spot').flowery_name).to eq('🎈Spot🎈')
+  expect(ar_with_balloon.new(name: 'Not Spot').flowery_name).to eq('🌸Not Spot🌸')
+end
 ```
 
 ### Generate Options
 
 ```ruby
 AnonymousActiveRecord.generate(
-    table_name: 'a_table_name', 
-        # if table_name is not set klass_basename will be used to derive a unique random table_name
-        # default is a unique random table name
-    klass_basename: 'anons', # is default
-    columns: ['name'], 
-        # columns default is [], 
-        # meaning class will have ['id', 'created_at', 'updated_at'], as the AR defaults
-        # Optionally provide an array of hashes and thereby designate column type:
-        # [{name: 'name', type: 'string'}, {name: 'baked_at', type: 'time'}]
-    timestamps: true, # is default
-    indexes: [{columns: ['name'], unique: true}],
-        # indexes default is [], 
-        # meaning class will have no indexes, as the AR defaults
-        # Optionally provide an array of hashes of index options (similar to those used in Rails migrations):
-        # [{columns: ['name'], unique: true}, {columns: ['baked_at']}]
-    connection_params: { adapter: 'sqlite3', encoding: 'utf8', database: ':memory:' } # is default
-) do
+  table_name: 'a_table_name',
+      # if table_name is not set klass_basename will be used to derive a unique random table_name
+      # default is a unique random table name
+  klass_basename: 'anons', # is default
+  columns: ['name'],
+      # columns default is [],
+      # meaning class will have ['id', 'created_at', 'updated_at'], as the AR defaults
+      # Optionally provide an array of hashes and thereby designate column type:
+      # [{name: 'name', type: 'string'}, {name: 'baked_at', type: 'time'}]
+  timestamps: true, # is default
+  indexes: [{ columns: ['name'], unique: true }],
+      # indexes default is [],
+      # meaning class will have no indexes, as the AR defaults
+      # Optionally provide an array of hashes of index options (similar to those used in Rails migrations):
+      # [{columns: ['name'], unique: true}, {columns: ['baked_at']}]
+  connection_params: { adapter: 'sqlite3', encoding: 'utf8', database: ':memory:' } # is default
+  ) do
    # code which becomes part of the class definition
 end
 ```
@@ -122,10 +128,10 @@ The block is optional.
 
 ```ruby
 AnonymousActiveRecord.factory(
-    source_data: [{name: 'Phil'}, {name: 'Vickie'}],
+  source_data: [{ name: 'Phil' }, { name: 'Vickie' }]
         # Array of hashes, where each hash represents a record that will be created
     # ... The rest of the options are the same as for generate, see above.
-) do
+  ) do
   # same as for generate, see above.
 end
 ```
@@ -170,7 +176,7 @@ spec.add_dependency 'anonymous_active_record', '~> 0.0'
 
 * Copyright (c) 2018 [Peter H. Boling][peterboling] of [Rails Bling][railsbling]
 
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) 
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
 
 [![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fpboling%2Fanonymous_active_record.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2Fpboling%2Fanonymous_active_record?ref=badge_large)
 

data/lib/anonymous_active_record.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'active_record'
 
 require 'anonymous_active_record/version'
@@ -40,22 +42,31 @@ module AnonymousActiveRecord
     encoding: 'utf8',
     database: ':memory:'
   }.freeze
+  DEFAULT_PARENT_KLASS = 'ActiveRecord::Base'
 
   # Defines a pseudo anonymous class in a particular namespace of your choosing.
-  def generate(table_name: nil, klass_namespaces: [], klass_basename: nil, columns: [], indexes: [], timestamps: true, connection_params: DEFAULT_CONNECTION_PARAMS, &block)
-    gen = AnonymousActiveRecord::Generator.new(table_name, klass_namespaces, klass_basename)
+  def generate(table_name: nil, klass_namespaces: [], klass_basename: nil, columns: [], indexes: [], timestamps: true, parent_klass: DEFAULT_PARENT_KLASS, connection_params: DEFAULT_CONNECTION_PARAMS, &block)
+    gen = AnonymousActiveRecord::Generator.new(table_name, klass_namespaces, klass_basename, parent_klass)
     klass = gen.generate(&block)
     connection_params = YAML.load_file(connection_params) if connection_params.is_a?(String)
     klass.establish_connection(connection_params.dup)
-    klass.connection.create_table gen.table_name do |t|
+    klass.connection.create_table(gen.table_name) do |t|
       columns.each do |col|
         if col.is_a?(Hash)
           # :name and :type are required at minimum
           name = col.delete(:name)
           type = col.delete(:type)
-          t.column(name, type, col)
+          t.column(name, type, **col)
         elsif col.is_a?(Array)
-          t.column col[0], col[-1] || :string
+          if col[-1].is_a?(Hash)
+            if col[-1].present?
+              t.column col[0], **col[-1]
+            else
+              t.column col[0], :string
+            end
+          else
+            t.column col[0], col[-1] || :string
+          end
         else
           t.column col, :string
         end
@@ -63,10 +74,12 @@ module AnonymousActiveRecord
       indexes.each do |idx_options|
         if idx_options.is_a?(Hash)
           column_names = idx_options.delete(:columns)
-          t.index column_names, idx_options
+          t.index column_names, **idx_options
         elsif idx_options.is_a?(Array)
           if idx_options.length == 1
             t.index idx_options[0]
+          elsif idx_options[-1].is_a?(Hash)
+            t.index idx_options[0], **idx_options[-1]
           else
             t.index idx_options[0], idx_options[-1]
           end
@@ -80,21 +93,53 @@ module AnonymousActiveRecord
   end
 
   # Initializes instances of a pseudo anonymous class in a particular namespace of your choosing.
-  def factory(source_data: [], table_name: nil, klass_namespaces: [], klass_basename: nil, columns: [], indexes: [], timestamps: true, connection_params: DEFAULT_CONNECTION_PARAMS, &block)
-    factory = _factory(source_data: source_data, table_name: table_name, klass_namespaces: klass_namespaces, klass_basename: klass_basename, columns: columns, indexes: indexes, timestamps: timestamps, connection_params: connection_params, &block)
+  def factory(source_data: [], table_name: nil, klass_namespaces: [], klass_basename: nil, columns: [], indexes: [], timestamps: true, parent_klass: DEFAULT_PARENT_KLASS, connection_params: DEFAULT_CONNECTION_PARAMS, &block)
+    factory = _factory(
+      source_data: source_data,
+      table_name: table_name,
+      klass_namespaces: klass_namespaces,
+      klass_basename: klass_basename,
+      columns: columns,
+      indexes: indexes,
+      timestamps: timestamps,
+      parent_klass: parent_klass,
+      connection_params: connection_params,
+      &block
+    )
     factory.run
   end
 
   # Initializes instances of a pseudo anonymous class in a particular namespace of your choosing.
-  def factory!(source_data: [], table_name: nil, klass_namespaces: [], klass_basename: nil, columns: [], indexes: [], timestamps: true, connection_params: DEFAULT_CONNECTION_PARAMS, &block)
-    factory = _factory(source_data: source_data, table_name: table_name, klass_namespaces: klass_namespaces, klass_basename: klass_basename, columns: columns, indexes: indexes, timestamps: timestamps, connection_params: connection_params, &block)
+  def factory!(source_data: [], table_name: nil, klass_namespaces: [], klass_basename: nil, columns: [], indexes: [], timestamps: true, parent_klass: DEFAULT_PARENT_KLASS, connection_params: DEFAULT_CONNECTION_PARAMS, &block)
+    factory = _factory(
+      source_data: source_data,
+      table_name: table_name,
+      klass_namespaces: klass_namespaces,
+      klass_basename: klass_basename,
+      columns: columns,
+      indexes: indexes,
+      timestamps: timestamps,
+      parent_klass: parent_klass,
+      connection_params: connection_params,
+      &block
+    )
     factory.run!
   end
 
   private
 
-  def _factory(source_data: [], table_name: nil, klass_namespaces: [], klass_basename: nil, columns: [], indexes: [], timestamps: true, connection_params: DEFAULT_CONNECTION_PARAMS, &block)
-    klass = generate(table_name: table_name, klass_namespaces: klass_namespaces, klass_basename: klass_basename, columns: columns, timestamps: timestamps, indexes: indexes, connection_params: connection_params, &block)
+  def _factory(source_data: [], table_name: nil, klass_namespaces: [], klass_basename: nil, columns: [], indexes: [], timestamps: true, parent_klass: DEFAULT_PARENT_KLASS, connection_params: DEFAULT_CONNECTION_PARAMS, &block)
+    klass = generate(
+      table_name: table_name,
+      klass_namespaces: klass_namespaces,
+      klass_basename: klass_basename,
+      columns: columns,
+      timestamps: timestamps,
+      parent_klass: parent_klass,
+      indexes: indexes,
+      connection_params: connection_params,
+      &block
+    )
     AnonymousActiveRecord::Factory.new(source_data, klass)
   end