ruby-xml-smart 0.1.11-i486-linux

data/Changelog

@@ -0,0 +1,192 @@
+0.1.11 "name has to be selected"
+  * Made usage in threads more robust (examples/concurrent.rb)
+	  (namespace related bug? gone!)
+	* Made examples work when smart.so is not yet installed
+	* Fixed documentation generation the ugly way (ifdefs)
+	* Addes documentation comments all over the code
+	* GEM creation is now supported by Rakefile
+	* XML::SMART::QNAME#to_s returns "prefix:name" instead of "name" only
+	* XML::SMART::QNAME#inspect works the same for pull and dom
+	* XML::Smart::Pull::AttributeSet includes Enumeration
+	* 1.8.7 supported (rb_io_t works slightly different)
+
+0.1.10 "christmas is all around you"
+	* Adds XML::Smart::Dom::NamespaceSet#length
+	* Fixes a bug XML::Smart::Dom::NamespaceSet#[]= that lead to segfaults for
+		subsequent namespace setting
+	* Fixes a bug XML::Smart::Dom#find and XML::Smart::Dom::Element#find
+		-> ruby 1.8.* segfaults SOMETIMES (heisenbug :-) when rb_hash_foreach is
+		   called for empty hashes
+	* code cleanup and ifdefs to support > 1.8.6 (including 1.9.0)
+
+0.1.9 "signal weaving"
+  * XML::Smart::Dom::NodeSet#delete_if! returns now true when deleting a node
+	* Change Handlers (examples/signals.rb)
+    -> XML::Smart::Dom#on_change - supply a block that is called when a
+		   document changes
+    -> XML::Smart::Dom#change_handlers - an array that holds the list of
+			 change handlers (add, change, delete, ... them)
+	  -> 2 parameters are sent to your change handlers: type, node		 
+		   type is one of XML::Smart::Dom::SIGNAL_ADD,
+			 XML::Smart::Dom::SIGNAL_CHANGE, XML::Smart::Dom::SIGNAL_DELETE
+	* Adds XML::Smart::Dom::Other which contains #text, #to_s, #path
+	  -> returned when unknown node type
+	* Adds XML::Smart::Dom#namespaces[=] which adds global namespace support 
+	  -> its a hash
+		-> no more need to add namespaces to every #find
+		-> examples/namespace_find.rb
+	* Loads of bugfixes, which I can no longer remember :-)
+	  -> they had mostly to do with namespaces (e.g. handle xml namespace)
+
+0.1.8 "Documentation is like sex: when it is good, it is very, very good; and
+       when it is bad, it is better than nothing."
+  * rake is now the only way to go     
+  * Change qname.c to work correct for namespaces, inspired by Jonathan
+    Paisley
+  * Added the ability for append_child to move, copy existing nodes (from the same
+    or any other document)
+    Added constants:
+      XML::Smart::DOM::Element::MOVE (default for same document)
+      XML::Smart::DOM::Element::COPY (default for different document)
+  * API BROKEN!!!!:    
+    XML::Smart::Dom::Element#add        (renamed from append_child)
+    XML::Smart::Dom::Element#add_before (renamed from insert_sibling_before)
+    XML::Smart::Dom::Element#add_after  (renamed from insert_sibling_after)
+    XML::Smart::Dom::Element#replace_by (NEW)
+    -> add has now the ability to use other nodes (from same or other DOM's)
+       as input
+    -> #add_before, #add_after are now working, same parameters as with #add
+      are possible
+    -> examples/add_children.rb, examples/add_elements.rb  
+  * #add, #add_before and #add_after are able to ::COPY/::MOVE the results of
+    xpath searches (only the elements)
+    -> example/move_children.rb
+  * XML::Smart::Dom#root= is possible (simple replace_by, for root only)
+  * TODO: Documentation is not available at all yet, copy over the pieces from
+    Emmanuel
+  * Changed XML::Smart::Dom::AttributeSet#has_key? to 
+            XML::Smart::Dom::AttributeSet#has_attr?
+  * Changed XML::Smart::Dom::AttributeSet#get to 
+            XML::Smart::Dom::AttributeSet#get_attr
+  * Added XML::Smart::Dom::AttributeSet#add
+  * Added XML::Smart#new (same as #string), inspired by Ruediger Sonderfeld
+      
+0.1.7 "Horseman break things" Features + Breaking the API
+  * added support for numbers, booleans and strings as return value from an
+    xpath
+  * extconf.rb cleanup
+  * examples/count.rb
+  * WARNING: XML::Simple::DOM::NodeSet#clear renamed to #delete_all!  
+    This can break your application, but the name clear was no good idea at
+    all because it behaves very different from Array#clear
+  * WARNING: removed #inspect from rbxs_dom.c, rbxs_pull.c - so #inspect 
+    behaves no longer like #to_s, at least as long as I can find
+    something more useful
+  * WARNING: remoded XML::Simple::DOM::AttributeSet#delete. This may break
+    your program
+  * Added:
+      XML::Simple::DOM::NodeSet#delete_if!
+      XML::Simple::DOM::NodeSet#delete_at!
+      XML::Simple::DOM::NodeSet#nitems
+    When deleting elements, the entries in the NodeSet will be set to nil.
+    #nitems works according to Array#nitems.Nodesets have now Enumerable
+    mixed in.
+  * Added:  
+      XML::Simple::DOM::AttributeSet#each (node.attributes.each { |n| })
+    Nodesets have now Enumerable mixed in.
+  * Renamed XML::Simple::Dom::Node to XML::Simple::Dom::Element and added:
+      XML::Simple::DOM::Element#path   (uniquely identify the node)
+      XML::Simple::DOM::Element#empty? (no children)
+      XML::Simple::DOM::Element#mixed? (element and text nodes as children)
+  * Added:
+      XML::Simple::DOM::Attribute#path    (uniquely identify the node) 
+      XML::Simple::DOM::Attribute#element (associated element)
+  * Added XML::Simple::DOM::Text, so you have to check the #class. It has:
+      XML::Simple::DOM::Text#to_s
+      XML::Simple::DOM::Text#to_i
+      XML::Simple::DOM::Text#to_f
+      XML::Simple::DOM::Text#text
+      XML::Simple::DOM::Text#text=
+      XML::Simple::DOM::Text#parent
+      XML::Simple::DOM::Text#path
+  * Added XML::Simple::DOM#find so that doc.find("*") selects the root not,
+    doc.root.find("*") select all elements beneath root. This is standard
+    behaviour. 
+  * Examples: Cleanup and cool new stuff.
+      LOOK at examples/Visualise
+  * Rename to XML::Smart    
+      
+0.1.6 "Investigating the not so obvious" 
+  * added examples/replace.rb
+  * added rb_gc_start() when a new document is parsed,
+    example/replace.rb freezes after 600 parses, if this is not done.
+    I can only assume, that there is an internal limit in libxml. ruby starts
+    gc'ing when about 7 MB of memory are allocated.
+    Investigiating this further is maybe necessary, cause I don't understand
+    the effect fully.
+  * added XML::Simple::DOM::Attribute#to_i    
+  * changed behaviour of XML::Simple::file, the string that is used for 
+    creating te document is no longer the name of the root element, but free
+    form
+    OLD: XML::Simple.file("test.xml",test) resulting in 
+      <?xml version="1.0"?><test/>
+    NEW: XML::Simple.file("test.xml","<test/>") resulting in
+      <?xml version="1.0"?><test/>
+    Drawback: you can initialize documents that are not wellformed, but i
+    think the new way is much more convenient
+  * changed examples/create.rb
+  * added XML::Simple::DOM::Node#to_f
+  * added XML::Simple::DOM::Node#children?
+  * added XML::Simple::DOM::Attribute#to_f
+  * added XML::Simple::DOM::Attribute#has_key?
+  * removed XML::Simple::DOM::Attribute#at
+  * changed XML::Simple::DOM::Node#inspect - behaves like expected now
+  * added XML::Simple::DOM::Node#dump - output a Nodes XML representation
+  * all #to_i behave like expected (with base as optional parameter)
+
+0.1.5 "All work and no play ..." Features
+  * XML::Simple::Dom::Node#parent
+  * XML::Simple::Dom::Node#to_i
+  * XML::Simple::Dom#save_as
+  * XML::Simple#string
+  * improved locking
+  * started testing in semi-production environment
+  * cleanup and reorganisation
+  * examples/string.rb
+
+0.1.4 "Pull Perfection" Bugfixes + Features
+  * #append_child and the other functions now need only 1 paramter (thanks to
+    Emmanuel Touzery)
+  * domattributeset.* and pullattributeset.* to keep things logical
+  * pullattribute as specialized returntype when accessing attributes via pull
+  * small changes to nodes.c and attributes.c to remove a bug (to enthusiastic
+    xmlFree)
+  * additional cleanup and renaming
+  * added Christian Neukirchen to AUTHORS
+
+0.1.3 "Teamwork" - Bugfixes + Features
+  * Merged patch that adds XML::Simple::Node#name, contributed by 
+    <emmanuel dot touzery at wanadoo dot fr>
+  * Restructuring of the code, rbxs_base.* was renamed to rbxs_do.*, the
+    skeletons for the constructors and the module initialisation moved to
+    rbxs.c, to improve the design    
+  Together with Christian Neukirchen: <chneukirchen at gmail dot com>
+  * Added XML::Simple::QName, XML::Simple::Node#name, returns a QName object,
+    that has #name, #prefix, and #namespace.
+  * Added the first implementation of a pull parser, by borrowing ideas and
+    code from chris' ruby/dl implementation. XML::Simple.pull(File)
+  * Added examples/pull.rb for first demonstration
+  
+0.1.2 "Session with Klaus" - Bugfixes + Features
+  * rbxs_nodeset.c - each now works as expected
+  * rbxs_base.c - changed open to (name,root[,encoding]), which creates a
+                  file named name unless File.exists?
+  * examples/create.rb - added
+                  
+0.1.1 "The morning after" - Bugfixes
+  * Fixed memleaks in attributeset.c
+  * Added examples/xpath_attrs.rb
+  * Changed example names and added comments
+
+0.1.0 "First Strike"
+  * Basic Features

