cipherstash-pg 1.0.0.beta.4-x86_64-darwin

data/lib/cipherstash-pg.rb

@@ -0,0 +1,60 @@
+# -*- ruby -*-
+# frozen_string_literal: true
+
+module CipherStashPG
+  # cipherstash-pg *always* ships a "fat" gem with precompiled libs for
+  # each popular major.minor version of Ruby that is still in use.
+  major_minor = RUBY_VERSION[ /^(\d+\.\d+)/ ] or
+    raise "Oops, can't extract the major/minor version from #{RUBY_VERSION.dump}"
+  begin
+    require "#{major_minor}/pg_ext"
+  rescue => e
+    STDERR.puts "Failed to load pg_ext for #{RUBY_VERSION.dump}"
+    exit 1
+  end
+
+  # Provide a means to read the extension installation scripts
+  DB_EXT_DIR = File.join(__dir__, '../vendor/database-extensions')
+  def self.install_script
+    File.read(File.join(DB_EXT_DIR, "install.sql"))
+  end
+
+  def self.uninstall_script
+    File.read(File.join(DB_EXT_DIR, "uninstall.sql"))
+  end
+
+  class NotAllCopyDataRetrieved < CipherStashPG::Error
+  end
+
+  class NotInBlockingMode < CipherStashPG::Error
+  end
+
+  # Get the CipherStashPG library version.
+  #
+  # +include_buildnum+ is no longer used and any value passed will be ignored.
+  def self.version_string( include_buildnum=nil )
+    "%s %s" % [ self.name, VERSION ]
+  end
+
+  ### Convenience alias for CipherStashPG::Connection.new.
+  def self.connect( *args, &block )
+    Connection.new( *args, &block )
+  end
+
+  require 'cipherstash-pg/exceptions'
+  require 'cipherstash-pg/constants'
+  require 'cipherstash-pg/coder'
+  require 'cipherstash-pg/binary_decoder'
+  require 'cipherstash-pg/text_encoder'
+  require 'cipherstash-pg/text_decoder'
+  require 'cipherstash-pg/basic_type_registry'
+  require 'cipherstash-pg/basic_type_map_based_on_result'
+  require 'cipherstash-pg/basic_type_map_for_queries'
+  require 'cipherstash-pg/basic_type_map_for_results'
+  require 'cipherstash-pg/type_map_by_column'
+  require 'cipherstash-pg/connection'
+  require 'cipherstash-pg/result'
+  require 'cipherstash-pg/tuple'
+  require 'cipherstash-pg/version'
+
+end # module CipherStashPG

data/misc/openssl-pg-segfault.rb

@@ -0,0 +1,21 @@
+PGHOST = "localhost"
+PGDB = "test"
+SOCKHOST = "it-trac.laika.com"
+require("cipherstash-pg")
+$stderr.puts("connecting to postgres://#{PGHOST}/#{PGDB}")
+conn = CipherStashPG.connect(PGHOST, :dbname => (PGDB))
+require("socket")
+require("openssl")
+$stderr.puts("Connecting to #{SOCKHOST}")
+sock = TCPSocket.open(SOCKHOST, 443)
+ctx = OpenSSL::SSL::SSLContext.new
+sock = OpenSSL::SSL::SSLSocket.new(sock, ctx)
+sock.sync_close = true
+$stderr.puts("Attempting to connect...")
+begin
+  sock.connect
+rescue Errno
+  $stderr.puts("Got an error connecting, but no segfault.")
+else
+  $stderr.puts("Nope, no segfault!")
+end

data/misc/postgres/History.txt

@@ -0,0 +1,9 @@
+== v0.8.0 [2012-02-09] Michael Granger <ged@FaerieMUD.org>
+
+This placeholder version.
+
+
+== v0.7.9.2008.01.28 [2008-01-28] Jeff Davis <<ruby-pg@j-davis.com>>
+
+The last actual version.
+

data/misc/postgres/Manifest.txt

@@ -0,0 +1,5 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/postgres.rb

