sort_param 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fb0d8250b0a318bf85f2031f497b703e044387bb9b0ce53588a7bd8aefe42cc1
-  data.tar.gz: e48ff69e8d9f9d1eeb188222abceb7368b1fc928bf36e52b6f9822321b854782
+  metadata.gz: 410b605717d78b03414a2efa8fe9bcfc7db220f52b68ec20526068ee214dd695
+  data.tar.gz: 7b472ee03998faf9e05fb5aebb4a39e36d2a06853169598a9089a48cd04bf93a
 SHA512:
-  metadata.gz: e99bca609530200771778839f406bf270d2fa4a11041f9f44f095f2d6e81882fbf7f814e1a14699aa7b194ed6fa907eb69cb804824c85f5bcf4c3f85ca34ed65
-  data.tar.gz: 884b4a6af691fb6782c9b9f4db453d5e7f904e9b4ddf309c3e07999a51e136eae363acb5dbd2c60368ed315f17e707eacd8d2aa2c21f1bc8ad85dc91e4fa5765
+  metadata.gz: 2ad6f2f434973f1b1c25ce86d9949f02443a042ecc1a7279eb208c3eecfb04410adbcb0ea436b0341d729747c17665a8d7b25a9fb6d181f4d3623933b90e7a40
+  data.tar.gz: f838dd76a5d4e8231c6308f33575dae253c5cd4ab6f6e887488b3ab74da6252ee39ed4b3beb77e024c3f503e358a659788ee62ae78eeb6041f4049881a814ce2

data/CHANGELOG.md

@@ -9,3 +9,8 @@
 
 ## [1.1.0]
 - Introduce definition#load to silently ignore non-whitelisted sort fields
+
+## [1.2.0]
+- Introduce #fields to whitelist multiple fields with the same field defaults at once
+- Allow field renaming using a Proc instead of hardcoding a string value
+

data/README.md

@@ -137,12 +137,13 @@ Use `#load` method instead:
   => "first_name asc"
 ```
 
-### Render a different field name in the output
-Set the `:rename` field option to output a different field name:
+### Output a different field name
+Set the `:rename` field option to a string value or a Proc to output a different field name.
 
 ```ruby
   sort_param = SortParam.define do
     field :first_name, rename: 'users.name'
+    field :last_name, rename: ->(col) { "users.#{col}" }
   end
   
   sort_param.load!("+first_name", mode: :pg)
@@ -153,12 +154,28 @@ Set the `:rename` field option to output a different field name:
   
   sort_param.load!("+first_name")
   => {"users.name"=>{:direction=>:asc}}
+
+  sort_param.load!("+last_name")
+  => {"users.last_name"=>{:direction=>:asc}}
 ```
 
-<br/>
+### Whitelisting multiple fields with the same options at once
+Use `#fields` instead of `#field`:
+
+```ruby
+  sort_param = SortParam.define do
+    fields :first_name, :last_name, nulls: :first, rename: ->(col) { "users.#{col}" }
+    field :email
+  end
+```
+
+NOTE: Unlike `#field`, `#fields` can only accept a Proc for the `:rename` option.
+
 
 ### Rails example
 
+### controller
+
 ```ruby
 def index 
   render json: User.all.order(sort_fields)
@@ -197,7 +214,7 @@ module HasSortParam
 end
 ```
 
-### controller
+### controller v2
 
 ```ruby
 def index 

data/lib/sort_param/definition.rb

@@ -21,19 +21,40 @@ module SortParam
       self
     end
 
-    # Add a whitelisted column
+    # Whitelist a column
     #
     # @param name [String, Symbol] column name
     # @param defaults [Hash] column default options:
-    #   * nulls (Symbol) nulls sort order. `:last` or `:first`
-    #   * rename (String) field name in formatted output
+    #   * nulls [Symbol] nulls sort order. `:last` or `:first`
+    #   * rename [String, Proc] rename field in the formatted output.
+    #     This can be a Proc code block that receives the :name as argument and
+    #     returns a transformed field name.
     #
     # @return [self] Definition instance
-    def field(name, defaults = {})
+    def field(name, **defaults)
       name = name.to_s
       return if name.strip.empty?
 
-      fields_hash[name] = defaults
+      fields_hash[name] = preprocess_field_defaults(name, defaults)
+
+      self
+    end
+
+    # Whitelist multiple columns with the same column defaults.
+    #
+    # @param name [Array<String, Symbol>] list of column names
+    # @param defaults [Hash] column default options
+    #
+    # @see #field
+    #
+    # @return [self] Definition instance
+    #
+    def fields(*names, **defaults)
+      if defaults[:rename] && !defaults[:rename].is_a?(Proc)
+        raise ArgumentError.new(":rename should be a Proc")
+      end
+
+      names.each { |name| field(name, **defaults) }
 
       self
     end
@@ -100,6 +121,14 @@ module SortParam
                            .format(*fields)
     end
 
+    def preprocess_field_defaults(field, defaults)
+      rename = defaults[:rename]
+      return defaults unless rename.is_a?(Proc)
+
+      defaults[:rename] = defaults[:rename].call(field)
+      defaults
+    end
+
     def non_whitelisted_fields(loaded_fields)
       loaded_fields.names - fields_hash.keys
     end

data/lib/sort_param/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SortParam
-  VERSION = "1.1.0"
+  VERSION = "1.2.0"
 end

metadata

@@ -1,16 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: sort_param
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Uy Jayson B
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-06-20 00:00:00.000000000 Z
+date: 2023-06-27 00:00:00.000000000 Z
 dependencies: []
-description: Sort records using a sort query parameter à la JSON-API style
+description: Sort records using a sort query parameter à la JSON:API format
 email:
 - uy.json.dev@gmail.com
 executables: []
@@ -57,5 +57,5 @@ requirements: []
 rubygems_version: 3.4.6
 signing_key:
 specification_version: 4
-summary: Sort records using a sort query parameter à la JSON-API style
+summary: Sort records using a sort query parameter à la JSON:API format
 test_files: []