ruby-postgres 0.7.1.2005.11.26 → 0.7.1.2005.11.27

data/Contributors

@@ -23,4 +23,4 @@ shibata <kshibata@vesta.ocn.ne.jp>
 <greentea@fa2.so-net.ne.jp>
 ts <decoux@moulon.inra.fr>
 Yuta TSUBOI <yuuta-t@is.aist-nara.ac.jp>
-<meadow.nnick@gmail.com>
+Lugovoi Nikolai <meadow.nnick@gmail.com>

data/Makefile

@@ -0,0 +1,139 @@
+
+SHELL = /bin/sh
+
+#### Start of system configuration section. ####
+
+srcdir = .
+topdir = c:/mingw/ruby/lib/ruby/1.8/i386-mingw32
+hdrdir = $(topdir)
+VPATH = $(srcdir);$(topdir);$(hdrdir)
+
+DESTDIR = c:
+prefix = $(DESTDIR)/mingw/ruby
+exec_prefix = $(DESTDIR)/mingw/ruby
+sitedir = $(prefix)/lib/ruby/site_ruby
+rubylibdir = $(libdir)/ruby/$(ruby_version)
+archdir = $(rubylibdir)/$(arch)
+sbindir = $(exec_prefix)/sbin
+datadir = $(prefix)/share
+includedir = $(prefix)/include
+infodir = $(prefix)/info
+sysconfdir = $(prefix)/etc
+mandir = $(prefix)/man
+libdir = $(DESTDIR)/mingw/ruby/lib
+sharedstatedir = $(prefix)/com
+oldincludedir = $(DESTDIR)/usr/include
+sitearchdir = $(sitelibdir)/$(sitearch)
+bindir = $(exec_prefix)/bin
+localstatedir = $(prefix)/var
+sitelibdir = $(sitedir)/$(ruby_version)
+libexecdir = $(exec_prefix)/libexec
+
+CC = gcc
+LIBRUBY = lib$(LIBRUBY_SO).a
+LIBRUBY_A = lib$(RUBY_SO_NAME)-static.a
+LIBRUBYARG_SHARED = -l$(RUBY_SO_NAME)
+LIBRUBYARG_STATIC = -l$(RUBY_SO_NAME)-static
+
+CFLAGS   =  -g -O2  
+CPPFLAGS = -I. -I$(topdir) -I$(hdrdir) -I$(srcdir) -DHAVE_LIBPQ_FE_H -DHAVE_LIBPQ_LIBPQ_FS_H -DHAVE_PQSETCLIENTENCODING -DHAVE_PG_ENCODING_TO_CHAR -DHAVE_PQFREEMEM -DHAVE_PQESCAPESTRING -DHAVE_PQEXECPARAMS -Ic:/apps/POSTGR~1/8.1/include 
+CXXFLAGS = $(CFLAGS) 
+DLDFLAGS =   -Wl,--enable-auto-import,--export-all 
+LDSHARED = gcc -shared -s
+AR = ar
+EXEEXT = .exe
+
+RUBY_INSTALL_NAME = ruby
+RUBY_SO_NAME = msvcrt-ruby18
+arch = i386-mingw32
+sitearch = i386-msvcrt
+ruby_version = 1.8
+ruby = c:/mingw/ruby/bin/ruby
+RUBY = $(ruby)
+RM = rm -f
+MAKEDIRS = mkdir -p
+INSTALL = /bin/install -c
+INSTALL_PROG = $(INSTALL) -m 0755
+INSTALL_DATA = $(INSTALL) -m 644
+COPY = cp
+
+#### End of system configuration section. ####
+
+preload = 
+
+libpath = c:/apps/POSTGR~1/8.1/lib $(libdir)
+LIBPATH =  -L"c:/apps/POSTGR~1/8.1/lib" -L"$(libdir)"
+DEFFILE = 
+
+CLEANFILES = 
+DISTCLEANFILES = 
+
+extout = 
+extout_prefix = 
+target_prefix = 
+LOCAL_LIBS = 
+LIBS = $(LIBRUBYARG_SHARED) -lpq  -lwsock32  
+SRCS = postgres.c
+OBJS = postgres.o
+TARGET = postgres
+DLLIB = $(TARGET).so
+STATIC_LIB = 
+
+RUBYCOMMONDIR = $(sitedir)$(target_prefix)
+RUBYLIBDIR    = $(sitelibdir)$(target_prefix)
+RUBYARCHDIR   = $(sitearchdir)$(target_prefix)
+
+TARGET_SO     = $(DLLIB)
+CLEANLIBS     = $(TARGET).so $(TARGET).il? $(TARGET).tds $(TARGET).map
+CLEANOBJS     = *.o *.a *.s[ol] *.pdb *.exp *.bak
+
+all:		$(DLLIB)
+static:		$(STATIC_LIB)
+
+clean:
+		@-$(RM) $(CLEANLIBS:/=\) $(CLEANOBJS:/=\) $(CLEANFILES:/=\)
+
+distclean:	clean
+		@-$(RM) Makefile extconf.h conftest.* mkmf.log
+		@-$(RM) core ruby$(EXEEXT) *~ $(DISTCLEANFILES:/=\)
+
+realclean:	distclean
+install: install-so install-rb
+
+install-so: $(RUBYARCHDIR)
+install-so: $(RUBYARCHDIR)/$(DLLIB)
+$(RUBYARCHDIR)/$(DLLIB): $(DLLIB)
+	$(INSTALL_PROG) $(DLLIB) $(RUBYARCHDIR)
+install-rb: pre-install-rb install-rb-default
+install-rb-default: pre-install-rb-default
+pre-install-rb pre-install-rb-default: $(RUBYLIBDIR)
+$(RUBYARCHDIR):
+	$(MAKEDIRS) $@
+$(RUBYLIBDIR):
+	$(MAKEDIRS) $@
+
+site-install: site-install-so site-install-rb
+site-install-so: install-so
+site-install-rb: install-rb
+
+.SUFFIXES: .c .m .cc .cxx .cpp .o
+
+.cc.o:
+	$(CXX) $(CXXFLAGS) $(CPPFLAGS) -c $<
+
+.cxx.o:
+	$(CXX) $(CXXFLAGS) $(CPPFLAGS) -c $<
+
+.cpp.o:
+	$(CXX) $(CXXFLAGS) $(CPPFLAGS) -c $<
+
+.c.o:
+	$(CC) $(CFLAGS) $(CPPFLAGS) -c $<
+
+$(DLLIB): $(OBJS)
+	@-$(RM) $@
+	$(LDSHARED) $(DLDFLAGS) $(LIBPATH) -o $@ $(OBJS) $(LOCAL_LIBS) $(LIBS)
+
+
+
+$(OBJS): ruby.h defines.h

