sqlpostgres 1.2.4

data/Gemfile

@@ -0,0 +1,8 @@
+source "http://rubygems.org"
+
+gem 'pg', '~> 0.13.2'
+
+group :development do
+  gem 'jeweler', '~> 1.8.4'
+  gem 'rake', '~> 10.0.3'
+end

data/Gemfile.lock

@@ -0,0 +1,22 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    git (1.2.5)
+    jeweler (1.8.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    json (1.7.6)
+    pg (0.13.2)
+    rake (10.0.3)
+    rdoc (3.12)
+      json (~> 1.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  jeweler (~> 1.8.4)
+  pg (~> 0.13.2)
+  rake (~> 10.0.3)

data/LICENSE.md

@@ -0,0 +1,23 @@
+Copyright 2013 Wayne Conrad
+
+This software is distributed under the [MIT License](http://opensource.org/licenses/MIT):
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

data/README.rdoc

@@ -0,0 +1,59 @@
+= sqlpostgres
+
+sqlpostgres is a mini-language for building and execting SQL
+statements against a postgresql database.
+
+This is a very old library, pre-dating active record and lacking many
+of its refinements.  New projects will probably not want to use this.
+
+== INSTALL
+
+    $ gem install USPS-intelligent-barcode
+
+== EXAMPLE
+
+    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
+      # [{"t"=>"Jones"}, {"t"=>"O'Brien"}]
+      
+    end
+
+== RUBY VERSIONS
+
+The tests are known to pass in MRI 1.8.7 and MRI 1.9.3
+
+== POSTGRES VERSIONS
+
+This library works with Postgres 1.8.  It does not yet fully support
+Postgres 1.9.
+
+== ENCODINGS
+
+This library only works properly with the SQL-ASCII encoding.
+
+== WHOAMI
+
+Wayne Conrad <wconrad@yagni.com>

data/Rakefile

@@ -0,0 +1,32 @@
+# encoding: utf-8
+
+require 'rubygems'
+
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts 'Run `bundle install` to install missing gems'
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see
+  #  http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = 'sqlpostgres'
+  gem.homepage = 'http://github.com/wconrad/sqlpostgres'
+  gem.license = 'MIT'
+  gem.summary = %Q{library for postgresql queries}
+  gem.description =
+    ('A mini-language for building and executing SQL statements '\
+     'against a postgresql database.  This is a very old library, '\
+     'pre-dating active record and lacking many of its refinments.  '\
+     'New projects will probably not want to use it.')
+  gem.email = 'wconrad@yagni.com'
+  gem.authors = ['Wayne Conrad']
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new

data/VERSION

@@ -0,0 +1 @@
+1.2.4

data/doc/BUGS

@@ -0,0 +1,2 @@
+Is only tested and known to work properly if the database encoding is
+SQL_ASCII.

data/doc/examples/README

@@ -0,0 +1,6 @@
+These example programs are designed to run standalone, provided that
+there is a database with the same name as your login name.
+
+They are automatically inserted into the class (rdoc) documentation
+and into the manual's docbook source.  To do that, run the script
+"insertexamples.rb"

data/doc/examples/connection.rb

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib/"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include Assert
+include SqlPostgres
+
+# Example: ../manual.dbk
+Connection.open do |connection|
+  # Use the connection
+end
+# End example

data/doc/examples/connection_auto.rb

@@ -0,0 +1,22 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), "../../lib/")
+
+require 'sqlpostgres'
+include SqlPostgres
+
+dbName = "sqlpostgres_test"
+Connection.open do |connection1|
+  connection1.exec("create database #{dbName}")
+  begin
+    # Example: ../manual.dbk
+    Connection.open('db_name'=>'sqlpostgres_test') do |connection|
+      # Use the connection
+    end
+    # End example
+    sleep(0.1)     # I don't know why, but it seems to take some time
+    # for the connection to be closed
+  ensure
+    connection1.exec("drop database #{dbName}")
+  end
+end

data/doc/examples/connection_ctor.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), "../../lib/")
+
+require 'sqlpostgres'
+include SqlPostgres
+
+Connection.open do |connection|
+
+  connection.exec("create temporary table person (name text)")
+
+  # Example: ../manual.dbk
+  insert = Insert.new('person', connection)
+  insert.insert('name', 'Fred')
+  insert.exec
+  # End example
+
+end

data/doc/examples/connection_default.rb

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), "../../lib/")
+
+require 'sqlpostgres'
+include SqlPostgres
+
+# Example: ../manual.dbk
+Connection.open do |connection|
+  Connection.default = connection
+  select = Select.new
+  select.select_literal(1, 'i')    # OUTPUT
+  p select.exec
+end
+# End example

data/doc/examples/connection_exec.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), "../../lib/")
+
+require 'sqlpostgres'
+include SqlPostgres
+
+Connection.open do |connection|
+
+  connection.exec("create temporary table person (name text)")
+
+  # Example: ../manual.dbk
+  insert = Insert.new('person')
+  insert.insert('name', 'Fred')
+  insert.exec(connection)
+  # End example
+
+end

data/doc/examples/connection_manual.rb

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), "../../lib/")
+
+require 'sqlpostgres'
+include SqlPostgres
+
+# Example: ../manual.dbk
+connection = Connection.new
+# use the connection
+connection.close
+# End example

data/doc/examples/connection_wrapped_new.rb

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), "../../lib/")
+
+require 'sqlpostgres'
+include SqlPostgres
+
+# Example: ../manual.dbk
+pgconn = PGconn.connect('localhost', 5432, '', '', ENV['USER'])
+connection = Connection.new('connection'=>pgconn)
+# use the connection
+connection.close    # or, if you prefer, pgconn.close
+# End example

