cassie 1.0.0.beta.32 → 1.0.0.beta.33

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: aa2ba0d811ffdad384c60cf0cea82d8ee954ddcc
-  data.tar.gz: b8ad756bafd678a34549b50fbbbda53e262ebbe7
+  metadata.gz: 8ffedeca0fe95eb9d618ed1042b54fc2ffbda0a4
+  data.tar.gz: 5bb78230669425a06ea21f8886006074b2b38878
 SHA512:
-  metadata.gz: 4fbd55628b1c9ad3a3de3ef02857cdd8aca0d14f8262c876db7e84caf58cc9fb39a49b5e19ee192465211ff6356548344ba3e687fd1f10c7b8bc9cb6a0198557
-  data.tar.gz: eea113133729eb44de23800afc680ebf36b04e61643e9de2c137f487d22b9356d6a67854de0ba659a45f4b7bcbce355543bce1ae0fa0f38bfc2bc99d0fb7d80e
+  metadata.gz: 16503691f2a924dc76cae63749f0ab3cf5b40afa56b37fd51df271f500862ba181e83f45740c15f0305df2d5911437a26e89ce177ad58b6f617d32ee47f8e1cf
+  data.tar.gz: c3ede66882f0a2341581892ca83fbc430f0ba525b04ced68d1fdfa3ec0f1e2a67473a7c736793e9bb18f847e0215a7accffd1068bceaa7a835198188acfbe6cb

data/lib/cassie/statements/README.md

@@ -785,6 +785,32 @@ set_1 = query.fetch([1, 2, 3])
 set_2 = query.fetch([7, 8, 9, 10, 11, 12])
 ```
 
+#### Allowing Filtering
+
+For select statements, allowing filtering is supported.
+
+```ruby
+class IveReallyThoughtThisOutQuery < Cassie::Query
+
+  select_from :users_by_id
+
+  where :rank, :gt
+
+  attr_accessor :rank
+
+  allow_filtering
+end
+```
+
+Assuming `rank` is a field for which a ranging query requires [Cassandra filtering](http://www.datastax.com/dev/blog/allow-filtering-explained-2), the statement will now be valid.
+```
+query = IveReallyThoughtThisOutQuery.new(rank: rank)
+query.to_cql
+=> "SELECT * FROM users_by_id WHERE rank > 100 ALLOW FILTERING;"
+```
+
+Allowing filtering in production is usually a Bad Idea, unless you really are ok with Cassandra loading all CQL rows into memory before filtering down to the requested set.
+
 #### Custom queries
 
 For certain queries, it may be most effective to write CQL directly. The recommended way is to override `cql` and `params`.

data/lib/cassie/statements/statement/allow_filtering.rb

@@ -0,0 +1,35 @@
+module Cassie::Statements::Statement
+  module AllowFiltering
+    extend ActiveSupport::Concern
+
+    module ClassMethods
+      def inherited(subclass)
+        subclass.allow_filtering(allow_filtering?) if defined?(@allow_filtering)
+        super
+      end
+
+      def allow_filtering(val=:allow)
+        @allow_filtering = !!val
+      end
+
+      def allow_filtering?
+        return !!@allow_filtering if defined?(@allow_filtering)
+        false
+      end
+    end
+
+    def allow_filtering?
+      self.class.allow_filtering?
+    end
+
+    protected
+
+    def build_allow_filtering_str
+      if allow_filtering?
+        "ALLOW FILTERING"
+      else
+        ""
+      end
+    end
+  end
+end

data/lib/cassie/statements/statement/selection.rb

@@ -1,4 +1,5 @@
 require_relative 'limiting'
+require_relative 'allow_filtering'
 require_relative 'pagination'
 require_relative 'relations'
 require_relative 'ordering'
@@ -11,6 +12,7 @@ module Cassie::Statements::Statement
       include Relations
       include Ordering
       include Limiting
+      include AllowFiltering
       include Pagination
 
       @result_class = Cassie::Statements::Results::QueryResult
@@ -68,6 +70,7 @@ module Cassie::Statements::Statement
           #{where_str}
           #{build_order_str}
           #{build_limit_str}
+          #{build_allow_filtering_str}
       ).squish + ";"
     end
 

data/lib/cassie/version.rb

@@ -1,3 +1,3 @@
 module Cassie
-  VERSION = "1.0.0.beta.32"
+  VERSION = "1.0.0.beta.33"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cassie
 version: !ruby/object:Gem::Version
-  version: 1.0.0.beta.32
+  version: 1.0.0.beta.33
 platform: ruby
 authors:
 - Evan Prothro
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-01-19 00:00:00.000000000 Z
+date: 2017-01-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cassandra-driver
@@ -160,6 +160,7 @@ files:
 - lib/cassie/statements/modification.rb
 - lib/cassie/statements/query.rb
 - lib/cassie/statements/statement.rb
+- lib/cassie/statements/statement/allow_filtering.rb
 - lib/cassie/statements/statement/assignment.rb
 - lib/cassie/statements/statement/assignments.rb
 - lib/cassie/statements/statement/conditions.rb