onix 0.4.7 → 0.5.0

data/CHANGELOG

@@ -1,3 +1,8 @@
+v0.5 (2nd March 2009)
+- Switch ROXML dependency from a patched version to vanilla
+  - Vanilla ROXML now has all the features we need
+  - This change should be transparent to ONIX gem users
+
 v0.4.7 (9th December 2008)
 - Contributor sub elements should match the order specified in the DTD
 

data/lib/onix.rb

@@ -1,19 +1,63 @@
 require 'rubygems'
+require 'bigdecimal'
+require 'cgi'
 
 # ensure we load the correct gem versions
-gem 'yob-roxml', '2.1.1'
+gem 'roxml', '2.5.1'
 gem 'andand'
 
 # and now load the actual gems
 require 'roxml'
 require 'andand'
 
-# custom xml-mapping node types
-require File.join(File.dirname(__FILE__), "onix", "decimal_type")
-require File.join(File.dirname(__FILE__), "onix", "etext_type")
-require File.join(File.dirname(__FILE__), "onix", "integer_type")
-require File.join(File.dirname(__FILE__), "onix", "two_digit_type")
-require File.join(File.dirname(__FILE__), "onix", "date_type")
+module ONIX
+  module Version #:nodoc:
+    Major = 0
+    Minor = 5
+    Tiny  = 0
+
+    String = [Major, Minor, Tiny].join('.')
+  end
+
+  class Formatters
+    def self.decimal
+      lambda do |val|
+        if val.kind_of?(BigDecimal)
+          val.to_s("F")
+        else
+          val.to_s
+        end
+      end
+    end
+
+    def self.yyyymmdd
+      lambda do |val|
+        if val.nil? || !val.respond_to?(:strftime)
+          nil
+        else
+          val.strftime("%Y%m%d")
+        end
+      end
+    end
+
+    def self.two_digit
+      lambda do |val|
+        if val.nil?
+          nil
+        elsif val < 10
+          "0#{val}"
+        elsif val > 99
+          val.to_s[-2,2]
+        else
+          val.to_s
+        end
+      end
+    end
+  end
+end
+
+# silence some warnings from ROXML
+ROXML::SILENCE_XML_NAME_WARNING = true
 
 # core files
 # - ordering is important, classes need to be defined before any
