libxsl-ruby 0.3.6

data/CHANGELOG

@@ -0,0 +1,14 @@
+27.02.2006 Ross Bamford <rosco at roscopeco.co.uk>
+  * Source layout for Rubygem release
+  * Fixed unit tests (set_up to setup, directory handling)
+  * Updated extconf to remove shell-script dependency
+  * Fixed multiple symbol declarations for -fno-common
+
+15.12.2003 Martin Povolny <martin@solnet.cz>
+  * libxslt.c: added call to exsltRegisterAll to enable exslt extensions
+  * extconf.rb: added -lexslt
+
+2.1.2004 Martin Povolny <martin@solnet.cz>
+  * libxslt.c: added call to ruby_init_xslt_transform_context() to make it 
+    work on ruby1.8
+

data/LICENSE

@@ -0,0 +1,21 @@
+# $Id: LICENSE,v 1.1 2006/03/24 10:54:55 roscopeco Exp $
+
+Copyright (c) 2002-2006 Sean Chittenden <sean@chittenden.org> and contributors
+
+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

@@ -0,0 +1,50 @@
+== INSTALLATION
+
+Installation is simple.  Follow the following steps:
+
+=== Rubygems
+
+  gem install libxsl-ruby
+	
+=== Tarball/zip	
+
+  $ rake test
+  $ rake install
+
+If extconf yacks up an error, follow the instructions it provides.
+You will need to chdir to ext/xml and run 'ruby extconf.rb' to provide
+options, after which you can either use Rake for everything or 
+do with make (make && make install).
+
+Once installed, look at the test scripts (tests/*.rb), and run 
+'rake doc' to generate API documentation.
+
+== DOCUMENTATION
+
+RDoc comments are included - run 'rake doc' to generate documentation.
+You can find the latest documentation at:
+
+* http://libxsl.rubyforge.org/doc
+
+== USAGE EXAMPLE
+
+*Note*: To use libxsl-ruby, you have to require both 'xml/libxml' and 
+'xml/libxslt'.
+
+  $ cd tests
+  $ ruby fuzface.rb
+
+== If you checked out from CVS
+
+If you checked out the source from CVS, you must install a copy of
+the current (or matching) libxml-ruby headers in:
+
+  ext/xml/libxml-ruby
+	
+prior to running the above. This can be done via rake, and will
+happen automatically if ../libxml/ext/xml is found, or the
+LIBXMLH=/path/to/headers commandline option is supplied.
+
+# $Id: README,v 1.2 2006/03/24 11:19:58 roscopeco Exp $
+
+# See the LICENSE file for copyright and distribution information

data/Rakefile

@@ -0,0 +1,245 @@
+require 'net/ftp'
+require 'rake/clean'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/gempackagetask'
+
+CLEAN.include '**/*.o'
+CLEAN.include '**/*.so'
+CLEAN.include 'html'
+CLEAN.include 'tests/fuzface.html'
+CLOBBER.include '**/*.log'
+CLOBBER.include '**/Makefile'
+CLOBBER.include '**/extconf.h'
+
+desc "Default Task (Build release)"
+task :default => :test
+
+# Determine the current version of the software
+if File.read('ext/xml/libxslt.h') =~ /\s*RUBY_LIBXSLT_VERSION\s*['"](\d.+)['"]/
+  CURRENT_VERSION = $1
+else
+  CURRENT_VERSION = "0.0.0"
+end
+
+PKG_VERSION = ENV['REL'] || CURRENT_VERSION
+LIBXMLH = ENV['LIBXMLH'] || '../libxml/ext/xml'
+
+task :test_ver do
+  puts PKG_VERSION
+end
+
+# Make tasks -----------------------------------------------------
+MAKECMD = ENV['MAKE_CMD'] || 'make'
+MAKEOPTS = ENV['MAKE_OPTS'] || ''
+
+# Copy libxml headers in if needed or official release
+task :copy_libxml_headers do  
+  rm_rf 'ext/xml/libxml-ruby' if ENV['REL'] || ENV['ALLCLEAN']
+
+  unless File.exist?('ext/xml/libxml-ruby')
+    unless File.exist?(LIBXMLH)
+      fail <<-EOM
+      
+    LibXML-Ruby headers are required to build a release.
+  
+    Install libxml-ruby source at ../libxml, or supply
+    LIBXMLH option to rake (e.g. LIBXMLH=../myinc/path)
+    
+      EOM
+    end
+    
+    mkdir 'ext/xml/libxml-ruby'
+    
+    Dir[File.join(LIBXMLH, '*.h')].each do |fn|
+      unless fn =~ /extconf.h$/
+        File.open(File.join('ext/xml/libxml-ruby', File.basename(fn)), 'w+') do |f|
+          f << "/* DO NOT EDIT THIS FILE - UPDATE FROM LIBXML-RUBY ONLY */\n"
+          f << "/* Generated: #{Time.now} */\n"
+          f << "/* Release  : #{CURRENT_VERSION} */\n\n\n\n\n\n\n\n"
+          f << File.read(fn)
+        end
+      end
+    end
+  end
+end
+
+file 'ext/xml/extconf.rb' => :copy_libxml_headers
+
+file 'ext/xml/Makefile' => 'ext/xml/extconf.rb' do
+  Dir.chdir('ext/xml') do
+    ruby 'extconf.rb'
+  end
+end
+
+def make(target = '')
+  Dir.chdir('ext/xml') do
+    pid = fork { exec "#{MAKECMD} #{MAKEOPTS} #{target}" }
+    Process.waitpid pid
+  end
+  $?.exitstatus
+end
+
+# Let make handle dependencies between c/o/so - we'll just run it. 
+file 'ext/xml/libxslt.so' => 'ext/xml/Makefile' do
+  m = make
+  fail "Make failed (status #{m})" unless m == 0
+end
+
+desc "Compile the shared object"
+task :compile => 'ext/xml/libxslt.so'
+
+desc "Install to your site_ruby directory"
+task :install => :compile do
+  m = make 'install' 
+  fail "Make install failed (status #{m})" unless m == 0
+end
+
+# Test Tasks ---------------------------------------------------------
+task :ta => :alltests
+task :tu => :unittests
+task :test => :unittests
+
+Rake::TestTask.new(:alltests) do |t|
+  t.test_files = FileList[
+    'tests/tc_*.rb',
+    'tests/contrib/*.rb',
+  ]
+  t.verbose = true
+end
+                    
+Rake::TestTask.new(:unittests) do |t|
+  t.test_files = FileList['tests/tc_*.rb']
+  t.verbose = false
+end
+                          
+#Rake::TestTask.new(:funtests) do |t|
+  #  t.test_files = FileList['test/fun*.rb']
+  #t.warning = true
+  #t.warning = true
+#end
+
+task :unittests => :compile
+task :alltests => :compile
+
+# RDoc Tasks ---------------------------------------------------------
+desc "Create the RDOC documentation tree"
+rd = Rake::RDocTask.new(:doc) do |rdoc|
+  rdoc.rdoc_dir = 'html'
+  rdoc.title    = "Libxsl-Ruby API"
+  rdoc.options << '--main' << 'README'
+  rdoc.rdoc_files.include('README', 'LICENSE', 'TODO')
+  rdoc.rdoc_files.include('ext/xml/ruby_xslt*.c', 'ext/xml/libxslt.c', '*.rdoc')
+end
+
+desc "Publish the RDoc documentation to project web site"
+task :pubdoc => [ :doc ] do
+  unless ENV['RUBYFORGE_ACCT']
+    raise "Need to set RUBYFORGE_ACCT to your rubyforge.org user name (e.g. 'fred')"
+  end
+  require 'rake/contrib/sshpublisher'
+  Rake::SshDirPublisher.new(
+    "#{ENV['RUBYFORGE_ACCT']}@rubyforge.org",
+    "/var/www/gforge-projects/libxsl",
+    "html"
+  ).upload
+end
+
+# Packaging / Version number tasks -----------------------------------
+#
+# You can create a Rubygem with 'rake package'
+#
+# You can build a release package set with 'rake release'
+#
+# The project can build official release packages with
+# 'rake release REL=x.y.z' in a working copy (with correct 
+# libxml-ruby headers in ../libxml/ext/xml or alternative dir
+# specified with LIBXMLH=/path/to/headers/ )
+
+# Used during release packaging if a REL is supplied
+task :update_version do
+  unless PKG_VERSION == CURRENT_VERSION
+    maj, min, mic = /(\d+)\.(\d+)(?:\.(\d+))?/.match(PKG_VERSION).captures
+    File.open('ext/xml/libxslt.h.new','w+') do |f|
+      f << File.read('ext/xml/libxslt.h').
+           gsub(/RUBY_LIBXSLT_VERSION\s+"(\d.+)"/) { "RUBY_LIBXSLT_VERSION  \"#{PKG_VERSION}\"" }.
+           gsub(/RUBY_LIBXSLT_VERNUM\s+\d+/) { "RUBY_LIBXSLT_VERNUM   #{PKG_VERSION.tr('.','')}" }.
+           gsub(/RUBY_LIBXSLT_VER_MAJ\s+\d+/) { "RUBY_LIBXSLT_VER_MAJ   #{maj}" }.
+           gsub(/RUBY_LIBXSLT_VER_MIN\s+\d+/) { "RUBY_LIBXSLT_VER_MIN   #{min}" }.
+           gsub(/RUBY_LIBXSLT_VER_MIC\s+\d+/) { "RUBY_LIBXSLT_VER_MIC   #{mic || 0}" }           
+    end
+    mv('ext/xml/libxslt.h.new', 'ext/xml/libxslt.h')     
+  end
+end
+
+PKG_FILES = FileList[
+  'ext/xml/extconf.rb',
+  '[A-Z]*',
+  'ext/xml/*.c', 
+  'ext/xml/libxml-ruby/*.h',
+  'ext/xml/ruby_xslt*.h',
+  'ext/xml/libxslt.h',
+  'tests/**/*',
+]
+
+if ! defined?(Gem)
+  warn "Package Target requires RubyGEMs"
+else
+  spec = Gem::Specification.new do |s|
+    
+    #### Basic information.
+
+    s.name = 'libxsl-ruby'
+    s.version = PKG_VERSION
+    s.summary = "LibXSLT bindings for Ruby"
+    s.description = <<-EOF
+      C-language bindings for Gnome LibXSLT and Ruby.
+      Part of the LibXML-Ruby project.
+    EOF
+    s.extensions = 'ext/xml/extconf.rb'    
+
+    #### Which files are to be included in this gem? 
+    s.files = PKG_FILES.to_a
+    
+    #### dependencies
+    s.add_dependency('libxml-ruby', '>= 0.3.6')    
+
+    #### Load-time details
+    s.require_path = 'ext'
+    
+    #### Documentation and testing.
+    s.has_rdoc = true
+    s.extra_rdoc_files = rd.rdoc_files.reject { |fn| fn =~ /\.rb$/ }.to_a
+    s.rdoc_options <<
+      '--title' <<  'Libxsl-Ruby API' <<
+      '--main' << 'README' <<
+      '-o' << 'rdoc'      
+
+    s.test_files = Dir.glob('tests/*runner.rb')
+    
+    #### Author and project details.
+
+    s.author = "Sean Chittenden"
+    s.email = "libxsl-devel@rubyforge.org"
+    s.homepage = "http://libxsl.rubyforge.org"
+    s.rubyforge_project = "libxsl"
+  end
+  
+  # Quick fix for Ruby 1.8.3 / YAML bug
+  if (RUBY_VERSION == '1.8.3')
+    def spec.to_yaml
+      out = super
+      out = '--- ' + out unless out =~ /^---/
+      out
+    end  
+  end
+
+  package_task = Rake::GemPackageTask.new(spec) do |pkg|
+    pkg.need_zip = true
+    pkg.need_tar_gz = true
+    pkg.package_dir = 'pkg'    
+  end
+      
+  desc "Build a full release"
+  task :release => [:clobber, :update_version, :compile, :test, :package]  
+end

data/TODO

@@ -0,0 +1,32 @@
+$Id: TODO,v 1.1 2006/03/24 10:54:55 roscopeco Exp $
+
+XML::XSLT needs a class method that'll let it use a stylesheet that's
+already in memory.  Something like: xsl = XML::XSLT.string(stylesheet)
+
+Need version constants to be available for both LIBXML and LIBXSLT
+
+Need a way of changing the IO stream used for printing the output
+
+Should have some way of turning on more debugging that what's there
+
+Need to add the ability to save to a file
+
+Ability to dump the tree instead of the result to a given IO stream (partially completed, iirc)
+
+Ability to dump the registered extension elements and functions to a given IO stream
+
+Ability to turn on and off the DTD loading phase
+
+Ability to increase the maximum depth of applying templates
+
+Some way of specifying that the incoming document is xhtml and not xml
+
+Some way of specifying that the incoming document is SGML docbook
+
+A way of setting parameters (key/value pairs) before the stylesheet gets processed
+
+A way of not telling the XSL engine to not fetch DTDs over a network
+
+A way of specifying the SGML catalogs to use
+
+A way of turning on XInclude processing of the document input

data/ext/xml/extconf.rb

@@ -0,0 +1,97 @@
+#!/usr/local/bin/ruby -w
+
+# $Id: extconf.rb,v 1.1 2006/03/24 10:54:55 roscopeco Exp $
+#
+# See the LICENSE file for copyright and distribution information
+
+require "mkmf"
+
+$preload = nil
+$LIBPATH.push(Config::CONFIG['libdir'])
+
+def crash(str)
+  print(" extconf failure: %s\n", str)
+  exit 1
+end
+
+dir_config('xml2')
+dir_config('xslt')
+#dir_config('libxml-ruby', '../../../libxml', '../../../libxml/ext/xml')
+
+unless have_library('m', 'atan')
+  # try again for gcc 4.0
+  saveflags = $CFLAGS
+  $CFLAGS += ' -fno-builtin'
+  unless have_library('m', 'atan')
+    crash('need libm')
+  end
+  $CFLAGS = saveflags
+end
+
+unless have_library("z", "inflate")
+  crash("need zlib")
+else
+  $defs.push('-DHAVE_ZLIB_H')
+end
+
+unless (have_library('xml2', 'xmlXPtrNewRange') or
+        find_library('xml2', '/opt/lib', '/usr/local/lib', '/usr/lib')) and 
+       (have_header('libxml/xmlversion.h') or
+        find_header('libxml/xmlversion.h', 
+                    '/opt/include/libxml2', 
+                    '/usr/local/include/libxml2', 
+                    '/usr/include/libxml2'))
+  crash(<<EOL)
+need libxml2.
+
+        Install the library or try one of the following options to extconf.rb:
+
+        --with-xml2-dir=/path/to/libxml2
+        --with-xml2-lib=/path/to/libxml2/lib
+        --with-xml2-include=/path/to/libxml2/include
+EOL
+end
+
+unless (have_library('xslt','xsltApplyStylesheet') or
+        find_library('xslt', '/opt/lib', '/usr/local/lib', '/usr/lib')) and 
+       (have_header('xslt.h') or
+        find_header('xslt.h', 
+                    '/opt/include/libxslt', 
+                    '/usr/local/include/libxslt', 
+                    '/usr/include/libxslt'))
+  crash(<<EOL)
+need libxslt.
+
+        Install the library or try one of the following options to extconf.rb:
+
+        --with-xslt-dir=/path/to/libxslt
+        --with-xslt-lib=/path/to/libxslt/lib
+        --with-xslt-include=/path/to/libxslt/include
+EOL
+end
+
+unless have_header('libxml-ruby/libxml.h') 
+  crash(<<EOL)
+need headers for libxml-ruby.
+
+        If you downloaded a release, this is a bug - please inform
+        libxml-devel@rubyforge.org including the release version and
+        download URL you obtained it from.
+
+        If you checked libxslt-ruby out from CVS, you will need to
+        obtain the headers from CVS (using the same version tag if
+        applicable) and place them in directory 'ext/xml/libxml-ruby'.
+EOL
+end
+
+$LDFLAGS << ' -lexslt'
+#$LDFLAGS << ' -lxml'
+#$LDFLAGS << ' ' + `xslt-config --libs`.chomp
+#$LDFLAGS << ' ' + `xml2-config --libs`.chomp
+#$CFLAGS << ' ' + `xslt-config --cflags`.chomp
+#$CFLAGS << ' ' + `xml2-config --cflags`.chomp
+$CFLAGS = '-g -Wall ' + $CFLAGS + ' ' + $INCFLAGS
+
+
+create_header()
+create_makefile("xml/libxslt")