data/mkmf.log

@@ -0,0 +1,154 @@
+have_library: checking for main() in -lpq... -------------------- yes
+
+"gcc -o conftest -I. -Ic:/mingw/ruby/lib/ruby/1.8/i386-mingw32 -Ic:/apps/POSTGR~1/8.1/include  -g -O2  conftest.c  -L"c:/apps/POSTGR~1/8.1/lib" -L"c:/mingw/ruby/lib"      -lmsvcrt-ruby18-static -lpq  -lwsock32  "
+checked program was:
+/* begin */
+
+/*top*/
+int main() { return 0; }
+int t() { main(); return 0; }
+/* end */
+
+--------------------
+
+have_header: checking for libpq-fe.h... -------------------- yes
+
+"gcc -E -I. -Ic:/mingw/ruby/lib/ruby/1.8/i386-mingw32 -Ic:/apps/POSTGR~1/8.1/include  -g -O2   conftest.c -o conftest.i"
+checked program was:
+/* begin */
+#include <libpq-fe.h>
+/* end */
+
+--------------------
+
+have_header: checking for libpq/libpq-fs.h... -------------------- yes
+
+"gcc -E -I. -Ic:/mingw/ruby/lib/ruby/1.8/i386-mingw32 -Ic:/apps/POSTGR~1/8.1/include  -g -O2   conftest.c -o conftest.i"
+checked program was:
+/* begin */
+#include <libpq/libpq-fs.h>
+/* end */
+
+--------------------
+
+have_library: checking for main() in -lcrypto... -------------------- no
+
+"gcc -o conftest -I. -Ic:/mingw/ruby/lib/ruby/1.8/i386-mingw32 -Ic:/apps/POSTGR~1/8.1/include  -g -O2  conftest.c  -L"c:/apps/POSTGR~1/8.1/lib" -L"c:/mingw/ruby/lib"     -lpq  -lmsvcrt-ruby18-static -lcrypto -lpq  -lwsock32  "
+c:\mingw\bin\..\lib\gcc\mingw32\3.4.2\..\..\..\..\mingw32\bin\ld.exe: cannot find -lcrypto
+collect2: ld returned 1 exit status
+checked program was:
+/* begin */
+
+/*top*/
+int main() { return 0; }
+int t() { main(); return 0; }
+/* end */
+
+"gcc -o conftest -I. -Ic:/mingw/ruby/lib/ruby/1.8/i386-mingw32 -Ic:/apps/POSTGR~1/8.1/include  -g -O2  conftest.c  -L"c:/apps/POSTGR~1/8.1/lib" -L"c:/mingw/ruby/lib"     -lpq  -lmsvcrt-ruby18-static -lcrypto -lpq  -lwsock32  "
+c:\mingw\bin\..\lib\gcc\mingw32\3.4.2\..\..\..\..\mingw32\bin\ld.exe: cannot find -lcrypto
+collect2: ld returned 1 exit status
+checked program was:
+/* begin */
+#include <windows.h>
+#include <winsock.h>
+
+/*top*/
+int main() { return 0; }
+int t() { void ((*volatile p)()); p = (void ((*)()))main; return 0; }
+/* end */
+
+--------------------
+
+have_library: checking for main() in -lssl... -------------------- no
+
+"gcc -o conftest -I. -Ic:/mingw/ruby/lib/ruby/1.8/i386-mingw32 -Ic:/apps/POSTGR~1/8.1/include  -g -O2  conftest.c  -L"c:/apps/POSTGR~1/8.1/lib" -L"c:/mingw/ruby/lib"     -lpq  -lmsvcrt-ruby18-static -lssl -lpq  -lwsock32  "
+c:\mingw\bin\..\lib\gcc\mingw32\3.4.2\..\..\..\..\mingw32\bin\ld.exe: cannot find -lssl
+collect2: ld returned 1 exit status
+checked program was:
+/* begin */
+
+/*top*/
+int main() { return 0; }
+int t() { main(); return 0; }
+/* end */
+
+"gcc -o conftest -I. -Ic:/mingw/ruby/lib/ruby/1.8/i386-mingw32 -Ic:/apps/POSTGR~1/8.1/include  -g -O2  conftest.c  -L"c:/apps/POSTGR~1/8.1/lib" -L"c:/mingw/ruby/lib"     -lpq  -lmsvcrt-ruby18-static -lssl -lpq  -lwsock32  "
+c:\mingw\bin\..\lib\gcc\mingw32\3.4.2\..\..\..\..\mingw32\bin\ld.exe: cannot find -lssl
+collect2: ld returned 1 exit status
+checked program was:
+/* begin */
+#include <windows.h>
+#include <winsock.h>
+
+/*top*/
+int main() { return 0; }
+int t() { void ((*volatile p)()); p = (void ((*)()))main; return 0; }
+/* end */
+
+--------------------
+
+have_func: checking for PQsetClientEncoding()... -------------------- yes
+
+"gcc -o conftest -I. -Ic:/mingw/ruby/lib/ruby/1.8/i386-mingw32 -Ic:/apps/POSTGR~1/8.1/include  -g -O2  conftest.c  -L"c:/apps/POSTGR~1/8.1/lib" -L"c:/mingw/ruby/lib"     -lpq  -lmsvcrt-ruby18-static -lpq  -lwsock32  "
+checked program was:
+/* begin */
+
+/*top*/
+int main() { return 0; }
+int t() { PQsetClientEncoding(); return 0; }
+/* end */
+
+--------------------
+
+have_func: checking for pg_encoding_to_char()... -------------------- yes
+
+"gcc -o conftest -I. -Ic:/mingw/ruby/lib/ruby/1.8/i386-mingw32 -Ic:/apps/POSTGR~1/8.1/include  -g -O2  conftest.c  -L"c:/apps/POSTGR~1/8.1/lib" -L"c:/mingw/ruby/lib"     -lpq  -lmsvcrt-ruby18-static -lpq  -lwsock32  "
+checked program was:
+/* begin */
+
+/*top*/
+int main() { return 0; }
+int t() { pg_encoding_to_char(); return 0; }
+/* end */
+
+--------------------
+
+have_func: checking for PQfreemem()... -------------------- yes
+
+"gcc -o conftest -I. -Ic:/mingw/ruby/lib/ruby/1.8/i386-mingw32 -Ic:/apps/POSTGR~1/8.1/include  -g -O2  conftest.c  -L"c:/apps/POSTGR~1/8.1/lib" -L"c:/mingw/ruby/lib"     -lpq  -lmsvcrt-ruby18-static -lpq  -lwsock32  "
+checked program was:
+/* begin */
+
+/*top*/
+int main() { return 0; }
+int t() { PQfreemem(); return 0; }
+/* end */
+
+--------------------
+
+have_func: checking for PQescapeString()... -------------------- yes
+
+"gcc -o conftest -I. -Ic:/mingw/ruby/lib/ruby/1.8/i386-mingw32 -Ic:/apps/POSTGR~1/8.1/include  -g -O2  conftest.c  -L"c:/apps/POSTGR~1/8.1/lib" -L"c:/mingw/ruby/lib"     -lpq  -lmsvcrt-ruby18-static -lpq  -lwsock32  "
+checked program was:
+/* begin */
+
+/*top*/
+int main() { return 0; }
+int t() { PQescapeString(); return 0; }
+/* end */
+
+--------------------
+
+have_func: checking for PQexecParams()... -------------------- yes
+
+"gcc -o conftest -I. -Ic:/mingw/ruby/lib/ruby/1.8/i386-mingw32 -Ic:/apps/POSTGR~1/8.1/include  -g -O2  conftest.c  -L"c:/apps/POSTGR~1/8.1/lib" -L"c:/mingw/ruby/lib"     -lpq  -lmsvcrt-ruby18-static -lpq  -lwsock32  "
+checked program was:
+/* begin */
+
+/*top*/
+int main() { return 0; }
+int t() { PQexecParams(); return 0; }
+/* end */
+
+--------------------
+

