rfc2047 0.1

data/README.md

@@ -0,0 +1,15 @@
+The rfc2047 ruby gem decodes email header fields that have been encoded according the the rules layed forth by [RFC 2047][1].
+
+    Rfc2047.decode("=?ISO-8859-1?B?SWYgeW91IGNhbiByZWFkIHRoaXMgeW8=?= =?ISO-8859-2?B?dSB1bmRlcnN0YW5kIHRoZSBleGFtcGxlLg==?=")
+    # => "If you can read this yo u understand the example."
+
+It is released under the same [terms][2] as Ruby itself.
+
+It was originally written by Sam Roberts in 2003, and the current version was taken from the [Joyent Connector][3], who cite the original [mailing list post][4] as the source. It was packaged as a gem in 2011, and now resides on [Rubygems][5], with the source at [GitHub][6].
+
+[1]: http://www.ietf.org/rfc/rfc2047.txt
+[2]: http://www.ruby-lang.org/en/LICENSE.txt
+[3]: http://dev.joyent.com/projects/connector/browse/trunk/vendor/rfc2047.rb
+[4]: http://blade.nagaokaut.ac.jp/cgi-bin/scat.rb/ruby/ruby-talk/69323
+[5]: https://rubygems.org/gems/rfc2047
+[6]: https://www.github.com/ConradIrwin/rfc2047-ruby/

data/lib/rfc2047.rb

@@ -0,0 +1,54 @@
+# from http://blade.nagaokaut.ac.jp/cgi-bin/scat.rb/ruby/ruby-talk/69323
+# via http://dev.joyent.com/projects/connector/browse/trunk/vendor/rfc2047.rb
+#
+# An implementation of RFC 2047 decoding.
+#
+# This module depends on the iconv library by Nobuyoshi Nakada, which I've 
+# heard may be distributed as a standard part of Ruby 1.8.
+#
+# Copyright (c) Sam Roberts <sroberts / uniserve.com> 2003 (with modifications).
+#
+# This file is distributed under the same terms as Ruby.
+
+require 'iconv'
+
+module Rfc2047
+
+  WORD = /=\?([!#$\%&'*+-\/0-9A-Z\\^\`a-z{|}~]+)\?([BbQq])\?([!->@-~]+)\?=/ # :nodoc:
+
+  # Decodes a string, +from+, containing RFC 2047 encoded words into a target
+  # character set, +target+ defaulting to utf-8. See iconv_open(3) for information on the
+  # supported target encodings. If one of the encoded words cannot be
+  # converted to the target encoding, it is left in its encoded form.
+  def self.decode(from, target='utf-8')
+    from.gsub(WORD) do |word|
+      cs = $1
+      encoding = $2
+      text = $3
+      # B64 or QP decode, as necessary:
+      case encoding.downcase
+      when 'b'
+        text = text.unpack('m*')[0]
+      when 'q'
+        # RFC 2047 has a variant of quoted printable where a ' ' character
+        # can be represented as an '_', rather than =32, so convert
+        # any of these that we find before doing the QP decoding.
+        text = text.tr("_", " ")
+        text = text.unpack('M*')[0]
+      else
+        raise Unparseable, from
+      end
+      # Convert
+      #
+      # Remember: Iconv.open(to, from)
+      begin
+        text = Iconv.open(target, cs) {|i| i.iconv(text)}
+      rescue 
+        raise Unparseable, from
+      end
+    end
+  end
+
+  class Unparseable < RuntimeError; end
+end
+

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification 
+name: rfc2047
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  version: "0.1"
+platform: ruby
+authors: 
+- Sam Roberts
+- Conrad Irwin
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-04-09 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Provides a method Rfc2047.decode that can decode individual headers encoded with this format.
+email: conrad.irwin@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/rfc2047.rb
+- README.md
+has_rdoc: true
+homepage: http://github.com/ConradIrwin/rfc2047-ruby/
+licenses: 
+- Ruby
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Decodes email headers according to RFC2047
+test_files: []
+