blackwinter-libxslt-ruby 1.0.1

data/CHANGES

@@ -0,0 +1,81 @@
+== 0.9.1 / 2008-11-24 Charlie Savage
+
+* Support libxml-ruby bindings 0.9.3 and above which has a changed
+  external api.
+
+* Remove unused xslt transform wrapper class.
+
+== 0.9.0 / 2008-11-18 Charlie Savage
+
+* Add back in support for exslt.
+
+* Support libxml-ruby bindings 0.9.0.
+
+== 0.8.2 / 2008-07-21 Charlie Savage
+
+* To use LibXSLT you can either require 'xslt' or require 'libxslt'.
+  The differences is that require 'xslt' mixes the LibXML and
+  LIBXSLT modules into the global namespace, thereby allowing
+  you to write code such as:
+    stylesheet = XSLT::Stylesheet.new(XML::Document.new).  Note that
+  this is different from 0.8.0 release and may require updating your code.
+
+* Support for libxml-ruby 0.8.2
+
+* Improved Windows support - libxslt-ruby should now work out of the box.
+
+== 0.8.0 / 2008-07-10 Charlie Savage
+
+* Fix memory errors when reusing a stylehseet
+
+* Added support for setting xsl::param values
+
+* Updated RDocs.
+
+* Moved to LibXSLT namespace
+
+
+== 0.7.0 / 2008-07-10 Charlie Savage
+
+* Ability to reuse the same stylesheet multiple times
+
+* Simpler api
+
+* Compatibility layer for pre-0.7.0 versions
+
+* Major rewrite, resulting in significantly less code
+
+* Updated RDocs.
+
+
+== 0.6.0 / 2008-07-01 Charlie Savage
+
+* Now packaged as a separate gem
+
+* Windows support (both lots of memory fixes and binaries)
+
+* New libxslt.rb ruby wrapper, so programs can simply say require 'xslt'
+
+
+== 0.5.0 / 2006-02-27 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
+
+
+== 0.4.0 / 2003-12-15 Martin Povolny <martin@solnet.cz>
+
+* libxslt.c: added call to exsltRegisterAll to enable exslt extensions
+
+* extconf.rb: added -lexslt
+
+== 0.3.0 / 2004-02-01 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$
+
+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,164 @@
+= libxslt-ruby
+
+== Overview
+
+The libxslt gem provides Ruby language bindings for GNOME's Libxslt
+toolkit. It is free software, released under the MIT License.
+
+
+== Requirements
+
+libxslt-ruby requires Ruby 1.8.4 or higher.  It is dependent on 
+the following libraries to function properly:
+
+* libm      (math routines: very standard)
+* libz      (zlib)
+* libiconv
+* libxml2
+* libxslt
+* libxml-ruby bindings
+
+If you are running Linux or Unix you'll need a C compiler so the extension
+can be compiled when it is installed.  If you are running Windows, then install the Windows specific RubyGem which
+includes an already built extension.
+
+!!!NOTE!!!  The libxml-ruby and libxslt-ruby bindings must absolutely, positively,
+without a doubt share the same libxml2 library.  This is because libxslt modifies
+XML documents created by libxml2.  If there are two copies of libxml2 on your 
+system, then when XML documents allocated in copy #1 are manipulated by copy #2,
+a segmentation fault will occur.  So make sure that your system has only one copy of libxml2
+installed.
+
+
+== INSTALLATION
+
+The easiest way to install libxslt-ruby is via Ruby Gems.  To install:
+
+<tt>gem install libxslt-ruby</tt>
+
+If you are running Windows, make sure to install the Win32 RubyGem which 
+includes an already built binary file.  The binary is built against
+libxml2 version 2.6.32, iconv version 1.11 and libxslt version 1.1.24.
+Binaries for libxml2 and iconv are provided in the libxml-ruby bindings,
+while a binary for libxslt is provided in the libxslt-ruby bindings. 
+
+The Windows binaries are biult with MingW.  The gem also includes 
+a Microsoft VC++ 2005 solution.  If you wish to run a debug version
+of libxml-ruby on Windows, then it is highly recommended
+you use VC++.
+
+
+== USAGE
+
+For in-depth information about using libxslt-ruby please refer
+to its online Rdoc documentation.  
+
+All libxslt classes are in the LibXSLT::XSLT module. The simplest
+way to use libxslt is to require 'xslt'.  This will mixin the 
+LibXML and LibXSLT modules into the global namespace, allowing you to 
+write code like this: 
+
+require 'xslt'
+document = XML::Document.new
+stylesheett = XSLT::Stylesheet.new(document)
+
+If you prefer not to add the LibXSLT module to the global namepace, then
+write your code like this:
+
+require 'libxslt'
+
+class MyClass
+  def some_method
+    document = LibXML::XML::Document.new
+    stylesheett = LibXSLT::XSLT::Stylesheet.new(document)
+  end
+end
+
+Given an XML file like:
+
+  <?xml version="1.0" encoding="UTF-8"?>
+  <?xml-stylesheet href="fuzface.xsl" type="text/xsl"?>
+  
+  <commentary>
+    <meta>
+      <author>       
+        <first_name>Sean</first_name>
+        <last_name>Chittenden</last_name>
+        <email>sean@chittenden.org</email>
+      </author>
+      <version>$Version$</version>
+      <date>$Date$</date>
+      <id>$Id$</id>     <title>Fuzface...</title>
+      <subtitle>The Internet's a big place and here's some proof...</subtitle>
+    </meta>
+  
+    <body>
+      <para>
+        I think it's a tragedy that I'm going to start off my new
+        commentary by talking about facial hair and the Internet.
+        Something about that just screams pathetic, but whatever: it's
+        humor and that's life.
+      </para>
+    </body>
+  </commentary>
+
+And an XSLT file like this:
+
+  <?xml version="1.0" ?>
+  <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+  <xsl:template match="/">
+    <xsl:element name="html">
+      <xsl:element name="head">
+        <xsl:element name="title">Ramblings - <xsl:value-of select="commentary/meta/title" /> - <xsl:value-of select="commentary/meta/subtitle" /></xsl:element>
+      </xsl:element>
+  
+      <xsl:element name="body">
+        <xsl:element name="h1"><xsl:value-of select="commentary/meta/title" /></xsl:element>
+        <xsl:element name="h3"><xsl:value-of select="commentary/meta/subtitle" /></xsl:element>
+        By: <xsl:value-of select="commentary/meta/author/first_name" /> <xsl:value-of select="commentary/meta/author/last_name" /><xsl:element name="br" />
+        Date: <xsl:value-of select="commentary/meta/date" /><xsl:element name="br" />
+  
+        <xsl:for-each select="./commentary/body">
+          <xsl:apply-templates />
+        </xsl:for-each>
+  
+      </xsl:element>
+    </xsl:element>
+  </xsl:template>
+  
+  <xsl:template match="para">
+    <xsl:element name="p">
+      <xsl:value-of select="." />
+    </xsl:element>
+  </xsl:template>
+  </xsl:stylesheet>
+
+We can easily transform the XML with the following ruby code:
+
+  require 'xslt'
+  
+  # Create a new XSL Transform
+  stylesheet_doc = XML::Document.file('files/fuzface.xsl')
+  stylesheet = LibXSLT::Stylesheet.new(stylesheet_doc)
+
+  # Transform a xml document
+  xml_doc = XML::Document.file('files/fuzface.xml')
+  result = stylesheet.apply(xml_doc)
+   
+You can then print, save or manipulate the returned document.
+
+== License
+
+See LICENSE for license information.
+
+== DOCUMENTATION
+
+RDoc comments are included - run 'rake doc' to generate documentation.
+You can find the latest documentation at:
+
+* http://libxsl.rubyforge.org/
+
+== MORE INFORMATION
+
+For more information please refer to the documentation.  If you have any
+questions, please send email to libxml-devel@rubyforge.org.

