hal_api-rails 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA256:
-  metadata.gz: 0d17fee58879f4f95b3f32e05bd626d6242f9c2d1e321073ce48aa6c2cfb2e37
-  data.tar.gz: f23c5f2dcee52f79701947acdb1ee6835b7ab864aaa606f065758a82617c0750
+SHA1:
+  metadata.gz: 4f8ad6ad0044a8438881c35775259d46cce7448d
+  data.tar.gz: c4dd5e6a42a4cca9d744e7050a91dc6d06e335f9
 SHA512:
-  metadata.gz: d96ae095dfa08377102ca42a3ad02294d04a44d37df600d69beb7e69428ec5621ad8e257dcca5a668f76ab19717c753cbe5e4b5bfc66b44830bf1821b10a7a9c
-  data.tar.gz: a7889a43949e18dbf54796de43a15ce5f3868fcbf6711db4911b4f2e2d56278f8698b8bcdfd486af425904594da2be8ce9ec7f5978158bf8d66d8add2be1c2ef
+  metadata.gz: ae0cf7fc44f171df5972c660d732cbd837f89216e001ef76f8b9aa97a0cc25b8581e975a90efdfdee7401cc7e9ae3ad947442239119828a374806ac023b3ce3a
+  data.tar.gz: 9d8eb8563e870a584b7eb69696a8d205cbb03b5b6ea68b33c64913ced078a158cfc21a37fb62a0c349b2a66c4cb026a8e3448080139f27ec88bc939ebd6e0d12

data/lib/hal_api/controller.rb

@@ -9,12 +9,16 @@ module HalApi::Controller
   require 'hal_api/controller/cache'
   require 'hal_api/controller/resources'
   require 'hal_api/controller/exceptions'
+  require 'hal_api/controller/sorting'
+  require 'hal_api/controller/filtering'
   require 'hal_api/responders/api_responder'
 
   include HalApi::Controller::Actions
   include HalApi::Controller::Cache
   include HalApi::Controller::Resources
   include HalApi::Controller::Exceptions
+  include HalApi::Controller::Sorting
+  include HalApi::Controller::Filtering
 
   included do
     include Roar::Rails::ControllerAdditions

data/lib/hal_api/controller/filtering.rb

@@ -0,0 +1,107 @@
+module HalApi::Controller::Filtering
+  extend ActiveSupport::Concern
+
+  included do
+    class_eval do
+      class_attribute :allowed_filter_names
+      class_attribute :allowed_filter_types
+    end
+  end
+
+  class FilterParams < OpenStruct
+    def initialize(filters = {})
+      @filters = filters.with_indifferent_access
+    end
+
+    def method_missing(m, *args, &_block)
+      if @filters.key?(m) && args.empty?
+        @filters[m]
+      elsif m.to_s[-1] == '?' && args.empty? && @filters.key?(m.to_s.chop)
+        !!@filters[m.to_s.chop]
+      else
+        msg = "Unknown filter param '#{m}'"
+        hint = "Valid filters are: #{@filters.keys.join(' ')}"
+        raise HalApi::Errors::UnknownFilterError.new(msg, hint)
+      end
+    end
+  end
+
+  module ClassMethods
+    def filter_params(*args)
+      self.allowed_filter_names = []
+      self.allowed_filter_types = {}
+      (args || []).map do |arg|
+        if arg.is_a? Hash
+          arg.to_a.each { |key, val| add_filter_param(key.to_s, val.to_s) }
+        else
+          add_filter_param(arg.to_s)
+        end
+      end
+    end
+
+    private
+
+    def add_filter_param(name, type = nil)
+      unless allowed_filter_names.include? name
+        allowed_filter_names << name
+        allowed_filter_types[name] = type unless type.nil?
+      end
+    end
+  end
+
+  def filters
+    @filters ||= parse_filters_param
+  end
+
+  private
+
+  def parse_filters_param
+    filters_map = {}
+    filters = self.class.allowed_filter_names
+    force_types = self.class.allowed_filter_types
+
+    # set nils
+    filters.each do |name|
+      filters_map[name] = nil
+    end
+
+    # parse query param
+    (params[:filters] || '').split(',').each do |str|
+      name, value = str.split('=', 2)
+      next unless filters_map.key?(name)
+
+      # convert/guess type of known params
+      filters_map[name] =
+        if force_types[name] == 'date'
+          parse_date(value)
+        elsif force_types[name] == 'time'
+          parse_time(value)
+        elsif value.nil?
+          true
+        elsif value.blank?
+          ''
+        elsif [false, 'false'].include? value
+          false
+        elsif [true, 'true'].include? value
+          true
+        elsif value =~ /\A[-+]?\d+\z/
+          value.to_i
+        else
+          value
+        end
+    end
+    FilterParams.new(filters_map)
+  end
+
+  def parse_date(str)
+    Date.parse(str)
+  rescue ArgumentError
+    raise HalApi::Errors::BadFilterValueError.new "Invalid filter date: '#{str}'"
+  end
+
+  def parse_time(str)
+    Time.find_zone('UTC').parse(str) || (raise ArgumentError.new 'Nil result!')
+  rescue ArgumentError
+    raise HalApi::Errors::BadFilterValueError.new "Invalid filter time: '#{str}'"
+  end
+end

