Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

XML to Hash translator

branch: master

This branch is 0 commits ahead and 0 commits behind master

Fetching latest commit…

Cannot retrieve the latest commit at this time

README.md

Nori Build Status

Really simple XML parsing ripped from Crack which ripped it from Merb.
Nori was created to bypass the stale development of Crack, improve its XML parser
and fix certain issues.

Nori.parse("<tag>This is the contents</tag>")
# => { 'tag' => 'This is the contents' }

Nori supports pluggable parsers and ships with both REXML and Nokogiri implementations.
It defaults to REXML, but you can change it to use Nokogiri via:

Nori.parser = :nokogiri

Make sure Nokogiri is in your LOAD_PATH when parsing XML, because Nori tries to load it
when it's needed.

Typecasting

Besides regular typecasting, Nori features somewhat "advanced" typecasting:

  • "true" and "false" String values are converted to TrueClass and FalseClass.
  • String values matching xs:time, xs:date and xs:dateTime are converted to Time, Date and DateTime objects.

You can disable this feature via:

Nori.advanced_typecasting = false

Namespaces

Nori can strip the namespaces from your XML tags. This feature might raise
problems and is therefore disabled by default. Enable it via:

Nori.strip_namespaces = true

XML tags -> Hash keys

Nori lets you specify a custom formula to convert XML tags to Hash keys.
Let me give you an example:

Nori.configure do |config|
  config.convert_tags_to { |tag| tag.snake_case.to_sym }
end

xml = '<userResponse><accountStatus>active</accountStatus></userResponse>'
Nori.parse(xml)  # => { :user_response => { :account_status => "active" }
Something went wrong with that request. Please try again.