data/misc/postgres/README.txt

@@ -0,0 +1,21 @@
+= postgres
+
+* https://github.com/ged/ruby-pg
+
+== Description
+
+This is an old, deprecated version of the Ruby PostgreSQL driver that hasn't
+been maintained or supported since early 2008.
+
+You should install/require 'pg' instead.
+
+If you need the 'postgres' gem for legacy code that can't be converted, you can
+still install it using an explicit version, like so:
+
+  gem install postgres -v '0.7.9.2008.01.28'
+  gem uninstall postgres -v '>0.7.9.2008.01.28'
+
+If you have any questions, the nice folks in the Google group can help:
+
+  http://goo.gl/OjOPP / ruby-pg@googlegroups.com
+

data/misc/postgres/Rakefile

@@ -0,0 +1,14 @@
+require("date")
+require("rubygems")
+require("hoe")
+require("pp")
+Hoe.spec("postgres") do
+  self.developer("Michael Granger", "ged@FaerieMUD.org")
+  self.dependency("pg", "~> 0")
+  self.spec_extras[:date] = Date.parse("2008/01/30")
+  line = ("-" * 75)
+  msg = paragraphs_of("README.txt", (3..-1))
+  msg.unshift(line)
+  msg.push(line)
+  self.spec_extras[:post_install_message] = (msg.join("\n\n") + "\n")
+end

data/misc/postgres/lib/postgres.rb

@@ -0,0 +1,12 @@
+require("pathname")
+module Postgres
+  VERSION = "0.8.1"
+  
+  gemdir = Pathname("(string)").dirname.parent
+  
+  readme = (gemdir + "README.txt")
+  
+  header, message = readme.read.split(/^== Description/m)
+  
+  abort(message.strip)
+end

data/misc/ruby-pg/History.txt

@@ -0,0 +1,9 @@
+== v0.8.0 [2012-02-09] Michael Granger <ged@FaerieMUD.org>
+
+This placeholder version.
+
+
+== v0.7.9.2008.01.28 [2008-01-28] Jeff Davis <<ruby-pg@j-davis.com>>
+
+The last actual version.
+

data/misc/ruby-pg/Manifest.txt

@@ -0,0 +1,5 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/ruby/pg.rb

data/misc/ruby-pg/README.txt

@@ -0,0 +1,21 @@
+= ruby-pg
+
+* https://github.com/ged/ruby-pg
+
+== Description
+
+This is an old, deprecated version of the 'pg' gem that hasn't been
+maintained or supported since early 2008.
+
+You should install/require 'pg' instead.
+
+If you need ruby-pg for legacy code that can't be converted, you can still
+install it using an explicit version, like so:
+
+  gem install ruby-pg -v '0.7.9.2008.01.28'
+  gem uninstall ruby-pg -v '>0.7.9.2008.01.28'
+
+If you have any questions, the nice folks in the Google group can help:
+
+  http://goo.gl/OjOPP / ruby-pg@googlegroups.com
+

data/misc/ruby-pg/Rakefile

@@ -0,0 +1,14 @@
+require("date")
+require("rubygems")
+require("hoe")
+require("pp")
+Hoe.spec("ruby-pg") do
+  self.developer("Michael Granger", "ged@FaerieMUD.org")
+  self.dependency("pg", "~> 0")
+  self.spec_extras[:date] = Date.parse("2008/01/30")
+  line = ("-" * 75)
+  msg = paragraphs_of("README.txt", (3..-1))
+  msg.unshift(line)
+  msg.push(line)
+  self.spec_extras[:post_install_message] = (msg.join("\n\n") + "\n")
+end

data/misc/ruby-pg/lib/ruby/pg.rb

@@ -0,0 +1,12 @@
+require("pathname")
+module Pg
+  VERSION = "0.8.0"
+  
+  gemdir = Pathname("(string)").dirname.parent.parent
+  
+  readme = (gemdir + "README.txt")
+  
+  header, message = readme.read.split(/^== Description/m)
+  
+  abort(message.strip)
+end