data/Rakefile

@@ -0,0 +1,75 @@
+#!/usr/bin/env ruby
+
+require "rubygems"
+require "rake/extensiontask"
+require "rake/testtask"
+require 'rdoc/task'
+require "grancher/task"
+require "yaml"
+
+GEM_NAME = "libxslt-ruby"
+SO_NAME  = "libxslt_ruby"
+
+# Read the spec file
+spec = Gem::Specification.load("#{GEM_NAME}.gemspec")
+
+# Setup compile tasks
+Rake::ExtensionTask.new do |ext|
+  ext.gem_spec = spec
+  ext.name = SO_NAME
+  ext.ext_dir = "ext/libxslt"
+  ext.lib_dir = "lib/#{RUBY_VERSION.sub(/\.\d$/, '')}"
+  ext.config_options << "--with-xml2-include=C:/MinGW/local/include/libxml2"
+  ext.config_options << "--with-xslt-include=C:/MinGW/local/include/libxslt"
+  ext.config_options << "--with-exslt-include=C:/MinGW/local/include/libexslt"
+end
+
+# Setup generic gem
+Gem::PackageTask.new(spec) do |pkg|
+  pkg.package_dir = 'pkg'
+  pkg.need_tar    = false
+end
+
+# Setup Windows Gem
+if RUBY_PLATFORM.match(/win32|mingw32/)
+  binaries = (FileList['lib/**/*.so',
+                       'lib/**/*dll'])
+
+  # Windows specification
+  win_spec = spec.clone
+  win_spec.platform = Gem::Platform::CURRENT
+  win_spec.files += binaries.to_a
+
+  # Unset extensions
+  win_spec.extensions = nil
+
+  # Rake task to build the windows package
+  Gem::PackageTask.new(win_spec) do |pkg|
+    pkg.package_dir = 'pkg'
+    pkg.need_tar = false
+  end
+end
+
+# RDoc Task
+desc "Generate rdoc documentation"
+RDoc::Task.new("rdoc") do |rdoc|
+  rdoc.rdoc_dir = 'doc'
+  rdoc.title    = "libxml-xslt"
+  # Show source inline with line numbers
+  rdoc.options << "--line-numbers"
+  # Make the readme file the start page for the generated html
+  rdoc.options << '--main' << 'README'
+  rdoc.rdoc_files.include('doc/*.rdoc',
+                          'ext/**/*.c',
+                          'lib/**/*.rb',
+                          'CHANGES',
+                          'README',
+                          'LICENSE')
+end
+
+# Test Task
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList['test/test*.rb'].exclude('test/test_suite.rb')
+  t.verbose = true
+end

