ruby-postgres 0.7.1.2005.11.23

data/ChangeLog

@@ -0,0 +1,261 @@
+Ruby extension library to access PostgreSQL.
+===========================================
+
+Tue Dec 14 2004
+	* set_notice_processor: add methods set_notice_processor.
+	Dennis Vshivkov <walrus@amur.ru>	
+	
+Sat Nov  6 2004
+	* unescape_bytea: add methods unescape_bytea.
+	  patch supplied by "Henry T. So Jr." <henryso@panix.com>
+	
+Sat Oct  9 2004
+	* extconf.rb: VERSION -> RUBY_VERSION. 
+	  add header check.
+	  patch supplied by MoonWolf <moonwolf@moonwolf.com>
+
+Fri Jul  2 2004
+	* open: add methods open.
+	  patch supplied by Leon Brooks <leon-ruby-postgres@cyberknights.com.au>
+	
+Tue Feb 24 2004
+	* postgres.c: add comments.
+	  patch supplied by Gavin Kistner <gavin@refinery.com>
+	
+Fri Nov 23 2003
+	* extconf.rb: add ssl support.
+	  patch supplied by Martin Hedenfalk <mahe@kth.se>
+
+Sat Nov  1 2003
+
+	* oid: add methods oid.
+	  patch supplied by Ceri Storey <cez@compsoc.man.ac.uk>
+ 
+Mon Jan  6 2003 version 0.7.1
+	
+	* async_exec: remove check of PQisBusy.
+	  patch supplied by <m_seki@mva.biglobe.ne.jp>
+	
+Wed Oct 16 2002 version 0.7.0
+	
+	* rename README.jp -> README.ja.
+
+Thu Oct 10 2002
+	
+	* get_notify: bug fix Deletes of unnecessary "free(notify);"
+	  debian bug report.
+	
+Wed Oct  9 2002
+	
+	* query: add pgresult_clear.
+	  patch supplied by "Shirai,Kaoru" <shirai@p1jp.com>
+
+Sat Sep 28 2002
+	
+	* PGconn: add methods escape, quote, escape_bytes. 
+	  patch supplied by MoonWolf <moonwolf@moonwolf.com>
+
+Tue Aug 20 2002 
+
+	* extconf.rb add dir_config('postgres')
+ 	  patch supplied by Nate Haggard <nate@wordplace.com>
+	
+Mon Jun  3 2002 version 0.7.0-pre2
+	
+	* not to use fe_getauthname().
+	  patch supplied by Neil Conway <nconway@klamath.dyndns.org>
+	
+Thu May 30 2002 version 0.7.0-pre1
+	
+	* Fix to insert_table so that nil values in Ruby are inserted
+	  back into the database as nulls.
+	  patch supplied by Jeremy Henty <jeremy@chaos.org.uk>
+
+	* Fix to insert_table to protect characters that Postgres would
+	  otherwise interpret specially.
+	  patch supplied by Jeremy Henty <jeremy@chaos.org.uk>
+	
+Wed Apr 24 2002
+	
+	* Removed unused variables.
+	* Improve notification code.
+	* Add a missing "return Qnil" statement in a function 
+	  declared to return VALUE.
+	* Fix an minor error in pgconn_loopen().
+	  patch supplied by Neil Conway <nconway@klamath.dyndns.org>	
+	
+Tue Mar  5 2002
+	
+	* fix pglarge_write return.
+	  patch supplied by Noboru Matui <silicon@mx1.freemail.ne.jp>
+
+Mon Jan  7 2002
+	
+	* refer to POSTGRES_INCLUDE and POSTGTRES_LIB 
+	  environmental variables.
+	  patch supplied by Neil Conway <nconway@klamath.dyndns.org>
+	
+Sun Dec 16 2001
+	
+	* add methods "getisnull".
+	  patch supplied by Jeremy Henty <jeremy@chaos.org.uk>
+	
+Tue Nov 27 2001
+	
+	* convert NULL => nil .
+	  patch supplied by "Shirai,Kaoru" <shirai@p1jp.com>
+
+Mon Nov 19 2001 version 0.6.5 released
+	
+	* change my address.
+	  Noboru Saitou <noborus@netlab.jp>
+	
+Fri Nov 16 2001	
+	
+	* default encoding set.
+	  Riley <wormwood@speakeasy.org>
+
+Fri Nov 16 2001	
+	
+	* add methods "cmdtuples"
+          Gabriel Emerson <gemerson@evalsoft.com>	
+	  Thanks to greentea@fa2.so-net.ne.jp
+	
+Thu Jul 12 2001
+	
+	* psql.rb $OPT_p => $OPT_p.to_i (bug fix).
+	  Yuta TSUBOI <yuuta-t@is.aist-nara.ac.jp>
+	
+Mon Apr 23 2001 version 0.6.4 released
+	
+	* add include sys/types.h
+          patch supplied by "Akinori MUSHA" <knu@iDaemons.org>.
+	
+Sun Apr 22 2001 version 0.6.3 released
+
+	* document updated.
+	
+Sun Mar 18 2001
+	
+	* extern -> EXTERN changed.
+          shibata <kshibata@vesta.ocn.ne.jp>
+	
+Sun Feb 11 2001
+	
+	* add methods "async_exec" and "async_query.
+	  patch supplied by  Andy Yu <is@gnuchina.org>.
+
+Tue Feb  6 2001 version 0.6.2 released
+	
+	* extconf.rb have_func second argument omit.
+	  (old ruby version support).
+
+Mon Feb  5 2001
+
+	* RSTRING(*)->ptr -> STR2CSTR(*) changed.
+
+Sun Feb  4 2001
+	 
+	* README and README.jp  copying are unified to Ruby's.
+	 
+Wed Jan 31 2001
+	
+	* postgres.html bug fix and better.
+	  patch supplied by Neil Conway <nconway@klamath.dyndns.org>.
+
+	* README bug fix and better.
+	  patch supplied by Neil Conway <nconway@klamath.dyndns.org>.
+	 
+Sat Jan 27 2001
+	
+	* extconf.rb add error message for
+	  Could not find PostgreSQL libraries.
+	  patch supplied by Neil Conway <nconway@klamath.dyndns.org>.
+	 
+Tue Jan 23 2001
+
+	* add methods "initialize".
+	  patch supplied by <matz@zetabits.com>.
+
+Sun Dec 17 2000 
+	
+	* 8192 byte limit removed.
+	
+Tue Oct 11 2000	
+
+	* methods name lo* -> lo_* changed.
+
+	* extconf.rb bug fix.
+	   have_func("PQsetClientEncoding")
+
+Thu Jun 30 2000 version 0.6.1 released
+
+	* change receive parameter with VALUE.
+	  (exec, insert_table, putline)
+
+	* insert_table: remove debug print.
+	
+	* insert_table bug fix.
+	  patch supplied by "Okada Jun" <yun@be-in.org>.
+
+	* extconf.rb ClientEncoding->SetClientEnocoding.
+
+Sun May 21 2000 version 0.6.0 released
+
+	* change the maintainer with 
+	  Noboru Saitou <noborus@mb.kcom.ne.jp>.
+
+	* add provided clientEnocoding and setClientEncoding.
+
+	* replace rb_str_new with rb_tainted_str_new.
+	  ts <decoux@moulon.inra.fr>
+
+	* add provided Large Object support!
+
+	* error message changed PQerrorMessage() use.
+
+Fri Feb 25 2000 version 0.5.4 released
+
+	* PGError should be subclass of StandardError.
+
+Fri Aug  6 1999 version 0.5.3 released
+
+	* use PQsetdbLogin() instead of PQsetdb().
+	  patch supplied by <kasa@air.linkclub.or.jp>.
+
+Tue Jul 30 1999 version 0.5.2 released
+
+	* document updated.
+	* better Ruby 1.3 support.
+
+Tue Jul 13 1999 version 0.5.1 released
+
+	* modified for Ruby 1.3.x or later.
+
+Wed Jan 20 1999 version 0.4.1 released
+
+	* Makefile.rb, extconf.rb: trivial bug fix.
+
+Thu Dec 12 1997 version 0.4 released
+
+	* PGresult: add new method -- each{}, [] --
+	* provided Makefile.rb for ruby-1.1b
+
+Thu Sep 25 1997 version 0.3.1 released
+
+	* extconf.rb bug fix.
+	* documentation about 'How to install' 
+
+Mon Sep 4 1997 version 0.3 released
+
+	* remove restrictions about japanese EUC characters.
+	* parseArgs related bug fix.
+
+Mon Sep 2 1997 version 0.2 released
+
+	* provided psql.rb. (an interactive interface for PostgreSQL)
+	* some bug fixes.
+
+Mon Aug 22 1997 version 0.1 released
+
+	* first release.

