jruby-pg 0.1-java

data/POSTGRES

@@ -0,0 +1,23 @@
+PostgreSQL Database Management System
+(formerly known as Postgres, then as Postgres95)
+
+Portions Copyright (c) 1996-2008, PostgreSQL Global Development Group
+
+Portions Copyright (c) 1994, The Regents of the University of California
+
+Permission to use, copy, modify, and distribute this software and its
+documentation for any purpose, without fee, and without a written agreement
+is hereby granted, provided that the above copyright notice and this
+paragraph and the following two paragraphs appear in all copies.
+
+IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR
+DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING
+LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS
+DOCUMENTATION, EVEN IF THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+
+THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES,
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS
+ON AN "AS IS" BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO OBLIGATIONS TO
+PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.

data/README-OS_X.rdoc

@@ -0,0 +1,68 @@
+= Compiling on MacOS X
+
+The EnterpriseDB packages are the recommended PostgreSQL installations to use
+with MacOS X. They eliminate most or all of the issues with getting 'pg'
+installed, linked correctly, and running.
+
+== Segfaults and SSL Support
+
+If you need a custom installation of PostgreSQL, you should ensure that you
+either compile it against the same version of OpenSSL as the OpenSSL extension
+of the Ruby you'll be using, or compile it without SSL support. If you fail to
+do this, you will likely see segfaults when you use 'pg' and the 'openssl'
+extension at the same time. You can see what library it's linked against using
+'otool -L'; for example, on my 10.7 machine I use for 'pg' development:
+
+    $ otool -L /System/Library/Frameworks/Ruby.framework/Versions\
+      /1.8/usr/lib/ruby/1.8/universal-darwin11.0/openssl.bundle
+
+    /System/Library/Frameworks/Ruby.framework/Versions/1.8/usr/\
+        lib/ruby/1.8/universal-darwin11.0/openssl.bundle:
+        /System/Library/Frameworks/Ruby.framework/Versions/1.8/\
+            usr/lib/libruby.1.dylib (compatibility version 1.8.0, \
+            current version 1.8.7)
+        /usr/lib/libssl.0.9.8.dylib (compatibility version 0.9.8, \
+            current version 0.9.8)
+        /usr/lib/libcrypto.0.9.8.dylib (compatibility version 0.9.8, \
+            current version 0.9.8)
+        /usr/lib/libSystem.B.dylib (compatibility version 1.0.0, \
+            current version 159.0.0)
+
+
+== Dealing with Installation Problems
+
+If you are building/installing pg on MacOS X, and the installation doesn't
+work at first, here are a few things you can try.
+
+=== pg_config
+
+The first thing you should do is ensure that the 'pg_config' tool that comes
+with Postgres is in your path. If it isn't, or the one that's first in your
+path isn't the one that was installed with the Postgres you want to build
+against, you can specify the path to it with the --with-pg-config option.
+
+For example, if you're using the Ruby binary that comes with OSX, and
+PostgreSQL 9.0.x installed from MacPorts, do:
+
+	gem install -- --with-pg-config=/opt/local/lib/postgresql90/bin/pg_config
+
+=== ARCHFLAGS and Universal Binaries
+
+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.
+
+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 x86_64' gem install pg
+
+or, if you're building from source:
+
+	rake compile ARCHFLAGS="-arch x86_64"
+
+Note that the recommended EnterpriseDB packages are correctly compiled as
+universal binaries, and don't need any of these workarounds.
+

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,102 @@
+= pg
+
+This is a JRuby gem replacement for ruby-pg. The gem should be a
+drop-in replacement for ruby-pg version 0.17.1. If you see any
+inconsistency please open an issue
+{here}[https://github.com/headius/jruby-pg/issues].
+
+Another JRuby Postgres adapter is {jdbc-postgres}[https://github.com/jruby/activerecord-jdbc-adapter/tree/master/jdbc-postgres/]. jruby-pg provides a few interfaces that jdbc-postgres doesn't have. Most use cases don't require those interfaces, specially if you are using ActiveRecord. Extra APIs in the pg & jruby-pg gem include:
+
+* Async API for querying
+* Large objects API
+* Bulk Copy API
+* Notification API
+
+= Documentation
+
+For documentation please refair to the MRI pg gem docs which you can
+find {here}[http://www.rubydoc.info/gems/pg/0.17.1/PG]. The original
+ruby-pg project can be found {here on github}[https://github.com/ged/ruby-pg].
+
+== 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
+
+* JRuby 1.7.1 or later (due to https://github.com/jruby/jruby/issues/411)
+* JRuby in 1.9 or 2.0 mode
+* json gem 1.7.7 or later (see https://github.com/flori/json/pull/152 and
+  https://github.com/flori/json/pull/155)
+* Postgresql 7.4 or higher
+
+The gem has been tested with the following:
+
+* JRuby 1.7.18
+* PostgreSQL 9.3.6
+
+It may work with earlier versions of Ruby/PostgreSQL as well, but those are
+not regularly tested.
+
+
+== How To Install
+
+*NOTE*: if you are installing jruby-pg to use it with rails you'll
+have to install it using bundler.
+
+Install via RubyGems:
+
+    gem install pg_jruby
+
+Install via Bundler, in your gemfile add the following:
+
+    # Please note that Bundler version 1.0 is necessary to let bundler do its dependency management,
+    # as there is no .gemspec in the source.
+    gem 'pg', '0.17.1', :platform => :jruby, :git => 'git://github.com/headius/jruby-pg.git', :branch => :master
+
+    # comment the activerecord-jdbcsqlite3-adapter line
+    # gem 'activerecord-jdbcsqlite3-adapter'
+
+== Sample app
+
+See {this app}[https://github.com/jvshahid/sample-jruby-pg] for a demonstration
+of using jruby-pg with rails
+
+== Copying
+
+Copyright (c) 1997-2013 by the authors.
+
+=== MRI contributors
+
+* Jeff Davis <ruby-pg@j-davis.com>
+* Guy Decoux (ts) <decoux@moulon.inra.fr>
+* Michael Granger <ged@FaerieMUD.org>
+* Lars Kanis <lars@greiz-reinsdorf.de>
+* Dave Lee
+* Eiji Matsumoto <usagi@ruby.club.or.jp>
+* Yukihiro Matsumoto <matz@ruby-lang.org>
+* Noboru Saitou <noborus@netlab.jp>
+
+=== JRuby contributors
+
+* John Shahid <jvshahid@gmail.com>
+
+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,211 @@
+#!/usr/bin/env rake
+#-*- ruby -*-
+
+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.plugin :bundler
+
+Hoe.plugins.delete :rubyforge
+Hoe.plugins.delete :compiler
+
+def jruby?
+  RUBY_PLATFORM =~ /java/
+end
+
+# Hoe specification
+$hoespec = Hoe.spec jruby? ? 'jruby-pg' : '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 'Charles Nutter', 'headius@headius.com'
+	self.developer 'John Shahid', 'jvshahid@gmail.com'
+
+	self.dependency 'rake-compiler', '~> 0.9', :developer
+	self.dependency 'hoe', '~> 3.5.1', :developer
+	self.dependency 'hoe-deveiate', '~> 0.2', :developer
+	self.dependency 'hoe-bundler', '~> 1.0', :developer
+
+	self.spec_extras[:licenses] = ['BSD-2-Clause', 'Ruby']
+	self.spec_extras[:extensions] = [ 'ext/extconf.rb' ] unless jruby?
+
+        self.license 'Ruby'
+
+  self.spec_extras[:files] = Proc.new do |f|
+    self.spec_extras[:files] = f << 'lib/pg_ext.jar'
+  end if jruby?
+
+	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}"
+
+  self.spec_extras[:platform] = 'java' if jruby?
+  self.version = '0.1' if jruby?
+end
+
+if jruby?
+  require "rake/javaextensiontask"
+
+  Rake::JavaExtensionTask.new("pg_ext", $hoespec.spec) do |ext|
+    ext.ext_dir = 'ext/java'
+    ext.lib_dir = 'lib'
+  end
+else
+  load 'Rakefile.cross'
+
+  # 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
+
+    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
+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'
+
+# Make the ChangeLog update if the repo has changed since it was last built
+file '.hg/branch' do
+	warn "WARNING: You need the Mercurial repo to update the ChangeLog"
+end
+file 'ChangeLog' do |task|
+	if File.exist?('.hg/branch')
+		$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
+	else
+		touch 'ChangeLog'
+	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
+
+desc "Update list of server error codes"
+task :update_error_codes do
+	URL_ERRORCODES_TXT = "http://git.postgresql.org/gitweb/?p=postgresql.git;a=blob_plain;f=src/backend/utils/errcodes.txt;hb=HEAD"
+
+	ERRORCODES_TXT = "ext/errorcodes.txt"
+	sh "wget #{URL_ERRORCODES_TXT.inspect} -O #{ERRORCODES_TXT.inspect} || curl #{URL_ERRORCODES_TXT.inspect} -o #{ERRORCODES_TXT.inspect}"
+end
+
+def error_codes_file
+  if jruby?
+    return 'ext/java/Errors.java'
+  else
+    'ext/errorcodes.def'
+  end
+end
+
+file error_codes_file => ['ext/errorcodes.rb', 'ext/errorcodes.txt'] do
+	ruby 'ext/errorcodes.rb', 'ext/errorcodes.txt', error_codes_file
+end
+
+#file 'ext/pg_errors.c' => ['ext/errorcodes.def'] do
+#	# trigger compilation of changed errorcodes.def
+#	touch 'ext/pg_errors.c'
+#end
+
+file 'ext/java/PgExtService.java' => error_codes_file