xml-motor 0.1.1 → 0.1.2

data/.gitignore

@@ -0,0 +1,2 @@
+.bundle
+pkg

data/lib/xml-motor.rb

@@ -1,221 +1,11 @@
 #!/usr/bin/env ruby
-
-module XMLStdout
-  def self._err(mesag); puts "ERROR:: #{mesag}"; end
-  def self._nfo(mesag); puts "INFORMATION:: #{mesag}"; end
-end
-
-module XMLUtils
-  def self.dbqot_string(attrib_val)
-    return nil if attrib_val.nil?
-    matched_data = attrib_val.strip.match(/^'(.*)'$/)
-    return attrib_val if matched_data.nil?
-    matched_data = matched_data[0].gsub("\"","'")
-    matched_data[0] = matched_data[-1] = "\""
-    matched_data
-  end
-end
-
-module XMLIndexHandler
-  def self.get_tag_indexes(xml_motor, tag)
-   xml_idx_to_find = []
-   begin
-    xml_motor.xmltags[tag.split(".")[0]].each_value {|val|  xml_idx_to_find.push val }
-    xml_idx_to_find = xml_idx_to_find.flatten
-
-    tag.split(".")[1..-1].each do |tag_i|
-      outer_idx = xml_idx_to_find
-      x_curr = []
-      xml_motor.xmltags[tag_i].each_value {|val|  x_curr.push val }
-      x_curr = x_curr.flatten
-
-      xml_idx_to_find = expand_node_indexes outer_idx, x_curr
-    end
-   rescue
-    XMLStdout._err "Finding index for tag:#{tag}.\nLook if it's actually present in the provided XML."
-   end
-   xml_idx_to_find
-  end
-
-  def self.expand_node_indexes(outer_idx, x_curr)
-    osize = outer_idx.size/2 -1
-    xsize = x_curr.size/2 -1
-    expanded_node_indexes = []
-    0.upto osize do |o|
-      o1 = outer_idx[o*2]
-      o2 = outer_idx[o*2 +1]
-      0.upto xsize do |x|
-        x1 = x_curr[x*2]
-        x2 = x_curr[x*2 +1]
-        unless o1>x1 or o2<x2
-          expanded_node_indexes.push x1
-          expanded_node_indexes.push x2
-        end
-      end
-    end
-    expanded_node_indexes.flatten
-  end
-end
-
-module XMLChopper
-  def self.get_tag_attrib_value(tag_value)
-    tag_value_split = tag_value.split(/>/)
-    in_tag = tag_value_split.first
-    out_tag = tag_value_split[1..-1].join
-    in_tag_split = in_tag.split
-    tag_name = in_tag_split.first
-    attribzone = in_tag_split[1..-1].flatten.join(' ')
-    attrs = get_attribute_hash attribzone
-    [[tag_name.downcase, attrs],out_tag]
-  end
-
-  def self.get_attribute_hash(attribzone)
-    attribzone = attribzone.strip unless attribzone.nil?
-    return nil if attribzone.nil? or attribzone==""
-    attrs = {}
-    broken_attrib = attribzone.split(/=/)
-    attribs = broken_attrib.first.strip
-    values = nil
-    broken_attrib[1..-2].each do |attrib_part|
-      value_n_attrib = attrib_part.split
-      values = value_n_attrib[0..-2].join(' ')
-      attrs[attribs] = XMLUtils.dbqot_string values
-      attribs = value_n_attrib[-1].strip
-    end
-    values = broken_attrib.last.strip
-    attrs[attribs] = XMLUtils.dbqot_string values
-    attrs
-  end
-end
-
-module XMLJoiner
-  def self.dejavu_attributes(attrib_hash)
-    return nil if attrib_hash.nil?
-    attributes = ""
-    attrib_hash.each_key do |hash_key|
-      attributes += " " + hash_key + "=" + attrib_hash[hash_key]
-    end
-    attributes
-  end
-
-  def self.dejavu_node(node_block)
-    return nil if node_block.nil?
-    ["<#{node_block.first}#{dejavu_attributes(node_block.last)}>", "</#{node_block.first}>"]
-  end
-end
-
-module XMLMotorEngine
-  def self._splitter_(xmldata)
-    @xmlnodes = [xmldata.split(/</)[0]]
-    xmldata.split(/</)[1..-1].each do |x1|
-      @xmlnodes.push  XMLChopper.get_tag_attrib_value(x1)
-    end
-    @xmlnodes
-  end
-
-  def self._indexify_(_nodes=nil)
-    xmlnodes _nodes unless _nodes.nil?
-    @xmltags = {}
-    idx = 1
-    depth = 0
-    @xmlnodes[1..-1].each do |xnode|
-      tag_name = xnode[0][0].strip.downcase
-      unless tag_name.match(/^\/.*/) then
-        @xmltags[tag_name] ||= {}
-        @xmltags[tag_name][depth] ||= []
-        @xmltags[tag_name][depth].push idx
-        depth += 1
-      else
-        depth -= 1
-        @xmltags[tag_name[1..-1]][depth] ||= []
-        @xmltags[tag_name[1..-1]][depth].push idx
-      end
-      idx +=1
-    end
-    @xmltags
-  end
-
-  def self._get_attrib_key_val_ (attrib)
-    attrib_key = attrib.split(/=/)[0].strip
-    attrib_val = attrib.split(/=/)[1..-1].join.strip
-    [attrib_key, XMLUtils.dbqot_string(attrib_val)]
-  end
-
-  def self._grab_my_node_ (index_to_find, attrib_to_find=nil, with_tag=false)
-    unless attrib_to_find.nil? or attrib_to_find.empty?
-      attrib_keyval = [attrib_to_find].flatten.collect{|keyval| _get_attrib_key_val_ keyval }
-    end
-    nodes = []
-    node_count = index_to_find.size/2 -1
-    0.upto node_count do |ncount|
-      node_start = index_to_find[ncount*2]
-      node_stop = index_to_find[ncount*2 +1]
-      unless attrib_to_find.nil? or attrib_to_find.empty?
-	next if @xmlnodes[node_start][0][1].nil?
-        next if attrib_keyval.collect{|keyval| @xmlnodes[node_start][0][1][keyval.first] == keyval.last}.include? false
-      end
-      nodes[ncount] ||= ""
-      nodes[ncount] += @xmlnodes[node_start][1] unless @xmlnodes[node_start][1].nil?
-      (node_start+1).upto (node_stop-1) do |node_idx|
-        any_attrib ||= ""
-        any_attrib = XMLJoiner.dejavu_attributes(@xmlnodes[node_idx][0][1]).to_s unless @xmlnodes[node_idx][0][1].nil?
-        nodes[ncount] += "<" + @xmlnodes[node_idx][0][0] + any_attrib + ">"
-        nodes[ncount] += @xmlnodes[node_idx][1] unless @xmlnodes[node_idx][1].nil?
-      end
-      if with_tag
-        tagifyd = XMLJoiner.dejavu_node @xmlnodes[node_start][0]
-        nodes[ncount] = tagifyd.first + nodes[ncount] + tagifyd.last
-      end
-    end
-    nodes.delete(nil) unless attrib_to_find.nil?
-    nodes
-  end
-
-  def self.xml_extracter(tag_to_find=nil, attrib_to_find=nil, with_tag=false)
-    index_to_find = []
-    if attrib_to_find.nil? and tag_to_find.nil?
-      return nil
-    elsif tag_to_find.nil? 
-      index_to_find = @xmltags.collect {|xtag| xtag[1].collect {|val| val[1] }}.flatten
-    else
-      index_to_find = XMLIndexHandler.get_tag_indexes self, tag_to_find.downcase
-    end
-    _grab_my_node_ index_to_find, attrib_to_find, with_tag
-  end  
-
-  def self.xml_miner(xmldata, tag_to_find=nil, attrib_to_find=nil, with_tag=false)
-    return nil if xmldata.nil?
-    _splitter_ xmldata
-    _indexify_
-    xml_extracter tag_to_find, attrib_to_find, with_tag
-  end 
-
-  def self.xmlnodes(xml_nodes=nil)
-    @xmlnodes = xml_nodes || @xmlnodes
-  end
-
-  def self.xmltags(xml_tags=nil)
-    @xmltags = xml_tags || @xmltags
-  end
-
-  def self.pre_processed_content(_nodes, _tags=nil, tag_to_find=nil, attrib_to_find=nil, with_tag=false)
-    begin
-      xmlnodes _nodes
-      unless _tags.nil?
-        xmltags _tags
-      else
-        _indexify_ 
-      end
-      return xml_extracter tag_to_find, attrib_to_find, with_tag
-    rescue
-      XMLStdout._err "Parsing processed XML Nodes."
-    end
-    return nil 
-  end
+#
+# XMLMotor_EXECUTIONER ;)
+xml_motor_libs = File.join(File.dirname(File.expand_path __FILE__), 'xml-motor', '*.rb')
+Dir.glob(xml_motor_libs).each do |lib|
+  require lib
 end
 