data/postgres.c

@@ -52,6 +52,8 @@ extern char* pg_encoding_to_char(int);
 
 #define rb_check_hash_type(x) rb_check_convert_type(x, T_HASH, "Hash", "to_hash")
 
+#define rb_define_singleton_alias(klass,new,old) rb_define_alias(rb_singleton_class(klass),new,old)
+
 #define Data_Set_Struct(obj,ptr) do { \
     Check_Type(obj, T_DATA); \
     DATA_PTR(obj) = ptr; \
@@ -180,6 +182,13 @@ pgconn_connect(argc, argv, self)
     return self;
 }
 
+/*
+ * call-seq:
+ *   PGconn.translate_results = boolean
+ *
+ * When true (default), results are translated to appropriate ruby class.
+ * When false, results are returned as +Strings+.
+ */
 static VALUE
 pgconn_s_translate_results_set(self, fact)
     VALUE self, fact;
@@ -188,18 +197,6 @@ pgconn_s_translate_results_set(self, fact)
     return Qnil;
 }
 
-/*
- * See #new.
- */
-static VALUE
-pgconn_s_connect(argc, argv, klass)
-    int argc;
-    VALUE *argv;
-    VALUE klass;
-{
-    return rb_class_new_instance(argc, argv, klass);
-}
-
 static VALUE format_array_element(VALUE obj);
 
 static VALUE