data/doc/examples/connection_wrapped_open.rb

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), "../../lib/")
+
+require 'sqlpostgres'
+include SqlPostgres
+
+# Example: ../manual.dbk
+pgconn = PGconn.connect('localhost', 5432, '', '', ENV['USER'])
+connection = Connection.open('connection'=>pgconn) do |connection|
+  # use the connection
+end
+# End example

data/doc/examples/cursor.rb

@@ -0,0 +1,38 @@
+#!/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)")
+  5.times do |i|
+    connection.exec("insert into foo (i) values (#{i})")
+  end
+
+  # Example: ../../lib/sqlpostgres/Cursor.rb
+  Transaction.new(connection) do
+    select = Select.new(connection)
+    select.select('i')
+    select.from('foo')
+    Cursor.new('my_cursor', select, {}, connection) do |cursor|
+      while !(rows = cursor.fetch).empty?
+        for row in rows
+          p row # OUTPUT
+                # OUTPUT
+                # OUTPUT
+                # OUTPUT
+                # OUTPUT
+          end
+      end
+    end
+  end
+  # End example
+
+end

data/doc/examples/include_module.rb

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), "../../lib/")
+
+# Example: ../../lib/sqlpostgres.rb
+require 'sqlpostgres'
+include SqlPostgres
+insert = Insert.new('foo')
+# End example

data/doc/examples/include_module2.rb

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), "../../lib/")
+
+# Example: ../manual.dbk
+require 'sqlpostgres'
+include SqlPostgres
+
+Connection.open do |connection|
+  #...
+end
+# End example

data/doc/examples/insert.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, t text)")
+
+  # Example: ../../lib/sqlpostgres/Insert.rb
+  insert = Insert.new('foo', connection)
+  insert.insert('i', 1)
+  insert.insert('t', 'foo')
+  p insert.statement           # OUTPUT
+  insert.exec
+  # End example
+
+  select = Select.new(connection)
+  select.select('i')
+  select.select('t')
+  select.from('foo')
+  assertEquals(select.exec, [{'i'=>1, 't'=>'foo'}])
+
+end

data/doc/examples/insert2.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, "\
+                  "date_of_birth date)")
+
+  # Example: ../manual.dbk
+  insert = Insert.new('person', connection)
+  insert.insert('name', "O'Reilly")
+  insert.insert('date_of_birth', Date.civil(1972, 1, 1))
+  p insert.statement         # OUTPUT
+  insert.exec
+  # End example
+
+  select = Select.new(connection)
+  select.select('name')
+  select.select('date_of_birth')
+  select.from('person')
+  assertEquals(select.exec, [
+                 {
+                   'name'=>"O'Reilly", 
+                   'date_of_birth'=>Date.civil(1972, 1, 1)
+                 }
+               ])
+
+end

data/doc/examples/insert_bytea.rb

@@ -0,0 +1,16 @@
+#!/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/Insert.rb
+insert = Insert.new('foo')
+insert.insert_bytea('t', "\000\001\002\003")
+p insert.statement     # OUTPUT
+# End example

data/doc/examples/insert_bytea_array.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/Insert.rb
+insert = Insert.new('foo')
+insert.insert_bytea_array('t', ["foo", "\000bar\nbaz"])
+p insert.statement     # OUTPUT
+
+# End example

data/doc/examples/insert_default_values.rb

@@ -0,0 +1,16 @@
+#!/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/Insert.rb
+insert = Insert.new('foo')
+insert.default_values
+p insert.statement     # OUTPUT
+# End example

data/doc/examples/insert_insert.rb

@@ -0,0 +1,16 @@
+#!/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/Insert.rb
+insert = Insert.new('foo')
+insert.insert('t', 'bar')
+p insert.statement         # OUTPUT
+# End example

data/doc/examples/insert_insert_default.rb

@@ -0,0 +1,16 @@
+#!/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/Insert.rb
+insert = Insert.new('foo')
+insert.insert('i', :default)
+p insert.statement             # OUTPUT
+# End example

data/doc/examples/insert_insert_select.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/Insert.rb
+select = Select.new
+select.select('j')
+select.from('bar')
+select.limit(1)
+insert = Insert.new('foo')
+insert.insert('i', select)
+p insert.statement           # OUTPUT
+# End example

data/doc/examples/insert_select.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/Insert.rb
+select = Select.new
+select.select('i')
+select.from('bar')
+insert = Insert.new('foo')
+insert.insert('i')
+insert.select(select)
+p insert.statement     # OUTPUT
+# End example

data/doc/examples/interval.rb

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.join(File.dirname(__FILE__), "../../test"))
+$:.unshift(File.join(File.dirname(__FILE__), "../../lib/"))
+
+require 'Assert'
+require 'sqlpostgres'
+
+include Assert
+include SqlPostgres
+
+# Example: ../../lib/sqlpostgres/PgInterval.rb
+interval = PgInterval.new('hours'=>1, 'minutes'=>30)
+p interval.hours                                      # OUTPUT
+p interval.minutes                                    # OUTPUT
+p interval.seconds                                    # OUTPUT
+# End example

data/doc/examples/savepoint.rb

@@ -0,0 +1,38 @@
+#!/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/Savepoint.rb
+  Transaction.new(connection) do
+
+    insert = Insert.new('foo', connection)
+    insert.insert('i', 1)
+    insert.exec
+
+    Savepoint.new('bar', connection) do |sp|
+      insert = Insert.new('foo', connection)
+      insert.insert('i', 2)
+      sp.abort
+    end
+
+    insert = Insert.new('foo', connection)
+    insert.insert('i', 3)
+    insert.exec
+
+  end
+
+  p connection.query("select i from foo order by i") #OUTPUT
+  # End example
+
+end

data/doc/examples/select.rb

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