nuodb 1.0.0.rc.1

data/.gitignore

@@ -0,0 +1,8 @@
+*.bundle
+*.log
+*.o
+*.so
+ext/nuodb/Makefile
+pkg
+tmp
+.idea

data/AUTHORS

@@ -0,0 +1,4 @@
+# Authors ordered by first contribution.
+
+Dave Meppelink <davemepp@gmail.com>
+

data/COPYING

@@ -0,0 +1,25 @@
+Copyright (c) 2012, NuoDB, Inc.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+    * Neither the name of NuoDB, Inc. nor the names of its contributors may
+      be used to endorse or promote products derived from this software
+      without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL NUODB, INC. BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+gemspec
+
+group(:development, :test) do
+  gem 'rake'
+  gem 'rake-compiler'
+  gem 'rdoc'
+end

data/History.txt

@@ -0,0 +1,4 @@
+=== 1.0.0
+
+First release of the NuoDB API gem.
+

data/LICENSE

@@ -0,0 +1,26 @@
+Copyright (c) 2012, NuoDB, Inc.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+    * Neither the name of NuoDB, Inc. nor the names of its contributors may
+      be used to endorse or promote products derived from this software
+      without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL NUODB, INC. BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

data/Manifest.txt

@@ -0,0 +1,10 @@
+COPYING
+History.txt
+Manifest.txt
+README.md
+Rakefile
+ext/nuodb/extconf.rb
+ext/nuodb/nuodb.cpp
+lib/nuodb.rb
+lib/nuodb/version.rb
+test/test_nuodb.rb

data/README.rdoc

@@ -0,0 +1,77 @@
+= NuoDB/Ruby Interface
+
+== DESCRIPTION
+
+This is the NuoDB API module for Ruby. It integrates the NuoDB C++
+library into Ruby.
+
+== BUILDING THE GEM
+
+To compile and test run this command:
+
+    rake build
+
+== INSTALLING THE GEM
+
+    NUODB_ROOT=/Users/rbuck/tmp/nuodb gem install nuodb-1.0.0-rc.1.gem
+
+Or from the source tree:
+
+    NUODB_ROOT=/Users/rbuck/tmp/nuodb gem install pkg/nuodb-1.0.0-rc.1.gem
+
+== TESTING THE GEM
+
+Start up a minimal chorus as follows:
+
+    java -jar nuoagent.jar --broker &
+    ./nuodb --chorus test --password bar --dba-user dba --dba-password baz &
+
+Create a user in the database:
+
+    ./nuosql test@localhost --user dba --password baz
+    > create user cloud password 'user';
+    > exit
+
+Run the tests:
+
+    rake test
+
+== PUBLISHING THE GEM
+
+=== TAGGING
+
+Tag the product using tags per the SemVer specification; our tags have a v-prefix:
+
+    git tag -a v1.0.0.rc.1 -m "SemVer Version: v1.0.0-rc.1"
+
+If you make a mistake, take it back quickly:
+
+    git tag -d v1.0.0.rc.1
+    git push origin :refs/tags/v1.0.0.rc.1
+
+===PUBLISHING
+
+Here are the commands used to publish:
+
+    gem push pkg/nuodb-1.0.0.rc.1.gem
+
+If you bugger it up, pull it back quickly, or cause grief for users:
+
+    npm unpublish  db-nuodb@1.0.0.RC.1
+
+To view published versions:
+
+    npm view  db-nuodb
+
+== INSPECTING THE GEM
+
+It is often useful to inspect the contents of a Gem before distribution.
+To do this you dump the contents of a gem thus:
+
+    gem unpack pkg/nuodb-1.0.0.rc.1.gem
+
+== INSPECTING THE EXPORTED SYMBOLS
+
+    nm -gU ext/nuodb/nuodb.bundle
+
+== REFERENCES

data/Rakefile