@@ -48,13 +92,3 @@ require File.join(File.dirname(__FILE__), "onix", "lists", "product_availability
 require File.join(File.dirname(__FILE__), "onix", "simple_product")
 require File.join(File.dirname(__FILE__), "onix", "apa_product")
 
-module ONIX
-  module Version #:nodoc:
-    Major = 0
-    Minor = 4
-    Tiny  = 7
-
-    String = [Major, Minor, Tiny].join('.')
-  end
-
-end

data/lib/onix/addressee_identifier.rb

@@ -2,7 +2,7 @@ module ONIX
   class AddresseeIdentifier
     include ROXML
 
-    xml_accessor :addressee_id_type, :twodigit, :from => "AddresseeIDType"
+    xml_accessor :addressee_id_type, :from => "AddresseeIDType", :as => Fixnum # should be a 2 digit num
     xml_accessor :id_type_name,      :from => "IDTypeName"
     xml_accessor :id_value,          :from => "IDValue"
   end

data/lib/onix/contributor.rb

@@ -2,21 +2,23 @@ module ONIX
   class Contributor
     include ROXML
 
-    xml_accessor :sequence_number,      :from => "SequenceNumber"
+    xml_name "Contributor"
+
+    xml_accessor :sequence_number,      :from => "SequenceNumber", :as => Fixnum
     xml_accessor :contributor_role,     :from => "ContributorRole"
     xml_accessor :language_code,        :from => "LanguageCode"
-    xml_accessor :sequence_number_within_role,  :from => "SequenceNumberWithinRole"
-    xml_accessor :person_name,          :etext, :from => "PersonName"
-    xml_accessor :person_name_inverted, :etext, :from => "PersonNameInverted"
-    xml_accessor :titles_before_name,   :etext, :from => "TitlesBeforeName"
-    xml_accessor :names_before_key,     :etext, :from => "NamesBeforeKey"
-    xml_accessor :prefix_to_key,        :etext, :from => "PrefixToKey"
-    xml_accessor :key_names,            :etext, :from => "KeyNames"
-    xml_accessor :names_after_key,      :etext, :from => "NamesArterKey"
-    xml_accessor :suffix_to_key,        :etext, :from => "SuffixToKey"
-    xml_accessor :letters_after_names,  :etext, :from => "LettersAfterNames"
-    xml_accessor :titles_after_names,   :etext, :from => "TitlesAfterNames"
-    xml_accessor :corporate_name,       :etext, :from => "CorporateName"
-    xml_accessor :biographical_note,    :etext, :from => "BiographicalNote"
+    xml_accessor :sequence_number_within_role,  :from => "SequenceNumberWithinRole", :as => Fixnum
+    xml_accessor :person_name,          :from => "PersonName"
+    xml_accessor :person_name_inverted, :from => "PersonNameInverted"
+    xml_accessor :titles_before_name,   :from => "TitlesBeforeName"
+    xml_accessor :names_before_key,     :from => "NamesBeforeKey"
+    xml_accessor :prefix_to_key,        :from => "PrefixToKey"
+    xml_accessor :key_names,            :from => "KeyNames"
+    xml_accessor :names_after_key,      :from => "NamesArterKey"
+    xml_accessor :suffix_to_key,        :from => "SuffixToKey"
+    xml_accessor :letters_after_names,  :from => "LettersAfterNames"
+    xml_accessor :titles_after_names,   :from => "TitlesAfterNames"
+    xml_accessor :corporate_name,       :from => "CorporateName"
+    xml_accessor :biographical_note,    :from => "BiographicalNote"
   end
 end

data/lib/onix/header.rb

@@ -4,28 +4,34 @@ module ONIX
 
     xml_name "Header"
 
-    xml_accessor :from_ean_number, :etext, :from => "FromEANNumber"
-    xml_accessor :from_san,        :etext, :from => "FromSAN"
-    xml_accessor :sender_identifiers, [ONIX::SenderIdentifier], :from => "SenderIdentifier"
-    xml_accessor :from_company,    :etext, :from => "FromCompany"
-    xml_accessor :from_person,     :etext, :from => "FromPerson"
-    xml_accessor :from_email,      :etext, :from => "FromEmail"
-    xml_accessor :to_ean_number,   :etext, :from => "ToEANNumber"
-    xml_accessor :to_san,          :etext, :from => "ToSAN"
-    xml_accessor :addressee_identifier, [ONIX::AddresseeIdentifier], :from => "AddresseeIdentifier"
-    xml_accessor :to_company,      :etext, :from => "ToCompany"
-    xml_accessor :to_person,       :etext, :from => "ToPerson"
-    xml_accessor :message_number,  :etext, :from => "MessageNumber"
-    xml_accessor :message_repeat,  :integer, :from => "MessageRepeat"
-    xml_accessor :sent_date,       :yyyymmdd, :from => "SentDate"
-    xml_accessor :message_note,    :etext, :from => "MessageNote"
+    xml_accessor :from_ean_number, :from => "FromEANNumber"
+    xml_accessor :from_san,        :from => "FromSAN"
+    xml_accessor :sender_identifiers, :from => "SenderIdentifier", :as => [ONIX::SenderIdentifier]
+    xml_accessor :from_company,    :from => "FromCompany"
+    xml_accessor :from_person,     :from => "FromPerson"
+    xml_accessor :from_email,      :from => "FromEmail"
+    xml_accessor :to_ean_number,   :from => "ToEANNumber"
+    xml_accessor :to_san,          :from => "ToSAN"
+    xml_accessor :addressee_identifiers, :from => "AddresseeIdentifier", :as => [ONIX::AddresseeIdentifier]
+    xml_accessor :to_company,      :from => "ToCompany"
+    xml_accessor :to_person,       :from => "ToPerson"
+    xml_accessor :message_number,  :from => "MessageNumber"
+    xml_accessor :message_repeat,  :from => "MessageRepeat", :as => Fixnum
+    xml_accessor :sent_date,       :from => "SentDate", :as => Date, :to_xml => ONIX::Formatters.yyyymmdd
+    xml_accessor :message_note,    :from => "MessageNote"
 
     # defaults
     xml_accessor  :default_language_of_text, :from => "DefaultLanguageOfText"
-    xml_accessor  :default_price_type_code, :integer, :from => "DefaultPriceTypeCode"
+    xml_accessor  :default_price_type_code, :from => "DefaultPriceTypeCode", :as => Fixnum, :to_xml => ONIX::Formatters.two_digit
     xml_accessor  :default_currency_code,   :from => "DefaultCurrencyCode"
-    xml_reader    :default_linear_unit,     :from => "DefaultLinearUnit"        # deprecated
-    xml_reader    :default_weight_unit,     :from => "DefaultWeightUnit"        # deprecated
+    xml_reader    :default_linear_unit,     :from => "DefaultLinearUnit"        # deprecated in ONIX spec
+    xml_reader    :default_weight_unit,     :from => "DefaultWeightUnit"        # deprecated in ONIX spec
     xml_accessor  :default_class_of_trade,  :from => "DefaultClassOfTrade"
+
+    def initialize
+      self.sender_identifiers = []
+      self.addressee_identifiers = []
+    end
   end
+
 end

data/lib/onix/imprint.rb

@@ -2,9 +2,11 @@ module ONIX
   class Imprint
     include ROXML
 
-    xml_accessor :name_code_type,      :twodigit, :from => "NameCodeType"
-    xml_accessor :name_code_type_name, :etext,    :from => "NameCodeTypeName"
-    xml_accessor :name_code_value,     :etext,    :from => "NameCodeValue"
-    xml_accessor :imprint_name,        :etext,    :from => "ImprintName"
+    xml_name "Imprint"
+
+    xml_accessor :name_code_type,      :from => "NameCodeType", :as => Fixnum, :to_xml => ONIX::Formatters.two_digit
+    xml_accessor :name_code_type_name, :from => "NameCodeTypeName"
+    xml_accessor :name_code_value,     :from => "NameCodeValue"
+    xml_accessor :imprint_name,        :from => "ImprintName"
   end
 end

data/lib/onix/market_representation.rb

@@ -2,13 +2,15 @@ module ONIX
   class MarketRepresentation
     include ROXML
 
-    xml_accessor :agent_name, :etext, :from => "AgentName"
-    xml_accessor :agent_role, :twodigit, :from => "AgentRole"
-    xml_accessor :market_country, :etext, :from => "MarketCountry"
-    xml_accessor :market_territory, :etext, :from => "MarketTerritory"
-    xml_accessor :market_country_excluded, :etext, :from => "MarketCountryExcluded"
-    xml_accessor :market_restriction_detail, :etext, :from => "MarketRestrictionDetail"
-    xml_accessor :market_publishing_status, :twodigit, :from => "MarketPublishingStatus"
+    xml_name "MarketRepresentation"
+
+    xml_accessor :agent_name, :from => "AgentName"
+    xml_accessor :agent_role, :from => "AgentRole", :as => Fixnum, :to_xml => ONIX::Formatters.two_digit
+    xml_accessor :market_country, :from => "MarketCountry"
+    xml_accessor :market_territory, :from => "MarketTerritory"
+    xml_accessor :market_country_excluded, :from => "MarketCountryExcluded"
+    xml_accessor :market_restriction_detail, :from => "MarketRestrictionDetail"
+    xml_accessor :market_publishing_status, :from => "MarketPublishingStatus", :as => Fixnum, :to_xml => ONIX::Formatters.two_digit
   end
 end
 

data/lib/onix/measure.rb

@@ -2,8 +2,10 @@ module ONIX
   class Measure
     include ROXML
 
-    xml_accessor :measure_type_code, :twodigit, :from => "MeasureTypeCode"
-    xml_accessor :measurement,       :decimal,  :from => "Measurement"
-    xml_accessor :measure_unit_code, :etext,    :from => "MeasureUnitCode"
+    xml_name "Measure"
+
+    xml_accessor :measure_type_code, :from => "MeasureTypeCode", :as => Fixnum, :to_xml => ONIX::Formatters.two_digit
+    xml_accessor :measurement,       :from => "Measurement", :as => BigDecimal
+    xml_accessor :measure_unit_code, :from => "MeasureUnitCode"
   end
 end

data/lib/onix/media_file.rb

@@ -2,10 +2,12 @@ module ONIX
   class MediaFile
     include ROXML
 
-    xml_accessor :media_file_type_code, :twodigit, :from => "MediaFileTypeCode"
-    xml_accessor :media_file_format_code, :twodigit, :from => "MediaFileFormatCode"
+    xml_name "MediaFile"
+
+    xml_accessor :media_file_type_code, :from => "MediaFileTypeCode", :as => Fixnum, :to_xml => ONIX::Formatters.two_digit
+    xml_accessor :media_file_format_code, :from => "MediaFileFormatCode", :as => Fixnum, :to_xml => ONIX::Formatters.two_digit
     xml_accessor :image_resolution, :from => "ImageResolution"
-    xml_accessor :media_file_link_type_code, :twodigit, :from => "MediaFileLinkTypeCode"
+    xml_accessor :media_file_link_type_code, :from => "MediaFileLinkTypeCode", :as => Fixnum, :to_xml => ONIX::Formatters.two_digit
     xml_accessor :media_file_link, :from => "MediaFileLink"
   end
 end

data/lib/onix/other_text.rb

@@ -2,11 +2,13 @@ module ONIX
   class OtherText
     include ROXML
 
-    xml_accessor :text_type_code, :twodigit, :from => "TextTypeCode"
-    xml_accessor :text_format,    :etext,    :from => "TextFormat"
-    xml_accessor :text,           :etext,    :from => "Text"
-    xml_accessor :text_link_type, :twodigit, :from => "TextLinkType"
-    xml_accessor :text_link,                 :from => "TextLink"
-    xml_accessor :text_author,    :etext,    :from => "TextAuthor"
+    xml_name "OtherText"
+
+    xml_accessor :text_type_code, :from => "TextTypeCode", :as => Fixnum, :to_xml => ONIX::Formatters.two_digit
+    xml_accessor :text_format,    :from => "TextFormat"
+    xml_accessor :text,           :from => "Text"
+    xml_accessor :text_link_type, :from => "TextLinkType", :as => Fixnum, :to_xml => ONIX::Formatters.two_digit
+    xml_accessor :text_link,      :from => "TextLink"
+    xml_accessor :text_author,    :from => "TextAuthor"
   end
 end

data/lib/onix/price.rb

@@ -2,15 +2,17 @@ module ONIX
   class Price
     include ROXML
 
-    xml_accessor :price_type_code, :twodigit, :from => "PriceTypeCode"
-    xml_accessor :price_type_qualifier, :from => "PriceTypeQualifier"
+    xml_name "Price"
+
+    xml_accessor :price_type_code, :from => "PriceTypeCode", :as => Fixnum, :to_xml => ONIX::Formatters.two_digit
+    xml_accessor :price_type_qualifier, :from => "PriceTypeQualifier", :as => Fixnum, :to_xml => ONIX::Formatters.two_digit
     xml_accessor :price_type_description, :from => "PriceTypeDescription"
-    xml_accessor :price_per, :from => "PricePer"
-    xml_accessor :minimum_order_qty, :from => "MinimumOrderQuantity"
+    xml_accessor :price_per, :from => "PricePer", :as => Fixnum, :to_xml => ONIX::Formatters.two_digit
+    xml_accessor :minimum_order_qty, :from => "MinimumOrderQuantity", :as => Fixnum
     xml_accessor :class_of_trade, :from => "ClassOfTrade"
     xml_accessor :bic_discount_group_code, :from => "BICDiscountGroupCode"
-    xml_accessor :price_status, :from => "PriceStatus"
-    xml_accessor :price_amount, :from => "PriceAmount"
+    xml_accessor :price_status, :from => "PriceStatus", :as => Fixnum, :to_xml => ONIX::Formatters.two_digit
+    xml_accessor :price_amount, :from => "PriceAmount", :as => BigDecimal, :to_xml => ONIX::Formatters.decimal
     xml_accessor :currency_code, :from => "CurrencyCode"
   end
 end

data/lib/onix/product.rb

@@ -5,37 +5,52 @@ module ONIX
     xml_name "Product"
 
     xml_accessor :record_reference, :from => "RecordReference"
-    xml_accessor :notification_type, :twodigit, :from => "NotificationType"
-    xml_accessor :product_identifiers, [ONIX::ProductIdentifier], :from => "ProductIdentifier"
+    xml_accessor :notification_type, :from => "NotificationType", :as => Fixnum, :to_xml => ONIX::Formatters.two_digit
+    xml_accessor :product_identifiers, :from => "ProductIdentifier", :as => [ONIX::ProductIdentifier]
     xml_accessor :product_form, :from => "ProductForm"
     xml_accessor :series, :from => "Series"
-    xml_accessor :edition_number, :integer, :from => "EditionNumber"
-    xml_accessor :titles, [ONIX::Title], :from => "Title"
-    xml_accessor :contributors, [ONIX::Contributor], :from => "Contributor"
-    xml_accessor :websites, [ONIX::Website], :from => "Website"
-    xml_accessor :number_of_pages, :integer, :from => "NumberOfPages"
+    xml_accessor :edition_number, :from => "EditionNumber", :as => Fixnum
+    xml_accessor :titles, :from => "Title", :as => [ONIX::Title]
+    xml_accessor :contributors, :from => "Contributor", :as => [ONIX::Contributor]
+    xml_accessor :websites, :from => "Website", :as => [ONIX::Website]
+    xml_accessor :number_of_pages, :from => "NumberOfPages", :as => Fixnum
     xml_accessor :bic_main_subject, :from => "BICMainSubject"
-    xml_accessor :subjects, [ONIX::Subject], :from => "Subject"
-    xml_accessor :text, [ONIX::OtherText], :from => "OtherText"
-    xml_accessor :media_files, [ONIX::MediaFile], :from => "MediaFile"
-    xml_accessor :imprints, [ONIX::Imprint], :from => "Imprint"
-    xml_accessor :publishers, [ONIX::Publisher], :from => "Publisher"
-    xml_accessor :publishing_status, :twodigit, :from => "PublishingStatus"
-    xml_accessor :publication_date, :yyyymmdd, :from => "PublicationDate"
-    xml_accessor :year_first_published, :integer, :from => "YearFirstPublished"
-    xml_accessor :sales_restrictions, [ONIX::SalesRestriction], :from => "SalesRestriction"
-    xml_accessor :measurements, [ONIX::Measure], :from => "Measure"
-    xml_accessor :supply_details, [ONIX::SupplyDetail], :from => "SupplyDetail"
-    xml_accessor :market_representations, [ONIX::MarketRepresentation], :from => "MarketRepresentation"
+    xml_accessor :subjects, :from => "Subject", :as => [ONIX::Subject]
+    xml_accessor :text, :from => "OtherText", :as => [ONIX::OtherText]
+    xml_accessor :media_files, :from => "MediaFile", :as => [ONIX::MediaFile]
+    xml_accessor :imprints, :from => "Imprint", :as => [ONIX::Imprint]
+    xml_accessor :publishers, :from => "Publisher", :as => [ONIX::Publisher]
+    xml_accessor :publishing_status, :from => "PublishingStatus", :as => Fixnum, :to_xml => ONIX::Formatters.two_digit
+    xml_accessor :publication_date, :from => "PublicationDate", :as => Date, :to_xml => ONIX::Formatters.yyyymmdd
+    xml_accessor :year_first_published, :from => "YearFirstPublished", :as => Fixnum
+    xml_accessor :sales_restrictions, :from => "SalesRestriction", :as => [ONIX::SalesRestriction]
+    xml_accessor :measurements, :from => "Measure", :as => [ONIX::Measure]
+    xml_accessor :supply_details, :from => "SupplyDetail", :as => [ONIX::SupplyDetail]
+    xml_accessor :market_representations, :from => "MarketRepresentation", :as => [ONIX::MarketRepresentation]
 
     # some deprecated attributes. Read only
     # - See the measures array for the current way of specifying
     #   various measurements of the product
-    xml_reader :height,    :decimal, :from => "Height"
-    xml_reader :width,     :decimal, :from => "Width"
-    xml_reader :thickness, :decimal, :from => "Thickness"
-    xml_reader :weight,    :decimal, :from => "Weight"
-    xml_reader :dimensions, :etext,  :from => "Dimensions"
+    xml_reader :height,     :from => "Height", :as => BigDecimal
+    xml_reader :width,      :from => "Width", :as => BigDecimal
+    xml_reader :thickness,  :from => "Thickness", :as => BigDecimal
+    xml_reader :weight,     :from => "Weight", :as => BigDecimal
+    xml_reader :dimensions, :from => "Dimensions"
 
+    def initialize
+      self.product_identifiers = []
+      self.titles = []
+      self.contributors = []
+      self.websites = []
+      self.subjects = []
+      self.text = []
+      self.media_files = []
+      self.imprints = []
+      self.publishers = []
+      self.sales_restrictions = []
+      self.measurements = []
+      self.supply_details = []
+      self.market_representations = []
+    end
   end
 end

data/lib/onix/product_identifier.rb

@@ -2,7 +2,9 @@ module ONIX
   class ProductIdentifier
     include ROXML
 
-    xml_accessor :product_id_type, :twodigit, :from => "ProductIDType"
+    xml_name "ProductIdentifier"
+
+    xml_accessor :product_id_type, :from => "ProductIDType", :as => Fixnum, :to_xml => ONIX::Formatters.two_digit
     xml_accessor :id_value, :from => "IDValue"
   end
 end

data/lib/onix/publisher.rb

@@ -2,10 +2,12 @@ module ONIX
   class Publisher
     include ROXML
 
-    xml_accessor :publishing_role,      :twodigit, :from => "PublishingRole"
-    xml_accessor :name_code_type,       :twodigit, :from => "NameCodeType"
-    xml_accessor :name_code_type_name,  :etext,    :from => "NameCodeTypeName"
-    xml_accessor :name_code_type_value, :etext,    :from => "NameCodeTypeValue"
-    xml_accessor :publisher_name,       :etext,    :from => "PublisherName"
+    xml_name "Publisher"
+
+    xml_accessor :publishing_role,      :from => "PublishingRole", :as => Fixnum, :to_xml => ONIX::Formatters.two_digit
+    xml_accessor :name_code_type,       :from => "NameCodeType", :as => Fixnum, :to_xml => ONIX::Formatters.two_digit
+    xml_accessor :name_code_type_name,  :from => "NameCodeTypeName"
+    xml_accessor :name_code_type_value, :from => "NameCodeTypeValue"
+    xml_accessor :publisher_name,       :from => "PublisherName"
   end
 end

data/lib/onix/reader.rb

@@ -52,7 +52,7 @@ module ONIX
   #
   class Reader
 
-    attr_reader :header, :version, :xml_lang, :xml_version, :encoding
+    attr_reader :header, :version, :xml_lang, :xml_version, :encoding, :queue
 
     # Create a new ONIX::Reader object
     #
@@ -105,24 +105,67 @@ module ONIX
     # user uses the each() method.
     #
     def read_input
-      while @reader.read == 1
+      while @reader.read
         @xml_lang    = @reader.xml_lang         if @xml_lang.nil?
         @xml_version = @reader.xml_version.to_f if @xml_version.nil?
-        @encoding    = @reader.encoding         if @encoding.nil?
-        if @reader.node_type == 10
+        @encoding    = encoding_const_to_name(@reader.encoding) if @encoding.nil?
+        if @reader.node_type == LibXML::XML::Reader::TYPE_DOCUMENT_TYPE
           uri = @reader.expand.to_s
           m, major, minor, rev = *uri.match(/.+(\d)\.(\d)\/(\d*).*/)
           @version = [major.to_i, minor.to_i, rev.to_i]
-        elsif @reader.name == "Header" && @reader.node_type == 1
-          @header = ONIX::Header.parse(@reader.expand.to_s)
+        elsif @reader.name == "Header" && @reader.node_type == LibXML::XML::Reader::TYPE_ELEMENT
+          @header = ONIX::Header.from_xml(@reader.expand.to_s)
           @reader.next_sibling
-        elsif @reader.name == "Product" && @reader.node_type == 1
+        elsif @reader.name == "Product" && @reader.node_type == LibXML::XML::Reader::TYPE_ELEMENT
           node = @reader.expand
-          @queue.push @product_klass.parse(node.to_s)
+          @queue.push @product_klass.from_xml(node.to_s)
           @reader.next_sibling
         end
       end
       @queue.push nil
     end
+
+    def encoding_const_to_name(const)
+      case const
+      when LibXML::XML::Encoding::UTF_8
+        "utf-8"
+      when LibXML::XML::Encoding::UTF_16LE
+        "utf-16le"
+      when LibXML::XML::Encoding::UTF_16BE
+        "utf-16be"
+      when LibXML::XML::Encoding::UCS_4LE
+        "ucs-4le"
+      when LibXML::XML::Encoding::UCS_4BE
+        "ucs-4be"
+      when LibXML::XML::Encoding::UCS_2
+        "ucs-2"
+      when LibXML::XML::Encoding::ISO_8859_1
+        "iso-8859-1"
+      when LibXML::XML::Encoding::ISO_8859_2
+        "iso-8859-2"
+      when LibXML::XML::Encoding::ISO_8859_3
+        "iso-8859-3"
+      when LibXML::XML::Encoding::ISO_8859_4
+        "iso-8859-4"
+      when LibXML::XML::Encoding::ISO_8859_5
+        "iso-8859-5"
+      when LibXML::XML::Encoding::ISO_8859_6
+        "iso-8859-6"
+      when LibXML::XML::Encoding::ISO_8859_7
+        "iso-8859-7"
+      when LibXML::XML::Encoding::ISO_8859_8
+        "iso-8859-8"
+      when LibXML::XML::Encoding::ISO_8859_9
+        "iso-8859-9"
+      when LibXML::XML::Encoding::ISO_2022_JP
+        "iso-2022-jp"
+      when LibXML::XML::Encoding::SHIF_JIS
+        "shift-jis"
+      when LibXML::XML::Encoding::EUC_JP
+        "euc-jp"
+      when LibXML::XML::Encoding::ASCII
+        "ascii"
+      end
+    end
   end
 end