data/rakelib/task_extension.rb

@@ -0,0 +1,32 @@
+module TaskExtension
+  def file(name, *args, &block)
+    task_once(name, block) do
+      super(name, *args) do |ta|
+        block&.call(ta).tap do
+          unless File.exist?(ta.name) then
+            raise("file #{ta.name} is missing after task executed")
+          end
+        end
+      end
+    end
+  end
+  
+  def task(name, *args, &block)
+    task_once(name, block) { super }
+  end
+  
+  private(def task_once(name, block)
+    name = name.keys.first if name.is_a?(Hash)
+    if block and (Rake::Task.task_defined?(name) and (Rake::Task[name].instance_variable_get("@task_block_location") == block.source_location)) then
+      Rake::Task[name]
+    else
+      if block then
+        yield.tap do
+          Rake::Task[name].instance_variable_set("@task_block_location", block.source_location)
+        end
+      else
+        yield
+      end
+    end
+  end)
+end

data/sample/array_insert.rb

@@ -0,0 +1,7 @@
+require("cipherstash-pg")
+c = CipherStashPG.connect(:dbname => "test")
+c.exec("DROP TABLE IF EXISTS foo")
+c.exec("CREATE TABLE foo (strings character varying[]);")
+c.set_error_verbosity(CipherStashPG::PQERRORS_VERBOSE)
+c.prepare("stmt", "INSERT INTO foo VALUES ($1);")
+c.exec_prepared("stmt", ["{'this','that'}"])

data/sample/async_api.rb

@@ -0,0 +1,60 @@
+require("cipherstash-pg")
+TIMEOUT = 5.0
+progress_thread = Thread.new { loop { print("x") } }
+def output_progress(msg)
+  puts("\n>>> #{msg}\n")
+end
+output_progress("Starting connection...")
+(conn = CipherStashPG::Connection.connect_start(:dbname => "test") or abort("Unable to create a new connection!"))
+if (conn.status == CipherStashPG::CONNECTION_BAD) then
+  abort(("Connection failed: %s" % [conn.error_message]))
+end
+poll_status = CipherStashPG::PGRES_POLLING_WRITING
+until ((poll_status == CipherStashPG::PGRES_POLLING_OK) or (poll_status == CipherStashPG::PGRES_POLLING_FAILED)) do
+  (case poll_status
+  when CipherStashPG::PGRES_POLLING_READING then
+    output_progress("  waiting for socket to become readable")
+    (select([conn.socket_io], nil, nil, TIMEOUT) or raise("Asynchronous connection timed out!"))
+  when CipherStashPG::PGRES_POLLING_WRITING then
+    output_progress("  waiting for socket to become writable")
+    (select(nil, [conn.socket_io], nil, TIMEOUT) or raise("Asynchronous connection timed out!"))
+  end
+  case conn.status
+  when CipherStashPG::CONNECTION_STARTED then
+    output_progress("  waiting for connection to be made.")
+  when CipherStashPG::CONNECTION_MADE then
+    output_progress("  connection OK; waiting to send.")
+  when CipherStashPG::CONNECTION_AWAITING_RESPONSE then
+    output_progress("  waiting for a response from the server.")
+  when CipherStashPG::CONNECTION_AUTH_OK then
+    output_progress("  received authentication; waiting for backend start-up to finish.")
+  when CipherStashPG::CONNECTION_SSL_STARTUP then
+    output_progress("  negotiating SSL encryption.")
+  when CipherStashPG::CONNECTION_SETENV then
+    output_progress("  negotiating environment-driven parameter settings.")
+  when CipherStashPG::CONNECTION_NEEDED then
+    output_progress("  internal state: connect() needed.")
+  end
+  poll_status = conn.connect_poll)
+end
+unless (conn.status == CipherStashPG::CONNECTION_OK) then
+  abort(("Connect failed: %s" % [conn.error_message]))
+end
+output_progress("Sending query")
+conn.send_query("SELECT * FROM pg_stat_activity")
+loop do
+  output_progress("  waiting for a response")
+  conn.consume_input
+  while conn.is_busy do
+    (select([conn.socket_io], nil, nil, TIMEOUT) or raise("Timeout waiting for query response."))
+    conn.consume_input
+  end
+  (result = conn.get_result or break)
+  puts(("\n\nQuery result:\n%p\n" % [result.values]))
+end
+output_progress("Done.")
+conn.finish
+if defined? progress_thread then
+  progress_thread.kill
+  progress_thread.join
+end