-##
-# XMLMotor_EXECUTIONER ;)
 
 module XMLMotor
   def self.get_node_from_file(file, my_tag=nil, my_attrib=nil, with_tag=false)
@@ -246,4 +36,3 @@ module XMLMotor
     XMLMotorEngine.pre_processed_content nodes, tags, tag_to_find, attrib_to_find, with_tag
   end
 end
-

data/lib/xml-motor/version.rb

@@ -1,5 +1,3 @@
-module Xml
-  module Motor
-    VERSION = "0.1.1"
-  end
+module XmlMotor
+  VERSION = "0.1.2"
 end

data/lib/xml-motor/xml-chopper.rb

@@ -0,0 +1,30 @@
+module XMLChopper
+  def self.get_tag_attrib_value(tag_value)
+    tag_value_split = tag_value.split(/>/)
+    in_tag = tag_value_split.first
+    out_tag = tag_value_split[1..-1].join
+    in_tag_split = in_tag.split
+    tag_name = in_tag_split.first
+    attribzone = in_tag_split[1..-1].flatten.join(' ')
+    attrs = get_attribute_hash attribzone
+    [[tag_name.downcase, attrs],out_tag]
+  end
+
+  def self.get_attribute_hash(attribzone)
+    attribzone = attribzone.strip unless attribzone.nil?
+    return nil if attribzone.nil? or attribzone==""
+    attrs = {}
+    broken_attrib = attribzone.split(/=/)
+    attribs = broken_attrib.first.strip
+    values = nil
+    broken_attrib[1..-2].each do |attrib_part|
+      value_n_attrib = attrib_part.split
+      values = value_n_attrib[0..-2].join(' ')
+      attrs[attribs] = XMLUtils.dbqot_string values
+      attribs = value_n_attrib[-1].strip
+    end
+    values = broken_attrib.last.strip
+    attrs[attribs] = XMLUtils.dbqot_string values
+    attrs
+  end
+end

