Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
ASN.1 encoder and decoder for Ruby. (based on a porting of Convert::ASN1 for Perl)
branch: master
Failed to load latest commit information.
debian Initial import.
lib Initial import.
test Initial import.
COPYING Initial import.
ChangeLog Initial import.
README Initial import.
TODO Initial import.
rubyasn1.y Initial import.
setup.rb Initial import.

README

rubyasn1
========

This library will parse ASN.1 notations and create converter object which
encode Ruby data structures using BER (Basic Encoding Rules) and vice versa.

The library is still EXPERIMENTAL and not implemented completely.
APIs may be changed in future version.


Install
=======

On almost all unix-like systems, type the followings for quick install.

 $ su
 # ruby setup.rb

If you want to customize install directories, type the following for help.

 $ ruby setup.rb --help


How to use
==========

Example 1:

  parser = ASN1::Parser.new
  converter = parser.parse(%<
    seq SEQUENCE {
      integer INTEGER,
      bool BOOLEAN,
      str STRING
    }
  >)

  # Encode
  binary = converter.encode( :seq => {
    :integer => 1, :bool => false, :str => 'A string'
  } )
  p binary
  #=> "0\020\002\001\001\001\001\000\004\bA string"

  # Decode
  object = conter.decode(ber_binary)
  p object
  #=> {:seq=>{:integer=>1, :bool=>false, :str=>"A string"}}


Example 2:

  parser = ASN1::Parser.new
  converter = parser.parse(%<
    AddressBook ::= SEQUENCE OF Person

    Person ::= SEQUENCE {
      name STRING,
      age INTEGER,
      email STRING OPTIONAL
    }
  >)

  # Check compilation error
  if converter.nil?
    puts parser.error
    puts parser.backtrace
    abort
  end

  # Select a type
  converter.select('AddressBook')

  # Encode
  binary = converter.encode([
    { :name => 'Bob',  :age => 24 },
    { :name => 'John', :age => 18, :email => 'john@example.com' },
  ])
  p binary
  #=> "0'0\b\004\003Bob\002\001\0300\e\004\004John\002\001\022\004\020john@example.com"

  # Decode
  object = converter.decode(binary)
  p object
  #=> [{:age=>24, :name=>"Bob"}, {:age=>18, :email=>"john@example.com", :name=>"John"}]


Copyright
=========

Copyright(C)2005 MATSUYAMA Kengo <macksx@gmail.com>. All rights reserved.
This module is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.

This module is based on a porting of Convert::ASN1 module for Perl.
Convert::ASN1 is copyrighted by Graham Barr.
For more details, see http://search.cpan.org/~gbarr/Convert-ASN1-0.19/

setup.rb is copyrighted by Minero Aoki.
For more details, see http://raa.ruby-lang.org/project/setup/
Something went wrong with that request. Please try again.