data/README

@@ -0,0 +1,52 @@
+== XML::Smart - A Ruby class for fast and simple XML access
+
+Copyright (C) 2004-2007 Jürgen Mangler <juergen.mangler@univie.ac.at>
+
+Ruby/XML/Smart is freely distributable according to the terms of the
+GNU Lesser General Public License (see the file 'COPYING').
+
+This program is distributed without any warranty. See the file
+'COPYING' for details.
+
+== Installation
+
+* You need a least ruby 1.8.6
+* You need a least rake 0.5.0
+* a libxml version known to work is 1.6.28
+
+The installation process is very simple:
+
+* rake
+* [become root]
+* rake install
+
+== Documentation
+
+View the examples in the ./examples subdirectory. In the ./examples/Visualise subdirectory
+you can find a simple XPath visualiser. Never try to mix this module with the old libxml
+binding, or you will get nasty segfaults.
+
+=== SYNOPSIS TO CHANGE A FILE ON THE DISK
+
+  require 'xml/smart'
+
+  XML::Smart.modify(File.dirname($0) + "/EXAMPLE.xml") { |doc|
+    node = doc.find("/test/names").first
+    node.add("test_node",{"attr" => 12}, "Muahaha")
+    node.add("test_node", "Muahaha", {"attr" => 13})
+    node.add("test_node", {"attr" => 14})
+    node.add("test_node", "Muahaha")
+    node.add("test_node")
+  }  
+
+=== SYNOPSIS TO QUERY A FILE
+
+  require 'xml/smart'
+
+  doc = XML::Smart.open(File.dirname($0) + "/EXAMPLE.xml")
+
+  node = doc.find("/test/names").first
+  node.add("test_node",{"attr" => 12}, "Muahaha")
+  node.add("test_node", "Muahaha", {"attr" => 13})
+  node.add("test_node", {"attr" => 14})
+  node.add("test_node", "Muahaha")