data/lib/xml-motor/xml-index-handler.rb

@@ -0,0 +1,40 @@
+module XMLIndexHandler
+  def self.get_tag_indexes(xml_motor, tag)
+   xml_idx_to_find = []
+   begin
+    xml_motor.xmltags[tag.split(".")[0]].each_value {|val|  xml_idx_to_find.push val }
+    xml_idx_to_find = xml_idx_to_find.flatten
+
+    tag.split(".")[1..-1].each do |tag_i|
+      outer_idx = xml_idx_to_find
+      x_curr = []
+      xml_motor.xmltags[tag_i].each_value {|val|  x_curr.push val }
+      x_curr = x_curr.flatten
+
+      xml_idx_to_find = expand_node_indexes outer_idx, x_curr
+    end
+   rescue
+    XMLStdout._err "Finding index for tag:#{tag}.\nLook if it's actually present in the provided XML."
+   end
+   xml_idx_to_find
+  end
+
+  def self.expand_node_indexes(outer_idx, x_curr)
+    osize = outer_idx.size/2 -1
+    xsize = x_curr.size/2 -1
+    expanded_node_indexes = []
+    0.upto osize do |o|
+      o1 = outer_idx[o*2]
+      o2 = outer_idx[o*2 +1]
+      0.upto xsize do |x|
+        x1 = x_curr[x*2]
+        x2 = x_curr[x*2 +1]
+        unless o1>x1 or o2<x2
+          expanded_node_indexes.push x1
+          expanded_node_indexes.push x2
+        end
+      end
+    end
+    expanded_node_indexes.flatten
+  end
+end