@@ -282,15 +279,16 @@ format_array_element(obj)
  */
 static VALUE
 pgconn_s_quote(self, obj)
-    VALUE self;
-    VALUE obj;
+    VALUE self, obj;
 {
     char* quoted;
     int size;
     VALUE result;
 
     if (TYPE(obj) == T_STRING) {
-        quoted = ALLOCA_N(char, RSTRING(obj)->len * 2 + 1 + 2);
+        /* length * 2 because every char could require escaping */
+        /* + 2 for the quotes, + 1 for the null terminator */
+        quoted = ALLOCA_N(char, RSTRING(obj)->len * 2 + 2 + 1);
         size = PQescapeString(quoted + 1, RSTRING(obj)->ptr, RSTRING(obj)->len);
         *quoted = *(quoted + size + 1) = SINGLE_QUOTE;
         result = rb_str_new(quoted, size + 2);
@@ -389,39 +387,39 @@ pgconn_s_escape_bytea(self, obj)
  */
 static VALUE
 pgconn_s_unescape_bytea(self, obj)
-    VALUE self;
-    VALUE obj;
+    VALUE self, obj;
 {
     char *from, *to;
     size_t to_len;
     VALUE ret;
-    
+
     Check_Type(obj, T_STRING);
     from = StringValuePtr(obj);
-    
-    to = (char *)PQunescapeBytea(from, &to_len);
-    
+
+    to = (char *) PQunescapeBytea(from, &to_len);
+
     ret = rb_str_new(to, to_len);
     OBJ_INFECT(ret, obj);
-    
     PQfreemem(to);
-    
+
     return ret;
 }
 
 /*
+ * Document-method: new
+ *
  * call-seq:
- *     PGconn.connect(host,  port, options, tty, dbname, login, passwd)  =>  conn
- *     PGconn.open(   host,  port, options, tty, dbname, login, passwd)  =>  conn
- *     PGconn.new(    host,  port, options, tty, dbname, login, passwd)  =>  conn
- *  
- *  _host_::     server hostname (String)
- *  _port_::     server port number (Integer)
+ *     PGconn.open(connection_hash) -> PGconn
+ *     PGconn.open(connection_string) -> PGconn
+ *     PGconn.open(host, port, options, tty, dbname, login, passwd) ->  PGconn
+ *
+ *  _host_::     server hostname
+ *  _port_::     server port number
  *  _options_::  backend options (String)
  *  _tty_::      tty to print backend debug message <i>(ignored in newer versions of PostgreSQL)</i> (String)
- *  _dbname_::     connecting database name (String)
- *  _login_::      login user name (String)
- *  _passwd_::     login password (String)
+ *  _dbname_::     connecting database name
+ *  _login_::      login user name
+ *  _passwd_::     login password
  *  
  *  On failure, it raises a PGError exception.
  */
@@ -460,7 +458,7 @@ get_pgconn(obj)
 
 /*
  * call-seq:
- *    conn.close()
+ *    conn.close
  *
  * Closes the backend connection.
  */
@@ -503,11 +501,13 @@ PGresult *PQexecParams_compat(PGconn *conn, VALUE command, VALUE values);
 
 /*
  * call-seq:
- *    conn.exec( sql )
+ *    conn.exec(sql, *bind_values)
  *
  * Sends SQL query request specified by _sql_ to the PostgreSQL.
  * Returns a PGresult instance on success.
  * On failure, it raises a PGError exception.
+ *
+ * +bind_values+ represents values for the PostgreSQL bind parameters found in the +sql+.  PostgreSQL bind parameters are presented as $1, $1, $2, etc.
  */
 static VALUE
 pgconn_exec(argc, argv, obj)
@@ -658,11 +658,13 @@ pgconn_async_exec(obj, str)
 
 /*
  * call-seq:
- *    conn.query( sql )
+ *    conn.query(sql, *bind_values)
  *
  * Sends SQL query request specified by _sql_ to the PostgreSQL.
  * Returns an Array as the resulting tuple on success.
  * On failure, it returns +nil+, and the error details can be obtained by #error.
+ *
+ * +bind_values+ represents values for the PostgreSQL bind parameters found in the +sql+.  PostgreSQL bind parameters are presented as $1, $1, $2, etc.
  */
 static VALUE
 pgconn_query(argc, argv, obj)
@@ -675,7 +677,7 @@ pgconn_query(argc, argv, obj)
 
 /*
  * call-seq:
- *    conn.async_query( sql )
+ *    conn.async_query(sql)
  *
  * Sends an asynchronous SQL query request specified by _sql_ to the PostgreSQL.
  * Returns an Array as the resulting tuple on success.
@@ -1070,6 +1072,12 @@ pgconn_transaction_status(obj)
 
 #ifdef HAVE_PQSETCLIENTENCODING
 
+/*
+ * call-seq:
+ *  conn.protocol_version -> Integer
+ *
+ * The 3.0 protocol will normally be used when communicating with PostgreSQL 7.4 or later servers; pre-7.4 servers support only protocol 2.0. (Protocol 1.0 is obsolete and not supported by libpq.)
+ */
 static VALUE
 pgconn_protocol_version(obj)
     VALUE obj;
@@ -1077,6 +1085,12 @@ pgconn_protocol_version(obj)
     return INT2NUM(PQprotocolVersion(get_pgconn(obj)));
 }
 
+/*
+ * call-seq:
+ *   conn.server_version -> Integer
+ *
+ * The number is formed by converting the major, minor, and revision numbers into two-decimal-digit numbers and appending them together. For example, version 7.4.2 will be returned as 70402, and version 8.1 will be returned as 80100 (leading zeroes are not shown). Zero is returned if the connection is bad.
+ */
 static VALUE
 pgconn_server_version(obj)
     VALUE obj;
@@ -1084,6 +1098,15 @@ pgconn_server_version(obj)
     return INT2NUM(PQserverVersion(get_pgconn(obj)));
 }
 