data/Rakefile

@@ -0,0 +1,112 @@
+require 'rubygems'
+require 'rake/clean'
+require 'rake/rdoctask'
+require 'rake/testtask'
+require 'rake/gempackagetask'
+require 'rdoc/rdoc'
+
+PKG_FILE    = 'ruby-xml-smart'
+PKG_FILES   = Dir.glob("_darcs/current/**/*").collect{ |i| i.gsub(/_darcs\/current\//,"") }
+PKG_VERSION = File.read('rbxs.h').to_s.match(/RBXS_VERSION\s+"([^"]+)"/)[1]
+PKG_CURRENT = PKG_FILE + "-" + PKG_VERSION
+
+task :default => [:config, :compile]
+
+desc "Configuring library"
+task :config do
+  unless File.exists?('extconf.h')
+    ruby 'extconf.rb'
+  end  
+end  
+
+desc "Compiling library"
+task :compile => :config do
+  system "make"
+end
+
+desc "Installing library"
+task :install => [:compile,:doc] do
+  print "ROOT "
+  system "su -c 'make install'"
+end
+
+desc "Clean directory"
+task :clean do
+  if File.exists?("_darcs")
+    Dir.glob("**/*").collect{ |i| i unless i=~/^_darcs/ || i=~/^rdoc/ || i=~/^extconf/ || i=~/^Makefile/ }.compact.each { |i|
+      unless PKG_FILES.include?(i)
+        rm_r i if File.exists?(i) 
+      end
+    }
+  else
+    system "make clean"
+  end  
+end  
+task :distclean do
+  if File.exists?("_darcs")
+    Dir.glob("**/*").collect{ |i| i unless i=~/_darcs/ }.compact.each { |i|
+      unless PKG_FILES.include?(i)
+        rm_r i if File.exists?(i) 
+      end
+    }
+  else
+    system "make distclean"
+  end   
+end
+
+spec = Gem::Specification.new do |s| 
+  s.name = PKG_FILE
+  s.version = PKG_VERSION
+  s.author = "Jürgen Mangler"
+  s.email = "juergen.mangler@univie.ac.at"
+  s.homepage = "http://raa.ruby-lang.org/project/ruby-xml-smart/"
+  s.platform = Gem::Platform::CURRENT
+  s.summary = 'easy to use and stable libxml2 binding'
+  s.files = PKG_FILES
+  s.test_files = FileList["{test}/*_test.rb"].to_a
+  s.require_path = '.'
+  s.has_rdoc = true
+  s.extensions = 'extconf.rb'
+  s.autorequire = 'smart'
+  s.rdoc_options  << '--charset=utf8' << '--line-numbers' << '--inline'
+  s.extra_rdoc_files = ["README"]
+  s.required_ruby_version = '>= 1.8.6'
+end
+ 
+Rake::GemPackageTask.new(spec) do |pkg| 
+  pkg.need_tar = true 
+end
+
+desc "Generating RDoc documentation"
+Rake::RDocTask.new(:doc) do |rdoc|
+  rdoc.options << '--charset=utf8' << '--line-numbers' << '--inline'
+  rdoc.main = 'README'
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.rdoc_files.include 'README'
+  rdoc.rdoc_files.include 'rbxs.c'
+  rdoc.rdoc_files.include 'rbxs_dom.c'
+  rdoc.rdoc_files.include 'rbxs_qname.c'
+  rdoc.rdoc_files.include 'rbxs_domelement.c'
+  rdoc.rdoc_files.include 'rbxs_domnodeset.c'
+  rdoc.rdoc_files.include 'rbxs_domattribute.c'
+  rdoc.rdoc_files.include 'rbxs_domattributeset.c'
+  rdoc.rdoc_files.include 'rbxs_domnamespace.c'
+  rdoc.rdoc_files.include 'rbxs_domnamespaceset.c'
+  rdoc.rdoc_files.include 'rbxs_domtext.c'
+  rdoc.rdoc_files.include 'rbxs_domother.c'
+  rdoc.rdoc_files.include 'rbxs_pull.c'
+  rdoc.rdoc_files.include 'rbxs_pullattributeset.c'
+  rdoc.rdoc_files.include 'rbxs_pullattribute.c'
+end
+
+desc "Creating package"
+task :darcs_package do
+  system "export DARCS_REPO=#{Dir.pwd}; " +
+         "darcs dist -d #{PKG_CURRENT}"
+end
+
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.pattern = "test/*_test.rb"
+  t.verbose = true
+end

data/TODO

@@ -0,0 +1,6 @@
+Todo + Ideas:
+
+* add apply_style to dom (apply xslts) - keep in touch with Ken Wronkiewicz <wh at wirewd dot com> 
+  who is interessted in this (I don't like the API's from Gregoire Lejeune but they are usable)
+* create detailed documention, not only examples
+* create unit test

data/examples/EXAMPLE.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<test xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">
+  <names>
+    <name team="0" a="3">Renate</name>
+    <name team="1">J�rgen</name>
+    <name team="1">Michel</name>
+    <name team="1">Raphi</name>
+    <name team="2">Kathrin <b>Fiedler</b></name>
+    <name team="2">Egon</name>
+  </names>  
+  <colors>
+    <blue  taint="true">Yeah</blue>
+    <red   taint="true"></red>
+    <green taint="true"/>
+  </colors>  
+  <soap:hallo/>
+</test>

data/examples/EXAMPLE.xml.sic

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<test xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">
+  <names>
+    <name team="0">Renate</name>
+    <name team="1">J�rgen</name>
+    <name team="1">Michel</name>
+    <name team="1">Raphi</name>
+    <name team="2">Kathrin <b>Fiedler</b></name>
+    <name team="2">Egon</name>
+  </names>  
+  <colors>
+    <blue  taint="true">Yeah</blue>
+    <red   taint="true"></red>
+    <green taint="true"/>
+  </colors>  
+  <soap:hallo/>
+</test>

data/examples/Visualise/EXAMPLE.xml

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<test xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" attr1="a" attr2="b">
+  <names>
+    <name team="0">Sun Apr 03 14:53:20 CEST 2005</name>
+    <name team="1">J�rgen</name>
+    <name team="1">Michel</name>
+    <name team="1">Raphi</name>
+    <name team="2">Kathrin <b>Fiedler</b> MBA</name>
+    <name team="5">egon</name>
+  </names>
+  <colors>
+    <blue taint="true">Yeah</blue>
+    <red taint="true"/>
+    <green taint="true"/>
+  </colors>
+  <hallo>Hallo1</hallo>
+  <soap:hallo>Hallo2</soap:hallo>
+</test>

data/examples/Visualise/term-ansicolor-0.0.4/CHANGES

@@ -0,0 +1,11 @@
+2004-09-28 * 0.0.4 * First release on Rubyforge
+                   * Supports Rubygems now
+2003-10-09 * 0.0.3 * Added uncolored method as suggested by
+                     Thomas Husterer <Thomas.Husterer@heidelberg.com>
+                   * Added attribute methods with string arguments
+                   * Deleted now unused files
+
+2002-07-27 * 0.0.2 * Minor Code Cleanup
+                   * Added cdiff.rb
+
+2002-06-12 * 0.0.1 * Initial Release