rao-query 0.0.48.pre → 0.0.50.pre

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6963df3b6d53ee9358249f17dab0dbf65bc62330de5bb735e98fe425e1dd665c
-  data.tar.gz: ab862f96ed37ecaa14f10a23bf70ce106678dd9d919ae75894864b3db279fcd7
+  metadata.gz: 6ce1a4cf9d5cba42dc47127d986e8f07f51b0418c6b946f03cd994295ea3b337
+  data.tar.gz: eccea738821842049daed7f8337f2c6f67bc7500b7cfb067861299211181d8e5
 SHA512:
-  metadata.gz: 512d09f819735003f009cdea184ea7c5e79fd9ac2978151187074c2fb082379390817c73517abef69b1ed95b83d493f0c5cff46b21e96d8492821308c5836ef5
-  data.tar.gz: bbb0f02ebf3c3d052934a868c9acf7baa93b5664b9d8679153f54961707efc2b542fed7487b40d80ee2134a2595ea1adcf94322257e5b7668034539606bde49b
+  metadata.gz: e70ba89cf5b845b38ad6742ab7ea1a5e12ef7663229c6127439f3eb67b4c6135d0b7d7e1e658721b7ba870010669f9c2ca659671c21186f16b8fdebfd53c4a00
+  data.tar.gz: d4f5990dc6005abf6a12a77f167095bdc26a2114fd0338e5c314dd064002b3fa5761864d4e2ba9dcf43e6af5105a14d899a6597a54d7af36cc3ef26d3047f9e7

data/README.md

@@ -1,10 +1,54 @@
 # Rails Add-Ons Query
-Short description and motivation.
 
-## Usage
-How to use my plugin.
+Provides filtering and sorting of collections at controller level. Useful for
+UIs or APIs that display any collection of records.
+
+## Basic Usage
+
+Include the concern in your controller and change you index action to use
+conditions coming from the query string:
+
+    # app/controllers/posts_controller.rb
+    class PostsController < ApplicationController
+      include Rao::Query::Controller::QueryConcern
+
+      def index
+        @posts = with_conditions_from_query(Post).all
+      end
+    end
+
+### Using limit
+
+### Using offset
+
+### Using order
+
+### Using includes
+
+The includes parameter is used to eager load associations.
+
+#### has many
+
+Assume you have posts that have many comments. You can have the comments
+included in your query like this:
+
+    http://localhost:3000/posts?includes[]=comments
+
+## Usage with rao-api-resources_controller
+
+rao-api_resources_controller comes with support for rao-query. You just have
+to include the QueryConcern to enable it. There is no need to overwrite the
+index action:
+
+    # app/controllers/posts_controller.rb
+    class PostsController < Rao::Api::ResourcesController::Base
+      include Rao::Query::Controller::QueryConcern
+
+      #...
+    end
 
 ## Installation
+
 Add this line to your application's Gemfile:
 
 ```ruby
@@ -12,17 +56,21 @@ gem 'rao-query'
 ```
 
 And then execute:
+
 ```bash
 $ bundle
 ```
 
 Or install it yourself as:
+
 ```bash
 $ gem install rao-query
 ```
 
 ## Contributing
+
 Contribution directions go here.
 
 ## License
+
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/app/concerns/rao/query/controller/query_concern.rb

@@ -47,11 +47,11 @@ module Rao
         end
 
         def default_query_params
-          request.query_parameters.except(*default_query_params_exceptions)
+          request.query_parameters.except(*query_params_exceptions)
         end
 
-        def default_query_params_exceptions
-          Rao::Query::Configuration.default_query_params_exceptions
+        def query_params_exceptions
+          @query_params_exceptions ||= Rao::Query::Configuration.default_query_params_exceptions
         end
 
         def normalize_query_params(params)

data/app/parsers/rao/query/condition_parser.rb

@@ -18,7 +18,7 @@ module Rao
           if operator == 'cont'
             return ["#{table}.#{column} LIKE ?", "%#{normalized_condition(table, column, condition)}%"]
           else
-            return ["#{table}.#{column} = ?", normalized_condition(table, column, condition)]
+            return ["#{table}.#{column} #{extract_operator(parent_key)} ?", normalized_condition(table, column, condition)]
           end
         else
           if nested
@@ -73,7 +73,7 @@ module Rao
       # end
 
       def extract_table_column_and_operator(string)
-        if string =~ /([\.a-z_]{1,})\(([a-z_]{2,})\)/
+        if string =~ /([\.a-z0-9_]{1,})\(([a-z0-9_]{2,})\)/
           table_and_column = $~[1]
           operator = $~[2]
           column, table_or_association = table_and_column.split('.').reverse

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rao-query
 version: !ruby/object:Gem::Version
-  version: 0.0.48.pre
+  version: 0.0.50.pre
 platform: ruby
 authors:
 - Roberto Vasquez Angel
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-21 00:00:00.000000000 Z
+date: 2023-10-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -221,7 +221,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
-rubygems_version: 3.2.24
+rubygems_version: 3.4.20
 signing_key: 
 specification_version: 4
 summary: Simple Filter Queries for Ruby on Rails.