+/*
+ * call-seq:
+ *   conn.lastval -> Integer
+ *
+ * Returns the sequence value returned by the last call to the PostgreSQL function <tt>nextval(sequence_name)</tt>. Equivalent to <tt>conn.query('select lastval()').first.first</tt>.
+ *
+ * This functionality is only available with PostgreSQL 8.1 and newer.
+ * See the PostgreSQL documentation on lastval[http://www.postgresql.org/docs/current/interactive/functions-sequence.html] for more information.
+ */
 static VALUE
 pgconn_lastval(obj)
     VALUE obj;
@@ -1116,7 +1139,7 @@ pgconn_lastval(obj)
 
 /*
  * call-seq:
- *    conn.client_encoding() => String
+ *    conn.client_encoding() -> String
  * 
  * Returns the client encoding as a String.
  */
@@ -1338,7 +1361,7 @@ pgresult_aref(argc, argv, obj)
  *
  * Returns an array of Strings representing the names of the fields in the result.
  *
- *   res=conn.exec("SELECT foo,bar AS biggles,jim,jam FROM mytable;")
+ *   res=conn.exec("SELECT foo,bar AS biggles,jim,jam FROM mytable")
  *   res.fields => [ 'foo' , 'biggles' , 'jim' , 'jam' ]
  */
 static VALUE
@@ -1400,7 +1423,7 @@ pgresult_num_fields(obj)
  *
  * Returns the name of the field (column) corresponding to the index.
  *
- *   res=conn.exec("SELECT foo,bar AS biggles,jim,jam FROM mytable;")
+ *   res=conn.exec("SELECT foo,bar AS biggles,jim,jam FROM mytable")
  *   puts res.fieldname(2) => 'jim'
  *   puts res.fieldname(1) => 'biggles'
  *
@@ -1428,7 +1451,7 @@ pgresult_fieldname(obj, index)
  *
  * Returns the index of the field specified by the string _name_.
  *
- *   res=conn.exec("SELECT foo,bar AS biggles,jim,jam FROM mytable;")
+ *   res=conn.exec("SELECT foo,bar AS biggles,jim,jam FROM mytable")
  *   puts res.fieldnum('foo') => 0
  *
  * Raises an ArgumentError if the specified _name_ isn't one of the field names;