data/Contributors

@@ -0,0 +1,26 @@
+Dennis Vshivkov <walrus@amur.ru>
+Gabriel Emerson <gemerson@evalsoft.com>
+Noboru Saitou <noborus@netlab.jp>
+Akinori MUSHA <knu@iDaemons.org>
+Andy Yu <is@gnuchina.org>
+Ceri Storey <cez@compsoc.man.ac.uk>
+Gavin Kistner <gavin@refinery.com>
+Henry T. So Jr. <henryso@panix.com>
+Jeremy Henty <jeremy@chaos.org.uk>
+<kasa@air.linkclub.or.jp>
+Leon Brooks <leon-ruby-postgres@cyberknights.com.au>
+Martin Hedenfalk <mahe@kth.se>
+<matz@zetabits.com>
+MoonWolf <moonwolf@moonwolf.com>
+<m_seki@mva.biglobe.ne.jp>
+Nate Haggard <nate@wordplace.com>
+Neil Conway <nconway@klamath.dyndns.org>
+Noboru Matui <silicon@mx1.freemail.ne.jp>
+Okada Jun <yun@be-in.org>
+Shirai,Kaoru <shirai@p1jp.com>
+Riley <wormwood@speakeasy.org>
+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

data/MANIFEST

@@ -0,0 +1,14 @@
+MANIFEST
+ChangeLog
+postgres.c
+extconf.rb
+README
+README.ja
+doc/postgres.html
+doc/postgres.jp.html
+sample/psql.rb
+sample/psqlHelp.rb
+sample/test1.rb
+sample/test2.rb
+sample/test4.rb
+sample/losample.rb