@@ -0,0 +1,146 @@
+#
+# Copyright (c) 2012, NuoDB, Inc.
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+#     * Redistributions of source code must retain the above copyright
+#       notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above copyright
+#       notice, this list of conditions and the following disclaimer in the
+#       documentation and/or other materials provided with the distribution.
+#     * Neither the name of NuoDB, Inc. nor the names of its contributors may
+#       be used to endorse or promote products derived from this software
+#       without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+# DISCLAIMED. IN NO EVENT SHALL NUODB, INC. BE LIABLE FOR ANY DIRECT, INDIRECT,
+# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+# OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+# OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+
+require 'rubygems'
+require 'rake'
+require 'rake/clean'
+require 'rake/testtask'
+require 'rdoc/task'
+require 'date'
+
+#############################################################################
+#
+# Helper functions
+#
+#############################################################################
+
+def name
+  @name ||= Dir['*.gemspec'].first.split('.').first
+end
+
+def version
+  require File.expand_path('../lib/nuodb/version', __FILE__)
+  NuoDB::VERSION
+end
+
+def rubyforge_project
+  name
+end
+
+def date
+  Date.today.to_s
+end
+
+def gemspec_file
+  "#{name}.gemspec"
+end
+
+def gem_file
+  "#{name}-#{version}.gem"
+end
+
+def replace_header(head, header_name)
+  head.sub!(/(\.#{header_name}\s*= ').*'/) { "#{$1}#{send(header_name)}'" }
+end
+
+
+def so_ext
+  case RUBY_PLATFORM
+    when /bsd/i, /darwin/i
+      # extras here...
+      @sh_extension = 'bundle'
+    when /linux/i
+      # extras here...
+      @sh_extension = 'so'
+    when /solaris|sunos/i
+      # extras here...
+      @sh_extension = 'so'
+    else
+      puts
+      puts "Unsupported platform '#{RUBY_PLATFORM}'. Supported platforms are BSD, DARWIN, and LINUX."
+      exit
+  end
+end
+
+#############################################################################
+#
+# Standard tasks
+#
+#############################################################################
+
+CLEAN.include('pkg')
+CLEAN.include('ext/**/*{.o,.log,.so,.bundle}')
+CLEAN.include('ext/**/Makefile')
+CLEAN.include('lib/**/*{.so,.bundle}')
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "#{name} #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+file "lib/#{name}/#{name}.#{so_ext}" => Dir.glob("ext/#{name}/*{.rb,.c}") do
+  Dir.chdir("ext/#{name}") do
+    # this does essentially the same thing
+    # as what RubyGems does
+    ruby "extconf.rb"
+    sh "make"
+  end
+  cp "ext/#{name}/#{name}.#{so_ext}", "lib/#{name}"
+end
+
+task :test => "lib/#{name}/#{name}.#{so_ext}"
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+end
+
+task :default => :test
+
+#############################################################################
+#
+# Packaging tasks
+#
+#############################################################################
+
+desc "Build #{gem_file} into the pkg directory"
+task :build do
+  sh "mkdir -p pkg"
+  sh "gem build #{gemspec_file}"
+  sh "mv #{gem_file} pkg"
+end
+
+task :install => :build do
+  sh %{gem install pkg/#{name}-#{version} --no-rdoc --no-ri}
+end
+
+task :uninstall do
+  sh %{gem uninstall #{name} -x -v #{version}}
+end

data/ext/nuodb/extconf.rb

@@ -0,0 +1,152 @@
+#
+# Copyright (c) 2012, NuoDB, Inc.
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+#     * Redistributions of source code must retain the above copyright
+#       notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above copyright
+#       notice, this list of conditions and the following disclaimer in the
+#       documentation and/or other materials provided with the distribution.
+#     * Neither the name of NuoDB, Inc. nor the names of its contributors may
+#       be used to endorse or promote products derived from this software
+#       without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+# DISCLAIMED. IN NO EVENT SHALL NUODB, INC. BE LIABLE FOR ANY DIRECT, INDIRECT,
+# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+# OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+# OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+
+require 'fileutils'
+require 'pathname'
+require 'mkmf'
+require 'find'
+
+nuodb_include = nil
+nuodb_lib64 = nil
+
+case RUBY_PLATFORM
+  when /solaris|sunos/i
+    have_library('stdc++')
+    $CC = "gcc"
+    $CXX = "g++"
+    $LIBS << " -lstdc++ -lc"
+end
+
+def dylib_extension
+  case RUBY_PLATFORM
+    when /bsd/i, /darwin/i
+      # extras here...
+      'dylib'
+    when /linux/i, /solaris|sunos/i
+      # extras here...
+      'so'
+    else
+      puts "Unsupported platform '#{RUBY_PLATFORM}'. Supported platforms are BSD, DARWIN, SOLARIS, and LINUX."
+      raise
+  end
+end
+
+def nuodb_home?(path)
+  unless path.nil?
+    incl = File.join(path, 'include')
+    libs = File.join(path, 'lib64')
+    if File.directory? incl and File.directory? libs
+      [incl, libs]
+    else
+      [nil, nil]
+    end
+  end
+end
+
+def nuodb_srcs?(path)
+  if File.directory? path
+    entries = Dir.entries path
+    if entries.include? 'CMakeLists.txt'
+      remote_dir = File.join(path, 'Remote')
+      dylib_paths = []
+      Find.find(remote_dir) do |file|
+        if File.file? file
+          basename = "libNuoRemote.#{dylib_extension}"
+          dylib_paths << file unless file !~ /#{basename}/
+        end
+      end
+      [File.join(path, 'Remote'), File.dirname(dylib_paths[0])] unless dylib_paths.length == 0
+    else
+      pathname = Pathname.new path
+      nuodb_srcs? File.expand_path("..", path) unless pathname.root?
+    end
+  end
+end
+
+if nuodb_include.nil? and nuodb_lib64.nil?
+  nuodb_include, nuodb_lib64 = nuodb_home? ENV['NUODB_ROOT']
+end
+
+# Like other package managers, gems do not install from the source directory
+# even if they are installed from a local .gem file. Because of this we need
+# to provide a fake NUODB_ROOT when building the gems within our source tree
+# so that the installation process can find build artifacts and sources; the
+# section below handles this special case so that we can run our test suites.
+
+if nuodb_include.nil? and nuodb_lib64.nil?
+  nuodb_include, nuodb_lib64 = nuodb_srcs? ENV['NUODB_ROOT']
+end
+
+# Lastly we fall back to detecting the location of installed product against
+# which we compile and link.
+
+if nuodb_include.nil? and nuodb_lib64.nil?
+  nuodb_include, nuodb_lib64 = nuodb_home? '/opt/nuodb'
+end
+
+def dir_exists? (path)
+  !path.nil? and File.directory? path
+end
+
+unless dir_exists? nuodb_include and dir_exists? nuodb_lib64
+  puts
+  puts "Neither NUODB_ROOT is set, nor is NuoDB installed to /opt/nuodb platform. Please set NUODB_ROOT to refer to NuoDB installation directory."
+  exit(false)
+end
+
+dir_config('nuodb', nuodb_include, nuodb_lib64)
+have_library("NuoRemote") or raise
+
+if have_header('stdint.h') then
+  $CPPFLAGS << " -DHAVE_STDINT_H"
+end
+
+if CONFIG['warnflags']
+  CONFIG['warnflags'].slice!(/-Wdeclaration-after-statement/)
+  CONFIG['warnflags'].slice!(/-Wimplicit-function-declaration/)
+end
+
+case RUBY_PLATFORM
+  when /bsd/i, /darwin/i, /linux/i, /solaris|sunos/i
+    case RUBY_PLATFORM
+      when /bsd/i, /darwin/i
+        # extras here...
+        $LDFLAGS << " -Xlinker -rpath -Xlinker #{nuodb_lib64}"
+      when /linux/i
+        # extras here...
+        $LDFLAGS << " -Wl,-rpath,'$$ORIGIN'"
+      when /solaris|sunos/i
+        # extras here...
+        $LDFLAGS << " -Wl,-rpath,'$$ORIGIN' -m64"
+      else
+        puts
+    end
+  else
+end
+
+create_makefile('nuodb/nuodb')