pg 0.15.0.pre.454-x64-mingw32

data/README-Windows.rdoc

@@ -0,0 +1,67 @@
+= Compiling 'pg' 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 or MacOS X
+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 using the instructions in rake-compiler's README.
+For Debian/Ubuntu it is <tt>apt-get install gcc-mingw32</tt> .
+Use ruby-1.8.7 for the following commands.
+
+Download and cross compile ruby 1.8 and 1.9 for win32 with:
+
+	rake-compiler cross-ruby VERSION=1.8.7-p352
+	rake-compiler cross-ruby VERSION=1.9.2-p290
+
+Download and cross compile pg for win32:
+
+	rake cross native gem
+
+or with custom versions:
+
+	rake cross native gem RUBY_CC_VERSION=1.8.7:1.9.2 \
+	    OPENSSL_VERSION=1.0.0e POSTGRESQL_VERSION=9.1.1
+
+If everything works, there should be pg-VERSION-x86-mingw32.gem in the pkg
+directory.
+
+
+== Reporting Problems
+
+If you have any problems you can submit them via
+[the project's issue-tracker][bitbucket]. And submit questions, problems, or
+solutions, so that it can be improved.
+

data/README.ja.rdoc

@@ -0,0 +1,14 @@
+= pg
+
+home :: https://bitbucket.org/ged/ruby-pg
+mirror :: https://github.com/ged/ruby-pg
+docs :: http://deveiate.org/code/pg
+
+
+== Description
+
+This file needs a translation of the English README. Pull requests, patches, or
+volunteers gladly accepted.
+
+Until such time, please accept my sincere apologies for not knowing Japanese.
+

data/README.rdoc

@@ -0,0 +1,111 @@
+= pg
+
+home :: https://bitbucket.org/ged/ruby-pg
+mirror :: https://github.com/ged/ruby-pg
+docs :: http://deveiate.org/code/pg
+
+
+== Description
+
+Pg is the Ruby interface to the {PostgreSQL RDBMS}[http://www.postgresql.org/].
+
+It works with {PostgreSQL 8.3 and later}[http://bit.ly/6AfPhm].
+
+A small example usage:
+
+  #!/usr/bin/env ruby
+
+  require 'pg'
+
+  # Output a table of current connections to the DB
+  conn = PG.connect( dbname: 'sales' )
+  conn.exec( "SELECT * FROM pg_stat_activity" ) do |result|
+    puts "     PID | User             | Query"
+  result.each do |row|
+      puts " %7d | %-16s | %s " %
+        row.values_at('procpid', 'usename', 'current_query')
+    end
+  end
+
+== Build Status
+
+{<img src="https://travis-ci.org/ged/ruby-pg.png?branch=master" alt="Build Status" />}[https://travis-ci.org/ged/ruby-pg]
+
+
+== Requirements
+
+* Ruby 1.8.7-p371, 1.9.3-p392, or 2.0.0-p0.
+* PostgreSQL 8.3.x (with headers, -dev packages, etc).
+
+It may work with earlier versions of Ruby as well, but those are not regularly tested.
+
+
+== How To Install
+
+Install via RubyGems:
+
+    gem install pg
+
+You may need to specify the path to the 'pg_config' program installed with
+Postgres:
+
+    gem install pg -- --with-pg-config=<path to pg_config>
+
+If you're installing via Bundler, you can provide compile hints like so:
+
+    bundle config build.pg --with-pg-config=<path to pg_config>
+
+See README-OS_X.rdoc for more information about installing under MacOS X, and
+README-Windows.rdoc for Windows build/installation instructions.
+
+There's also {a Google+ group}[http://goo.gl/TFy1U] and a
+{mailing list}[http://groups.google.com/group/ruby-pg] if you get stuck, or just
+want to chat about something.
+
+
+== Contributing
+
+To report bugs, suggest features, or check out the source with Mercurial,
+{check out the project page}[http://bitbucket.org/ged/ruby-pg]. If you prefer
+Git, there's also a {Github mirror}[https://github.com/ged/ruby-pg].
+
+After checking out the source, run:
+
+    $ rake newb
+
+This task will install any missing dependencies, run the tests/specs, and
+generate the API documentation.
+
+The current maintainer is Michael Granger <ged@FaerieMUD.org>.
+
+
+== Copying
+
+Copyright (c) 1997-2012 by the authors.
+
+* Jeff Davis <ruby-pg@j-davis.com>
+* Guy Decoux (ts) <decoux@moulon.inra.fr>
+* Michael Granger <ged@FaerieMUD.org>
+* Dave Lee
+* Eiji Matsumoto <usagi@ruby.club.or.jp>
+* Yukihiro Matsumoto <matz@ruby-lang.org>
+* Noboru Saitou <noborus@netlab.jp>
+
+You may redistribute this software under the same terms as Ruby itself; see
+http://www.ruby-lang.org/en/LICENSE.txt or the LICENSE file in the source
+for details.
+
+Portions of the code are from the PostgreSQL project, and are distributed
+under the terms of the PostgreSQL license, included in the file POSTGRES.
+
+Portions copyright LAIKA, Inc.
+
+
+== Acknowledgments
+
+See Contributors.rdoc for the many additional fine people that have contributed
+to this library over the years.
+
+We are thankful to the people at the ruby-list and ruby-dev mailing lists.
+And to the people who developed PostgreSQL.
+

data/Rakefile

@@ -0,0 +1,156 @@
+#!/usr/bin/env rake
+
+require 'rbconfig'
+require 'pathname'
+require 'tmpdir'
+
+begin
+	require 'rake/extensiontask'
+rescue LoadError
+	abort "This Rakefile requires rake-compiler (gem install rake-compiler)"
+end
+
+begin
+	require 'hoe'
+rescue LoadError
+	abort "This Rakefile requires hoe (gem install hoe)"
+end
+
+require 'rake/clean'
+
+# Build directory constants
+BASEDIR = Pathname( __FILE__ ).dirname
+SPECDIR = BASEDIR + 'spec'
+LIBDIR  = BASEDIR + 'lib'
+EXTDIR  = BASEDIR + 'ext'
+PKGDIR  = BASEDIR + 'pkg'
+TMPDIR  = BASEDIR + 'tmp'
+
+DLEXT   = RbConfig::CONFIG['DLEXT']
+EXT     = LIBDIR + "pg_ext.#{DLEXT}"
+
+TEST_DIRECTORY = BASEDIR + "tmp_test_specs"
+
+CLOBBER.include( TEST_DIRECTORY.to_s )
+CLEAN.include( PKGDIR.to_s, TMPDIR.to_s )
+
+# Set up Hoe plugins
+Hoe.plugin :mercurial
+Hoe.plugin :signing
+Hoe.plugin :deveiate
+
+Hoe.plugins.delete :rubyforge
+Hoe.plugins.delete :compiler
+
+load 'Rakefile.cross'
+
+
+# Hoe specification
+$hoespec = Hoe.spec 'pg' do
+	self.readme_file = 'README.rdoc'
+	self.history_file = 'History.rdoc'
+	self.extra_rdoc_files = Rake::FileList[ '*.rdoc' ]
+	self.extra_rdoc_files.include( 'POSTGRES', 'LICENSE' )
+	self.extra_rdoc_files.include( 'ext/*.c' )
+
+	self.developer 'Michael Granger', 'ged@FaerieMUD.org'
+
+	self.dependency 'rake-compiler', '~> 0.8', :developer
+	self.dependency	'hoe-deveiate', '~> 0.2', :developer
+
+	self.spec_extras[:licenses] = ['BSD', 'Ruby', 'GPL']
+	self.spec_extras[:extensions] = [ 'ext/extconf.rb' ]
+
+	self.require_ruby_version( '>= 1.8.7' )
+
+	self.hg_sign_tags = true if self.respond_to?( :hg_sign_tags= )
+	self.check_history_on_release = true if self.respond_to?( :check_history_on_release= )
+	self.spec_extras[:rdoc_options] = [
+		'-f', 'fivefish',
+		'-t', 'pg: The Ruby Interface to PostgreSQL',
+		'-m', 'README.rdoc',
+	]
+
+	self.rdoc_locations << "deveiate:/usr/local/www/public/code/#{remote_rdoc_dir}"
+end
+
+ENV['VERSION'] ||= $hoespec.spec.version.to_s
+
+# Tests should pass before checking in
+task 'hg:precheckin' => [ :check_history, :check_manifest, :spec ]
+
+# Support for 'rvm specs'
+task :specs => :spec
+
+# Compile before testing
+task :spec => :compile
+
+# gem-testers support
+task :test do
+	# rake-compiler always wants to copy the compiled extension into lib/, but
+	# we don't want testers to have to re-compile, especially since that
+	# often fails because they can't (and shouldn't have to) write to tmp/ in
+	# the installed gem dir. So we clear the task rake-compiler set up
+	# to break the dependency between :spec and :compile when running under
+	# rubygems-test, and then run :spec.
+	Rake::Task[ EXT.to_s ].clear
+	Rake::Task[ :spec ].execute
+end
+
+desc "Turn on warnings and debugging in the build."
+task :maint do
+	ENV['MAINTAINER_MODE'] = 'yes'
+end
+
+ENV['RUBY_CC_VERSION'] ||= '1.8.7:1.9.2:2.0.0'
+
+# Rake-compiler task
+Rake::ExtensionTask.new do |ext|
+	ext.name           = 'pg_ext'
+	ext.gem_spec       = $hoespec.spec
+	ext.ext_dir        = 'ext'
+	ext.lib_dir        = 'lib'
+	ext.source_pattern = "*.{c,h}"
+	ext.cross_compile  = true
+	ext.cross_platform = CrossLibraries.map(&:for_platform)[1,1]
+
+  ext.cross_config_options += CrossLibraries.map do |lib|
+    {
+      lib.for_platform => [
+        "--with-pg-include=#{lib.static_postgresql_libdir}",
+        "--with-opt-include=#{lib.static_postgresql_incdir}",
+        "--with-pg-lib=#{lib.static_postgresql_libdir}",
+        "--with-opt-lib=#{lib.static_openssl_builddir}",
+      ]
+    }
+  end
+end
+
+
+# Make the ChangeLog update if the repo has changed since it was last built
+file '.hg/branch' do
+	abort "You need the Mercurial repo to make packages"
+end
+file 'ChangeLog' => '.hg/branch' do |task|
+	$stderr.puts "Updating the changelog..."
+	begin
+		content = make_changelog()
+	rescue NameError
+		abort "Packaging tasks require the hoe-mercurial plugin (gem install hoe-mercurial)"
+	end
+	File.open( task.name, 'w', 0644 ) do |fh|
+		fh.print( content )
+	end
+end
+
+# Rebuild the ChangeLog immediately before release
+task :prerelease => 'ChangeLog'
+
+
+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
+

data/Rakefile.cross

@@ -0,0 +1,271 @@
+#!/usr/bin/env rake
+
+require 'uri'
+require 'tempfile'
+require 'rbconfig'
+require 'rake/clean'
+require 'rake/extensiontask'
+require 'rake/extensioncompiler'
+require 'ostruct'
+
+MISCDIR = BASEDIR + 'misc'
+
+NUM_CPUS = if File.exist?('/proc/cpuinfo')
+	File.read('/proc/cpuinfo').scan('processor').length
+elsif RUBY_PLATFORM.include?( 'darwin' )
+	`system_profiler SPHardwareDataType | grep 'Cores' | awk '{print $5}'`.chomp
+else
+	1
+end
+
+class CrossLibrary < OpenStruct
+	include Rake::DSL
+
+	def initialize(for_platform, openssl_config)
+		super()
+
+		self.for_platform               = for_platform
+		self.openssl_config             = openssl_config
+
+		# Cross-compilation constants
+		self.openssl_version            = ENV['OPENSSL_VERSION'] || '1.0.1e'
+		self.postgresql_version         = ENV['POSTGRESQL_VERSION'] || '9.2.3'
+
+		self.compile_home               = Pathname( "./build" ).expand_path
+		self.static_sourcesdir          = compile_home + 'sources'
+		self.static_builddir            = compile_home + 'builds' + for_platform
+
+		# Static OpenSSL build vars
+		self.static_openssl_builddir    = static_builddir + "openssl-#{openssl_version}"
+
+		self.openssl_source_uri         =
+			URI( "http://www.openssl.org/source/openssl-#{openssl_version}.tar.gz" )
+		self.openssl_tarball            = static_sourcesdir + File.basename( openssl_source_uri.path )
+		self.openssl_makefile           = static_openssl_builddir + 'Makefile'
+
+		self.libssleay32                = static_openssl_builddir + 'libssleay32.a'
+		self.libeay32                   = static_openssl_builddir + 'libeay32.a'
+
+		self.openssl_patches            = Rake::FileList[ (MISCDIR + "openssl-#{openssl_version}.*.patch").to_s ]
+
+		# Static PostgreSQL build vars
+		self.static_postgresql_builddir = static_builddir + "postgresql-#{postgresql_version}"
+		self.postgresql_source_uri      = begin
+			uristring = "http://ftp.postgresql.org/pub/source/v%s/postgresql-%s.tar.bz2" %
+				[ postgresql_version, postgresql_version ]
+			URI( uristring )
+		end
+		self.postgresql_tarball         = static_sourcesdir + File.basename( postgresql_source_uri.path )
+
+		self.static_postgresql_srcdir   = static_postgresql_builddir + 'src'
+		self.static_postgresql_libdir   = static_postgresql_srcdir + 'interfaces/libpq'
+		self.static_postgresql_incdir   = static_postgresql_srcdir + 'include'
+
+		self.postgresql_global_makefile = static_postgresql_srcdir + 'Makefile.global'
+		self.postgresql_shlib_makefile  = static_postgresql_srcdir + 'Makefile.shlib'
+		self.postgresql_shlib_mf_orig   = static_postgresql_srcdir + 'Makefile.shlib.orig'
+		self.postgresql_lib             = static_postgresql_libdir + 'libpq.a'
+		self.postgresql_patches         = Rake::FileList[ (MISCDIR + "postgresql-#{postgresql_version}.*.patch").to_s ]
+
+		# Use rake-compilers config.yml to determine the toolchain that was used
+		# to build Ruby for this platform.
+		self.host_platform = begin
+			config_file = YAML.load_file(File.expand_path("~/.rake-compiler/config.yml"))
+			_, rbfile = config_file.find{|key, fname| key.start_with?("rbconfig-#{for_platform}-") }
+			IO.read(rbfile).match(/CONFIG\["host"\] = "(.*)"/)[1]
+		end
+
+
+		# clean intermediate files and folders
+		CLEAN.include( static_builddir.to_s )
+
+
+		ENV['RUBY_CC_VERSION'] ||= '1.8.7:1.9.3:2.0.0'
+
+		def download(url, save_to)
+			part = save_to+".part"
+			sh "wget #{url.to_s.inspect} -O #{part.inspect} || curl #{url.to_s.inspect} -o #{part.inspect}"
+			FileUtils.mv part, save_to
+		end
+
+		def run(*args)
+			sh *args
+		end
+
+		#####################################################################
+		### C R O S S - C O M P I L A T I O N - T A S K S
+		#####################################################################
+
+
+		directory static_sourcesdir.to_s
+
+		#
+		# Static OpenSSL build tasks
+		#
+		directory static_openssl_builddir.to_s
+
+		# openssl source file should be stored there
+		file openssl_tarball => static_sourcesdir do |t|
+			download( openssl_source_uri, t.name )
+		end
+
+		# Extract the openssl builds
+		file static_openssl_builddir => openssl_tarball do |t|
+			puts "extracting %s to %s" % [ openssl_tarball, static_openssl_builddir.parent ]
+			static_openssl_builddir.mkpath
+			run 'tar', '-xzf', openssl_tarball.to_s, '-C', static_openssl_builddir.parent.to_s
+			openssl_makefile.unlink if openssl_makefile.exist?
+
+			openssl_patches.each do |patchfile|
+				puts "  applying patch #{patchfile}..."
+				run 'patch', '-Np1', '-d', static_openssl_builddir.to_s,
+				'-i', File.expand_path( patchfile, BASEDIR )
+			end
+		end
+
+		self.cmd_prelude = [
+			'env',
+			"CC=#{host_platform}-gcc",
+			"CFLAGS=-DDSO_WIN32",
+			"AR=#{host_platform}-ar",
+			"RANLIB=#{host_platform}-ranlib"
+		]
+
+
+		# generate the makefile in a clean build location
+		file openssl_makefile => static_openssl_builddir do |t|
+			Dir.chdir( static_openssl_builddir ) do
+				cmd = cmd_prelude.dup
+				cmd << "./Configure" << openssl_config
+
+				run( *cmd )
+			end
+		end
+
+		desc "compile static openssl libraries"
+		task :openssl_libs => [ libssleay32, libeay32 ]
+
+		task :compile_static_openssl => openssl_makefile do |t|
+			Dir.chdir( static_openssl_builddir ) do
+				cmd = cmd_prelude.dup
+				cmd << 'make' << "-j#{NUM_CPUS}" << 'build_libs'
+
+				run( *cmd )
+			end
+		end
+
+		desc "compile static #{libeay32}"
+		file libeay32 => :compile_static_openssl do |t|
+			FileUtils.cp( static_openssl_builddir + 'libcrypto.a', libeay32.to_s )
+		end
+
+		desc "compile static #{libssleay32}"
+		file libssleay32 => :compile_static_openssl do |t|
+			FileUtils.cp( static_openssl_builddir + 'libssl.a', libssleay32.to_s )
+		end
+
+
+
+		#
+		# Static PostgreSQL build tasks
+		#
+		directory static_postgresql_builddir.to_s
+
+
+		# postgresql source file should be stored there
+		file postgresql_tarball => static_sourcesdir do |t|
+			download( postgresql_source_uri, t.name )
+		end
+
+		# Extract the postgresql sources
+		file static_postgresql_builddir => postgresql_tarball do |t|
+			puts "extracting %s to %s" % [ postgresql_tarball, static_postgresql_builddir.parent ]
+			static_postgresql_builddir.mkpath
+			run 'tar', '-xjf', postgresql_tarball.to_s, '-C', static_postgresql_builddir.parent.to_s
+			mv postgresql_shlib_makefile, postgresql_shlib_mf_orig
+
+			postgresql_patches.each do |patchfile|
+				puts "  applying patch #{patchfile}..."
+				run 'patch', '-Np1', '-d', static_postgresql_builddir.to_s,
+				'-i', File.expand_path( patchfile, BASEDIR )
+			end
+		end
+
+		# generate the makefile in a clean build location
+		file postgresql_global_makefile => [ static_postgresql_builddir, :openssl_libs ] do |t|
+			options = [
+				"--target=#{host_platform}",
+				"--host=#{host_platform}",
+				'--with-openssl',
+				'--without-zlib',
+				'--disable-shared',
+			]
+
+			Dir.chdir( static_postgresql_builddir ) do
+				configure_path = static_postgresql_builddir + 'configure'
+				cmd = [ configure_path.to_s, *options ]
+				cmd << "CFLAGS=-L#{static_openssl_builddir}"
+				cmd << "LDFLAGS=-L#{static_openssl_builddir}"
+				cmd << "LDFLAGS_SL=-L#{static_openssl_builddir}"
+				cmd << "LIBS=-lwsock32 -lgdi32"
+				cmd << "CPPFLAGS=-I#{static_openssl_builddir}/include"
+
+				run( *cmd )
+			end
+		end
+
+
+		# patch the Makefile.shlib -- depend on the build dir so it's only
+		# rewritten if the tarball is re-extracted.
+		file postgresql_shlib_makefile => postgresql_shlib_mf_orig do |t|
+			tf = Tempfile.new( postgresql_shlib_makefile.basename.to_s )
+			postgresql_shlib_mf_orig.open( File::RDONLY ) do |ifh|
+				ifh.each_line do |line|
+					tf.print( line.sub(/^(\s*haslibarule\s*=\s*yes)/, "# \\1 ") )
+				end
+			end
+			tf.close
+
+			FileUtils.mv( tf.path, t.name, :verbose => $puts )
+		end
+
+
+		# make libpq.a
+		task postgresql_lib => [ postgresql_global_makefile, postgresql_shlib_makefile ] do |t|
+			Dir.chdir( postgresql_lib.dirname ) do
+				sh 'make', "-j#{NUM_CPUS}", postgresql_lib.basename.to_s, 'PORTNAME=win32'
+			end
+		end
+
+
+		#desc 'compile static libpg.a'
+		task :static_libpq => postgresql_lib
+	end
+end
+
+if File.exist?(File.expand_path("~/.rake-compiler/config.yml"))
+	CrossLibraries = [
+		['i386-mingw32', 'mingw'],
+		['x64-mingw32', 'mingw64'],
+	].map do |platform, openssl_config|
+		CrossLibrary.new platform, openssl_config
+	end
+else
+	$stderr.puts "Cross-compilation disabled -- rake-compiler not properly installed"
+	CrossLibraries = []
+end
+
+desc 'cross compile pg for win32'
+task :cross do
+	ENV['CROSS_COMPILING'] = 'yes'
+end
+task :cross => [ :mingw32, :static_libpq ]
+
+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