data/lib/xml-motor/xml-joiner.rb

@@ -0,0 +1,15 @@
+module XMLJoiner
+  def self.dejavu_attributes(attrib_hash)
+    return nil if attrib_hash.nil?
+    attributes = ""
+    attrib_hash.each_key do |hash_key|
+      attributes += " " + hash_key + "=" + attrib_hash[hash_key]
+    end
+    attributes
+  end
+
+  def self.dejavu_node(node_block)
+    return nil if node_block.nil?
+    ["<#{node_block.first}#{dejavu_attributes(node_block.last)}>", "</#{node_block.first}>"]
+  end
+end

data/lib/xml-motor/xml-motor-engine.rb

@@ -0,0 +1,114 @@
+module XMLMotorEngine
+  def self._splitter_(xmldata)
+    @xmlnodes = [xmldata.split(/</)[0]]
+    xmldata.split(/</)[1..-1].each do |x1|
+      @xmlnodes.push XMLChopper.get_tag_attrib_value(x1)
+    end
+    @xmlnodes
+  end
+
+  def self._indexify_(_nodes=nil)
+    xmlnodes _nodes unless _nodes.nil?
+    @xmltags = {}
+    idx = 1
+    depth = 0
+    @xmlnodes[1..-1].each do |xnode|
+      tag_name = xnode[0][0].strip.downcase
+      if tag_name.match(/^\/.*/) then
+        depth -= 1
+        @xmltags[tag_name[1..-1]][depth] ||= []
+        @xmltags[tag_name[1..-1]][depth].push idx
+      elsif tag_name.chomp.match(/^\/$/) then
+        @xmltags[tag_name] ||= {}
+        @xmltags[tag_name][depth] ||= []
+        @xmltags[tag_name][depth].push idx
+        @xmltags[tag_name][depth].push idx
+      else
+        @xmltags[tag_name] ||= {}
+        @xmltags[tag_name][depth] ||= []
+        @xmltags[tag_name][depth].push idx
+        depth += 1
+      end
+      idx +=1
+    end
+    @xmltags
+  end
+
+  def self._get_attrib_key_val_ (attrib)
+    attrib_key = attrib.split(/=/)[0].strip
+    attrib_val = attrib.split(/=/)[1..-1].join.strip
+    [attrib_key, XMLUtils.dbqot_string(attrib_val)]
+  end
+
+  def self._grab_my_node_ (index_to_find, attrib_to_find=nil, with_tag=false)
+    unless attrib_to_find.nil? or attrib_to_find.empty?
+      attrib_keyval = [attrib_to_find].flatten.collect{|keyval| _get_attrib_key_val_ keyval }
+    end
+    nodes = []
+    node_count = index_to_find.size/2 -1
+    0.upto node_count do |ncount|
+      node_start = index_to_find[ncount*2]
+      node_stop = index_to_find[ncount*2 +1]
+      unless attrib_to_find.nil? or attrib_to_find.empty?
+	next if @xmlnodes[node_start][0][1].nil?
+        next if attrib_keyval.collect{|keyval| @xmlnodes[node_start][0][1][keyval.first] == keyval.last}.include? false
+      end
+      nodes[ncount] ||= ""
+      nodes[ncount] += @xmlnodes[node_start][1] unless @xmlnodes[node_start][1].nil?
+      (node_start+1).upto (node_stop-1) do |node_idx|
+        any_attrib ||= ""
+        any_attrib = XMLJoiner.dejavu_attributes(@xmlnodes[node_idx][0][1]).to_s unless @xmlnodes[node_idx][0][1].nil?
+        nodes[ncount] += "<" + @xmlnodes[node_idx][0][0] + any_attrib + ">"
+        nodes[ncount] += @xmlnodes[node_idx][1] unless @xmlnodes[node_idx][1].nil?
+      end
+      if with_tag
+        tagifyd = XMLJoiner.dejavu_node @xmlnodes[node_start][0]
+        nodes[ncount] = tagifyd.first + nodes[ncount] + tagifyd.last
+      end
+    end
+    nodes.delete(nil) unless attrib_to_find.nil?
+    nodes
+  end
+
+  def self.xml_extracter(tag_to_find=nil, attrib_to_find=nil, with_tag=false)
+    index_to_find = []
+    if attrib_to_find.nil? and tag_to_find.nil?
+      return nil
+    elsif tag_to_find.nil?
+      index_to_find = @xmltags.collect {|xtag| xtag[1].collect {|val| val[1] }}.flatten
+    else
+      index_to_find = XMLIndexHandler.get_tag_indexes self, tag_to_find.downcase
+    end
+    _grab_my_node_ index_to_find, attrib_to_find, with_tag
+  end
+
+  def self.xml_miner(xmldata, tag_to_find=nil, attrib_to_find=nil, with_tag=false)
+    return nil if xmldata.nil?
+    _splitter_ xmldata
+    _indexify_
+    xml_extracter tag_to_find, attrib_to_find, with_tag
+  end
+
+  def self.xmlnodes(xml_nodes=nil)
+    @xmlnodes = xml_nodes || @xmlnodes
+  end
+
+  def self.xmltags(xml_tags=nil)
+    @xmltags = xml_tags || @xmltags
+  end
+
+  def self.pre_processed_content(_nodes, _tags=nil, tag_to_find=nil, attrib_to_find=nil, with_tag=false)
+    begin
+      xmlnodes _nodes
+      unless _tags.nil?
+        xmltags _tags
+      else
+        _indexify_
+      end
+      return xml_extracter tag_to_find, attrib_to_find, with_tag
+    rescue
+      XMLStdout._err "Parsing processed XML Nodes."
+    end
+    return nil
+  end
+end

