flounder 0.9.0 → 0.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 97e8380edd41a2232f500fc61ceb3f49e2dd3211
-  data.tar.gz: e0330758a5aac5eba5d509cdffa778f0dca41735
+  metadata.gz: b7f0215b9a32d26575d6a27982baf1e3557df937
+  data.tar.gz: b0b7cb0356ea83e8af672a0f91b025f567891d03
 SHA512:
-  metadata.gz: c17571110ffbe588b794f026e5eddfc244bd479c37d1a09e4f01639caa4e6031bbb82a1ff5512a616fc4c0069cab4c0165eeddcd5a39535275376c8e8dcf5509
-  data.tar.gz: 76e6e016a4ac6bcaa9f2c8679909a63cd1564efeed5b5ce970d6a41e845cdc77d43c09cc188e0fbd3e367bff6725c382fae2fa223b07b15ce25c15947766417e
+  metadata.gz: ff873c40c360913978fd6d9138b704e8362c26e577a15f042c062f2be74731e63ab0d06ec49931892b1a98f729eab67823b8e23da8cf2fd41f09841ccaa9fa01
+  data.tar.gz: 4ab1e4048e43d99ce94ea224e026e4e6bd9b36ca591d600df5777f9bcf4666ddcc47eaa93afcb44fc5a74751e98790ec1be3f68e440dc3c43ba0747926efdbe8

data/HISTORY

@@ -4,4 +4,7 @@
  + Allows expressions of the form `where('id=$1', 1)`.
  + You now need to call `#kick` when performing an insert or an update 
    to get it to really happen. Please see our documentation in qed/*.
- + `domain.transaction do |conn| ... end`
+ + `domain.transaction do |conn| ... end`
+
+ 0.9.1
+ + `search_path` argument for `Flounder.connect`.

data/flounder.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name     = "flounder"
-  s.version  = '0.9.0'
+  s.version  = '0.9.1'
   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/connection.rb

@@ -4,9 +4,15 @@ module Flounder
     attr_reader :pg
     attr_reader :visitor
 
-    def initialize pg_conn_args
-      @pg = PG.connect(*pg_conn_args)
+    def initialize pg_conn_opts
+      search_path = pg_conn_opts.delete(:search_path)
+
+      @pg = PG.connect(pg_conn_opts)
       @visitor = Arel::Visitors::PostgreSQL.new(self)
+
+      if search_path
+        exec('set search_path=' + search_path)
+      end
     end
 
     attr_reader :visitor

data/lib/flounder.rb

@@ -22,8 +22,8 @@ require 'flounder/exceptions'
 
 module Flounder
 module_function
-  def connect *args
-    ConnectionPool.new(args)
+  def connect opts={}
+    ConnectionPool.new(opts)
   end
 
   def domain connection, &block

data/qed/database_technicalities.md

@@ -0,0 +1,41 @@
+# Transactions
+
+Transactions are supported on the domain and on entities. Since you need to make sure that your transaction uses only one connection, you will need to handle connections explicitly. 
+
+~~~ruby
+  expect RuntimeError do
+    domain.with_connection do |conn|
+      conn.transaction do
+        posts.update(title: 'A single title for everyone').kick(conn)
+        fail 'rollback'
+      end
+    end
+  end
+
+  posts.first.title.assert != 'A single title for everyone'
+~~~
+
+The same works on any entity from the domain. Please note that there is a shortcut for getting at a transaction.
+
+~~~ruby
+  domain.transaction do |conn| 
+    posts.all(conn)
+  end
+
+  posts.transaction do |conn|
+    posts.all(conn)
+  end
+~~~
+
+# Schemas & Search-Path
+
+When connecting to a database, you can use the `search_path` argument to install a search path for all your accesses. 
+
+~~~ruby
+  pool = Flounder.connect(dbname: 'flounder', search_path: 'public,test')
+  pool.with_connection do |connection|
+    result = connection.exec 'show search_path'
+    path = result.to_a.first.first.last
+    path.assert == 'public, test'
+  end
+~~~

data/qed/index.md

@@ -112,31 +112,3 @@ The call to `#anchor` anchors all further joins at that point.
     to_sql.assert == %Q(SELECT "users"."id" FROM "users"  WHERE "users"."id" = 2013)
 ~~~
 
-# Transactions
-
-Transactions are supported on the domain and on entities. Since you need to make sure that your transaction uses only one connection, you will need to handle connections explicitly. 
-
-~~~ruby
-  expect RuntimeError do
-    domain.with_connection do |conn|
-      conn.transaction do
-        posts.update(title: 'A single title for everyone').kick(conn)
-        fail 'rollback'
-      end
-    end
-  end
-
-  posts.first.title.assert != 'A single title for everyone'
-~~~
-
-The same works on any entity from the domain. Please note that there is a shortcut for getting at a transaction.
-
-~~~ruby
-  domain.transaction do |conn| 
-    posts.all(conn)
-  end
-
-  posts.transaction do |conn|
-    posts.all(conn)
-  end
-~~~

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: flounder
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.9.1
 platform: ruby
 authors:
 - Kaspar Schiess
@@ -90,7 +90,6 @@ files:
 - HISTORY
 - LICENSE
 - README
-- flounder-0.3.0.gem
 - flounder.gemspec
 - lib/flounder.rb
 - lib/flounder/connection.rb
@@ -114,6 +113,7 @@ files:
 - qed/applique/setup_domain.rb
 - qed/atomic_insert_update.md
 - qed/conditions.md
+- qed/database_technicalities.md
 - qed/exceptions.md
 - qed/flounder.sql
 - qed/index.md
@@ -153,6 +153,7 @@ test_files:
 - qed/applique/setup_domain.rb
 - qed/atomic_insert_update.md
 - qed/conditions.md
+- qed/database_technicalities.md
 - qed/exceptions.md
 - qed/flounder.sql
 - qed/index.md