enum_fields 0.1.2 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bc607b206f6498ca75d71fc583206138080cf768b849ddbe690789281a21921e
-  data.tar.gz: da78b379dd988c85daa54c5f29f9562ee03cf86a143eb360f22ccae14547d8a7
+  metadata.gz: 52a056fc46a1cb6934d9dc11ab2717f4babb8b32ee2ccf6a85ab97b147517152
+  data.tar.gz: b1d671075bbebd910032795752b42da8a94123c7f245f8c7f4cfb99a874eae1c
 SHA512:
-  metadata.gz: e0494cb5c0d8d4afc5ed527fd5c69fd67c1074f631ddaac73896efd7a7553c02f01e6069300356b7a7fc62f960c56e44d8860563ef0847d1bca6588834b423c2
-  data.tar.gz: 2b9fef8b1ee2af4fd06a2c6fd36c86655fd694502b291968c836452473c61b3ee33f23849a43e4404b87578c4f87451a4081d369ae0cfe7cedf9c8a70b9fa248
+  metadata.gz: 76715e583a3cff76e5cd00da9c88060a0fe38d9d46e8899ba987014483a968ac8a678ac66f3847263021c7851d51e45e709a349fe6650fb369f5d347f8f2e0f6
+  data.tar.gz: 3ffce4b7a7830e2744cc1aed9f80c908646658733eea38ae312188262713b0ac9ef37fe868dd2d1cbc5f0572c1a096aab90d55b467457b0b16875d03d463f0f5

data/README.md

