rao-query 0.0.48.pre → 0.0.49.pre

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6963df3b6d53ee9358249f17dab0dbf65bc62330de5bb735e98fe425e1dd665c
-  data.tar.gz: ab862f96ed37ecaa14f10a23bf70ce106678dd9d919ae75894864b3db279fcd7
+  metadata.gz: caa1108b2190909256712d1c97cfe7fa5d5383ac39ece955225612db16e53ea3
+  data.tar.gz: f69148a47ce87ae69952ca896ba0b0b7a3dee8f5075ed6b2dc7e72bc65013872
 SHA512:
-  metadata.gz: 512d09f819735003f009cdea184ea7c5e79fd9ac2978151187074c2fb082379390817c73517abef69b1ed95b83d493f0c5cff46b21e96d8492821308c5836ef5
-  data.tar.gz: bbb0f02ebf3c3d052934a868c9acf7baa93b5664b9d8679153f54961707efc2b542fed7487b40d80ee2134a2595ea1adcf94322257e5b7668034539606bde49b
+  metadata.gz: 5de6981ceafb1a92e5525a34cf489607aef446f5c537a010ba33d2eeb482c1c3b42ad99381d78609c2c57cc3926b0d6797cafd0a5d9e0932557790748b04dab8
+  data.tar.gz: b5a87d1251a4f8e2c6557ad13920f84f88f89e15309ad99b73a53c36bd52f3e5e6e5a6062247a441e43cae05ed19108b4da5a023e480425c15d5747e914bcf01

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/parsers/rao/query/condition_parser.rb

@@ -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.49.pre
 platform: ruby
 authors:
 - Roberto Vasquez Angel
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-21 00:00:00.000000000 Z
+date: 2023-04-11 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.11
 signing_key: 
 specification_version: 4
 summary: Simple Filter Queries for Ruby on Rails.