nummy 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1eec6bebfcfcfb1a55059d7a9b86bf2f2639a1db72ad9b69294ea3e26bb28d88
-  data.tar.gz: 17d3335c6b7bdfeb12233cf1bca4f95ac11ed608930e0a9fd46a0c92b63ca2fa
+  metadata.gz: 83fe6928d06ebd4ba649eaa37ad3278366e2322a99fe56a7efdfed228b971841
+  data.tar.gz: 7116e7d5febca95ae52544bcbc42a4fd99e895ca8e60ef9cd7e3444e6dae8719
 SHA512:
-  metadata.gz: df883a0535f1b3e2ccf7015d7159d6fd9ba08f6b277324fda3ddf90222e95514f81e792f28fe6994bc1a59f1917bfe0e9cb40fa53b5ab5459172f5d080cd0a20
-  data.tar.gz: 105f1fbf20d88aa5168de81056c072498b7af2d994fbbc203b5317095fba49f6b9d86bc83e9254468c6b49dd4e7338aa0f0d104bbfb21237a3cb5f4af2c1c393
+  metadata.gz: 4d4bb886ad7d5187aca88391c1e9366a82b4bdb08e435cb5567951a5e2a5e5d230ef5f06cdae0bd5b104c8a62d00e41c437969cf9b9b4a4cf7d5eb41e73dd4ac
+  data.tar.gz: dc40fbde79187708d1006bd80475b114f98f8de238faaae8bd4a9b620f5557df06c3d960123e237267041370f59baee13d42e1f4389e97e3394e68fe6e383cfc

data/CHANGELOG.md

@@ -1,8 +1,70 @@
 ## [Unreleased]
 
