openpgp 0.0.1

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2009 Arto Bendiken <http://ar.to/>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to
+deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+IN THE SOFTWARE.

data/README

@@ -0,0 +1,92 @@
+= OpenPGP.rb
+
+This is a pure-Ruby implementation of the OpenPGP Message Format (RFC 4880).
+
+
+=== About OpenPGP
+
+OpenPGP is the most widely-used e-mail encryption standard in the world. It
+is defined by the OpenPGP Working Group of the Internet Engineering Task
+Force (IETF) Proposed Standard RFC 4880. The OpenPGP standard was originally
+derived from PGP (Pretty Good Privacy), first created by Phil Zimmermann in
+1991.
+
+* http://tools.ietf.org/html/rfc4880
+* http://www.openpgp.org
+
+
+== Features
+
+* Encodes and decodes ASCII-armored OpenPGP messages.
+* Parses OpenPGP messages into their constituent packets.
+  * Supports both old-format (PGP 2.6.x) and new-format (RFC 4880) packets.
+* Includes a GnuPG wrapper for features that are not natively supported.
+
+
+== Examples
+
+  require 'openpgp'
+
+
+=== Decoding an ASCII-armored message
+
+  require 'open-uri'
+  text = open('http://ar.to/pgp.txt').read
+
+  msg = OpenPGP::Message.parse(OpenPGP.dearmor(text))
+
+
+=== Generating a new keypair
+
+  gpg = OpenPGP::GnuPG.new(:homedir => '~/.gnupg')
+  key_id = gpg.gen_key({
+    :key_type      => 'DSA',
+    :key_length    => 1024,
+    :subkey_type   => 'ELG-E',
+    :subkey_length => 1024,
+    :name          => 'J. Random Hacker',
+    :comment       => nil,
+    :email         => 'jhacker@example.org',
+    :passphrase    => 'secret passphrase',
+  })
+
+
+== Documentation
+
+* http://openpgp.rubyforge.org
+
+
+== Download
+
+To get a local working copy of the development repository, do:
+
+  % git clone git://github.com/bendiken/openpgp.git
+
+Alternatively, you can download the latest development version as a tarball
+as follows:
+
+  % wget http://github.com/bendiken/openpgp/tarball/master
+
+
+== Installation
+
+The recommended installation method is via RubyGems. To install the latest
+official release from RubyForge, do:
+
+  % [sudo] gem install openpgp
+
+To use the very latest bleeding-edge development version, install the gem
+directly from GitHub as follows:
+
+  % [sudo] gem install bendiken-openpgp -s http://gems.github.com
+
+
+== Authors
+
+* Arto Bendiken (mailto:arto.bendiken@gmail.com) - http://ar.to
+
+
+== License
+
+All source code is available under the terms of the MIT license. For more
+information, see the accompanying LICENSE file.