data/ext/libxslt/extconf.rb

@@ -0,0 +1,146 @@
+#!/usr/local/bin/ruby -w
+
+# See the LICENSE file for copyright and distribution information
+
+require 'mkmf'
+require 'rbconfig'
+
+require 'rubygems'
+$preload = nil
+$INCFLAGS << " -I/usr/local/include"
+$LIBPATH.push(Config::CONFIG['libdir'])
+
+def crash(str)
+  print(" extconf failure: %s\n", str)
+  exit 1
+end
+
+# Directories
+dir_config('iconv')
+dir_config('zlib')
+dir_config('xml2')
+dir_config('xslt')
+dir_config('exslt')
+dir_config('libxml-ruby')
+
+# First get zlib
+unless have_library('z', 'inflate') or
+       have_library('zlib', 'inflate') or
+       have_library('zlib1', 'inflate') or
+       have_library('libz', 'inflate')
+  crash('need zlib')
+else
+  $defs.push('-DHAVE_ZLIB_H')
+end
+
+unless have_library('iconv','iconv_open') or
+       have_library('iconv','libiconv_open') or
+       have_library('libiconv', 'libiconv_open') or
+       have_library('libiconv', 'iconv_open') or
+       have_library('c','iconv_open') or
+       have_library('recode','iconv_open') or
+       have_library('iconv')
+  crash(<<-EOL)
+need libiconv.
+
+Install the libiconv or try passing one of the following options
+to extconf.rb:
+
+  --with-iconv-dir=/path/to/iconv
+  --with-iconv-lib=/path/to/iconv/lib
+  --with-iconv-include=/path/to/iconv/include
+EOL
+end
+
+
+unless (have_library('xml2', 'xmlXPtrNewRange') or
+        have_library('libxml2', 'xmlXPtrNewRange') or
+        find_library('xml2', 'xmlXPtrNewRange', '/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
+        have_library('libxslt','xsltApplyStylesheet') or
+        find_library('xslt', 'xsltApplyStylesheet', '/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_library('exslt','exsltRegisterAll') or
+        have_library('libexslt','exsltRegisterAll') or
+        find_library('exslt', 'exsltRegisterAll', '/opt/lib', '/usr/local/lib', '/usr/lib')) and
+       (have_header('exslt.h') or
+        find_header('exslt.h',
+                    '/opt/include/libexslt',
+                    '/usr/local/include/libexslt',
+                    '/usr/include/libexslt'))
+  crash(<<-EOL)
+    Need libexslt.
+        Install the library or try one of the following options to extconf.rb:
+        --with-exslt-dir=/path/to/libexslt
+        --with-exslt-lib=/path/to/libexslt/lib
+        --with-exslt-include=/path/to/libexslt/include
+   EOL
+end
+
+# Figure out where libxml-ruby is installed
+gem_specs = Gem.source_index.find_name('libxml-ruby')
+if gem_specs.empty?
+  crash(<<-EOL)
+    libxml-ruby bindings must be installed
+  EOL
+end
+
+gem_specs = gem_specs.sort_by {|spec| spec.version}.reverse
+libxml_ruby_path = gem_specs.first.full_gem_path
+
+$INCFLAGS += " -I#{libxml_ruby_path}/ext"
+
+unless have_header('libxml/ruby_libxml.h')
+  crash(<<-EOL)
+    Need headers for libxml-ruby.
+  EOL
+end
+
+if RUBY_PLATFORM.match(/win32|mingw32/)
+  RUBY_VERSION =~ /(\d+.\d+)/
+  $LIBPATH << File.join(libxml_ruby_path, "lib")
+  $LIBPATH << File.join(libxml_ruby_path, "lib", $1)
+
+  headers = ['iconv.h', 'libxml/ruby_libxml.h']
+  unless have_library(':libxml_ruby.so', 'Init_libxml_ruby', headers)
+    crash(<<-EOL)
+      Need libxml-ruby
+      Please install libxml-ruby or specify the path to the gem via:
+        --with-libxml-ruby=/path/to/libxml-ruby gem
+    EOL
+  end
+end
+
+create_header()
+create_makefile("libxslt_ruby")