@@ -258,6 +258,114 @@ ticket.priority_metadata[:sla_hours]      # 72
 ticket.priority_metadata[:notify_manager] # false
 ```
 
+### Registry & Standalone Registration
+
+When `enum_field` is used in a model, definitions are automatically registered under a namespace derived from the model class name (e.g., `Campaign` becomes `campaign`).
+
+You can also register definitions directly, outside of models, using the `namespace` DSL:
+
+```ruby
+# config/initializers/enum_fields.rb
+EnumFields.namespace(:basic) do
+  enum_field :priority, {
+    low: {
+      value: "low",
+      label: "Low",
+    },
+    medium: {
+      value: "medium",
+      label: "Medium",
+    },
+    high: {
+      value: "high",
+      label: "High",
+    },
+  }
+
+  enum_field :status, {
+    active: {
+      value: "active",
+      label: "Active",
+    },
+    inactive: {
+      value: "inactive",
+      label: "Inactive",
+    },
+  }
+end
+```
+
+Access the raw registry:
+
+```ruby
+EnumFields.registry
+# => { "basic" => { "priority" => { ... }, "status" => { ... } }, "campaign" => { ... } }
+```
+
+### Catalog
+
+`EnumFields.catalog` returns all registered definitions with namespaces sorted alphabetically, each field's entries as an array of metadata hashes (keys stripped):
+
+```ruby
+EnumFields.catalog
+# => {
+#   "basic" => {
+#     "priority" => [
+#       {
+#         "value" => "low",
+#         "label" => "Low",
+#       },
+#       {
+#         "value" => "medium",
+#         "label" => "Medium",
+#       },
+#       {
+#         "value" => "high",
+#         "label" => "High",
+#       },
+#     ],
+#     "status" => [
+#       {
+#         "value" => "active",
+#         "label" => "Active",
+#       },
+#       {
+#         "value" => "inactive",
+#         "label" => "Inactive",
+#       },
+#     ],
+#   },
+#   "campaign" => {
+#     "stage" => [
+#       {
+#         "value" => "pending",
+#         "label" => "Pending",
+#         "icon" => "clock",
+#         "color" => "yellow",
+#       },
+#       {
+#         "value" => "processing",
+#         "label" => "Processing",
+#         "icon" => "cog",
+#         "color" => "blue",
+#       },
+#       {
+#         "value" => "shipped",
+#         "label" => "Shipped",
+#         "icon" => "truck",
+#         "color" => "green",
+#       },
+#       {
+#         "value" => "delivered",
+#         "label" => "Delivered",
+#         "icon" => "check",
+#         "color" => "green",
+#       },
+#     ],
+#   },
+# }
+```
+
 ## Development
 
 After checking out the repo, run:

data/___release.md

@@ -0,0 +1,9 @@
+Enum Fields
+
+1. Update version.rb
+2. Commit "Bump version to 0.0.X"
+3. `rake release`
+   Even if API error comes, just do:
+4. And then just `gem push pkg/enum_fields-0.0.5.gem`
+
+gem push pkg/enum_fields-0.2.0.gem

data/lib/enum_fields/definition.rb

@@ -37,23 +37,46 @@ module EnumFields
         when Hash
           input.with_indifferent_access
         when Array
-          input.to_h do |value|
-            [value, { value: value }]
-          end.with_indifferent_access
+          build_from_array(input)
         else
           raise InvalidDefinitionsError, "Invalid definitions format: #{input.class}"
         end
       end
 
       output.transform_values do |metadata|
+        metadata = metadata.with_indifferent_access
+
         if metadata.key?(:label)
           metadata
         else
-          metadata.merge(label: metadata[:value])
+          metadata.merge(label: metadata[:value].to_s)
         end
       end
     end
 
+    def build_from_array(input)
+      input.to_h do |element|
+        metadata = normalize_item(element)
+
+        [normalize_key(metadata[:value]), metadata]
+      end.with_indifferent_access
+    end
+
+    def normalize_item(item)
+      if item.is_a?(Hash)
+        item.with_indifferent_access
+      else
+        {
+          value: item,
+          label: item.to_s,
+        }
+      end
+    end
+
+    def normalize_key(value)
+      value.to_s.to_sym
+    end
+
     def valid_hash?(data)
       return false unless data.is_a?(HashWithIndifferentAccess)
       return false unless data.values.all? { |metadata| metadata.key?(:value) }

data/lib/enum_fields/enum_field.rb

@@ -31,11 +31,11 @@ module EnumFields
     private
 
     def register!
-      EnumFields.register(
-        model_class: @model_class,
+      EnumFields.register({
+        namespace: @model_class.name&.underscore || @model_class.object_id.to_s,
         accessor: @accessor,
-        definition: @definition.data
-      )
+        definition: @definition.data,
+      })
     end
 
     def store_definition!

data/lib/enum_fields/namespace.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module EnumFields
+  class Namespace
+    def initialize(namespace)
+      @namespace = namespace
+    end
+
+    def enum_field(accessor, definition = {})
+      EnumFields.register({
+        namespace: @namespace,
+        accessor: accessor,
+        definition: definition,
+      })
+    end
+  end
+end

data/lib/enum_fields/registry.rb

@@ -7,10 +7,19 @@ module EnumFields
       super(@store)
     end
 
-    def register(model_class:, accessor:, definition:)
-      key = model_class.name&.underscore || model_class.object_id.to_s
-      @store[key] ||= {}.with_indifferent_access
-      @store[key][accessor] = definition
+    def register(args = {})
+      namespace = args.fetch(:namespace) { raise ArgumentError, "namespace is required" }
+      accessor = args.fetch(:accessor) { raise ArgumentError, "accessor is required" }
+      definition = args.fetch(:definition, {})
+
+      @store[namespace] ||= {}.with_indifferent_access
+      @store[namespace][accessor] = definition
+    end
+
+    def catalog
+      sort_by { |key, _| key.to_s }.to_h.transform_values do |fields|
+        fields.transform_values(&:values)
+      end
     end
   end
 end

data/lib/enum_fields/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EnumFields
-  VERSION = "0.1.2"
+  VERSION = "0.2.1"
 end

data/lib/enum_fields.rb

@@ -18,6 +18,7 @@ module EnumFields
 
   autoload :Definition
   autoload :EnumField
+  autoload :Namespace
   autoload :Registry
 
   def self.registry
@@ -28,6 +29,14 @@ module EnumFields
     registry.register(...)
   end
 
+  def self.namespace(name, &)
+    Namespace.new(name).instance_eval(&)
+  end
+
+  def self.catalog
+    registry.catalog
+  end
+
   def self.clear_registry!
     @registry = nil
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: enum_fields
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.1
 platform: ruby
 authors:
 - Kinnell Shah
@@ -60,14 +60,15 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- CHANGELOG.md
 - LICENSE
 - README.md
+- ___release.md
 - lib/enum_fields.rb
 - lib/enum_fields/base.rb
 - lib/enum_fields/definition.rb
 - lib/enum_fields/enum_field.rb
 - lib/enum_fields/errors.rb
+- lib/enum_fields/namespace.rb
 - lib/enum_fields/registry.rb
 - lib/enum_fields/version.rb
 homepage: https://github.com/kinnell/enum_fields
@@ -94,7 +95,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '2.0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.7
 specification_version: 4
 summary: Enhanced enum-like fields for ActiveRecord models with metadata support
 test_files: []

data/CHANGELOG.md

@@ -1,21 +0,0 @@
-# Changelog
-
-## [0.0.1] - 2025-11-17
-
-### Added
-
-- Initial release of EnumFields gem
-- Support for enum-like fields with metadata properties
-- Array and Hash definition formats
-- Automatic generation of:
-  - Class methods (`<accessor>s`, `<accessor>s_count`, `<accessor>_values`, `<accessor>_options`)
-  - Instance getter/setter methods (when accessor differs from column)
-  - Metadata accessor methods (`<accessor>_metadata`)
-  - Property accessor methods for all defined properties (`<accessor>_<property>`)
-  - Inquiry methods (`<key>_<accessor>?`)
-  - Scopes (`<key>_<accessor>`)
-  - Validations (inclusion with `allow_nil: true`)
-- Custom column mapping support via `column:` option
-- Dynamic property method generation for custom properties
-
-[0.0.1]: https://github.com/kinnell/enum_fields/releases/tag/v0.0.1