data/Rakefile

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+$:.unshift(File.expand_path(File.join(File.dirname(__FILE__), 'lib')))
+require 'rubygems'
+require 'rakefile' # http://github.com/bendiken/rakefile
+require 'openpgp'

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/bin/openpgp

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby -rubygems
+$:.unshift(File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib')))
+require 'openpgp'

data/lib/openpgp.rb

@@ -0,0 +1,6 @@
+require 'openpgp/version'
+require 'openpgp/armor'
+require 'openpgp/message'
+require 'openpgp/packet'
+require 'openpgp/algorithm'
+require 'openpgp/gnupg'

data/lib/openpgp/algorithm.rb

@@ -0,0 +1,57 @@
+module OpenPGP
+  module Algorithm
+    ##
+    # OpenPGP public-key algorithms.
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-9.1
+    module Asymmetric
+      RSA         = 1
+      RSA_E       = 2
+      RSA_S       = 3
+      ELG_E       = 16
+      DSA         = 17
+    end
+
+    ##
+    # OpenPGP symmetric-key algorithms.
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-9.2
+    module Symmetric
+      NONE        = 0
+      IDEA        = 1
+      TRIPLEDES   = 2
+      CAST5       = 3
+      BLOWFISH    = 4
+      AES         = 7
+      AES128      = 7
+      AES192      = 8
+      AES256      = 9
+      TWOFISH     = 10
+    end
+
+    ##
+    # OpenPGP compression algorithms.
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-9.3
+    module Compression
+      NONE        = 0
+      ZIP         = 1
+      ZLIB        = 2
+      BZIP2       = 3
+    end
+
+    ##
+    # OpenPGP hash algorithms.
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-9.4
+    module Hash
+      MD5         = 1
+      SHA1        = 2
+      RIPEMD160   = 3
+      SHA256      = 8
+      SHA384      = 9
+      SHA512      = 10
+      SHA224      = 11
+    end
+  end
+end

data/lib/openpgp/armor.rb

@@ -0,0 +1,114 @@
+module OpenPGP
+  ##
+  # Alias for OpenPGP::Armor.encode().
+  def self.enarmor(data, marker = 'MESSAGE', headers = {})
+    Armor.encode(data, marker, headers)
+  end
+
+  ##
+  # Alias for OpenPGP::Armor.decode().
+  def self.dearmor(text, marker = nil)
+    Armor.decode(text, marker)
+  end
+
+  ##
+  # OpenPGP ASCII Armor utilities.
+  #
+  # @see http://tools.ietf.org/html/rfc4880#section-6.2
+  module Armor
+    ##
+    # @see http://tools.ietf.org/html/rfc4880#section-6.2
+    module Markers
+      MESSAGE           = 'MESSAGE'
+      PUBLIC_KEY_BLOCK  = 'PUBLIC KEY BLOCK'
+      PRIVATE_KEY_BLOCK = 'PRIVATE KEY BLOCK'
+      SIGNATURE         = 'SIGNATURE'
+    end
+
+    ##
+    # @see http://tools.ietf.org/html/rfc4880#section-6.2
+    def self.header(marker)
+      "-----BEGIN PGP #{marker.to_s.upcase}-----"
+    end
+
+    ##
+    # @see http://tools.ietf.org/html/rfc4880#section-6.2
+    def self.footer(marker)
+      "-----END PGP #{marker.to_s.upcase}-----"
+    end
+
+    ##
+    # @see http://tools.ietf.org/html/rfc4880#section-6
+    # @see http://tools.ietf.org/html/rfc4880#section-6.2
+    # @see http://tools.ietf.org/html/rfc2045
+    def self.encode(data, marker = 'MESSAGE', headers = {})
+      require 'stringio'
+      require 'base64'
+
+      text = StringIO.new
+      text << self.header(marker)     << "\n"
+      headers.each { |key, value| text << "#{key}: #{value}\n" }
+      text << "\n" << Base64.encode64(data)
+      text << "="  << Base64.encode64([self.crc24(data)].pack('N')[1, 3])
+      text << self.footer(marker)     << "\n"
+      text.string
+    end
+
+    ##
+    # @see http://tools.ietf.org/html/rfc4880#section-6
+    # @see http://tools.ietf.org/html/rfc2045
+    def self.decode(text, marker = nil)
+      require 'stringio'
+      require 'base64'
+
+      data, crc, state = StringIO.new, nil, :begin
+      text.each_line do |line|
+        line.chomp!
+        case state
+          when :begin
+            case line
+              when /^-----BEGIN PGP ([^-]+)-----$/
+                state = :head if marker.nil? || marker.to_s.upcase == $1
+            end
+          when :head
+            state = :body if line =~ /^\s*$/
+          when :body
+            case line
+              when /^=(....)$/
+                crc = ("\0" << Base64.decode64($1)).unpack('N').first
+                state = :end
+              when /^-----END PGP ([^-]+)-----$/
+                state = :end
+              else
+                data << Base64.decode64(line)
+            end
+          when :end
+            break
+        end
+      end
+      data.string
+    end
+
+    ##
+    # @see http://tools.ietf.org/html/rfc4880#section-6.1
+    CRC24_INIT = 0x00b704ce
+    CRC24_POLY = 0x01864cfb
+
+    ##
+    # @see http://tools.ietf.org/html/rfc4880#section-6
+    # @see http://tools.ietf.org/html/rfc4880#section-6.1
+    def self.crc24(data)
+      crc = CRC24_INIT
+      data.each_byte do |octet|
+        crc ^= octet << 16
+        8.times do
+          crc <<= 1
+          crc ^= CRC24_POLY if (crc & 0x01000000).nonzero?
+        end
+      end
+      crc &= 0x00ffffff
+    end
+  end
+
+  include Armor::Markers
+end

data/lib/openpgp/gnupg.rb

@@ -0,0 +1,169 @@
+module OpenPGP
+  ##
+  # GNU Privacy Guard (GnuPG) wrapper.
+  #
+  # @see http://www.gnupg.org/
+  class GnuPG
+    class Error < IOError; end
+
+    OPTIONS = {
+      :batch                 => true,
+      :quiet                 => true,
+      :no_verbose            => true,
+      :no_tty                => true,
+      :no_permission_warning => true,
+      :no_random_seed_file   => true,
+    }
+
+    attr_accessor :where
+    attr_accessor :options
+
+    def initialize(options = {})
+      @where   = '/usr/bin/env gpg' # FIXME
+      @options = OPTIONS.merge!(options)
+    end
+
+    ##
+    # Determines if GnuPG is available.
+    def available?
+      !!version
+    end
+
+    ##
+    # Returns the GnuPG version number.
+    def version
+      exec(:version).readline =~ /^gpg \(GnuPG\) (.*)$/ ? $1 : nil
+    end
+
+    ##
+    # Generates a new OpenPGP keypair and stores it GnuPG's keyring.
+    def gen_key(info = {})
+      stdin, stdout, stderr = exec3(:gen_key) do |stdin, stdout, stderr|
+        stdin.puts "Key-Type: #{info[:key_type]}"           if info[:key_type]
+        stdin.puts "Key-Length: #{info[:key_length]}"       if info[:key_length]
+        stdin.puts "Subkey-Type: #{info[:subkey_type]}"     if info[:subkey_type]
+        stdin.puts "Subkey-Length: #{info[:subkey_length]}" if info[:subkey_length]
+        stdin.puts "Name-Real: #{info[:name]}"              if info[:name]
+        stdin.puts "Name-Comment: #{info[:comment]}"        if info[:comment]
+        stdin.puts "Name-Email: #{info[:email]}"            if info[:email]
+        stdin.puts "Expire-Date: #{info[:expire_date]}"     if info[:expire_date]
+        stdin.puts "Passphrase: #{info[:passphrase]}"       if info[:passphrase]
+        stdin.puts "%commit"
+      end
+      stderr.each_line do |line|
+        if (line = line.chomp) =~ /^gpg: key ([0-9A-F]+) marked as ultimately trusted/
+          return $1.to_i(16) # the key ID
+        end
+      end
+      return nil
+    end
+
+    ##
+    # Exports a specified key from the GnuPG keyring.
+    def export(key_id = nil)
+      OpenPGP::Message.parse(exec([:export, *[key_id].flatten]).read)
+    end
+
+    ##
+    # Imports a specified keyfile into the GnuPG keyring.
+    def import()
+      # TODO
+    end
+
+    ##
+    # Returns an array of key IDs/titles of the keys in the public keyring.
+    def list_keys()
+      # TODO
+    end
+
+    ##
+    # Encrypts the given plaintext to the specified recipients.
+    def encrypt(plaintext, options = {})
+      # TODO
+    end
+
+    ##
+    # Decrypts the given ciphertext using the specified key ID.
+    def decrypt(ciphertext, options = {})
+      # TODO
+    end
+
+    ##
+    # Makes an OpenPGP signature.
+    def sign()
+      # TODO
+    end
+
+    ##
+    # Makes a clear text OpenPGP signature.
+    def clearsign()
+      # TODO
+    end
+
+    ##
+    # Makes a detached OpenPGP signature.
+    def detach_sign()
+      # TODO
+    end
+
+    ##
+    # Verifies an OpenPGP signature.
+    def verify()
+      # TODO
+    end
+
+    ##
+    # Executes a GnuPG command, yielding the standard input and returning
+    # the standard output.
+    def exec(command, options = {}, &block) #:yields: stdin
+      exec4(command, options) do |pid, stdin, stdout, stderr|
+        block.call(stdin) if block_given?
+        stdin.close_write
+        pid, status = Process.waitpid2(pid)
+        raise Error, stderr.read.chomp if status.exitstatus.nonzero?
+        stdout
+      end
+    end
+
+    ##
+    # Executes a GnuPG command, yielding and returning the standard input,
+    # output and error.
+    def exec3(command, options = {}, &block) #:yields: stdin, stdout, stderr
+      exec4(command, options) do |pid, stdin, stdout, stderr|
+        block.call(stdin, stdout, stderr) if block_given?
+        stdin.close_write
+        pid, status = Process.waitpid2(pid)
+        raise Error, stderr.read.chomp if status.exitstatus.nonzero?
+        [stdin, stdout, stderr]
+      end
+    end
+
+    ##
+    # Executes a GnuPG command, yielding the process identifier as well as
+    # the standard input, output and error.
+    def exec4(command, options = {}, &block) #:yields: pid, stdin, stdout, stderr
+      require 'rubygems'
+      require 'open4'
+      block.call(*Open4.popen4(cmdline(command, options)))
+    end
+
+    protected
+
+      ##
+      # Constructs the GnuPG command-line for use with +exec+.
+      def cmdline(command, options = {})
+        command = [command].flatten
+        cmdline = [where]
+        cmdline += @options.merge(options).map { |k, v| !v ? nil : "#{option(k)} #{v == true ? '' : v.to_s}".rstrip }.compact
+        cmdline << option(command.shift)
+        cmdline += command
+        cmdline.flatten.join(' ').strip
+      end
+
+      ##
+      # Translates Ruby symbols into GnuPG option arguments.
+      def option(option)
+        "--" << option.to_s.gsub('_', '-')
+      end
+  end
+end

data/lib/openpgp/message.rb

@@ -0,0 +1,55 @@
+module OpenPGP
+  ##
+  # OpenPGP message.
+  #
+  # @see http://tools.ietf.org/html/rfc4880#section-4.1
+  # @see http://tools.ietf.org/html/rfc4880#section-11
+  # @see http://tools.ietf.org/html/rfc4880#section-11.3
+  class Message
+    attr_accessor :packets
+
+    ##
+    # Parses an OpenPGP message.
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-4.1
+    # @see http://tools.ietf.org/html/rfc4880#section-4.2
+    def self.parse(data)
+      require 'stringio'
+      data = StringIO.new(data.to_str) if data.respond_to?(:to_str)
+
+      msg = self.new
+      until data.eof?
+        if packet = OpenPGP::Packet.parse(data)
+          msg << packet
+        else
+          raise "Invalid OpenPGP message data at position #{data.pos}"
+        end
+      end
+      msg
+    end
+
+    def initialize(packets = [])
+      @packets = packets
+    end
+
+    def each(&block) # :yields: packet
+      packets.each(&block)
+    end
+
+    def to_a
+      packets.to_a
+    end
+
+    def <<(packet)
+      packets << packet
+    end
+
+    def empty?
+      packets.empty?
+    end
+
+    def size
+      inject(0) { |sum, packet| sum + packet.size }
+    end
+  end
+end

data/lib/openpgp/packet.rb

@@ -0,0 +1,294 @@
+module OpenPGP
+  ##
+  # OpenPGP packet.
+  #
+  # @see http://tools.ietf.org/html/rfc4880#section-4.1
+  # @see http://tools.ietf.org/html/rfc4880#section-4.3
+  class Packet
+    attr_accessor :tag
+    attr_accessor :size
+    attr_accessor :data
+
+    ##
+    # Parses an OpenPGP packet.
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-4.2
+    def self.parse(data)
+      require 'stringio'
+      data = StringIO.new(data.to_str) if data.respond_to?(:to_str)
+
+      unless data.eof?
+        new = ((tag = data.getc) & 64).nonzero? # bit 6 indicates new packet format if set
+        data.ungetc(tag)
+        send(new ? :parse_new_format : :parse_old_format, data)
+      end
+    end
+
+    ##
+    # Parses a new-format (RFC 4880) OpenPGP packet.
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-4.2.2
+    def self.parse_new_format(data)
+      tag = data.getc & 63
+      len = data.getc
+
+      case len
+        when 0..191   # 4.2.2.1. One-Octet Lengths
+          data_length = len
+        when 192..223 # 4.2.2.2. Two-Octet Lengths
+          data_length = ((len - 192) << 8) + data.getc + 192
+        when 224..254 # 4.2.2.4. Partial Body Lengths
+          data_length = 1 << (len & 0x1f)
+        when 255      # 4.2.2.3. Five-Octet Lengths
+          data_length = (data.getc << 24) | (data.getc << 16) | (data.getc << 8) | data.getc
+      end
+
+      Packet.for(tag).new(tag, data.read(data_length))
+    end
+
+    ##
+    # Parses an old-format (PGP 2.6.x) OpenPGP packet.
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-4.2.1
+    def self.parse_old_format(data)
+      len = (tag = data.getc) & 3
+      tag = (tag >> 2) & 15
+
+      case len
+        when 0 # The packet has a one-octet length. The header is 2 octets long.
+          data_length = data.getc
+        when 1 # The packet has a two-octet length. The header is 3 octets long.
+          data_length = data.read(2).unpack('n').first
+        when 2 # The packet has a four-octet length. The header is 5 octets long.
+          data_length = data.read(4).unpack('N').first
+        when 3 # The packet is of indeterminate length. The header is 1 octet long.
+          data_length = false # read to EOF
+        else
+          raise "Invalid OpenPGP packet length-type: expected 0..3 but got #{len}"
+      end
+
+      Packet.for(tag).new(tag, data_length ? data.read(data_length) : data.read)
+    end
+
+    def self.for(tag)
+      @@tags[tag.to_i] || self
+    end
+
+    def initialize(tag = nil, data = nil)
+      @tag, @data, @size = tag, data, data ? data.size : 0
+    end
+
+    ##
+    # OpenPGP Public-Key Encrypted Session Key packet (tag 1).
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-5.1
+    class AsymmetricSessionKey < Packet
+      # TODO
+    end
+
+    ##
+    # OpenPGP Signature packet (tag 2).
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-5.2
+    class Signature < Packet
+      # TODO
+    end
+
+    ##
+    # OpenPGP Symmetric-Key Encrypted Session Key packet (tag 3).
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-5.3
+    class SymmetricSessionKey < Packet
+      # TODO
+    end
+
+    ##
+    # OpenPGP One-Pass Signature packet (tag 4).
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-5.4
+    class OnePassSignature < Packet
+      # TODO
+    end
+
+    ##
+    # OpenPGP Public-Key packet (tag 6).
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-5.5.1.1
+    # @see http://tools.ietf.org/html/rfc4880#section-5.5.2
+    # @see http://tools.ietf.org/html/rfc4880#section-11.1
+    # @see http://tools.ietf.org/html/rfc4880#section-12
+    class PublicKey < Packet
+      # TODO
+    end
+
+    ##
+    # OpenPGP Public-Subkey packet (tag 14).
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-5.5.1.2
+    # @see http://tools.ietf.org/html/rfc4880#section-5.5.2
+    # @see http://tools.ietf.org/html/rfc4880#section-11.1
+    # @see http://tools.ietf.org/html/rfc4880#section-12
+    class PublicSubkey < PublicKey
+      # TODO
+    end
+
+    ##
+    # OpenPGP Secret-Key packet (tag 5).
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-5.5.1.3
+    # @see http://tools.ietf.org/html/rfc4880#section-5.5.3
+    # @see http://tools.ietf.org/html/rfc4880#section-11.2
+    # @see http://tools.ietf.org/html/rfc4880#section-12
+    class SecretKey < PublicKey
+      # TODO
+    end
+
+    ##
+    # OpenPGP Secret-Subkey packet (tag 7).
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-5.5.1.4
+    # @see http://tools.ietf.org/html/rfc4880#section-5.5.3
+    # @see http://tools.ietf.org/html/rfc4880#section-11.2
+    # @see http://tools.ietf.org/html/rfc4880#section-12
+    class SecretSubkey < SecretKey
+      # TODO
+    end
+
+    ##
+    # OpenPGP Compressed Data packet (tag 8).
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-5.6
+    class CompressedData < Packet
+      # TODO
+    end
+
+    ##
+    # OpenPGP Symmetrically Encrypted Data packet (tag 9).
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-5.7
+    class EncryptedData < Packet
+      # TODO
+    end
+
+    ##
+    # OpenPGP Marker packet (tag 10).
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-5.8
+    class Marker < Packet
+      # TODO
+    end
+
+    ##
+    # OpenPGP Literal Data packet (tag 11).
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-5.9
+    class LiteralData < Packet
+      # TODO
+    end
+
+    ##
+    # OpenPGP Trust packet (tag 12).
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-5.10
+    class Trust < Packet
+      # TODO
+    end
+
+    ##
+    # OpenPGP User ID packet (tag 13).
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-5.11
+    # @see http://tools.ietf.org/html/rfc2822
+    class UserID < Packet
+      attr_accessor :name, :comment, :email
+
+      def initialize(tag = nil, data = nil)
+        super
+        case data
+          # User IDs of the form: "name (comment) <email>"
+          when /^([^\(]+)\(([^\)]+)\)\s+<([^>]+)>$/
+            @name, @comment, @email = $1, $2, $3
+          # User IDs of the form: "name <email>"
+          when /^([^<]+)\s+<([^>]+)>$/
+            @name, @comment, @email = $1, nil, $2
+          # User IDs of the form: "name"
+          when /^([^<]+)$/
+            @name, @comment, @email = $1, nil, nil
+          # User IDs of the form: "<email>"
+          when /^<([^>]+)>$/
+            @name, @comment, @email = nil, nil, $2
+          else
+            @name, @comment, @email = nil
+        end
+      end
+
+      def to_s
+        text = []
+        text << name if name
+        text << "(#{comment})" if comment
+        text << "<#{email}>" if email
+        text.join(' ')
+      end
+    end
+
+    ##
+    # OpenPGP User Attribute packet (tag 17).
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-5.12
+    # @see http://tools.ietf.org/html/rfc4880#section-11.1
+    class UserAttribute < Packet
+      attr_accessor :packets
+
+      # TODO
+    end
+
+    ##
+    # OpenPGP Sym. Encrypted Integrity Protected Data packet (tag 18).
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-5.13
+    class IntegrityProtectedData < Packet
+      # TODO
+    end
+
+    ##
+    # OpenPGP Modification Detection Code packet (tag 19).
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-5.14
+    class ModificationDetectionCode < Packet
+      # TODO
+    end
+
+    ##
+    # OpenPGP Private or Experimental packet (tags 60..63).
+    #
+    # @see http://tools.ietf.org/html/rfc4880#section-4.3
+    class Experimental < Packet; end
+
+    protected
+      ##
+      # @see http://tools.ietf.org/html/rfc4880#section-4.3
+      @@tags = {
+         1 => AsymmetricSessionKey,      # Public-Key Encrypted Session Key
+         2 => Signature,                 # Signature Packet
+         3 => SymmetricSessionKey,       # Symmetric-Key Encrypted Session Key Packet
+         4 => OnePassSignature,          # One-Pass Signature Packet
+         5 => SecretKey,                 # Secret-Key Packet
+         6 => PublicKey,                 # Public-Key Packet
+         7 => SecretSubkey,              # Secret-Subkey Packet
+         8 => CompressedData,            # Compressed Data Packet
+         9 => EncryptedData,             # Symmetrically Encrypted Data Packet
+        10 => Marker,                    # Marker Packet
+        11 => LiteralData,               # Literal Data Packet
+        12 => Trust,                     # Trust Packet
+        13 => UserID,                    # User ID Packet
+        14 => PublicSubkey,              # Public-Subkey Packet
+        17 => UserAttribute,             # User Attribute Packet
+        18 => IntegrityProtectedData,    # Sym. Encrypted and Integrity Protected Data Packet
+        19 => ModificationDetectionCode, # Modification Detection Code Packet
+        60 => Experimental,              # Private or Experimental Values
+        61 => Experimental,              # Private or Experimental Values
+        62 => Experimental,              # Private or Experimental Values
+        63 => Experimental,              # Private or Experimental Values
+      }
+  end
+end

data/lib/openpgp/version.rb

@@ -0,0 +1,11 @@
+module OpenPGP
+  module Version
+    MAJOR = 0
+    MINOR = 0
+    TINY  = 1
+    EXTRA = nil
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+    STRING << "-#{EXTRA}" if EXTRA
+  end
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification 
+name: openpgp
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Arto Bendiken
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-04-18 00:00:00 +02:00
+default_executable: openpgp
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rakefile
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: "    OpenPGP.rb is a pure-Ruby implementation of the OpenPGP Message Format (RFC 4880).\n"
+email: arto.bendiken@gmail.com
+executables: 
+- openpgp
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- LICENSE
+- README
+- Rakefile
+- VERSION
+- bin/openpgp
+- lib/openpgp.rb
+- lib/openpgp/algorithm.rb
+- lib/openpgp/armor.rb
+- lib/openpgp/gnupg.rb
+- lib/openpgp/message.rb
+- lib/openpgp/packet.rb
+- lib/openpgp/version.rb
+has_rdoc: false
+homepage: http://github.com/bendiken/openpgp
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: 1.8.2
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: 
+- GnuPG >= 1.4.7 (not required, but enables extra functionality)
+rubyforge_project: openpgp
+rubygems_version: 1.3.2
+signing_key: 
+specification_version: 3
+summary: A pure-Ruby implementation of the OpenPGP Message Format (RFC 4880).
+test_files: []
+