sqlpostgres 1.2.4

data/doc/examples/select2.rb

@@ -0,0 +1,36 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+Connection.open do |connection|
+
+  connection.exec("create temporary table person (name text, married boolean)")
+
+  insert = Insert.new('person', connection)
+  insert.insert('name', 'Fred')
+  insert.insert('married', false)
+  insert.exec
+
+  insert = Insert.new('person', connection)
+  insert.insert('name', 'Mary')
+  insert.insert('married', false)
+  insert.exec
+
+  # Example: ../manual.dbk
+  select = Select.new(connection)
+  select.select('name')
+  select.select('married')
+  select.from('person')
+  select.where(['married = %s', false])
+  p select.statement    # OUTPUT
+  p select.exec         # OUTPUT
+  # End example
+
+end

data/doc/examples/select_cross_join.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+# Example: ../../lib/sqlpostgres/Select.rb
+select = Select.new
+select.select('i')
+select.from('foo')
+select.cross_join('bar')
+p select.statement       # OUTPUT
+# End example

data/doc/examples/select_distinct.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+# Example: ../../lib/sqlpostgres/Select.rb
+select = Select.new
+select.distinct
+select.select('i')
+select.from('foo')
+p select.statement             # OUTPUT
+# End example

data/doc/examples/select_distinct_on

@@ -0,0 +1,19 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+# Example: ../../lib/sqlpostgres/Select.rb
+select = Select.new
+select.distinct_on('i')
+select.select('integer', 'i')
+select.select('integer', 'j')
+select.from('foo')
+p select.statement            # OUTPUT
+# End example

data/doc/examples/select_for_update.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+# Example: ../../lib/sqlpostgres/Select.rb
+select = Select.new
+select.select('i')
+select.from('foo')
+select.for_update
+p select.statement     # OUTPUT
+# End example

data/doc/examples/select_from.rb

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+# Example: ../../lib/sqlpostgres/Select.rb
+select = Select.new
+select.select('i')
+select.from('foo')
+p select.statement    # OUTPUT
+# End example

data/doc/examples/select_from_subselect.rb

@@ -0,0 +1,20 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+# Example: ../../lib/sqlpostgres/Select.rb
+subselect = Select.new
+subselect.select('i')
+subselect.from('foo')
+select = Select.new
+select.select('i')
+select.from(subselect, 'bar')
+p select.statement  # OUTPUT
+# End example

data/doc/examples/select_group_by.rb

@@ -0,0 +1,19 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+# Example: ../../lib/sqlpostgres/Select.rb
+select = Select.new
+select.select('i')
+select.select('count(*)', 'count')
+select.from('foo')
+select.group_by('i')
+p select.statement     # OUTPUT
+# End example

data/doc/examples/select_having.rb

@@ -0,0 +1,20 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+# Example: ../../lib/sqlpostgres/Select.rb
+select = Select.new
+select.select('i')
+select.select('count(*)', 'count')
+select.from('foo')
+select.group_by('i')
+select.having('i < 10')
+p select.statement       # OUTPUT
+# End example

data/doc/examples/select_join_on.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+# Example: ../../lib/sqlpostgres/Select.rb
+select = Select.new
+select.select('i')
+select.from('foo')
+select.join_on('inner', 'bar', 'foo.i = bar.j')
+p select.statement  # OUTPUT
+# End example

data/doc/examples/select_join_using.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+# Example: ../../lib/sqlpostgres/Select.rb
+select = Select.new
+select.select('i')
+select.from('foo')
+select.join_using('inner', 'bar', 'i', 'j')
+p select.statement  # OUTPUT
+# End example

data/doc/examples/select_limit.rb

@@ -0,0 +1,19 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+# Example: ../../lib/sqlpostgres/Select.rb
+select = Select.new
+select.select('i')
+select.from('foo')
+select.order_by('i')
+select.limit(1)
+p select.statement   # OUTPUT
+# End example

data/doc/examples/select_natural_join.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+# Example: ../../lib/sqlpostgres/Select.rb
+select = Select.new
+select.select('i')
+select.from('foo')
+select.natural_join('bar')
+p select.statement        # OUTPUT
+# End example

data/doc/examples/select_offset.rb

@@ -0,0 +1,19 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+# Example: ../../lib/sqlpostgres/Select.rb
+select = Select.new
+select.select('i')
+select.from('foo')
+select.order_by('i')
+select.offset(1)
+p select.statement     # OUTPUT
+# End example

data/doc/examples/select_order_by.rb

@@ -0,0 +1,20 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+# Example: ../../lib/sqlpostgres/Select.rb
+select = Select.new
+select.select('i')
+select.select('j')
+select.from('foo')
+select.order_by('i')
+select.order_by('j', 'desc')
+p select.statement   # OUTPUT
+# End example

data/doc/examples/select_select.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+Connection.open do |connection|
+
+  connection.exec("create temporary table foo (i int)")
+
+  insert = Insert.new('foo', connection)
+  insert.insert('i', 1)
+  insert.exec
+
+  # Example: ../../lib/sqlpostgres/Select.rb
+  select = Select.new(connection)
+  select.select('i')
+  select.from('foo')
+  p select.statement       # OUTPUT
+  p select.exec            # OUTPUT
+  # End example
+
+  assertEquals(select.exec, [{'i'=>1}])
+
+end