data/lib/xml-motor/xml-stdout.rb

@@ -0,0 +1,4 @@
+module XMLStdout
+  def self._err(mesag); puts "ERROR:: #{mesag}"; end
+  def self._nfo(mesag); puts "INFORMATION:: #{mesag}"; end
+end

data/lib/xml-motor/xml-utils.rb

@@ -0,0 +1,10 @@
+module XMLUtils
+  def self.dbqot_string(attrib_val)
+    return nil if attrib_val.nil?
+    matched_data = attrib_val.strip.match(/^'(.*)'$/)
+    return attrib_val if matched_data.nil?
+    matched_data = matched_data[0].gsub("\"","'")
+    matched_data[0] = matched_data[-1] = "\""
+    matched_data
+  end
+end

data/xml-motor.gemspec

@@ -4,39 +4,42 @@ require "xml-motor/version"
 
 Gem::Specification.new do |s|
   s.name        = "xml-motor"
-  s.version     = Xml::Motor::VERSION
+  s.version     = XmlMotor::VERSION
   s.authors     = ["abhishekkr"]
   s.email       = ["abhikumar163@gmail.com"]
   s.homepage    = "http://github.com/abhishekkr/rubygem_xml_motor"
   s.summary     = %q{An easy-to-use XML Parser without any Native Dependencies}