data/sample/async_copyto.rb

@@ -0,0 +1,24 @@
+require("cipherstash-pg")
+require("stringio")
+$stderr.puts("Opening database connection ...")
+conn = CipherStashPG.connect(:dbname => "test")
+conn.setnonblocking(true)
+socket = conn.socket_io
+$stderr.puts("Running COPY command ...")
+buf = ""
+conn.transaction do
+  conn.send_query("COPY logs TO STDOUT WITH csv")
+  buf = nil
+  begin
+    ($stderr.puts("COPY loop")
+    conn.consume_input
+    while conn.is_busy do
+      $stderr.puts("  ready loop")
+      (select([socket], nil, nil, 5.0) or raise("Timeout (5s) waiting for query response."))
+      conn.consume_input
+    end
+    buf = conn.get_copy_data
+    $stdout.puts(buf) if buf)
+  end until buf.nil?
+end
+conn.finish

data/sample/async_mixed.rb

@@ -0,0 +1,28 @@
+require("cipherstash-pg")
+$stdout.sync = true
+TIMEOUT = 5.0
+CONN_OPTS = { :host => "localhost", :dbname => "test" }
+def output_progress(msg)
+  puts(">>> #{msg}\n")
+end
+output_progress("Starting connection...")
+(conn = CipherStashPG.connect(CONN_OPTS) or abort("Unable to create a new connection!"))
+unless (conn.status == CipherStashPG::CONNECTION_OK) then
+  abort(("Connect failed: %s" % [conn.error_message]))
+end
+socket = conn.socket_io
+output_progress("Sending query")
+conn.send_query("SELECT * FROM pg_stat_activity")
+loop do
+  output_progress("  waiting for a response")
+  conn.consume_input
+  while conn.is_busy do
+    output_progress(("  waiting for data to be available on %p..." % [socket]))
+    (select([socket], nil, nil, TIMEOUT) or raise("Timeout waiting for query response."))
+    conn.consume_input
+  end
+  (result = conn.get_result or break)
+  output_progress(("Query result:\n%p\n" % [result.values]))
+end
+output_progress("Done.")
+conn.finish

data/sample/check_conn.rb

@@ -0,0 +1,9 @@
+require("cipherstash-pg")
+def check_connection(conn)
+  conn.exec("SELECT 1")
+rescue CipherStashPG::Error => err
+  $stderr.puts(("%p while testing connection: %s" % [err.class, err.message]))
+  conn.reset
+end
+conn = CipherStashPG.connect(:dbname => "test")
+check_connection(conn)

data/sample/copydata.rb