+## [0.3.0] - 2024-01-04
+
+- **Adds additional flexibility to `Nummy::Enum.to_attribute` (#2)
+
+  This release teaches a few new tricks to `Nummy::Enum.to_attribute`:
+
+  - it allows passing a block to fully customize how keys are transformed
+
+  - it looks for `String#underscore` rather than calling into  `ActiveSupport::Inflector.underscore` directly, which means that users can bring their own monkey patch if they want to.
+
+  - it falls back to `Symbol#downcase` if `String#underscore` is not available. If the constants are defined using `SCREAMING_SNAKE_CASE`, this will generally have the same result as calling `String#underscore`, but without requiring ActiveSupport.
+
+  ```ruby
+  class ShippingStatus < Nummy::Enum
+    IN_TRANSIT = auto
+    OUT_FOR_DELIVERY = auto
+    DELIVERED = auto
+  end
+  ```
+
+  ```ruby
+  # Without ActiveSupport
+  
+  ShippingStatus.to_attribute
+  # v0.2.0 (❌)
+  # => nummy/lib/nummy/enum.rb:379:in `block in to_attribute': uninitialized constant ActiveSupport (NameError)
+  # 
+  #              ::ActiveSupport::Inflector.underscore(key).to_sym
+  #              ^^^^^^^^^^^^^^^
+
+  # v0.3.0 (✅)
+  # => {:in_transit=>0, :out_for_delivery=>1, :delivered=>2}
+  ```
+
+  ```ruby
+  # With ActiveSupport
+  require "active_support/core_ext/string/inflections"
+
+  ShippingStatus.to_attribute
+  # => {:in_transit=>0, :out_for_delivery=>1, :delivered=>2}
+
+  ShippingStatus.to_attribute { |key| key.to_s.underscore.camelize.to_sym }
+  # => {:InTransit=>0, :OutForDelivery=>1, :Delivered=>2}
+  ```
+
+- **Adds JSON serialization support (#3)**
+
+  This release adds two methods to `Nummy::Enum`: `.as_json` and `.to_json`. These methods allow you to serialize an enum to JSON.
+
+  ```ruby
+  class Status < Nummy::Enum
+    ACTIVE = auto
+    ARCHIVED = auto
+  end
+
+  Status.as_json
+  # => {"ACTIVE" => 0, "ARCHIVED" => 1}
+
+  Status.to_json
+  # => "{\"ACTIVE\":0,\"ARCHIVED\":1}
+  ```
+
 ## [0.2.0] - 2024-01-04
 
-- Add `Nummy::Enum.to_attribute`, which converts the enum to a hash that can be passed as the values of an `ActiveRecord::Enum`:
+- Add `Nummy::Enum.to_attribute` (#1), which converts the enum to a hash that can be passed as the values of an `ActiveRecord::Enum`:
   
   ```ruby
   class Conversation < ActiveRecord::Base

data/README.md

@@ -148,10 +148,7 @@ end
 
 #### Rails / ActiveRecord integration
 
-> [!IMPORTANT]
-> This integration requires `ActiveSupport::Inflector` to be defined.
-
-To use nummy enums as ActiveRecord enums, you can use the `.to_attribute` method:
+To use nummy enums as ActiveRecord enums, you can use the `.to_attribute` method, which converts the keys to `snake_case` by default:
 
 ```ruby
 class Conversation < ActiveRecord::Base
@@ -164,7 +161,13 @@ class Conversation < ActiveRecord::Base
 end
 ```
 
-This allows you to use all of the Rails magic for enums, like scopes and boolean helpers, while also being able to refer to values in a safer way than hash lookups.
+> [!NOTE]
+> `to_attribute` will transform keys using `String#underscore` if it is defined, otherwise it will use `Symbol#downcase`.
+
+> [!TIP]
+> You can also do custom transformations by passing a block to `to_attribute`. See the documentation for more details.
+
+Using `to_attribute` allows you to use all of the Rails magic for enums, like scopes and boolean helpers, while also being able to refer to values in a safer way than hash lookups.
 
 That is, these two are the same:
 

data/lib/nummy/enum.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "json"
+
 require "nummy/auto_sequenceable"
 require "nummy/ordered_const_enumerable"
 require "nummy/errors"
@@ -354,30 +356,77 @@ module Nummy
       # Alias to support splatting enums into keyword args.
       alias to_hash to_h
 
+      # Converts +self+ to a +Hash+ that can be converted to JSON.
+      #
+      # @return [Hash{String => Object}]
+      #
+      # @see .to_json
+      def as_json
+        to_h.transform_keys!(&:to_s)
+      end
+
+      # Converts +self+ to a +Hash+ and serializes it to  a JSON string.
+      #
+      # Supports same options as +JSON#generate+.
+      #
+      # @return [String]
+      #
+      # @see .as_json
+      def to_json(*)
+        as_json.to_json(*)
+      end
+
       # Converts the enum to a +Hash+ with snake_case keys.
       #
       # This is intended to be used with +ActiveRecord::Enum+, but can be used
       # with any library that supports defining enums using a +Hash+ and expects
       # to have lowercase keys.
       #
-      # @note
-      #   This method _equires +ActiveSupport::Inflector+ to be defined.
+      # @overload to_attribute
+      #   If +String#underscore+ is defined, converts the keys to snake_case
+      #   by calling +underscore+ on the stringified key.
+      #
+      #   Otherwise, converts each key using +Symbol#downcase+.
+      #
+      #   @return [Hash{Symbol => Object}]
       #
-      # @return [Hash{Symbol => Integer}]
+      #   @example Using with +ActiveRecord::Enum+.
+      #     class Conversation < ActiveRecord::Base
+      #       class Status < Nummy::Enum
+      #         ACTIVE = auto
+      #         ARCHIVED = auto
+      #       end
       #
-      # @example
-      #   class Conversation < ActiveRecord::Base
-      #     class Status < Nummy::Enum
-      #       ACTIVE = auto
-      #       ARCHIVED = auto
+      #       enum :status, Status.to_attribute
       #     end
       #
-      #     enum :status, Status.to_attribute
-      #   end
-      def to_attribute
-        to_h.transform_keys! do |key|
-          ::ActiveSupport::Inflector.underscore(key).to_sym
+      # @overload to_attribute(&)
+      #   Transforms the keys by calling the given block on each key.
+      #
+      #   @yieldparam key [Symbol]
+      #   @return [Hash{Symbol => Object}]
+      #
+      #   @example Using custom key transformer.
+      #     class ShippingStatus < Nummy::Enum
+      #       IN_TRANSIT = auto
+      #       OUT_FOR_DELIVERY = auto
+      #       DELIVERED = auto
+      #     end
+      #
+      #     ShippingStatus.to_attribute { |key| key.to_s.underscore.camelize.to_sym }
+      #     # => {:InTransit=>0, :OutForDelivery=>1, :Delivered=>2}
+      def to_attribute(&)
+        return to_h.transform_keys!(&) if block_given?
+
+        # Ignore coverage because it's executed in a forked process, which
+        # messes with the coverage collection.
+        # :nocov:
+        if String.method_defined?(:underscore)
+          return to_attribute { |key| key.to_s.underscore.to_sym }
         end
+        # :nocov:
+
+        to_attribute(&:downcase)
       end
 
       # Returns a string representation of +self+.

data/lib/nummy/version.rb

@@ -2,5 +2,5 @@
 
 module Nummy
   # The current version of the gem.
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nummy
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Benjamin Chauvette