data/README

@@ -0,0 +1,171 @@
+        The extension for PostgreSQL access  version 0.7.1
+
+                                                 Yukihiro Matsumoto
+						     Eiji Matsumoto
+
+                                    maintainer:    Noboru Saitou
+- What's this ?
+
+This is the extension library to access a PostgreSQL database from Ruby.
+This library works with PostgreSQL 6.5/7.0/7.1/7.2; it probably works 
+with 6.3 or earlier with slight modification, but not tested at all.
+
+- Requirements
+
+  Ruby 1.3.4 or later.
+  PostgreSQL 6.4/6.5/7.0/7.1/7.2 installed.
+
+- How to install ?
+
+Follow the instructions below to compile and install:
+
+  ruby extconf.rb
+  make
+  su              (if necessary)
+  make install
+
+You may need to specify the directory name for the include files and the
+-lpq library by using
+
+    --with-pgsql-include-dir=<include file directory>
+    --with-pgsql-lib-dir=<library directory>
+ or 
+    --with-pgsql-dir=<dir>
+      Same as --with-pgsql-include-dir=<dir>/include,
+      --with-pgsql-lib-dir=<dir>/lib
+
+
+For example:
+
+  ruby extconf.rb --with-pgsql-include-dir=/usr/local/pgsql/include \
+                  --with-pgsql-lib-dir=/usr/local/pgsql/lib
+or
+  ruby extconf.rb --with-pgsql-dir=/usr/local/pgsql/
+
+- How to use ?
+
+You need to specify:
+
+  require "postgres"
+
+at the top of your script.
+
+- What functions can I use ?
+
+The list of supported functions are below.  See postgres.html for detail.
+
+class PGconn:
+
+ class methods:
+    new
+    connect
+    setdb
+    setdblogin
+
+    escape
+    quote
+    escape_bytea
+
+ methods:
+    db
+    host
+    options
+    port
+    tty
+    status
+    error
+    finish
+    close
+    reset
+    user
+    trace
+    untrace
+
+    exec
+    query
+    async_exec
+    async_query
+    get_notify
+    insert_table
+    putline
+    getline
+    endcopy
+    notifies
+
+    lo_import
+    lo_export
+    lo_create
+    lo_open  
+    lo_unlink
+
+    client_encoding
+    set_client_encoding
+
+class PGresult:
+
+ methods:
+    each
+    []
+    status
+    result
+    fields
+    num_tuples
+    num_fields
+    fieldname
+    fieldnum
+    type
+    size
+    getvalue
+    getlength
+    cmdstatus
+    print
+    clear
+
+class PGlarge:
+
+ methods:
+    open
+    close
+    read
+    write
+    lseek
+    tell
+    unlink
+    oid
+    size
+    export
+
+- Acknowledgments
+
+We are thankful to the people at the ruby-list and ruby-dev mailing lists.
+And to the people who developed PostgreSQL.
+
+- Copying
+
+This library is copyrighted by its authors; Yukihiro Matsumoto, and Eiji
+Matsumoto.
+
+You can redistribute This library and/or modify it under the same term
+of Ruby.  License of Ruby is included with Ruby distribution in
+the file "README".
+
+Please ask Noboru Saitou. Because I am maintainer currently.
+
+- Authors
+
+ Yukihiro Matsumoto <matz@ruby-lang.org>
+  Author of Ruby.
+
+ Eiji Matsumoto <usagi@ruby.club.or.jp>
+  One of users who loves Ruby.
+
+No, we are not literal brothers :-)
+
+- Special Thanks
+
+ Guy Decoux   ts <decoux@moulon.inra.fr> 
+
+- maintainer
+
+ Noboru Saitou <noborus@netlab.jp>
+

