pg 0.9.0.pre156-x86-mingw32

data/README.OS_X

@@ -0,0 +1,19 @@
+= Compiling on MacOS X
+
+If you are building/installing ruby-pg on MacOS X, and the installation doesn't work at first, here are a few things you can try.
+
+== Compiling With the Correct Architecture
+
+OS X supports both architecture-specific binaries (e.g. i386), as well as universal binaries (i.e. i386 & ppc). If ruby is built as a universal binary and postgresql is not, you need to specify the path to the appropriate pg_config binary or set the environment variable ARCHFLAGS appropriately.
+
+For example, if you're using the stock Ruby binary, and PostgreSQL 8.4.x installed from MacPorts (without specifying the {{{+universal}}} variant), do:
+
+  gem install -- --with-pg-config=/opt/local/lib/postgresql84/bin/pg_config
+
+Alternatively, if the build system can't figure out which architectures it should include, you may need to set the 'ARCHFLAGS' environment variable explicitly:
+
+  sudo env ARCHFLAGS='-arch i386' gem install pg
+
+or, if you're building from source:
+
+  rake compile ARCHFLAGS="-arch i386"

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 :-)
+

data/README.windows

@@ -0,0 +1,72 @@
+
+= Compiling on MS Windows
+
+In order to build this extension on MS Windows you will need a couple things.
+
+First, a compiler. For the one click installer this means you should either
+use VC++ 6.0 or the compiler that comes with cygwin or mingw if you're
+building on that platform.
+
+If you've built Ruby yourself, you should use the same compiler to build
+this library that you used to build Ruby.
+
+Second, PostgreSQL. Be sure you installed it with the development header
+files if you installed it using the standard PostgreSQL installer for
+Windows. If you didn't, you can run the installer again, select "modify",
+and then select the 'development headers' option to install them.
+
+I recommend making sure that 'pg_config.exe' is in your PATH. The PostgreSQL
+installer for Windows does not necessarily update your PATH when it installs
+itself, so you may need to do this manually. This isn't strictly necessary,
+however.
+
+In order to build ruby-pg, just run 'rake'. If the pg_config.exe executable
+is not in your PATH, you'll need to explicitly point ruby-pg to where your
+PostgreSQL headers and libraries are with something like this:
+
+   rake --with-pg-dir=c:/progra~1/postgr~1/8.3
+
+Adjust your path accordingly. BE SURE TO USE THE SHORT PATH NAMES! If you
+try to use a path with spaces in it, the nmake.exe program will choke.
+
+
+== Cross compiling for mswin32
+
+Using rake-compiler a cross compiled pg-gem can be build on a linux host for
+the win32 platform. The generated gem is statically linked against libpq and
+libssl. OpenSSL and PostgreSQL are downloaded and compiled from the sources.
+There are no runtime dependencies to any but the standard Windows DLLs.
+
+Install mingw32. On a debian based system this should work:
+
+   apt-get install mingw32
+
+On MacOS X, if you have MacPorts installed:
+
+  port install i386-mingw32-gcc
+
+Install the rake-compiler:
+
+  gem install rake-compiler
+
+Download and cross compile ruby for win32:
+
+  rake-compiler cross-ruby VERSION=1.8.6-p287
+
+Download and cross compile pg for win32:
+
+  rake cross native gem RUBY_CC_VERSION=1.8.6 OPENSSL_VERSION=0.9.8l POSTGRESQL_VERSION=8.4.2
+
+If everything works, there should be pg-VERSION-x86-mswin32.gem in the pkg
+directory.
+
+
+If you have any problems you can submit them via the project's issue-tracker:
+
+  http://bitbucket.org/ged/ruby-pg/issues/new/
+
+Or you can join the mailing list:
+
+  ruby-pg-general@rubyforge.org
+
+And submit questions, problems, or solutions, so that it can be improved.

data/Rakefile.local