@@ -0,0 +1,21 @@
+require("cipherstash-pg")
+require("stringio")
+$stderr.puts("Opening database connection ...")
+conn = CipherStashPG.connect(:dbname => "test")
+conn.exec("DROP TABLE IF EXISTS logs;\nCREATE TABLE logs (\n\tclient_ip inet,\n\tusername text,\n\tts timestamp,\n\trequest text,\n\tstatus smallint,\n\tbytes int\n);\n")
+csv_io = StringIO.new("\"127.0.0.1\",\"\",\"30/Aug/2010:08:21:24 -0700\",\"GET /manual/ HTTP/1.1\",404,205\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:21:24 -0700\",\"GET /favicon.ico HTTP/1.1\",404,209\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:21:24 -0700\",\"GET /favicon.ico HTTP/1.1\",404,209\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:22:29 -0700\",\"GET /manual/ HTTP/1.1\",200,11094\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:22:38 -0700\",\"GET /manual/index.html HTTP/1.1\",200,725\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:27:56 -0700\",\"GET /manual/ HTTP/1.1\",200,11094\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:27:57 -0700\",\"GET /manual/ HTTP/1.1\",200,11094\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:06 -0700\",\"GET /manual/index.html HTTP/1.1\",200,7709\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:06 -0700\",\"GET /manual/images/feather.gif HTTP/1.1\",200,6471\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:06 -0700\",\"GET /manual/images/left.gif HTTP/1.1\",200,60\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:06 -0700\",\"GET /manual/style/css/manual.css HTTP/1.1\",200,18674\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:06 -0700\",\"GET /manual/style/css/manual-print.css HTTP/1.1\",200,13200\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:06 -0700\",\"GET /manual/images/favicon.ico HTTP/1.1\",200,1078\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:06 -0700\",\"GET /manual/style/css/manual-loose-100pc.css HTTP/1.1\",200,3065\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:14 -0700\",\"OPTIONS * HTTP/1.0\",200,0\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:15 -0700\",\"OPTIONS * HTTP/1.0\",200,0\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:47 -0700\",\"GET /manual/mod/directives.html HTTP/1.1\",200,33561\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:53 -0700\",\"GET /manual/mod/mpm_common.html HTTP/1.1\",200,67683\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:53 -0700\",\"GET /manual/images/down.gif HTTP/1.1\",200,56\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:53 -0700\",\"GET /manual/images/up.gif HTTP/1.1\",200,57\n\"127.0.0.1\",\"\",\"30/Aug/2010:09:19:58 -0700\",\"GET /manual/mod/mod_log_config.html HTTP/1.1\",200,28307\n\"127.0.0.1\",\"\",\"30/Aug/2010:09:20:19 -0700\",\"GET /manual/mod/core.html HTTP/1.1\",200,194144\n\"127.0.0.1\",\"\",\"30/Aug/2010:16:02:56 -0700\",\"GET /manual/ HTTP/1.1\",200,11094\n\"127.0.0.1\",\"\",\"30/Aug/2010:16:03:00 -0700\",\"GET /manual/ HTTP/1.1\",200,11094\n\"127.0.0.1\",\"\",\"30/Aug/2010:16:06:16 -0700\",\"GET /manual/mod/mod_dir.html HTTP/1.1\",200,10583\n\"127.0.0.1\",\"\",\"30/Aug/2010:16:06:44 -0700\",\"GET /manual/ HTTP/1.1\",200,7709\n")
+$stderr.puts("Running COPY command with data ...")
+buf = ""
+conn.transaction do
+  res = conn.copy_data("COPY logs FROM STDIN WITH csv") do
+    $stderr.print("Sending lines... ")
+    csv_io.each_line.with_index do |buf, i|
+      $stderr.print("#{(i + 1)} ")
+      conn.put_copy_data(buf)
+    end
+    $stderr.puts("done.")
+  end
+  $stderr.puts(("Result of COPY is: %s" % [res.res_status(res.result_status)]))
+  $stderr.puts(("  tuples copied: %p" % [res.cmd_tuples]))
+end
+conn.finish

data/sample/copyfrom.rb