data/lib/hal_api/controller/sorting.rb

@@ -0,0 +1,61 @@
+module HalApi::Controller::Sorting
+  extend ActiveSupport::Concern
+
+  included do
+    class_eval do
+      class_attribute :allowed_sort_names
+      class_attribute :default_sort
+    end
+  end
+
+  module ClassMethods
+    def sort_params(args)
+      self.allowed_sort_names = args[:allowed].map(&:to_s).uniq
+      self.default_sort = args[:default]
+      if default_sort && !default_sort.is_a?(Array)
+        self.default_sort = Array[default_sort]
+      end
+    end
+  end
+
+  def sorts
+    @sorts ||= parse_sorts_param
+  end
+
+  def sorted(arel)
+    apply_sorts = !sorts.blank? ? sorts : default_sort
+    if apply_sorts.blank?
+      super
+    else
+      arel.order(*apply_sorts)
+    end
+  end
+
+  private
+
+  # support ?sorts=attribute,attribute:direction params
+  # e.g. ?sorts=published_at,updated_at:desc
+  # desc is default if a direction is not specified
+  def parse_sorts_param
+    sorts_array = []
+    allowed_sorts = self.class.allowed_sort_names
+
+    # parse sort param for name of the column and direction
+    # default is descending, because I say so, and we have a bias towards the new
+    (params[:sorts] || '').split(',').each do |str|
+      name, direction = str.split(':', 2).map { |s| s.to_s.strip }
+      name = name.underscore
+      direction = direction.blank? ? 'desc' : direction.downcase
+      unless allowed_sorts.include?(name)
+        hint = "Valid sorts are: #{allowed_sorts.join(' ')}"
+        raise HalApi::Errors::BadSortError.new("Invalid sort: #{name}", hint)
+      end
+      unless ['asc', 'desc'].include?(direction)
+        hint = "Valid directions are: asc desc"
+        raise HalApi::Errors::BadSortError.new("Invalid sort direction: #{direction}", hint)
+      end
+      sorts_array << { name => direction }
+    end
+    sorts_array
+  end
+end

data/lib/hal_api/errors.rb

@@ -4,10 +4,18 @@ module HalApi::Errors
 
   class ApiError < StandardError
     attr_accessor :status
+    attr_accessor :hint
 
-    def initialize(message = nil, status = 500)
+    def initialize(message = nil, status = nil, hint = nil)
       super(message || "API Error")
-      self.status = status
+      self.status = status || 500
+      self.hint = hint
+    end
+  end
+
+  class Forbidden < ApiError
+    def initialize(message = nil, hint = nil)
+      super(message || 'Forbidden', 403, hint)
     end
   end
 
@@ -23,6 +31,24 @@ module HalApi::Errors
     end
   end
 
+  class BadSortError < ApiError
+    def initialize(msg, hint = nil)
+      super(msg, 400, hint)
+    end
+  end
+
+  class UnknownFilterError < ApiError
+    def initialize(msg, hint = nil)
+      super(msg, 400, hint)
+    end
+  end
+
+  class BadFilterValueError < ApiError
+    def initialize(msg, hint = nil)
+      super(msg, 400, hint)
+    end
+  end
+
   module Representer
     include Roar::JSON::HAL
 

data/lib/hal_api/rails/version.rb

@@ -1,5 +1,5 @@
 module HalApi
   module Rails
-    VERSION = "0.5.0"
+    VERSION = "0.6.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hal_api-rails
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Chris Rhoden
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-08-13 00:00:00.000000000 Z
+date: 2019-08-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -216,7 +216,9 @@ files:
 - lib/hal_api/controller/actions.rb
 - lib/hal_api/controller/cache.rb
 - lib/hal_api/controller/exceptions.rb
+- lib/hal_api/controller/filtering.rb
 - lib/hal_api/controller/resources.rb
+- lib/hal_api/controller/sorting.rb
 - lib/hal_api/errors.rb
 - lib/hal_api/paged_collection.rb
 - lib/hal_api/paged_collection_representer.rb
@@ -253,7 +255,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.7.6.2
+rubygems_version: 2.5.2.3
 signing_key: 
 specification_version: 4
 summary: JSON HAL APIs on Rails in the style of PRX