rubyswig 0.0.1

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+swig/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in rubyswig.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Brian Wong
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,82 @@
+# Rubyswig
+
+Builds [SWIG](http://www.swig.org) (Simplified Wrapper Interface Generator) from source with minimal dependencies,
+then installs it as a rubygem executable, allowing it to be versioned with rvm gemsets.
+
+More importantly, makes installing SWIG dead-easy, and allows you to use Gemfiles and
+Bundler to specify dependencies against it.
+
+Tested with Ruby 1.9.3 on Ubuntu 12.04, OSX Snow Leopard (10.6), and Windows 7 (x86-64) with [Devkit](http://rubyinstaller.org/add-ons/devkit/).
+
+## Prerequisites
+
+### All
+
+Ruby and an environment that can build native gems.
+
+### Windows
+
+If you're starting your Ruby environment from scratch, I recommend the [RailsInstaller](http://railsinstaller.org/), which includes Devkit. You can also install Devkit [manually](https://github.com/oneclick/rubyinstaller/wiki/Development-Kit), but there are more steps involved.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'rubyswig'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install rubyswig
+
+## Usage
+
+Once SWIG is installed, use it as normal. See <http://www.swig.org>. Remember that if you use rvm gemsets that the executable is tied to the gemset in which you installed it.
+
+If you have gems that need to create SWIG wrappers, you can add rubyswig as a dependency of your gem.
+
+## Makefiles and extconf.rb
+
+You can include swig in your extconf.rb to automatically generate and compile wrappers from the .i interface file. Example:
+
+```ruby
+require 'mkmf'
+
+dir_config('ois', '/usr/include/OIS', '/usr/lib')
+
+# Identify SWIG interface files as source files
+SRC_EXT.concat %w[i]
+
+# make dependency file for SWIG wrappers
+open("depend", "w") do |f|
+  f.puts("SWIG = #{find_executable('swig')}")
+  f.puts("SWIGFLAGS = -D__GNUC__=4 -D__GNUC_MINOR__=6 -D__GNUC_PATCHLEVEL__=3 -ruby -Wall -c++ -minherit")
+  f.puts(".i.cxx:")
+  f.puts("\t$(ECHO) wrapping $(<)")
+  f.puts("\t$(SWIG) $(SWIGFLAGS) $(INCFLAGS) $(CPPFLAGS) -o $@ $(<)")
+
+have_library('OIS')
+
+create_makefile('ois')
+```
+
+Note that SWIG does not define the same symbols as, say, GCC, so you need to define them yourself for platform-specific compilation.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## Additional Credits
+
+Jon Maken for download.rb (https://gist.github.com/2202048)
+
+## Alternatives
+
+[Rice](http://rice.rubyforge.org/) is a C++ wrapper interface to the Ruby API. It's easier to use but is specific to Ruby. 

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/bin/ccache-swig

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+# Wrapper to call the binary executable.
+PROJECT_ROOT=File.expand_path(File.join(File.dirname(__FILE__), '..'))
+executable_path=File.join(PROJECT_ROOT, "swig", "bin", "ccache-swig")
+exec "#{executable_path}", *ARGV

data/bin/swig

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+# Wrapper to call the binary executable.
+PROJECT_ROOT=File.expand_path(File.join(File.dirname(__FILE__), '..'))
+executable_path=File.join(PROJECT_ROOT, "swig", "bin", "swig")
+exec "#{executable_path}", *ARGV

data/ext/Rakefile

@@ -0,0 +1,174 @@
+require 'fileutils'
+require 'parallel'
+require 'rbconfig'
+require File.expand_path(File.join(File.dirname(__FILE__), 'download'))
+
+module RubySwig
+  SWIG_VERSION='2.0.7'
+  PCRE_VERSION='8.30'
+  IS_WINDOWS = (RbConfig::CONFIG['host_os'] =~ /mswin|mingw|cygwin/)
+  if (IS_WINDOWS)
+    begin
+      # Setup devkit path so we have access to bash and tar.
+      require 'devkit'
+    rescue LoadError
+      puts "Devkit is required on Windows to build SWIG from source."
+    end
+  end
+
+  PROJECT_ROOT=File.expand_path(File.join(File.dirname(__FILE__), '..'))
+  EXT_ROOT=File.expand_path(File.dirname(__FILE__))
+  SOURCE_DIR=File.join(EXT_ROOT, "swig-#{SWIG_VERSION}")
+  INSTALL_DIR=File.join(PROJECT_ROOT, "swig")
+  PWD=FileUtils.pwd
+  GEMDIR=`gem env gemdir`.chomp
+  GEM_CACHE_DIR=File.join(GEMDIR, 'cache')
+  # Windows VC++: download http://prdownloads.sourceforge.net/swig/swigwin-2.0.7.zip
+
+  class SwigBuilder
+    def initialize
+      if `bash -c "which bsdtar"`.empty?
+        @tar_cmd='tar'
+      else
+        @tar_cmd='bsdtar'
+      end
+    end
+
+    def bsd_tar?
+      @tar_cmd=='bsdtar'
+    end
+
+    def system!(*args)
+      system(*args)
+      return_code=$?
+      if return_code != 0 then
+        raise RuntimeError.new("Failed to run #{args}. Return code: #{return_code}")
+      end
+    end
+
+    def link(src, dest, options={})
+      if IS_WINDOWS
+        begin
+          FileUtils.cp(src, dest)
+        rescue Errno::EEXIST
+          puts "File #{src} already exists, skipping file copy"
+        end
+      else
+        begin
+          FileUtils.ln_s(src, dest, options)
+        rescue Errno::EEXIST
+          puts "File #{src} already exists, skipping symlink"
+        end
+      end
+    end
+
+    def run_script!(command)
+      if IS_WINDOWS
+        system "bash -c '#{command}'"
+      else
+        system! command
+      end
+    end
+
+    # Detect existing pcre library.
+    def pcre_installed?
+      system "gcc -c #{EXT_ROOT}/findpcre.c -o /dev/null"
+      $? == 0
+    end
+
+    # Download and build local version of pcre.
+    def install_pcre
+      pcre_filename = "pcre-#{PCRE_VERSION}.tar.gz"
+      pcre_download_path = File.join(GEM_CACHE_DIR, pcre_filename)
+      pcre_url = "http://sourceforge.net/projects/pcre/files/pcre/#{PCRE_VERSION}/#{pcre_filename}"
+
+      FileUtils.chdir(SOURCE_DIR)
+      if not File.exists?(pcre_download_path) then
+        Downloader.download_file(pcre_url, pcre_download_path)
+        # system! "curl -L -o #{pcre_download_path} #{pcre_url}"
+        # system! "wget -P #{GEM_CACHE_DIR} #{pcre_url}"
+      end
+      link(pcre_download_path, pcre_filename)
+      if bsd_tar?
+        FileUtils.cp(File.join(EXT_ROOT, 'bsdtar-pcre-build.sh'), '.')
+        run_script! './bsdtar-pcre-build.sh'
+      else
+        run_script! 'Tools/pcre-build.sh'
+      end
+    end
+
+    def install_manpages(dest)
+      begin
+        FileUtils.chdir(INSTALL_DIR)
+        Dir.glob(File.join('share', 'man', '**', '*')).each do |file|
+          dest_file = File.join(dest, file)
+          FileUtils.mkdir_p(File.dirname(file))
+          link(File.expand_path(file), dest_file, :force => true)
+        end
+      rescue Errno::EACCES
+        puts "Warning: man pages are not installed. To install locally:"
+        puts "cd #{PROJECT_ROOT}; sudo rake install_manpages"
+      rescue Errno::EEXIST
+        puts "Man pages already installed."
+      rescue => e
+        puts "Rescuing #{e.class}"
+        puts e.inspect
+        raise
+      ensure
+        FileUtils.chdir(PWD)
+      end
+    end
+
+    def build_swig
+      swig_filename = "swig-#{SWIG_VERSION}.tar.gz"
+      swig_download_path = File.join(GEM_CACHE_DIR, swig_filename)
+      swig_url = "http://downloads.sourceforge.net/project/swig/swig/swig-#{SWIG_VERSION}/#{swig_filename}"
+
+      FileUtils.chdir(EXT_ROOT)
+      if not File.exists?(swig_download_path) then
+        Downloader.download_file(swig_url, swig_download_path)
+        # system! "curl -L -o #{swig_download_path} #{swig_url}"
+        # system! "wget -P #{GEM_CACHE_DIR} #{swig_url}"
+      end
+      link(swig_download_path, swig_filename)
+      system! "#{@tar_cmd} -xf swig-#{SWIG_VERSION}.tar.gz"
+      FileUtils.chdir(SOURCE_DIR)
+
+      # Requirement: pcre.
+      if not pcre_installed? then
+        install_pcre
+      end
+
+      system! "make distclean" if File.exists?('Makefile')
+      run_script! "./configure --prefix=#{INSTALL_DIR}"
+
+      processors = Parallel.processor_count
+      if processors > 1
+        system! "make -j#{processors}"
+      else
+        system! 'make'
+      end
+      FileUtils.chdir(PWD)
+    end
+
+    def install_swig
+      FileUtils.chdir(SOURCE_DIR)
+      system! 'make install'
+      FileUtils.chdir(PWD)
+    end
+  end
+end
+
+task :default => [:build_swig]
+
+task :build_swig do
+  builder = RubySwig::SwigBuilder.new
+  builder.build_swig
+  builder.install_swig
+  builder.install_manpages('/usr/local')
+end
+
+task :install_manpages do
+  RubySwig::SwigBuilder.new.install_manpages('/usr/local')
+end
+

data/ext/bsdtar-pcre-build.sh

@@ -0,0 +1,8 @@
+#!/bin/sh
+
+function tar ()
+{
+	bsdtar $*
+}
+
+. Tools/pcre-build.sh

data/ext/build_swig

@@ -0,0 +1,41 @@
+#!/bin/bash
+pushd `dirname $0/..`
+PROJECT_ROOT=$PWD
+
+wget http://downloads.sourceforge.net/project/swig/swig/swig-2.0.7/swig-2.0.7.tar.gz
+tar -zxsf swig-2.0.7.tar.gz
+cd swig-2.0.7
+
+# Requirement: pcre.
+# Detect existing pcre library.
+gcc -c findpcre.c -o /dev/null
+if ! $?; then
+	# Download and build local version of pcre.
+	wget http://sourceforge.net/projects/pcre/files/pcre/8.30/pcre-8.30.tar.gz
+	Tools/pcre-build.sh
+fi
+
+# This works for both rvm and non-rvm installations (as opposed to $GEM_PATH)
+GEMDIR=`gem env gemdir`
+# When running from extconf.rb, use $PROJECT_ROOT. Then swig will be in the bin folder.
+./configure --prefix=$GEMDIR
+processor_count=`ruby -r 'parallel' -e 'puts Parallel.processor_count'`
+make -j${processor_count:-1}
+make install
+
+# This is optional.
+# Add share/man page for ccache-swig
+sudo mkdir -p /usr/local/share/man/man1
+# ln -s $GEMDIR/share/man/man1/ccache-swig.1 /usr/local/share/man/man1/
+for manpage in $GEMDIR/share/man/man1/*; do
+	page=`basename $manpage`
+	if ! [ -f /usr/local/share/man/man1/$page ]; then
+		if [ -h /usr/local/share/man/man1/$page ]; then
+			# Remove stale link
+			sudo rm /usr/local/share/man/man1/$page
+		fi
+	sudo ln -s $manpage /usr/local/share/man/man1/$page
+	fi
+done
+
+popd

data/ext/download.rb

@@ -0,0 +1,204 @@
+#!/usr/bin/env ruby
+# An HTTP/HTTPS/FTP file downloader library/CLI based upon MiniPortile's
+# HTTP implementation.
+#
+# Author: Jon Maken
+# License: 3-clause BSD
+# Revision: 2012-03-25 23:01:19 -0600
+
+require 'net/http'
+require 'net/https' if RUBY_VERSION < '1.9'
+require 'net/ftp'
+require 'fileutils'
+require 'tempfile'
+
+class Downloader
+
+  VERSION = '0.1.0'
+
+  # class attributes
+  class << self
+    attr_accessor :logger, :max_ca_verify_depth, :ftp_data_chunk_size
+  end
+
+  @logger = STDOUT.binmode
+  @max_ca_verify_depth = 5
+  @ftp_data_chunk_size = 8192 
+
+
+  def self.download_file(url, full_path, count = 3)
+    return if File.exist?(full_path)
+
+    uri = URI.parse(url)
+    case uri.scheme.downcase
+    when /ftp/
+      ftp_download(uri, full_path)
+    when /http|https/
+      http_download(url, full_path, count)
+    end
+  end
+
+
+private
+  def self.message(text)
+    @logger.print text
+    @logger.flush
+  end
+
+  def self.output(text = '')
+    @logger.puts text
+    @logger.flush
+  end
+
+  def self.http_download(url, full_path, count)
+
+    begin
+      uri = URI.parse(url)
+      filename = File.basename(uri.path)
+
+      if ENV['HTTP_PROXY']
+        protocol, userinfo, proxy_host, proxy_port  = URI::split(ENV['HTTP_PROXY'])
+        proxy_user, proxy_pass = userinfo.split(/:/) if userinfo
+        http = Net::HTTP.new(uri.host, uri.port, proxy_host, proxy_port, proxy_user, proxy_pass)
+      else
+        http = Net::HTTP.new(uri.host, uri.port)
+      end
+
+      if uri.scheme.downcase == 'https'
+        http.use_ssl = true
+        if ENV['CA_CERT_FILE']
+          cert_file = ENV['CA_CERT_FILE'].dup
+          cert_file.gsub!(File::ALT_SEPARATOR, File::SEPARATOR) if File::ALT_SEPARATOR
+        end
+        if cert_file && File.exists?(cert_file)
+          http.ca_file = cert_file
+          http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+          http.verify_depth = @max_ca_verify_depth
+        else
+          raise <<-EOT
+To download using HTTPS you must first set the CA_CERT_FILE
+environment variable to the path of a valid CA certificate file.
+A file of bundled public CA certs may be downloaded from:
+
+   http://curl.haxx.se/ca/cacert.pem
+
+          EOT
+        end
+      end
+
+      http.request_get(uri.path) do |response|
+        case response
+        when Net::HTTPNotFound
+          output "404 - Not Found"
+          return false
+
+        when Net::HTTPClientError
+          output "Error: Client Error: #{response.inspect}"
+          return false
+
+        when Net::HTTPRedirection
+          raise "Too many redirections for the original URL, halting." if count <= 0
+          url = response["location"]
+          return http_download(url, full_path, count - 1)
+
+        when Net::HTTPOK
+          temp_file = Tempfile.new("download-#{filename}")
+          temp_file.binmode
+
+          size = 0
+          progress = 0
+          total = response.header["Content-Length"].to_i
+
+          response.read_body do |chunk|
+            temp_file << chunk
+            size += chunk.size
+            new_progress = (size * 100) / total
+            unless new_progress == progress
+              message "\rDownloading %s (%3d%%) " % [filename, new_progress]
+            end
+            progress = new_progress
+          end
+
+          output
+
+          temp_file.close
+          File.unlink full_path if File.exists?(full_path)
+          FileUtils.mkdir_p File.dirname(full_path)
+          FileUtils.mv temp_file.path, full_path, :force => true
+        end
+      end
+
+    rescue Exception => e
+      File.unlink full_path if File.exists?(full_path)
+      output "ERROR: #{e.message}"
+      raise "Failed to download file"
+    end
+  end
+
+  def self.ftp_download(parsed_uri, full_path)
+    filename = File.basename(parsed_uri.path)
+
+    begin
+      temp_file = Tempfile.new("download-#{filename}")
+      temp_file.binmode
+
+      size = 0
+      progress = 0
+
+      # TODO add user/pw support
+      Net::FTP.open(parsed_uri.host) do |ftp|
+        ftp.passive = true
+        ftp.login
+        remote_dir = File.dirname(parsed_uri.path)
+        ftp.chdir(remote_dir) unless remote_dir == '.'
+
+        total = ftp.size(filename)
+
+        ftp.getbinaryfile(filename, nil, @ftp_data_chunk_size) do |chunk|
+          temp_file << chunk
+          size += chunk.size
+          new_progress = (size * 100) / total
+          unless new_progress == progress
+            message "\rDownloading %s (%3d%%) " % [filename, new_progress]
+          end
+          progress = new_progress
+        end
+      end
+
+      output
+
+      temp_file.close
+      File.unlink full_path if File.exists?(full_path)
+      FileUtils.mkdir_p File.dirname(full_path)
+      FileUtils.mv temp_file.path, full_path, :force => true
+
+    rescue Exception => e
+      File.unlink full_path if File.exists?(full_path)
+      output "ERROR: #{e.message}"
+      raise "Failed to download file"
+    end
+  end
+
+end  # Downloader
+
+
+if __FILE__ == $0
+  usage = <<-EOU
+
+HTTP/HTTPS/FTP File Downloader, v#{Downloader::VERSION}
+Usage: ruby download.rb URL FILE
+
+  URL   http/https/ftp location of the file to download
+  FILE  full local path at which to save downloaded file
+
+
+influential environment variables:
+
+  HTTP_PROXY    url to http proxy
+  CA_CERT_FILE  full path to CA certificate file
+  EOU
+
+  abort usage if ARGV.length != 2
+
+  Downloader.download_file(ARGV[0], ARGV[1])
+end

data/ext/findpcre.c

@@ -0,0 +1 @@
+#include "pcre.h"

data/lib/rubyswig.rb

@@ -0,0 +1,5 @@
+require "rubyswig/version"
+
+module Rubyswig
+  # Your code goes here...
+end

data/lib/rubyswig/version.rb

@@ -0,0 +1,3 @@
+module Rubyswig
+  VERSION = "0.0.1"
+end

data/rubyswig.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/rubyswig/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Brian Wong"]
+  gem.email         = ["bdwong.net@gmail.com"]
+  gem.description   = %q{Builds SWIG (Simplified Wrapper Interface Generator) from source with minimal dependencies,
+                         then installs it as a rubygem executable, allowing it to be versioned with rvm gemsets.
+                         More importantly, makes installing SWIG dead-easy, and allows you to use Gemfiles and
+                         Bundler to specify dependencies against it.
+                        }
+  gem.summary       = %q{Build and install SWIG from source for Ruby}
+  gem.homepage      = ""
+
+  gem.extensions    << "ext/Rakefile"
+  gem.files         = `git ls-files`.split($\)
+  #gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.executables   = ['swig', 'ccache-swig']
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "rubyswig"
+  gem.require_paths = ["lib"]
+  gem.version       = Rubyswig::VERSION
+  gem.bindir        = "bin"
+  gem.add_dependency "parallel"
+end

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification
+name: rubyswig
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Brian Wong
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-08-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: parallel
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ! "Builds SWIG (Simplified Wrapper Interface Generator) from source with
+  minimal dependencies,\n                         then installs it as a rubygem executable,
+  allowing it to be versioned with rvm gemsets.\n                         More importantly,
+  makes installing SWIG dead-easy, and allows you to use Gemfiles and\n                         Bundler
+  to specify dependencies against it.\n                        "
+email:
+- bdwong.net@gmail.com
+executables:
+- swig
+- ccache-swig
+extensions:
+- ext/Rakefile
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/ccache-swig
+- bin/swig
+- ext/Rakefile
+- ext/bsdtar-pcre-build.sh
+- ext/build_swig
+- ext/download.rb
+- ext/findpcre.c
+- lib/rubyswig.rb
+- lib/rubyswig/version.rb
+- rubyswig.gemspec
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.21
+signing_key: 
+specification_version: 3
+summary: Build and install SWIG from source for Ruby
+test_files: []