@@ -1476,7 +1499,7 @@ pgresult_type(obj, index)
  *
  * Returns the size of the field type in bytes.  Returns <tt>-1</tt> if the field is variable sized.
  *
- *   res = conn.exec("SELECT myInt, myVarChar50 FROM foo;")
+ *   res = conn.exec("SELECT myInt, myVarChar50 FROM foo")
  *   res.size(0) => 4
  *   res.size(1) => -1
  */
@@ -1572,7 +1595,7 @@ pgresult_getlength(obj, tup_num, field_num)
 
 /*
  * call-seq:
- *    res.getisnull( tup_num, field_num ) => true or false
+ *    res.getisnull(tuple_position, field_position) -> boolean
  *
  * Returns +true+ if the specified value is +nil+; +false+ otherwise.
  *
@@ -1672,7 +1695,7 @@ pgresult_print(obj, file, opt)
  *
  * Returns the number of tuples (rows) affected by the SQL command.
  *
- * If the SQL command that generated the PGresult was not one of +INSERT+, +UPDATE+, +DELETE+, +MOVE+, or +FETCH+, or if no tuples (rows) were affected, +0+ is returned.
+ * If the SQL command that generated the PGresult was not one of +INSERT+, +UPDATE+, +DELETE+, +MOVE+, or +FETCH+, or if no tuples (rows) were affected, <tt>0</tt> is returned.
  */
 static VALUE
 pgresult_cmdtuples(obj)
@@ -1750,7 +1773,7 @@ get_pglarge(obj)
 
 /*
  * call-seq:
- *    conn.lo_import( file ) => pglarge
+ *    conn.lo_import(file) -> PGlarge
  *
  * Import a file to a large object. Returns a PGlarge instance on success. On failure, it raises a PGError exception.
  */
@@ -1798,7 +1821,7 @@ pgconn_loexport(obj, lo_oid,filename)
 
 /*
  * call-seq:
- *    conn.lo_create( [mode] ) => pglarge
+ *    conn.lo_create( [mode] ) -> PGlarge
  *
  * Returns a PGlarge instance on success. On failure, it raises PGError exception.
  * <i>(See #lo_open for information on _mode_.)</i>
@@ -1832,7 +1855,7 @@ pgconn_locreate(argc, argv, obj)
 
 /*
  * call-seq:
- *    conn.lo_open( oid, [mode] ) => pglarge
+ *    conn.lo_open( oid, [mode] ) -> PGlarge
  *
  * Open a large object of _oid_. Returns a PGlarge instance on success.
  * The _mode_ argument specifies the mode for the opened large object,
@@ -2199,6 +2222,12 @@ pgrow_init(self, keys)
     return self;
 }
 
+/*
+ * call-seq:
+ *   row.keys -> Array
+ *
+ * Column names.
+ */
 static VALUE
 pgrow_keys(self)
     VALUE self;
@@ -2206,6 +2235,10 @@ pgrow_keys(self)
     return rb_iv_get(self, "@keys");
 }
 
+/*
+ * call-seq:
+ *   row.values -> row
+ */
 static VALUE
 pgrow_values(self)
     VALUE self;
@@ -2213,6 +2246,13 @@ pgrow_values(self)
     return self;
 }
 
+/*
+ * call-seq:
+ *   row[position] -> value
+ *   row[name] -> value
+ *
+ * Access elements of this row by column position or name.
+ */
 static VALUE
 pgrow_aref(argc, argv, self)
     int argc;
@@ -2229,6 +2269,12 @@ pgrow_aref(argc, argv, self)
     }
 }
 
+/*
+ * call-seq:
+ *   row.each_value { |value| block } -> row
+ *
+ * Iterate with values.
+ */
 static VALUE
 pgrow_each_value(self)
     VALUE self;
@@ -2237,6 +2283,12 @@ pgrow_each_value(self)
     return self;
 }
 
+/*
+ * call-seq:
+ *   row.each_pair { |column_value_array| block } -> row
+ *
+ * Iterate with column,value pairs.
+ */
 static VALUE
 pgrow_each_pair(self)
     VALUE self;
@@ -2249,6 +2301,13 @@ pgrow_each_pair(self)
     return self;
 }
 
+/*
+ * call-seq:
+ *   row.each { |column, value| block } -> row
+ *   row.each { |value| block } -> row
+ *
+ * Iterate with values or column,value pairs.
+ */
 static VALUE
 pgrow_each(self)
     VALUE self;
@@ -2263,6 +2322,12 @@ pgrow_each(self)
     return self;
 }
 
+/*
+ * call-seq:
+ *   row.each_key { |column| block } -> row
+ *
+ * Iterate with column names.
+ */
 static VALUE
 pgrow_each_key(self)
     VALUE self;
@@ -2271,6 +2336,13 @@ pgrow_each_key(self)
     return self;
 }
 