@@ -0,0 +1,29 @@
+require("cipherstash-pg")
+require("stringio")
+$stderr.puts("Opening database connection ...")
+conn = CipherStashPG.connect(:dbname => "test")
+conn.exec("DROP TABLE IF EXISTS logs;\nCREATE TABLE logs (\n\tclient_ip inet,\n\tusername text,\n\tts timestamp,\n\trequest text,\n\tstatus smallint,\n\tbytes int\n);\n")
+copy_data = StringIO.new("\"127.0.0.1\",\"\",\"30/Aug/2010:08:21:24 -0700\",\"GET /manual/ HTTP/1.1\",404,205\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:21:24 -0700\",\"GET /favicon.ico HTTP/1.1\",404,209\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:21:24 -0700\",\"GET /favicon.ico HTTP/1.1\",404,209\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:22:29 -0700\",\"GET /manual/ HTTP/1.1\",200,11094\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:22:38 -0700\",\"GET /manual/index.html HTTP/1.1\",200,725\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:27:56 -0700\",\"GET /manual/ HTTP/1.1\",200,11094\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:27:57 -0700\",\"GET /manual/ HTTP/1.1\",200,11094\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:06 -0700\",\"GET /manual/index.html HTTP/1.1\",200,7709\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:06 -0700\",\"GET /manual/images/feather.gif HTTP/1.1\",200,6471\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:06 -0700\",\"GET /manual/images/left.gif HTTP/1.1\",200,60\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:06 -0700\",\"GET /manual/style/css/manual.css HTTP/1.1\",200,18674\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:06 -0700\",\"GET /manual/style/css/manual-print.css HTTP/1.1\",200,13200\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:06 -0700\",\"GET /manual/images/favicon.ico HTTP/1.1\",200,1078\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:06 -0700\",\"GET /manual/style/css/manual-loose-100pc.css HTTP/1.1\",200,3065\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:14 -0700\",\"OPTIONS * HTTP/1.0\",200,0\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:15 -0700\",\"OPTIONS * HTTP/1.0\",200,0\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:47 -0700\",\"GET /manual/mod/directives.html HTTP/1.1\",200,33561\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:53 -0700\",\"GET /manual/mod/mpm_common.html HTTP/1.1\",200,67683\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:53 -0700\",\"GET /manual/images/down.gif HTTP/1.1\",200,56\n\"127.0.0.1\",\"\",\"30/Aug/2010:08:28:53 -0700\",\"GET /manual/images/up.gif HTTP/1.1\",200,57\n\"127.0.0.1\",\"\",\"30/Aug/2010:09:19:58 -0700\",\"GET /manual/mod/mod_log_config.html HTTP/1.1\",200,28307\n\"127.0.0.1\",\"\",\"30/Aug/2010:09:20:19 -0700\",\"GET /manual/mod/core.html HTTP/1.1\",200,194144\n\"127.0.0.1\",\"\",\"30/Aug/2010:16:02:56 -0700\",\"GET /manual/ HTTP/1.1\",200,11094\n\"127.0.0.1\",\"\",\"30/Aug/2010:16:03:00 -0700\",\"GET /manual/ HTTP/1.1\",200,11094\n\"127.0.0.1\",\"\",\"30/Aug/2010:16:06:16 -0700\",\"GET /manual/mod/mod_dir.html HTTP/1.1\",200,10583\n\"127.0.0.1\",\"\",\"30/Aug/2010:16:06:44 -0700\",\"GET /manual/ HTTP/1.1\",200,7709\n")
+$stderr.puts("Running COPY command with data ...")
+buf = ""
+conn.transaction do
+  conn.exec("COPY logs FROM STDIN WITH csv")
+  begin
+    while copy_data.read(256, buf) do
+      $stderr.puts(("\tsending %d bytes of data..." % [buf.length]))
+      until conn.put_copy_data(buf) do
+        ($stderr.puts("\twaiting for connection to be writable...")
+        sleep(0.1))
+      end
+    end
+  rescue Errno => err
+    errmsg = ("%s while reading copy data: %s" % [err.class.name, err.message])
+    conn.put_copy_end(errmsg)
+  else
+    (conn.put_copy_end
+    while res = conn.get_result do
+      $stderr.puts(("Result of COPY is: %s" % [res.res_status(res.result_status)]))
+    end)
+  end
+end
+conn.finish

data/sample/copyto.rb

@@ -0,0 +1,13 @@
+require("cipherstash-pg")
+require("stringio")
+$stderr.puts("Opening database connection ...")
+conn = CipherStashPG.connect(:dbname => "test")
+$stderr.puts("Running COPY command ...")
+buf = ""
+conn.transaction do
+  conn.exec("COPY logs TO STDOUT WITH csv")
+  while buf = conn.get_copy_data do
+    $stdout.puts(buf)
+  end
+end
+conn.finish