-  s.description = %q{A new short XML Parsing Algorithm implemented directly in >500 lines. An easy-to-use XML Parser without any Native Dependencies.
-      
-       [How To Use]: https://github.com/abhishekkr/rubygem_xml_motor/raw/master/README  
-
-        Loading:
-         + $ gem install xml-motor
-         + 'require' the 'xml-motor'
-
-        Usage:
-           [[ To Search Just One QUERY ]]
-             nodes_array = XMLMotor.get_node_from_file "_XML_FILE_"
-             nodes_array = XMLMotor.get_node_from_file "_XML_FILE_", "ATTRIB_KEY=ATTRIB_VALUE"
-             nodes_array = XMLMotor.get_node_from_content "_XML_DATA_"
-             nodes_array = XMLMotor.get_node_from_content "_XML_DATA_", "ATTRIB_KEY=ATTRIB_VALUE"
-           [[ To Search More Than One QUERIES ]]
-             str = {XML_DATA}
-             nodes_ = XMLMotor.splitter str
-             tags_ = XMLMotor.indexify nodes_
-             nodes_array = XMLMotor.xmldata nodes_, tags_, "_TAG_"
-             nodes_array = XMLMotor.xmldata nodes_, tags_, "_TAG_", "ATTRIB_KEY=ATTRIB_VALUE"
-
-        Example Calls As Code:
-         + XMLMotor.get_node_from_content "<A>a</A><B><A>ba</A></B>", "A"
-             RETURNS: ["a", "ba"]
-         + XMLMotor.get_node_from_content "<A>a</A><B><A>ba</A></B>", "B.A"
-             RETURNS: ["ba"]
-         + XMLMotor.get_node_from_content "<A i='1'>a</A><B><A i='2'>ba</A></B>", "A", "i='1'"
-             RETURNS: ["a"]
+  s.description = %q{=begin
+  == A new short XML Parsing Algorithm implemented directly in >500 lines. An easy-to-use XML Parser without any Native Dependencies.
+
+       = [How To Use]: 
+         * http://justfewtuts.blogspot.in/2012/03/xml-motor-what-it-is-how-why-should-you.html 
+
+       == Loading:
+         * $ gem install xml-motor
+         * 'require' the 'xml-motor'
+
+       =  Usage:
+         ==  [[ To Search Just One QUERY ]]
+           *  nodes_array = XMLMotor.get_node_from_file "_XML_FILE_"
+           *  nodes_array = XMLMotor.get_node_from_file "_XML_FILE_", "ATTRIB_KEY=ATTRIB_VALUE"
+           *  nodes_array = XMLMotor.get_node_from_content "_XML_DATA_"
+           *  nodes_array = XMLMotor.get_node_from_content "_XML_DATA_", "ATTRIB_KEY=ATTRIB_VALUE"
+         ==  [[ To Search More Than One QUERIES ]]
+           *  str = {XML_DATA}
+           *  nodes_ = XMLMotor.splitter str
+           *  tags_ = XMLMotor.indexify nodes_
+           *  nodes_array = XMLMotor.xmldata nodes_, tags_, "_TAG_"
+           *  nodes_array = XMLMotor.xmldata nodes_, tags_, "_TAG_", "ATTRIB_KEY=ATTRIB_VALUE"
+
+       = Example Calls As Code:
+         * XMLMotor.get_node_from_content "<A>a</A><B><A>ba</A></B>", "A"
+            -- RETURNS: ["a", "ba"]
+         * XMLMotor.get_node_from_content "<A>a</A><B><A>ba</A></B>", "B.A"
+            -- RETURNS: ["ba"]
+         * XMLMotor.get_node_from_content "<A i='1'>a</A><B><A i='2'>ba</A></B>", "A", "i='1'"
+            -- RETURNS: ["a"]
+=end
   }
 
   s.rubyforge_project = "xml-motor"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: xml-motor
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,37 +9,45 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-03-05 00:00:00.000000000 Z
+date: 2012-04-12 00:00:00.000000000 Z
 dependencies: []
-description: ! "A new short XML Parsing Algorithm implemented directly in >500 lines.
-  An easy-to-use XML Parser without any Native Dependencies.\n      \n       [How
-  To Use]: https://github.com/abhishekkr/rubygem_xml_motor/raw/master/README  \n\n
-  \       Loading:\n         + $ gem install xml-motor\n         + 'require' the 'xml-motor'\n\n
-  \       Usage:\n           [[ To Search Just One QUERY ]]\n             nodes_array
-  = XMLMotor.get_node_from_file \"_XML_FILE_\"\n             nodes_array = XMLMotor.get_node_from_file
-  \"_XML_FILE_\", \"ATTRIB_KEY=ATTRIB_VALUE\"\n             nodes_array = XMLMotor.get_node_from_content
-  \"_XML_DATA_\"\n             nodes_array = XMLMotor.get_node_from_content \"_XML_DATA_\",
-  \"ATTRIB_KEY=ATTRIB_VALUE\"\n           [[ To Search More Than One QUERIES ]]\n
-  \            str = {XML_DATA}\n             nodes_ = XMLMotor.splitter str\n             tags_
-  = XMLMotor.indexify nodes_\n             nodes_array = XMLMotor.xmldata nodes_,
-  tags_, \"_TAG_\"\n             nodes_array = XMLMotor.xmldata nodes_, tags_, \"_TAG_\",
-  \"ATTRIB_KEY=ATTRIB_VALUE\"\n\n        Example Calls As Code:\n         + XMLMotor.get_node_from_content
-  \"<A>a</A><B><A>ba</A></B>\", \"A\"\n             RETURNS: [\"a\", \"ba\"]\n         +
-  XMLMotor.get_node_from_content \"<A>a</A><B><A>ba</A></B>\", \"B.A\"\n             RETURNS:
-  [\"ba\"]\n         + XMLMotor.get_node_from_content \"<A i='1'>a</A><B><A i='2'>ba</A></B>\",
-  \"A\", \"i='1'\"\n             RETURNS: [\"a\"]\n  "
+description: ! "=begin\n  == A new short XML Parsing Algorithm implemented directly
+  in >500 lines. An easy-to-use XML Parser without any Native Dependencies.\n\n       =
+  [How To Use]: \n         * http://justfewtuts.blogspot.in/2012/03/xml-motor-what-it-is-how-why-should-you.html
+  \n\n       == Loading:\n         * $ gem install xml-motor\n         * 'require'
+  the 'xml-motor'\n\n       =  Usage:\n         ==  [[ To Search Just One QUERY ]]\n
+  \          *  nodes_array = XMLMotor.get_node_from_file \"_XML_FILE_\"\n           *
+  \ nodes_array = XMLMotor.get_node_from_file \"_XML_FILE_\", \"ATTRIB_KEY=ATTRIB_VALUE\"\n
+  \          *  nodes_array = XMLMotor.get_node_from_content \"_XML_DATA_\"\n           *
+  \ nodes_array = XMLMotor.get_node_from_content \"_XML_DATA_\", \"ATTRIB_KEY=ATTRIB_VALUE\"\n
+  \        ==  [[ To Search More Than One QUERIES ]]\n           *  str = {XML_DATA}\n
+  \          *  nodes_ = XMLMotor.splitter str\n           *  tags_ = XMLMotor.indexify
+  nodes_\n           *  nodes_array = XMLMotor.xmldata nodes_, tags_, \"_TAG_\"\n
+  \          *  nodes_array = XMLMotor.xmldata nodes_, tags_, \"_TAG_\", \"ATTRIB_KEY=ATTRIB_VALUE\"\n\n
+  \      = Example Calls As Code:\n         * XMLMotor.get_node_from_content \"<A>a</A><B><A>ba</A></B>\",
+  \"A\"\n            -- RETURNS: [\"a\", \"ba\"]\n         * XMLMotor.get_node_from_content
+  \"<A>a</A><B><A>ba</A></B>\", \"B.A\"\n            -- RETURNS: [\"ba\"]\n         *
+  XMLMotor.get_node_from_content \"<A i='1'>a</A><B><A i='2'>ba</A></B>\", \"A\",
+  \"i='1'\"\n            -- RETURNS: [\"a\"]\n=end\n  "
 email:
 - abhikumar163@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- .gitignore
 - CHANGELOG
 - Gemfile
 - README
 - Rakefile
 - lib/xml-motor.rb
 - lib/xml-motor/version.rb
+- lib/xml-motor/xml-chopper.rb
+- lib/xml-motor/xml-index-handler.rb
+- lib/xml-motor/xml-joiner.rb
+- lib/xml-motor/xml-motor-engine.rb
+- lib/xml-motor/xml-stdout.rb
+- lib/xml-motor/xml-utils.rb
 - make_my_gem.sh
 - xml-motor.gemspec
 homepage: http://github.com/abhishekkr/rubygem_xml_motor