# -*- encoding: utf-8 -*- describe :string_encode, shared: true do describe "when passed no options" do it "transcodes to Encoding.default_internal when set" do Encoding.default_internal = Encoding::UTF_8 str = [0xA4, 0xA2].pack('CC').force_encoding Encoding::EUC_JP str.send(@method).should == "あ" end it "transcodes a 7-bit String despite no generic converting being available" do -> do Encoding::Converter.new Encoding::Emacs_Mule, Encoding::BINARY end.should raise_error(Encoding::ConverterNotFoundError) Encoding.default_internal = Encoding::Emacs_Mule str = "\x79".force_encoding Encoding::BINARY str.send(@method).should == "y".force_encoding(Encoding::BINARY) end it "raises an Encoding::ConverterNotFoundError when no conversion is possible" do Encoding.default_internal = Encoding::Emacs_Mule str = [0x80].pack('C').force_encoding Encoding::BINARY -> { str.send(@method) }.should raise_error(Encoding::ConverterNotFoundError) end end describe "when passed to encoding" do it "accepts a String argument" do str = [0xA4, 0xA2].pack('CC').force_encoding Encoding::EUC_JP str.send(@method, "utf-8").should == "あ" end it "calls #to_str to convert the object to an Encoding" do enc = mock("string encode encoding") enc.should_receive(:to_str).and_return("utf-8") str = [0xA4, 0xA2].pack('CC').force_encoding Encoding::EUC_JP str.send(@method, enc).should == "あ" end it "transcodes to the passed encoding" do str = [0xA4, 0xA2].pack('CC').force_encoding Encoding::EUC_JP str.send(@method, Encoding::UTF_8).should == "あ" end it "transcodes Japanese multibyte characters" do str = "あいうえお" str.send(@method, Encoding::ISO_2022_JP).should == "\e\x24\x42\x24\x22\x24\x24\x24\x26\x24\x28\x24\x2A\e\x28\x42".force_encoding(Encoding::ISO_2022_JP) end it "transcodes a 7-bit String despite no generic converting being available" do -> do Encoding::Converter.new Encoding::Emacs_Mule, Encoding::BINARY end.should raise_error(Encoding::ConverterNotFoundError) str = "\x79".force_encoding Encoding::BINARY str.send(@method, Encoding::Emacs_Mule).should == "y".force_encoding(Encoding::BINARY) end it "raises an Encoding::ConverterNotFoundError when no conversion is possible" do str = [0x80].pack('C').force_encoding Encoding::BINARY -> do str.send(@method, Encoding::Emacs_Mule) end.should raise_error(Encoding::ConverterNotFoundError) end it "raises an Encoding::ConverterNotFoundError for an invalid encoding" do -> do "abc".send(@method, "xyz") end.should raise_error(Encoding::ConverterNotFoundError) end end describe "when passed options" do it "does not process transcoding options if not transcoding" do result = "あ\ufffdあ".send(@method, undef: :replace) result.should == "あ\ufffdあ" end it "calls #to_hash to convert the object" do options = mock("string encode options") options.should_receive(:to_hash).and_return({ undef: :replace }) result = "あ\ufffdあ".send(@method, **options) result.should == "あ\ufffdあ" end it "transcodes to Encoding.default_internal when set" do Encoding.default_internal = Encoding::UTF_8 str = [0xA4, 0xA2].pack('CC').force_encoding Encoding::EUC_JP str.send(@method, invalid: :replace).should == "あ" end it "raises an Encoding::ConverterNotFoundError when no conversion is possible despite 'invalid: :replace, undef: :replace'" do Encoding.default_internal = Encoding::Emacs_Mule str = [0x80].pack('C').force_encoding Encoding::BINARY -> do str.send(@method, invalid: :replace, undef: :replace) end.should raise_error(Encoding::ConverterNotFoundError) end it "replaces invalid characters when replacing Emacs-Mule encoded strings" do got = [0x80].pack('C').force_encoding('Emacs-Mule').send(@method, invalid: :replace) got.should == "?".encode('Emacs-Mule') end end describe "when passed to, from" do it "transcodes between the encodings ignoring the String encoding" do str = "あ" result = [0xA6, 0xD0, 0x8F, 0xAB, 0xE4, 0x8F, 0xAB, 0xB1].pack('C8') result.force_encoding Encoding::EUC_JP str.send(@method, "euc-jp", "ibm437").should == result end it "calls #to_str to convert the from object to an Encoding" do enc = mock("string encode encoding") enc.should_receive(:to_str).and_return("ibm437") str = "あ" result = [0xA6, 0xD0, 0x8F, 0xAB, 0xE4, 0x8F, 0xAB, 0xB1].pack('C8') result.force_encoding Encoding::EUC_JP str.send(@method, "euc-jp", enc).should == result end end describe "when passed to, options" do it "replaces undefined characters in the destination encoding" do result = "あ?あ".send(@method, Encoding::EUC_JP, undef: :replace) # testing for: "\xA4\xA2?\xA4\xA2" xA4xA2 = [0xA4, 0xA2].pack('CC') result.should == "#{xA4xA2}?#{xA4xA2}".force_encoding("euc-jp") end it "replaces invalid characters in the destination encoding" do xFF = [0xFF].pack('C').force_encoding('utf-8') "ab#{xFF}c".send(@method, Encoding::ISO_8859_1, invalid: :replace).should == "ab?c" end it "calls #to_hash to convert the options object" do options = mock("string encode options") options.should_receive(:to_hash).and_return({ undef: :replace }) result = "あ?あ".send(@method, Encoding::EUC_JP, **options) xA4xA2 = [0xA4, 0xA2].pack('CC').force_encoding('utf-8') result.should == "#{xA4xA2}?#{xA4xA2}".force_encoding("euc-jp") end end describe "when passed to, from, options" do it "replaces undefined characters in the destination encoding" do str = "あ?あ".force_encoding Encoding::BINARY result = str.send(@method, "euc-jp", "utf-8", undef: :replace) xA4xA2 = [0xA4, 0xA2].pack('CC').force_encoding('utf-8') result.should == "#{xA4xA2}?#{xA4xA2}".force_encoding("euc-jp") end it "replaces invalid characters in the destination encoding" do xFF = [0xFF].pack('C').force_encoding('utf-8') str = "ab#{xFF}c".force_encoding Encoding::BINARY str.send(@method, "iso-8859-1", "utf-8", invalid: :replace).should == "ab?c" end it "calls #to_str to convert the to object to an encoding" do to = mock("string encode to encoding") to.should_receive(:to_str).and_return("iso-8859-1") xFF = [0xFF].pack('C').force_encoding('utf-8') str = "ab#{xFF}c".force_encoding Encoding::BINARY str.send(@method, to, "utf-8", invalid: :replace).should == "ab?c" end it "calls #to_str to convert the from object to an encoding" do from = mock("string encode to encoding") from.should_receive(:to_str).and_return("utf-8") xFF = [0xFF].pack('C').force_encoding('utf-8') str = "ab#{xFF}c".force_encoding Encoding::BINARY str.send(@method, "iso-8859-1", from, invalid: :replace).should == "ab?c" end it "calls #to_hash to convert the options object" do options = mock("string encode options") options.should_receive(:to_hash).and_return({ invalid: :replace }) xFF = [0xFF].pack('C').force_encoding('utf-8') str = "ab#{xFF}c".force_encoding Encoding::BINARY str.send(@method, "iso-8859-1", "utf-8", **options).should == "ab?c" end end describe "given the xml: :text option" do it "replaces all instances of '&' with '&'" do '& and &'.send(@method, "UTF-8", xml: :text).should == '& and &' end it "replaces all instances of '<' with '<'" do '< and <'.send(@method, "UTF-8", xml: :text).should == '< and <' end it "replaces all instances of '>' with '>'" do '> and >'.send(@method, "UTF-8", xml: :text).should == '> and >' end it "does not replace '\"'" do '" and "'.send(@method, "UTF-8", xml: :text).should == '" and "' end it "replaces undefined characters with their upper-case hexadecimal numeric character references" do 'ürst'.send(@method, Encoding::US_ASCII, xml: :text).should == 'ürst' end end describe "given the xml: :attr option" do it "surrounds the encoded text with double-quotes" do 'abc'.send(@method, "UTF-8", xml: :attr).should == '"abc"' end it "replaces all instances of '&' with '&'" do '& and &'.send(@method, "UTF-8", xml: :attr).should == '"& and &"' end it "replaces all instances of '<' with '<'" do '< and <'.send(@method, "UTF-8", xml: :attr).should == '"< and <"' end it "replaces all instances of '>' with '>'" do '> and >'.send(@method, "UTF-8", xml: :attr).should == '"> and >"' end it "replaces all instances of '\"' with '"'" do '" and "'.send(@method, "UTF-8", xml: :attr).should == '"" and ""' end it "replaces undefined characters with their upper-case hexadecimal numeric character references" do 'ürst'.send(@method, Encoding::US_ASCII, xml: :attr).should == '"ürst"' end end it "raises ArgumentError if the value of the :xml option is not :text or :attr" do -> { ''.send(@method, "UTF-8", xml: :other) }.should raise_error(ArgumentError) end end