+/*
+ * call-seq:
+ *   row.to_hash -> Hash
+ *
+ * Returns a +Hash+ of the row's values indexed by column name.
+ * Equivalent to <tt>Hash [*row.keys.zip(row).flatten]</tt>
+ */
 static VALUE
 pgrow_to_hash(self)
     VALUE self;
@@ -2291,12 +2363,11 @@ pgrow_to_hash(self)
  * Document-class: PGconn
  *
  * The class to access PostgreSQL database.
- * All other functionality of libpq save the large object to a file.
  *
  * For example, to send query to the database on the localhost:
- *    require "postgres"
- *    conn = PGconn.connect("localhost", 5432, "", "", "test1")
- *    res  = conn.exec("select * from a;")
+ *    require 'postgres'
+ *    conn = PGconn.open('dbname' => 'test1')
+ *    res  = conn.exec('select * from a')
  *
  * See the PGresult class for information on working with the results of a query.
  */
@@ -2313,6 +2384,13 @@ pgrow_to_hash(self)
  */
 
 
+/********************************************************************
+ * 
+ * Document-class: PGrow
+ *
+ * Array subclass that provides hash-like behavior.
+ */
+
 
 /********************************************************************
  * 
@@ -2347,12 +2425,14 @@ Init_postgres()
 #else
     rb_define_singleton_method(rb_cPGconn, "new", pgconn_s_new, -1);
 #endif  
-    rb_define_singleton_method(rb_cPGconn, "connect", pgconn_s_connect, -1);
-    rb_define_singleton_method(rb_cPGconn, "open", pgconn_s_connect, -1);
-    rb_define_singleton_method(rb_cPGconn, "setdb", pgconn_s_connect, -1);
-    rb_define_singleton_method(rb_cPGconn, "setdblogin", pgconn_s_connect, -1);
+    rb_define_singleton_alias(rb_cPGconn, "connect", "new");
+    rb_define_singleton_alias(rb_cPGconn, "open", "connect");
+    rb_define_singleton_alias(rb_cPGconn, "setdb", "connect");
+    rb_define_singleton_alias(rb_cPGconn, "setdblogin", "connect");
+    rb_define_singleton_alias(rb_cPGconn, "open", "connect");
     rb_define_singleton_method(rb_cPGconn, "escape", pgconn_s_escape, 1);
     rb_define_singleton_method(rb_cPGconn, "quote", pgconn_s_quote, 1);
+    rb_define_singleton_alias(rb_cPGconn, "format", "quote");
     rb_define_singleton_method(rb_cPGconn, "escape_bytea", pgconn_s_escape_bytea, 1);
     rb_define_singleton_method(rb_cPGconn, "unescape_bytea", pgconn_s_unescape_bytea, 1);
     rb_define_singleton_method(rb_cPGconn, "translate_results=", pgconn_s_translate_results_set, 1);
@@ -2387,6 +2467,8 @@ Init_postgres()
     rb_define_method(rb_cPGconn, "transaction_status", pgconn_transaction_status, 0);
     rb_define_method(rb_cPGconn, "protocol_version", pgconn_protocol_version, 0);
     rb_define_method(rb_cPGconn, "server_version", pgconn_server_version, 0);
+    /* following line is for rdoc */
+    /* rb_define_method(rb_cPGconn, "lastval", pgconn_lastval, 0); */
 
 #ifdef HAVE_PQSETCLIENTENCODING
     rb_define_method(rb_cPGconn, "client_encoding", pgconn_client_encoding, 0);

data/ruby-postgres.gemspec

@@ -1,35 +1,35 @@
-require 'rubygems'
-require 'date'
-
-SPEC = Gem::Specification.new do |s|
-  s.name              = 'ruby-postgres'
-  s.rubyforge_project = 'ruby-postgres'
-  s.version           = "0.7.1.#{Date.today}".tr('-', '.')
-  s.summary           = 'Ruby extension for PostgreSQL database coordination'
-  s.author            = 'Yukihiro Matsumoto, Eiji Matsumoto, Noboru Saitou, Dave Lee'
-  s.email             = 'davelee.com@gmail.com'
-  s.homepage          = 'http://ruby.scripting.ca/postgres/'
-  s.requirements      = 'PostgreSQL libpq library and headers'
-  s.has_rdoc          = true
-  s.require_path      = '.'
-  s.autorequire       = 'postgres'
-
-  if File.exists? 'postgres.so' and PLATFORM =~ /mingw|mswin/
-    s.platform        = Gem::Platform::WIN32
-  else
-    s.platform        = Gem::Platform::RUBY
-    s.extensions      = 'extconf.rb'
-  end
-
-  if File.exists? '_darcs'
-    s.files           = Dir.chdir('_darcs/current') { Dir['**/*'] }
-  else
-    s.files           = Dir['**/*']
-  end
-
-end
-
-if $0 == __FILE__
-  Gem::manage_gems
-  Gem::Builder.new(SPEC).build
-end
+require 'rubygems'
+require 'date'
+
+SPEC = Gem::Specification.new do |s|
+  s.name              = 'ruby-postgres'
+  s.rubyforge_project = 'ruby-postgres'
+  s.version           = "0.7.1.#{Date.today-1}".tr('-', '.')
+  s.summary           = 'Ruby extension for PostgreSQL database coordination'
+  s.author            = 'Yukihiro Matsumoto, Eiji Matsumoto, Noboru Saitou, Dave Lee'
+  s.email             = 'davelee.com@gmail.com'
+  s.homepage          = 'http://ruby.scripting.ca/postgres/'
+  s.requirements      = 'PostgreSQL libpq library and headers'
+  s.has_rdoc          = true
+  s.require_path      = '.'
+  s.autorequire       = 'postgres'
+
+  if File.exists? 'postgres.so' and PLATFORM =~ /mingw|mswin/
+    s.platform        = Gem::Platform::WIN32
+  else
+    s.platform        = Gem::Platform::RUBY
+    s.extensions      = 'extconf.rb'
+  end
+
+  if File.exists? '_darcs'
+    s.files           = Dir.chdir('_darcs/current') { Dir['**/*'] }
+  else
+    s.files           = Dir['**/*']
+  end
+
+end
+
+if $0 == __FILE__
+  Gem::manage_gems
+  Gem::Builder.new(SPEC).build
+end

