2004-02-12 15:22:18 +03:00
|
|
|
#
|
|
|
|
# = base64.rb: methods for base64-encoding and -decoding stings
|
|
|
|
#
|
|
|
|
# Author:: Yukihiro Matsumoto
|
|
|
|
# Documentation:: Dave Thomas and Gavin Sinclair
|
|
|
|
#
|
|
|
|
# Until Ruby 1.8.1, these methods were defined at the top-level. Now
|
|
|
|
# they are in the Base64 module but included in the top-level, where
|
|
|
|
# their usage is deprecated.
|
|
|
|
#
|
|
|
|
# See Base64 for documentation.
|
|
|
|
#
|
|
|
|
|
1999-01-20 07:59:39 +03:00
|
|
|
require "kconv"
|
1998-01-16 15:13:05 +03:00
|
|
|
|
2004-02-12 15:22:18 +03:00
|
|
|
|
|
|
|
# The Base64 module provides for the encoding (#encode64) and decoding
|
|
|
|
# (#decode64) of binary data using a Base64 representation.
|
2004-01-20 08:44:56 +03:00
|
|
|
#
|
2004-02-12 15:22:18 +03:00
|
|
|
# The following particular features are also provided:
|
|
|
|
# - encode into lines of a given length (#b64encode)
|
|
|
|
# - decode the special format specified in RFC2047 for the
|
|
|
|
# representation of email headers (decode_b)
|
2004-01-20 08:44:56 +03:00
|
|
|
#
|
2004-02-12 15:22:18 +03:00
|
|
|
# == Example
|
|
|
|
#
|
|
|
|
# A simple encoding and decoding.
|
|
|
|
#
|
|
|
|
# require "base64"
|
|
|
|
#
|
|
|
|
# enc = Base64.encode64('Send reinforcements')
|
|
|
|
# # -> "U2VuZCByZWluZm9yY2VtZW50cw==\n"
|
|
|
|
# plain = Base64.decode64(enc)
|
|
|
|
# # -> "Send reinforcements"
|
|
|
|
#
|
|
|
|
# The purpose of using base64 to encode data is that it translates any
|
|
|
|
# binary data into purely printable characters. It is specified in
|
|
|
|
# RFC 2045 (http://www.faqs.org/rfcs/rfc2045.html).
|
2004-01-20 08:44:56 +03:00
|
|
|
|
2004-01-21 10:10:41 +03:00
|
|
|
module Base64
|
|
|
|
module_function
|
2004-01-20 08:44:56 +03:00
|
|
|
|
2004-02-12 15:22:18 +03:00
|
|
|
# Returns the Base64-decoded version of +str+.
|
2004-01-21 10:10:41 +03:00
|
|
|
#
|
|
|
|
# require 'base64'
|
|
|
|
# str = 'VGhpcyBpcyBsaW5lIG9uZQpUaGlzIG' +
|
|
|
|
# 'lzIGxpbmUgdHdvClRoaXMgaXMgbGlu' +
|
|
|
|
# 'ZSB0aHJlZQpBbmQgc28gb24uLi4K'
|
2004-02-12 15:22:18 +03:00
|
|
|
# puts Base64.decode64(str)
|
2004-01-21 10:10:41 +03:00
|
|
|
#
|
|
|
|
# <i>Generates:</i>
|
|
|
|
#
|
|
|
|
# This is line one
|
|
|
|
# This is line two
|
|
|
|
# This is line three
|
|
|
|
# And so on...
|
2004-01-20 08:44:56 +03:00
|
|
|
|
2004-01-21 10:10:41 +03:00
|
|
|
def decode64(str)
|
|
|
|
str.unpack("m")[0]
|
|
|
|
end
|
1998-01-16 15:13:05 +03:00
|
|
|
|
2004-01-20 08:44:56 +03:00
|
|
|
|
2004-01-21 10:10:41 +03:00
|
|
|
# Decodes text formatted using a subset of RFC2047 (the one used for
|
2004-02-12 15:22:18 +03:00
|
|
|
# mime-encoding mail headers).
|
|
|
|
#
|
|
|
|
# Only supports an encoding type of 'b' (base 64), and only supports
|
|
|
|
# the character sets ISO-2022-JP and SHIFT_JIS (so the only two
|
|
|
|
# encoded word sequences recognized are <tt>=?ISO-2022-JP?B?...=</tt> and
|
|
|
|
# <tt>=?SHIFT_JIS?B?...=</tt>). Recognition of these sequences is case
|
2004-01-21 10:10:41 +03:00
|
|
|
# insensitive.
|
2004-01-20 08:44:56 +03:00
|
|
|
|
2004-01-21 10:10:41 +03:00
|
|
|
def decode_b(str)
|
|
|
|
str.gsub!(/=\?ISO-2022-JP\?B\?([!->@-~]+)\?=/i) {
|
|
|
|
decode64($1)
|
|
|
|
}
|
|
|
|
str = Kconv::toeuc(str)
|
|
|
|
str.gsub!(/=\?SHIFT_JIS\?B\?([!->@-~]+)\?=/i) {
|
|
|
|
decode64($1)
|
|
|
|
}
|
|
|
|
str = Kconv::toeuc(str)
|
|
|
|
str.gsub!(/\n/, ' ')
|
|
|
|
str.gsub!(/\0/, '')
|
|
|
|
str
|
|
|
|
end
|
1998-01-16 15:13:05 +03:00
|
|
|
|
2004-02-12 15:22:18 +03:00
|
|
|
# Returns the Base64-encoded version of +str+.
|
2004-01-21 10:10:41 +03:00
|
|
|
#
|
2004-02-12 15:22:18 +03:00
|
|
|
# require 'base64'
|
|
|
|
# Base64.b64encode("Now is the time for all good coders\nto learn Ruby")
|
|
|
|
#
|
|
|
|
# <i>Generates:</i>
|
|
|
|
#
|
|
|
|
# Tm93IGlzIHRoZSB0aW1lIGZvciBhbGwgZ29vZCBjb2RlcnMKdG8gbGVhcm4g
|
|
|
|
# UnVieQ==
|
2004-01-20 08:44:56 +03:00
|
|
|
|
2004-01-21 10:10:41 +03:00
|
|
|
def encode64(bin)
|
|
|
|
[bin].pack("m")
|
|
|
|
end
|
1998-01-16 15:13:05 +03:00
|
|
|
|
2004-02-12 15:22:18 +03:00
|
|
|
# _Prints_ the Base64 encoded version of +bin+ (a +String+) in lines of
|
|
|
|
# +len+ (default 60) characters.
|
2004-01-21 10:10:41 +03:00
|
|
|
#
|
|
|
|
# require 'base64'
|
2004-02-12 15:22:18 +03:00
|
|
|
# data = "Now is the time for all good coders\nto learn Ruby"
|
|
|
|
# puts Base64.b64encode(data)
|
2004-01-21 10:10:41 +03:00
|
|
|
#
|
2004-02-12 15:22:18 +03:00
|
|
|
# <i>Generates:</i>
|
2004-01-21 10:10:41 +03:00
|
|
|
#
|
|
|
|
# Tm93IGlzIHRoZSB0aW1lIGZvciBhbGwgZ29vZCBjb2RlcnMKdG8gbGVhcm4g
|
|
|
|
# UnVieQ==
|
2004-01-20 08:44:56 +03:00
|
|
|
|
2004-01-21 10:10:41 +03:00
|
|
|
def b64encode(bin, len = 60)
|
|
|
|
encode64(bin).scan(/.{1,#{len}}/o) do
|
|
|
|
print $&, "\n"
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2004-01-21 18:11:02 +03:00
|
|
|
|
|
|
|
module Deprecated # :nodoc:
|
2004-01-21 10:10:41 +03:00
|
|
|
include Base64
|
|
|
|
|
|
|
|
def _deprecated_base64(*args)
|
|
|
|
m0, m1 = caller(0)
|
|
|
|
m = m0[/\`(.*?)\'\z/, 1]
|
|
|
|
warn("#{m1}: #{m} is deprecated; use Base64.#{m} instead")
|
|
|
|
super
|
|
|
|
end
|
|
|
|
dep = instance_method(:_deprecated_base64)
|
|
|
|
remove_method(:_deprecated_base64)
|
|
|
|
for m in Base64.private_instance_methods(false)
|
|
|
|
define_method(m, dep)
|
|
|
|
end
|
1998-01-16 15:13:05 +03:00
|
|
|
end
|
2004-01-21 10:10:41 +03:00
|
|
|
end
|
|
|
|
|
|
|
|
include Base64::Deprecated
|