@@ -0,0 +1,239 @@
+#!rake
+
+require 'rake/extensiontask'
+require 'rake/extensioncompiler'
+require 'rbconfig'
+
+# C extension constants
+EXT_MAKEFILE  = EXTDIR + 'Makefile'
+EXT_SOURCES   = FileList[ EXTDIR + '*.c' ]
+EXT_SO        = EXTDIR + "pg.#{CONFIG['DLEXT']}"
+
+SITEARCH_DIR  = LIBDIR + Config::CONFIG['sitearch']
+
+NUM_CPUS = if File.exist?('/proc/cpuinfo')
+	File.read('/proc/cpuinfo').scan('processor').length
+else
+	1
+end
+
+# Cross-compilation constants
+COMPILE_HOME = File.expand_path("~/.rake-compiler")
+OPENSSL_VERSION = ENV['OPENSSL_VERSION'] || '0.9.8l'
+POSTGRESQL_VERSION = ENV['POSTGRESQL_VERSION'] || '8.4.2'
+
+CROSS_PREFIX = if RUBY_PLATFORM.include?( 'darwin' )
+	'i386-mingw32'
+else
+	'i586-mingw32msvc'
+end
+
+
+#####################################################################
+###	T A S K S
+#####################################################################
+
+# Make both the default task and the spec task depend on building the extension
+task :local => :compile
+task :spec => :compile
+namespace :spec do
+	task :doc   => [ :compile ]
+	task :quiet => [ :compile ]
+	task :html  => [ :compile ]
+	task :text  => [ :compile ]
+end
+
+ENV['RUBY_CC_VERSION'] = '1.8.6:1.9.1'
+
+Rake::ExtensionTask.new do |ext|
+	ext.name = 'pg_ext'
+	ext.gem_spec = GEMSPEC
+	ext.ext_dir = 'ext'
+	ext.lib_dir = 'lib'
+	ext.source_pattern = "*.{c,h}"
+
+	# If there's an explicit 'compile' argument, use everything after it as options.
+	if offset = ARGV.index( 'compile' )
+		trace "config options = %p" % [ ARGV[(offset + 1)..-1] ]
+		ext.config_options = ARGV[ (offset + 1)..-1 ]
+	# Otherwise, just grab everything from the first option onward
+	elsif offset = ARGV.index( ARGV.find {|arg| arg =~ /^--/ } )
+		trace "config options = %p" % [ ARGV[offset..-1] ]
+		ext.config_options = ARGV[ offset..-1 ]
+	else
+		trace "No config options (ARGV = %p)" % [ ARGV ]
+	end
+
+	ext.cross_compile = true                # enable cross compilation (requires cross compile toolchain)
+	ext.cross_platform = %w[i386-mswin32 i386-mingw32]     # forces the Windows platform instead of the default one
+
+	# configure options only for cross compile
+	ext.cross_config_options += [
+		"--with-pg-include=#{COMPILE_HOME}/builds/postgresql-#{POSTGRESQL_VERSION}/src/interfaces/libpq",
+		"--with-opt-include=#{COMPILE_HOME}/builds/postgresql-#{POSTGRESQL_VERSION}/src/include",
+		"--with-pg-lib=#{COMPILE_HOME}/builds/postgresql-#{POSTGRESQL_VERSION}/src/interfaces/libpq",
+		"--with-opt-lib=#{COMPILE_HOME}/builds/openssl-#{OPENSSL_VERSION}",
+		"--enable-static-build",
+	]
+
+end
+
+
+desc "Stop any Postmaster instances that remain after testing."
+task :cleanup_testing_dbs do
+    require 'spec/lib/helpers'
+    PgTestingHelpers.stop_existing_postmasters()
+    Rake::Task[:clean].invoke
+end
+
+
+#####################################################################
+###	C R O S S - C O M P I L A T I O N - T A S K S
+#####################################################################
+
+
+# define a location where sources will be stored
+directory "#{COMPILE_HOME}/sources"
+directory "#{COMPILE_HOME}/builds/openssl-#{OPENSSL_VERSION}"
+
+# clean intermediate files and folders
+CLEAN.include("#{COMPILE_HOME}/builds/openssl-#{OPENSSL_VERSION}")
+
+# openssl source file should be stored there
+file "#{COMPILE_HOME}/sources/openssl-#{OPENSSL_VERSION}.tar.gz" => ["#{COMPILE_HOME}/sources"] do |t|
+	# download the source file using wget or curl
+	chdir File.dirname(t.name) do
+		#http://www.openssl.org/source/openssl-0.9.8k.tar.gz
+		url = "http://www.openssl.org/source/#{File.basename(t.name)}"
+		sh "wget #{url} || curl -O #{url}"
+	end
+end
+
+# Extract the openssl builds
+file "#{COMPILE_HOME}/builds/openssl-#{OPENSSL_VERSION}" => ["#{COMPILE_HOME}/sources/openssl-#{OPENSSL_VERSION}.tar.gz"] do |t|
+	chdir File.dirname(t.name) do
+		t.prerequisites.each { |f| sh "tar xfz ../sources/#{File.basename(f)}" }
+	end
+end
+
+# generate the makefile in a clean build location
+file "#{COMPILE_HOME}/builds/openssl-#{OPENSSL_VERSION}/Makefile" =>
+		["#{COMPILE_HOME}/builds/openssl-#{OPENSSL_VERSION}"] do |t|
+
+	chdir File.dirname(t.name) do
+		sh File.expand_path("Configure"), 'mingw'
+	end
+end
+
+# make
+file "#{COMPILE_HOME}/builds/openssl-#{OPENSSL_VERSION}/libssleay32.a" => ["#{COMPILE_HOME}/builds/openssl-#{OPENSSL_VERSION}/Makefile"] do |t|
+	chdir File.dirname(t.prerequisites.first) do
+		sh <<-EOT
+			export cross=#{CROSS_PREFIX}- &&
+			make -j#{NUM_CPUS} CC="${cross}gcc -DDSO_WIN32" AR="${cross}ar r" RANLIB="${cross}ranlib" build_libs &&
+			cp libcrypto.a libeay32.a &&
+			cp libssl.a libssleay32.a
+		EOT
+	end
+end
+
+#desc 'compile static libssl.a'
+task 'openssl-make' => ["#{COMPILE_HOME}/builds/openssl-#{OPENSSL_VERSION}/libssleay32.a"]
+
+
+# define a location where sources will be stored
+directory "#{COMPILE_HOME}/builds/postgresql-#{POSTGRESQL_VERSION}"
+
+# clean intermediate files and folders
+CLEAN.include("#{COMPILE_HOME}/builds/postgresql-#{POSTGRESQL_VERSION}")
+
+
+# postgresql source file should be stored there
+file "#{COMPILE_HOME}/sources/postgresql-#{POSTGRESQL_VERSION}.tar.bz2" => ["#{COMPILE_HOME}/sources"] do |t|
+	# download the source file using wget or curl
+	chdir File.dirname(t.name) do
+		#http://wwwmaster.postgresql.org/redir/53/h/source/v8.4.0/postgresql-8.4.0.tar.bz2
+		url = "http://wwwmaster.postgresql.org/redir/53/h/source/v#{POSTGRESQL_VERSION}/#{File.basename(t.name)}"
+		sh "wget #{url} || curl -O #{url}"
+	end
+end
+
+# Extract the postgresql sources
+file "#{COMPILE_HOME}/builds/postgresql-#{POSTGRESQL_VERSION}" => ["#{COMPILE_HOME}/sources/postgresql-#{POSTGRESQL_VERSION}.tar.bz2"] do |t|
+	chdir File.dirname(t.name) do
+		t.prerequisites.each { |f| sh "tar xfj ../sources/#{File.basename(f)}" }
+	end
+end
+
+# generate the makefile in a clean build location
+file "#{COMPILE_HOME}/builds/postgresql-#{POSTGRESQL_VERSION}/src/Makefile.global" =>
+		["#{COMPILE_HOME}/builds/postgresql-#{POSTGRESQL_VERSION}",
+		"#{COMPILE_HOME}/builds/openssl-#{OPENSSL_VERSION}/libssleay32.a"] do |t|
+
+	options = [
+		'--target=i386-mingw32',
+		"--host=#{Rake::ExtensionCompiler.mingw_host}",
+		'--with-openssl',
+		'--without-zlib',
+		'--disable-shared',
+	]
+
+	chdir "#{COMPILE_HOME}/builds/postgresql-#{POSTGRESQL_VERSION}" do
+		configure_path = File.expand_path("#{COMPILE_HOME}/builds/postgresql-#{POSTGRESQL_VERSION}/configure")
+		sh <<-EOT
+			export CFLAGS=-L#{COMPILE_HOME}/builds/openssl-#{OPENSSL_VERSION} &&
+			export LDFLAGS=-L#{COMPILE_HOME}/builds/openssl-#{OPENSSL_VERSION} &&
+			export LDFLAGS_SL=-L#{COMPILE_HOME}/builds/openssl-#{OPENSSL_VERSION} &&
+			export "LIBS=-lwsock32 -lgdi32" &&
+			export CPPFLAGS=-I#{COMPILE_HOME}/builds/openssl-#{OPENSSL_VERSION}/include &&
+			#{configure_path} #{options.join(" ")}
+		EOT
+	end
+end
+
+# backup Makefile.shlib
+file "#{COMPILE_HOME}/builds/postgresql-#{POSTGRESQL_VERSION}/src/Makefile.shlib.bak" => ["#{COMPILE_HOME}/builds/postgresql-#{POSTGRESQL_VERSION}/src/Makefile.global"] do |t|
+	cp "#{COMPILE_HOME}/builds/postgresql-#{POSTGRESQL_VERSION}/src/Makefile.shlib", t.name
+end
+
+# patch the Makefile.shlib
+file "#{COMPILE_HOME}/builds/postgresql-#{POSTGRESQL_VERSION}/src/Makefile.shlib" => ["#{COMPILE_HOME}/builds/postgresql-#{POSTGRESQL_VERSION}/src/Makefile.shlib.bak"] do |t|
+	content = File.open(t.name, 'rb') { |f| f.read }
+
+	out = ""
+
+	content.each_line do |line|
+		if line =~ /^(\s*haslibarule\s*=\s*yes)/
+			out << "##{$1}\n"
+		else
+			out << line
+		end
+	end
+
+	when_writing("Patching Makefile.shlib") {
+		File.open(t.name, 'wb') { |f| f.write(out) }
+	}
+end
+
+
+# make libpq.a
+file "#{COMPILE_HOME}/builds/postgresql-#{POSTGRESQL_VERSION}/src/interfaces/libpq/libpq.a" => ["#{COMPILE_HOME}/builds/postgresql-#{POSTGRESQL_VERSION}/src/Makefile.global", "#{COMPILE_HOME}/builds/postgresql-#{POSTGRESQL_VERSION}/src/Makefile.shlib"] do |t|
+	chdir File.dirname(t.name) do
+		sh "make -j#{NUM_CPUS} libpq.a PORTNAME=win32"
+	end
+end
+
+#desc 'compile static libpg.a'
+task 'postgresql-make' => ['openssl-make', "#{COMPILE_HOME}/builds/postgresql-#{POSTGRESQL_VERSION}/src/interfaces/libpq/libpq.a"]
+
+desc 'cross compile pg for win32'
+task 'cross' => [:mingw32, 'postgresql-make']
+
+task :mingw32 do
+	# Use Rake::ExtensionCompiler helpers to find the proper host
+	unless Rake::ExtensionCompiler.mingw_host then
+		warn "You need to install mingw32 cross compile functionality to be able to continue."
+		warn "Please refer to your distribution/package manager documentation about installation."
+		fail
+	end
+end