data/{test.rb → tests/tc_postgres.rb}

@@ -1,11 +1,17 @@
 require 'postgres'
 require 'date'
 require 'test/unit'
-class TC_MyTest < Test::Unit::TestCase
+
+class PostgresTestCase < Test::Unit::TestCase
+
   def setup
     @conn = PGconn.new('dbname' => 'template1')
   end
 
+  def teardown
+    @conn.close
+  end
+
   def test_conversion
     query = <<-EOT
 select true as true_value,
@@ -42,4 +48,5 @@ EOT
     assert_kind_of(Integer, tuple['numeric_10_value'])
     assert_equal(BigDecimal("12345.12345"), tuple['numeric_10_5_value'])
   end
+
 end

metadata

@@ -1,13 +1,13 @@
-!ruby/object:Gem::Specification 
-rubygems_version: 0.8.11
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.8.10
 specification_version: 1
 name: ruby-postgres
 version: !ruby/object:Gem::Version 
-  version: 0.7.1.2005.11.26
-date: 2005-11-26 00:00:00 -06:00
+  version: 0.7.1.2005.11.27
+date: 2005-11-28
 summary: Ruby extension for PostgreSQL database coordination
 require_paths: 
-- .
+  - "."
 email: davelee.com@gmail.com
 homepage: http://ruby.scripting.ca/postgres/
 rubyforge_project: ruby-postgres
@@ -18,48 +18,45 @@ bindir: bin
 has_rdoc: true
 required_ruby_version: !ruby/object:Gem::Version::Requirement 
   requirements: 
-  - - ">"
-    - !ruby/object:Gem::Version 
-      version: 0.0.0
+    - 
+      - ">"
+      - !ruby/object:Gem::Version 
+        version: 0.0.0
   version: 
 platform: ruby
-signing_key: 
-cert_chain: 
 authors: 
-- Yukihiro Matsumoto, Eiji Matsumoto, Noboru Saitou, Dave Lee
+  - "Yukihiro Matsumoto, Eiji Matsumoto, Noboru Saitou, Dave Lee"
 files: 
-- sample
-- Contributors
-- test.rb
-- ruby-postgres.gemspec
-- ChangeLog
-- libpq-compat.c
-- README
-- doc
-- MANIFEST
-- postgres.c
-- extconf.rb
-- type-oids.h
-- README.ja
-- sample/psqlHelp.rb
-- sample/losample.rb
-- sample/test4.rb
-- sample/test2.rb
-- sample/test1.rb
-- sample/psql.rb
-- doc/postgres.jp.html
-- doc/postgres.html
+  - ChangeLog
+  - Contributors
+  - doc
+  - extconf.rb
+  - libpq-compat.c
+  - Makefile
+  - MANIFEST
+  - mkmf.log
+  - postgres.c
+  - README
+  - README.ja
+  - ruby-postgres.gemspec
+  - sample
+  - tests
+  - type-oids.h
+  - doc/postgres.html
+  - doc/postgres.jp.html
+  - sample/losample.rb
+  - sample/psql.rb
+  - sample/psqlHelp.rb
+  - sample/test1.rb
+  - sample/test2.rb
+  - sample/test4.rb
+  - tests/tc_postgres.rb
 test_files: []
-
 rdoc_options: []
-
 extra_rdoc_files: []
-
 executables: []
-
 extensions: 
-- extconf.rb
+  - extconf.rb
 requirements: 
-- PostgreSQL libpq library and headers
-dependencies: []
-
+  - PostgreSQL libpq library and headers
+dependencies: []