data/doc/examples/select_select_alias.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib/"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'sqlpostgres'
+require 'Assert'
+
+include Assert
+include SqlPostgres
+
+Connection.open do |connection|
+
+  connection.exec("create temporary table foo (i int)")
+
+  insert = Insert.new('foo', connection)
+  insert.insert('i', 1)
+  insert.exec
+
+  # Example: ../../lib/sqlpostgres/Select.rb
+  select = Select.new(connection)
+  select.select('i', 'number')
+  select.from('foo')
+  p select.statement       # OUTPUT
+  p select.exec            # OUTPUT
+  # End example
+
+  assertEquals(select.exec, [{"number"=>1}])
+
+end

data/doc/examples/select_select_expression.rb

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib/"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'sqlpostgres'
+require 'Assert'
+
+include Assert
+include SqlPostgres
+
+Connection.open do |connection|
+
+  connection.exec("create temporary table circles (d real)")
+
+  insert = Insert.new('circles', connection)
+  insert.insert('d', 2)
+  insert.exec
+
+  # Example: ../../lib/sqlpostgres/Select.rb
+  pi = 3.14
+  select = Select.new(connection)
+  select.select(['d * %s', pi], 'c')
+  select.from('circles')
+  p select.statement       # OUTPUT
+  p select.exec            # OUTPUT
+  # End example
+
+  assertEquals(select.exec, [{'c'=>6.28}])
+
+end

data/doc/examples/select_select_literal.rb

@@ -0,0 +1,24 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+Connection.open do |connection|
+
+  # Example: ../../lib/sqlpostgres/Select.rb
+  select = Select.new(connection)
+  select.select_literal(2, 'n')
+  select.select_literal('foo', 't')
+  p select.statement         # OUTPUT
+  p select.exec              # OUTPUT
+  # End example
+
+  assertEquals(select.exec, [{'n'=>2, 't'=>'foo'}])
+
+end

data/doc/examples/select_union.rb

@@ -0,0 +1,21 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+# Example: ../../lib/sqlpostgres/Select.rb
+select2 = Select.new
+select2.select('i')
+select2.from('bar')
+select1 = Select.new
+select1.select('i')
+select1.from('foo')
+select1.union(select2)
+p select1.statement    # OUTPUT
+# End example

data/doc/examples/select_where_array.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+# Example: ../../lib/sqlpostgres/Select.rb
+select = Select.new
+select.select('age')
+select.from('person')
+select.where(['name = %s', 'Smith'])
+p select.statement     # OUTPUT
+# End example

data/doc/examples/select_where_in.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+# Example: ../../lib/sqlpostgres/Select.rb
+select = Select.new
+select.select('s')
+select.from('foo')
+select.where(['s in %s', [:in, 'foo', 'bar']])
+p select.statement     # OUTPUT
+# End example

data/doc/examples/select_where_string.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+# Example: ../../lib/sqlpostgres/Select.rb
+select = Select.new
+select.select('i')
+select.from('foo')
+select.where('i > 0')
+p select.statement     # OUTPUT
+# End example

data/doc/examples/simple.rb

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib/"))
+
+# Example: ../../lib/sqlpostgres.rb
+require "sqlpostgres"
+
+include SqlPostgres
+
+Connection.open do |connection|
+  connection.exec("create temporary table foo (t text)")
+  
+  insert = Insert.new('foo', connection)
+  insert.insert('t', 'Smith')
+  insert.exec
+  
+  insert = Insert.new('foo', connection)
+  insert.insert('t', 'Jones')
+  insert.exec
+  
+  update = Update.new('foo', connection)
+  update.set('t', "O'Brien")
+  update.where(["t = %s", "Smith"])
+  update.exec  
+  
+  select = Select.new(connection)
+  select.select('t')
+  select.from('foo')
+  select.order_by('t')
+  p select.exec  # OUTPUT
+  
+end
+# End example
+

data/doc/examples/transaction.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+Connection.open do |connection|
+
+  connection.exec("create temporary table foo (i int)")
+
+  # Example: ../../lib/sqlpostgres/Transaction.rb
+  Transaction.new(connection) do
+
+    insert = Insert.new('foo', connection)
+    insert.insert('i', 1)
+    insert.exec
+
+    insert = Insert.new('foo', connection)
+    insert.insert('i', 2)
+    insert.exec
+
+  end
+  # End example
+
+end

data/doc/examples/transaction_abort.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+Connection.open do |connection|
+
+  connection.exec("create temporary table foo (i int)")
+
+  # Example: ../../lib/sqlpostgres/Transaction.rb
+  Transaction.new(connection) do |transaction|
+    insert = Insert.new('foo', connection)
+    insert.insert('i', 1)
+    insert.exec
+    transaction.abort
+  end
+
+  select = Select.new(connection)
+  select.select('i')
+  select.from('foo')
+  p select.exec            # OUTPUT
+  # End example
+
+end

data/doc/examples/transaction_commit.rb

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+Connection.open do |connection|
+
+  connection.exec("create temporary table foo (i int)")
+
+  # Example: ../../lib/sqlpostgres/Transaction.rb
+  begin
+    Transaction.new(connection) do |transaction|
+      insert = Insert.new('foo', connection)
+      insert.insert('i', 1)
+      insert.exec
+      transaction.commit
+      raise
+    end
+  rescue Exception => e
+  end
+
+  select = Select.new(connection)
+  select.select('i')
+  select.from('foo')
+  p select.exec            # OUTPUT
+  # End example
+
+end

data/doc/examples/translate_substitute_values.rb

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include SqlPostgres
+include Assert
+
+# Example: ../../lib/sqlpostgres/Translate.rb
+p Translate.substitute_values(['foo'])                 # OUTPUT
+p Translate.substitute_values(['%s + %s', 1, 2])       # OUTPUT
+p Translate.substitute_values([:in, 1, 2])             # OUTPUT
+p Translate.substitute_values([:in, 'foo', 'bar'])     # OUTPUT
+# End example