data/README.ja

@@ -0,0 +1,183 @@
+                  PostgreSQL$BMQ3HD%%i%$%V%i%j(B  version 0.7.1
+
+                                                             $B$^$D$b$H(B $B$f$-$R$m(B
+                                                             $B$^$D$b$H(B $B$($$$8(B
+
+                                                  $B@$OC?M(B:    $B@FF#(B $BEP(B
+	
+- What's this ?
+
+$BK\%i%$%V%i%j$O!"(BRuby$B$+$i(BPostgreSQL$B$X%"%/%;%9$9$k$?$a$N3HD%%i%$%V%i%j$G$9!#(B
+$B%5%]!<%H$7$F$$$k(BPostgreSQL$B$N%P!<%8%g%s$O!"(B6.5/7.0/7.1/7.2 $B$G$9!#(B6.3$B0JA0$N(B
+$B%P!<%8%g%s$G$b(B($B$A$g$C$H$7$?JQ99$G(B)$BF0:n$9$k$H;W$$$^$9$,!"%F%9%H$7$F$$$^$;$s!#(B
+
+- How to install ?
+ *** requirement ***
+ PostgreSQL module$B$r;H$&$s$G$9$+$i!$EvA3(BPostgreSQL$B$OI,MW$G$9$M!%:#$N$H$3$m(B
+ $B%m!<%+%k$K(BPostgreSQL$B$,%$%s%9%H!<%k$5$l$F$$$k$3$H$rA0Ds$K$7$F$$$^$9$,!$(B
+ $BI,MW$J%X%C%@$H(Blibpq$B$5$($"$l$P!$%5!<%P$OI,$:$7$b%m!<%+%k$GF0:n$7$F$$$kI,MW(B
+ $B$O$"$j$^$;$s!%(B
+
+ $B%G%U%)%k%H$G$O!$(BPostgreSQL$B$,(B/usr/local/pgsql$BG[2<$K%$%s%9%H!<%k$5$l$F$$$k(B
+ $B$H$7$F$$$^$9!%JL$N>l=j$K%$%s%9%H!<%k$7$F$$$k>l9g$K$O!$4D6-JQ?t(BPGLIB$B$K(Blibpq
+ $B%i%$%V%i%j$,CV$$$F$"$k(Bdirectory$B$K@_Dj$7$F2<$5$$!#(B
+
+ $BG$0U$N>l=j$G!$$3$N%"!<%+%$%V$rE83+$7$F$/$@$5$$!%8e$O(B
+
+  ruby extconf.rb
+  make
+  su               ($B$b$7I,MW$J$i(B)
+  make install
+ 
+ $B$H$9$k$@$1$G$9!%(BPostgreSQL$B$N%$%s%/%k!<%I%U%!%$%k!"%i%$%V%i%j%U%!%$%k$N(B
+ $B%$%s%9%H!<%k>l=j$,I8=`$N0LCV$G$O$J$/%3%s%Q%$%i$,8+IU$1$k$3$H$,$G$-$J$$(B
+ $B>l9g$K$O(B
+
+    --with-pgsql-include-dir=<$B%$%s%/%k!<%I%U%!%$%k%G%#%l%/%H%j(B>
+    --with-pgsql-lib-dir=<$B%i%$%V%i%j%G%#%l%/%H%j(B>
+$B$^$?$O(B
+    --with-pgsql-dir=<$B%G%#%l%/%H%j(B>
+          $B$3$l$O0J2<$N$h$&$K;XDj$7$?$H$-$H$*$J$8$G$9!#(B
+           --with-pgsql-include-dir=<$B%G%#%l%/%H%j(B>/include
+           --with-pgsql-lib-dir=<$B%G%#%l%/%H%j(B>/lib
+
+
+ $BNc$($P(B
+
+  ruby extconf.rb --with-pgsql-include-dir=/usr/local/pgsql/include \
+                  --with-pgsql-lib-dir=/usr/local/pgsql/lib
+$B$^$?$O(B
+  ruby extconf.rb --with-pgsql-dir=/usr/local/pgsql
+
+ $B$N$h$&$K;XDj$7$F$/$@$5$$!#(B
+
+- How to use ?
+
+  require "postgres"
+
+$B$H$7$F$+$i8f;HMQ2<$5$$!#(B
+
+- What function can I use ?
+
+$B4pK\E*$K!"(BC$B$N(Blibpq$B%$%s%?%U%'!<%9$GDj5A$5$l$F$$$k4X?t$O%5%]!<%H$7$F$$$^$9!#(B
+ver 0.6.0 $B$+$i?7$7$/(B Large Object $B%$%s%?!<%U%'%$%9$,DI2C$5$l$^$7$?!#(B
+
+$B%5%]!<%H$7$F$$$k%a%=%C%I$N0lMw$O0J2<$NDL$j$G$9!#(B
+
+PGconn$B%/%i%9(B:
+
+ $B%/%i%9%a%=%C%I(B
+    new
+    connect
+    setdb
+    setdblogin
+    escape
+    quote
+    escape_bytea
+
+ $B%a%=%C%I(B
+    db
+    host
+    options
+    port
+    tty
+    status
+    error
+    finish
+    close
+    reset
+    user
+    trace
+    untrace
+
+    exec
+    query
+    async_exec
+    async_query
+    get_notify
+    insert_table
+    putline
+    getline
+    endcopy
+    notifies
+
+    lo_import
+    lo_export
+    lo_create
+    lo_open  
+    lo_unlink
+
+    client_encoding
+    set_client_encoding
+
+PGresult$B%/%i%9(B:
+
+$B%a%=%C%I(B
+    each
+    []
+    status
+    result
+    fields
+    num_tuples
+    num_fields
+    fieldname
+    fieldnum
+    type
+    size
+    getvalue
+    getlength
+    cmdstatus
+    print
+    clear
+
+PGlarge$B%/%i%9(B:
+
+$B%a%=%C%I(B
+    open
+    close
+    read
+    write
+    lseek
+    tell
+    unlink
+    oid
+    size
+    export
+    
+- Acknowledgement
+
+$BK\3HD%%i%$%V%i%j$r:n@.$9$k$K$"$?$C$F!"(Bruby-list, ruby-dev,
+ruby-talk,$B5Z$S(B pgsql-jp$B%a!<%j%s%0%j%9%H$N%a%s%P!<$K!"B?$/$NM-1W$J(B
+$B%"%I%P%$%9$rD:$-$^$7$?!#$3$3$K46<U$N0U$rI=$7$^$9!#(B
+
+- Copying
+
+$BK\3HD%%i%$%V%i%j$NCx:n8"$O!"$^$D$b$H(B $B$f$-$R$m$H$^$D$b$H(B $B$($$$8$,(B
+$BJ];}$7$^$9!#(B
+
+$BK\3HD%%i%$%V%i%j$O!"(BRuby$BK\BN$HF1$8G[I[>r7o$K=>$C$F:FG[I[$9$k$3$H(B
+$B$,$G$-$^$9!#(BRuby$BK\BN$NG[I[>r7o$K$D$$$F$O!"(BRuby$BG[I[J*Cf$N(BREADME.jp
+$B$K=q$+$l$F$$$^$9!#(B
+
+$B8=:_$O@FF#(B $BEP$,(B maintainer $B$r>5$C$F$$$k$N$G!"Ld$$9g$o$;$O$3$A$i$NJ}$K(B
+$B$*4j$$$7$^$9!#(B
+
+- Author
+
+ $B$^$D$b$H(B $B$f$-$R$m(B <matz@ruby-lang.org>
+  Author of Ruby
+
+ $B$^$D$b$H(B $B$($$$8(B <usagi@ruby.club.or.jp>
+  One of users who loves Ruby
+
+$B$3$N$U$?$j$O7;Do$G$O$"$j$^$;$s!#(B :-)
+
+- Special Thanks
+
+ Guy Decoux   ts <decoux@moulon.inra.fr>
+
+- maintainer
+
+  $B@FF#(B $BEP(B <noborus@netlab.jp>
+  $B$^$D$b$H$G$J$/$F$9$$$^$;$s(B :-)
+