data/sample/cursor.rb

@@ -0,0 +1,11 @@
+require("cipherstash-pg")
+$stderr.puts("Opening database connection ...")
+conn = CipherStashPG.connect(:dbname => "test")
+conn.transaction do
+  conn.exec("DECLARE myportal CURSOR FOR select * from pg_database")
+  res = conn.exec("FETCH ALL IN myportal")
+  puts(res.fields.collect { |fname| ("%-15s" % [fname]) }.join(""))
+  res.values.collect do |row|
+    puts(row.collect { |col| ("%-15s" % [col]) }.join(""))
+  end
+end

data/sample/disk_usage_report.rb

@@ -0,0 +1,92 @@
+require("ostruct")
+require("optparse")
+require("etc")
+require("cipherstash-pg")
+SCRIPT_VERSION = "Id"
+def report(opts)
+  db = CipherStashPG.connect(:dbname => opts.database, :host => opts.host, :port => opts.port, :user => opts.user, :password => opts.pass, :sslmode => "prefer")
+  db_info = db.exec("\n\t\tSELECT\n\t\t\tcount(oid) AS num_relations,\n\t\t\tpg_size_pretty(pg_database_size('#{opts.database}')) AS dbsize\n\t\tFROM\n\t\t\tpg_class\n\t")
+  puts(("=" * 70))
+  puts(("Disk usage information for %s: (%d relations, %s total)" % [opts.database, db_info[0]["num_relations"], db_info[0]["dbsize"]]))
+  puts(("=" * 70))
+  top_twenty = db.exec("\n\t\tSELECT\n\t\t\trelname AS name,\n\t\t\trelkind AS kind,\n\t\t\tpg_size_pretty(pg_relation_size(pg_class.oid)) AS size\n\t\tFROM\n\t\t\tpg_class\n\t\tORDER BY\n\t\t\tpg_relation_size(pg_class.oid) DESC\n\t\tLIMIT 20\n\t")
+  puts("Top twenty objects by size:")
+  puts(("-" * 70))
+  top_twenty.each do |row|
+    type = case row["kind"]
+    when "i" then
+      "index"
+    when "t" then
+      "toast"
+    when "r" then
+      "table"
+    when "S" then
+      "sequence"
+    else
+      "???"
+    end
+    puts(("%40s %10s (%s)" % [row["name"], row["size"], type]))
+  end
+  puts(("-" * 70))
+  schema_sizes = db.exec("\n\t\tSELECT\n\t\t\ttable_schema,\n\t\t\tpg_size_pretty( CAST( SUM(pg_total_relation_size(table_schema || '.' || table_name)) AS bigint)) AS size\n\t\tFROM\n\t\t\tinformation_schema.tables\n\t\tGROUP BY\n\t\t\ttable_schema\n\t\tORDER BY\n\t\t\tCAST( SUM(pg_total_relation_size(table_schema || '.' || table_name)) AS bigint ) DESC\n\t")
+  puts("Size per schema:")
+  puts(("-" * 70))
+  schema_sizes.each do |row|
+    puts(("%20s %10s" % [row["table_schema"], row["size"]]))
+  end
+  puts(("-" * 70))
+  puts
+  db.finish
+end
+def parse_args(args)
+  options = OpenStruct.new
+  options.database = Etc.getpwuid(Process.uid).name
+  options.host = "127.0.0.1"
+  options.port = 5432
+  options.user = Etc.getpwuid(Process.uid).name
+  options.sslmode = "prefer"
+  options.interval = 5
+  opts = OptionParser.new do |opts|
+    opts.banner = "Usage: #{$0} [options]"
+    opts.separator("")
+    opts.separator("Connection options:")
+    opts.on("-d", "--database DBNAME", "specify the database to connect to (default: \"#{options.database}\")") do |db|
+      options.database = db
+    end
+    opts.on("-h", "--host HOSTNAME", "database server host") do |host|
+      options.host = host
+    end
+    opts.on("-p", "--port PORT", Integer, "database server port (default: \"#{options.port}\")") do |port|
+      options.port = port
+    end
+    opts.on("-U", "--user NAME", "database user name (default: \"#{options.user}\")") do |user|
+      options.user = user
+    end
+    opts.on("-W", "force password prompt") do |pw|
+      print("Password: ")
+      begin
+        (system("stty -echo")
+        options.pass = gets.chomp)
+      ensure
+        (system("stty echo")
+        puts)
+      end
+    end
+    opts.separator("")
+    opts.separator("Other options:")
+    opts.on_tail("--help", "show this help, then exit") do
+      $stderr.puts(opts)
+      exit
+    end
+    opts.on_tail("--version", "output version information, then exit") do
+      puts(SCRIPT_VERSION)
+      exit
+    end
+  end
+  opts.parse!(args)
+  return options
+end
+if ("(string)" == $0) then
+  opts = parse_args(ARGV)
+  report(opts)
+end

