enumbler 0.3.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd47cb4ab769babc898e8886bd974708ecf3f9e0a476b0a7c66218a27be01507
-  data.tar.gz: e7933176d827c42b4bfe3aff27ec7e1eb7e382cffe00ba3bf0b808394d54a6d0
+  metadata.gz: c41d00aedb09317c1c7d21627484d57e9d1d8f4f60e51370d56af7481e806fde
+  data.tar.gz: 5187426aefcb06364f1941bbf62932817800de1748646fb658c901afa58d1d6a
 SHA512:
-  metadata.gz: a2c1bab1e7db06447452132d15da099fd0e865602a9f35663ee86abdf242efb596ca156df2a105846072aefbe43cadf4351d7c0b9c9bee71453b1dd62c704e1a
-  data.tar.gz: 03e911879677654e64eec1f7545c6de25faf44cab021b33f81d48335a9c2048410a6bd389d13b5f8ed643eef98d16f4432454cff5612b5417dbfba12143674f9
+  metadata.gz: 64131fd59a8bd70b1897e554b266af9308378036e4d93817b50b95b0cb76bcc0d59c29153a7ccc42d5df1d556c4b3f4538a7499bb81b73c9f45e26823d1e5a30
+  data.tar.gz: 36789800d5e024417b10c872aadae7facaeb03691b289de8da0b5439ecc4c57153db5b4625255e855d39d402e0a086ac3b5d8585134d675684c768a697a93e16

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    enumbler (0.3.1)
+    enumbler (0.4.0)
       activerecord (~> 6.0.2)
       activesupport (~> 6.0.2)
 

data/README.md

@@ -2,15 +2,30 @@
 
 `Enums` are terrific, but they lack integrity.  Enumbler! The _enum enabler_!  The goal is to allow one to maintain a true foreign_key database driven relationship that also behaves a little bit like an `enum`.  Best of both worlds?  We hope so.
 
+## Installation
 
-## Example
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'enumbler'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install enumbler
+
+## Usage
 
 Suppose you have a `House` and you want to add some `colors` to the house.  You are tempted to use an `enum` but the `Enumbler` is calling!
 
 ```ruby
 ActiveRecord::Schema.define do
   create_table :colors|t|
-    t.string :label, null: false
+    t.string :label, null: false, index: { unique: true }
   end
 
   create_table :houses|t|
@@ -52,25 +67,28 @@ house.not_black?
 House.color(:black) # => [house]
 ```
 
-## Installation
+### Use a column other than `label`
 
-Add this line to your application's Gemfile:
+By default, the Enumbler expects a table in the database with a column `label`.  However, you can change this to another underlying column name.  Note that the enumbler still treats it as a `label` column; however it will be saved to the correct place in the database.
 
 ```ruby
-gem 'enumbler'
-```
-
-And then execute:
-
-    $ bundle install
-
-Or install it yourself as:
+ActiveRecord::Schema.define do
+  create_table :feelings, force: true do |t|
+    t.string :emotion, null: false, index: { unique: true }
+  end
+end
 
-    $ gem install enumbler
+class Feeling < ApplicationRecord
+  # @!parse extend Enumbler::Enabler::ClassMethods
+  include Enumbler::Enabler
 
-## Usage
+  enumbler_label_column_name :emotion
 
-TODO: Write usage instructions here
+  enumble :sad, 1
+  enumble :happy, 2
+  enumble :verklempt, 3, label: 'overcome with emotion'
+end
+```
 
 ## Development
 

data/lib/enumbler/enabler.rb

@@ -34,7 +34,7 @@ module Enumbler
       #
       #   # in your migration
       #   create_table :colors, force: true do |t|
-      #     t.string :label, null: false
+      #     t.string :label, null: false, index: { unique: true }
       #   end
       #
       #   class Color < ApplicationRecord
@@ -60,8 +60,9 @@ module Enumbler
       def enumble(enum, id, label: nil, **options)
         @enumbles ||= []
         @enumbled_model = self
+        @enumbler_label_column_name ||= :label
 
-        enumble = Enumble.new(enum, id, label: label, **options)
+        enumble = Enumble.new(enum, id, label: label, label_column_name: @enumbler_label_column_name, **options)
 
         if @enumbles.include?(enumble)
           raise Error, "You cannot add the same Enumble twice! Attempted to add: #{enum}, #{id}."
@@ -72,6 +73,30 @@ module Enumbler
         @enumbles << enumble
       end
 
+      # By default, the Enumbler is expecting a table with an underlying column
+      # named `label` that represents the enum in the database.  You can change
+      # this by calling `enumber_label_column_name` before you `enumble`!
+      #
+      #   ActiveRecord::Schema.define do
+      #     create_table :feelings, force: true do |t|
+      #       t.string :emotion, null: false, index: { unique: true }
+      #     end
+      #   end
+      #
+      #   class Feeling < ApplicationRecord
+      #     # @!parse extend Enumbler::Enabler::ClassMethods
+      #     include Enumbler::Enabler
+      #
+      #     enumbler_label_column_name :emotion
+      #
+      #     enumble :sad, 1
+      #     enumble :happy, 2
+      #     enumble :verklempt, 3, label: 'overcome with emotion'
+      #   end
+      def enumbler_label_column_name(label_column_name)
+        @enumbler_label_column_name = label_column_name
+      end
+
       # Return the record id for a given argument.  Can accept an Integer, a
       # Symbol, or an instance of Enumbled model.  This lookup is a database-free
       # lookup.

data/lib/enumbler/enumble.rb

@@ -3,12 +3,13 @@
 module Enumbler
   # Class that holds each row of Enumble data.
   class Enumble
-    attr_reader :id, :enum, :label, :options
+    attr_reader :id, :enum, :label, :label_column_name, :options
 
-    def initialize(enum, id, label: nil, **options)
+    def initialize(enum, id, label: nil, label_column_name: :label, **options)
       @id = id
       @enum = enum
       @label = label || enum.to_s.dasherize
+      @label_column_name = label_column_name
       @options = options
     end
 
@@ -20,7 +21,7 @@ module Enumbler
     def attributes
       {
         id: id,
-        label: label,
+        label_column_name => label,
       }
     end
 

data/lib/enumbler/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Enumbler
-  VERSION = '0.3.1'
+  VERSION = '0.4.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: enumbler
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Damon Timm
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-04-29 00:00:00.000000000 Z
+date: 2020-05-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord