flounder 0.11.3 → 0.11.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f4ac07a24ace10c1749674bf6267e9a72340dbb6
-  data.tar.gz: 727e4e6fd344cf1af92787e82ffd18c505fe5956
+  metadata.gz: b1e40f2f96562740062a78b94e3fe1aaefda394c
+  data.tar.gz: 6142038a425251078a47f4f0aea1dc4a2a383551
 SHA512:
-  metadata.gz: e9397d1aaef91195b6506305ba65738cebb2936cc3e1c507b5650ac3b8da2abc1ad5f221d8c36240a631621f1f1ca4d3c8b7a6261d1fc961b3f2d4200a6ce355
-  data.tar.gz: f48c8f2963b7ac31f16dd9e8a52d282221d39670ed12f72ac16c22e55a2d38fec7aa57523c3eaea51deb827a1ac6335fc7d24b7666033874414c2e92064f9e3f
+  metadata.gz: 3bceb92cf55b7e0cfe1c7ace211e0283f66a08be18f30ad841e923ac00f929f7089817098c30bf2fcbf10e87f2b322548d2fb726de8fd710299c997c46df3127
+  data.tar.gz: 56dffcedde3366684040a6aff7c29e84efe81ec1418a5c3580a7f76d8303a519b8aa34b69606c72cbafc1bfc2d35ca6e828e179b8c2d4a8cd6366b6bacd5c78c

data/HISTORY

@@ -4,6 +4,7 @@
     value. 
   + #hoist is the opposite of #anchor - it reverts to the original entity. 
   + native treatment of hstore - returns you a hashie::mash.
+  + Fixes a bug where limit would leak the SelectManager.
 
 # 0.10
   + Datamapper interop is improved (also in #order_by)

data/README

@@ -13,9 +13,10 @@ SYNOPSIS
 
 STATUS
 
-Company-wide private alpha. 
+Heavily volatile alpha, but feature stable for most of what we already have. 
+We welcome feedback! (flounder at technologyastronauts dot ch)
 
 LICENSE
 
-  Private code for now. No use permitted.
+  MIT License. 
 

data/flounder.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name     = "flounder"
-  s.version  = '0.11.3'
+  s.version  = '0.11.4'
   s.summary  = "Flounder is a way to write SQL simply in Ruby. It deals with everything BUT object relational mapping. "
   s.email    = "kaspar.schiess@technologyastronauts.ch"
   s.homepage = "https://bitbucket.org/technologyastronauts/oss_flounder"

data/lib/flounder/entity.rb

@@ -108,7 +108,9 @@ module Flounder
     end
 
     # Query initiators
-    [:where, :join, :outer_join, :project, :order_by, :group_by].each do |name|
+    [:where, :join, :outer_join, :project,
+      :order_by, :group_by, 
+      :limit, :offset].each do |name|
       define_method name do |*args|
         select { |q| q.send(name, *args) }
       end

data/lib/flounder/query/select.rb

@@ -118,6 +118,11 @@ module Flounder::Query
 
     def limit n
       manager.take n
+      self
+    end
+    def offset n
+      manager.skip n
+      self
     end
 
     alias all kick

data/qed/selects.md

@@ -45,6 +45,27 @@ You can treat the entities and the queries like an array.
   query.size.assert == entity.size
 ~~~
 
+# `LIMIT` and `OFFSET`
+
+Limit the amount of results fetched: 
+
+~~~ruby
+  rows = domain[:users].limit(1).order_by(:id).to_a
+  rows.size.assert == 1
+
+  rows = domain[:users].order_by(:id).limit(1).to_a
+  rows.size.assert == 1
+~~~
+
+And start at a given offset: 
+
+~~~ruby
+  rows = domain[:users].order_by(:id).offset(1).to_a
+  rows.first.id.assert == 2
+~~~
+
+As a special case, calling `#first` on a query will `.limit(1).first`. 
+
 # Subqueries
 
 Sometimes you have to say it with a subquery. For example, you might want to look at the latest post for each author in the database. 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: flounder
 version: !ruby/object:Gem::Version
-  version: 0.11.3
+  version: 0.11.4
 platform: ruby
 authors:
 - Kaspar Schiess
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-09-01 00:00:00.000000000 Z
+date: 2014-09-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: arel