data/sample/issue-119.rb

@@ -0,0 +1,46 @@
+require("cipherstash-pg")
+conn = CipherStashPG.connect(:dbname => "test")
+table_name = "issue_119"
+field_list = ["name", "body_weight", "brain_weight"]
+method = 0
+options = { :truncate => true }
+sql_parameters = ""
+conn.set_error_verbosity(CipherStashPG::PQERRORS_VERBOSE)
+conn.exec("DROP TABLE IF EXISTS #{table_name}")
+conn.exec("CREATE TABLE #{table_name} ( id SERIAL, name TEXT, body_weight REAL, brain_weight REAL )")
+text = "Mountain beaver\t1.35\t465\nCow\t465\t423\nGrey wolf\t36.33\t119.5\nGoat\t27.66\t115\nGuinea pig\t1.04\t5.5\nDipliodocus\t11700\t50\nAsian elephant\t2547\t4603\nDonkey\t187.1\t419\nHorse\t521\t655\nPotar monkey\t10\t115\nCat\t3.3\t25.6\nGiraffe\t529\t680\nGorilla\t207\t406\nHuman\t62\t1320\nAfrican elephant\t6654\t5712\nTriceratops\t9400\t70\nRhesus monkey\t6.8\t179\nKangaroo\t35\t56\nGolden hamster\t0.12\t1\nMouse\t0.023\t0.4\nRabbit\t2.5\t12.1\nSheep\t55.5\t175\nJaguar\t100\t157\nChimpanzee\t52.16\t440\nBrachiosaurus\t87000\t154.5\nMole\t0.122\t3\nPig\t192\t18\n"
+conn.transaction do
+  rc = conn
+  rc.exec("TRUNCATE TABLE #{table_name};") if options[:truncate]
+  sql = "COPY #{table_name} (#{field_list.join(",")}) FROM STDIN #{sql_parameters} "
+  p(sql)
+  rc.exec(sql)
+  errmsg = nil
+  begin
+    if (method == 1) then
+      rc.put_copy_data((text + "\\.\n"))
+    else
+      text.each_line { |line| rc.put_copy_data(line) }
+    end
+  rescue Errno => err
+    errmsg = ("%s while reading copy data: %s" % [err.class.name, err.message])
+    puts("an error occurred")
+  end
+  if errmsg then
+    rc.put_copy_end(errmsg)
+    puts("ERROR #{errmsg}")
+  else
+    rc.put_copy_end
+  end
+  while res = rc.get_result do
+    st = res.res_status(res.result_status)
+    puts(("Result of COPY is: %s" % [st]))
+    if (res.result_status != CipherStashPG::PGRES_COPY_IN) then
+      puts(res.error_message)
+    end
+  end
+  puts("end")
+end
+conn.exec("SELECT name, brain_weight FROM #{table_name}") do |res|
+  p(res.values)
+end