multibases 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e2b0dd76dacf9936bc730a2568740868ffd7da45d0d341bfbde1e7884ccfd162
-  data.tar.gz: b494e77003851e5cc216a163d2b75ef443a05609789de4f4070ed3fa2cc3d3cb
+  metadata.gz: b13bedd48880500a221befb94a50e4846437428e1acd7c52639d31fbfc0f6eaa
+  data.tar.gz: ee4a4bc0057c318236f3dd9152582b1bc9f621acd42e88081ba910280146280f
 SHA512:
-  metadata.gz: 2c15a0d0e856d94c6edf60c2e2a83d722c2c67527cd1c07b28bb917cb5e73572e834d3662352c3b0afe895e0109fb11d3848194a66477ca28565dabaa99ef925
-  data.tar.gz: 61b9616e4627224d15d76f04c75e621f16059de0128cd2a4f4a7b49cf62513200ef5c418495526b2cb65eebb1fc271cdb27620156c0ce388fa4a550972be4d38
+  metadata.gz: 889019b38214fe663dced15fd1c01cf4d27cf06778b5f4f27480c0fd75630c8cfaa929b0c6a725d233e675ae1e07190282ba54e72c031e69201ee6d001dc9ff0
+  data.tar.gz: f52ad51235bd80e03ac6fc4c4d191d1c63c6875eb0e6c794aa956f221cc09bbb8ba8375a91b28e0a1bbbd29da83368ed4ccfae36dc9cf80d9e3afa3ced68ed80

data/.gitignore

@@ -1,9 +1,9 @@
-/.bundle/
-/.yardoc
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-Gemfile.lock
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+Gemfile.lock

data/CHANGELOG.md

@@ -1,9 +1,19 @@
 # Changelog
 
+## 0.3.0
+
+- Fix convenience methods `names` and `codes`.
+- Add `encoding` to `ByteArray` in order to not _guess_ the output encoding. The
+  encoding is determined in the encoding engine (when encoding) and has to be
+  supplied when decoding (because the encoding information is thrown away).
+- Force `encoding` argument in `to_s` of `ByteArray`
+- Extract errors to `error.rb`.
+- Extract table strictness to its own method.
+
 ## 0.2.0
 
-- Add convenience methods to registry, like `multicodecs`
-- Change tests to use fixture files and add `rake` task to update these
+- Add convenience methods to registry, like `multicodecs`.
+- Change tests to use fixture files and add `rake` task to update these.
 
 ## 0.1.0
 

data/README.md

@@ -19,6 +19,12 @@ This gem can be used _both_ for encoding into or decoding from multibase packed
 strings, as well as serve as a _general purpose_ library to do `BaseX` encoding
 and decoding _without_ adding the prefix.
 
+> 🙌🏽 This is called `multibases` instead of the singular form, to stay
+> consistent with the `multihashes` gem, which was _forced_ to take a different
+> name has `multihash` was already taken, which is also the case for `multibase`
+> and others. In the future, this might be renamed to `multiformats-base`, with
+> a backwards-compatible interface.
+
 ## Installation
 
 Add this line to your application's Gemfile:

data/bin/setup

@@ -1,8 +1,8 @@
-#!/usr/bin/env bash
-set -euo pipefail
-IFS=$'\n\t'
-set -vx
-
-bundle install
-
-# Do any other automated setup that you need to do here
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/multibases/bare.rb

@@ -1,21 +1,11 @@
 # frozen_string_literal: true
 
 require 'multibases/version'
+require 'multibases/error'
 require 'multibases/registry'
+require 'multibases/byte_array'
 
 module Multibases
-  class Error < StandardError; end
-
-  class NoEngine < Error
-    def initialize(encoding)
-      super(
-        "There is no engine registered to encode or decode #{encoding}.\n" \
-          'Either pass it as an argument, or use Multibases.implement to ' \
-          'register it globally.'
-      )
-    end
-  end
-
   Encoded = Struct.new(:code, :encoding, :length, :data) do
     ##
     # Packs the data and the code into an encoded string
@@ -40,7 +30,7 @@ module Multibases
   end
 
   class Identity
-    def initialize(*_); end
+    def initialize(*_, encoding: nil); end
 
     def encode(data)
       EncodedByteArray.new(data.is_a?(Array) ? data : data.bytes)

data/lib/multibases/base16.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-require_relative './byte_array'
-require_relative './ord_table'
+require 'multibases/byte_array'
+require 'multibases/ord_table'
 
 module Multibases
   class Base16
@@ -14,14 +14,17 @@ module Multibases
 
     # RFC 4648 implementation
     def self.encode(plain)
-      plain = plain.map(&:chr).join if plain.is_a?(Array)
+      plain = plain.pack('C*') if plain.is_a?(Array)
 
       # plain.each_byte.map do |byte| byte.to_s(16) end.join
-      EncodedByteArray.new(plain.unpack1('H*').bytes)
+      EncodedByteArray.new(
+        plain.unpack1('H*').bytes,
+        encoding: Encoding::US_ASCII
+      )
     end
 
     def self.decode(packed)
-      packed = packed.map(&:chr).join if packed.is_a?(Array)
+      packed = packed.pack('C*') if packed.is_a?(Array)
 
       # packed.scan(/../).map { |x| x.hex.chr }.join
       DecodedByteArray.new(Array(String(packed)).pack('H*').bytes)
@@ -48,8 +51,8 @@ module Multibases
       end
     end
 
-    def initialize(alphabet, strict: false)
-      @table = Table.from(alphabet, strict: strict)
+    def initialize(alphabet, strict: false, encoding: nil)
+      @table = Table.from(alphabet, strict: strict, encoding: encoding)
     end
 
     def encode(plain)
@@ -58,7 +61,8 @@ module Multibases
 
       encoded.transcode(
         Default.table_ords(force_strict: @table.strict?),
-        table_ords
+        table_ords,
+        encoding: @table.encoding
       )
     end
 
@@ -66,7 +70,7 @@ module Multibases
       return DecodedByteArray::EMPTY if encoded.empty?
 
       unless encoded.is_a?(Array)
-        encoded = encoded.force_encoding(Encoding::ASCII_8BIT).bytes
+        encoded = encoded.force_encoding(@table.encoding).bytes
       end
 
       unless decodable?(encoded)
@@ -76,7 +80,8 @@ module Multibases
       unless default?
         encoded = ByteArray.new(encoded).transcode(
           table_ords,
-          Default.table_ords(force_strict: @table.strict?)
+          Default.table_ords(force_strict: @table.strict?),
+          encoding: Encoding::US_ASCII
         )
       end
 

data/lib/multibases/base2.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-require_relative './byte_array'
-require_relative './ord_table'
+require 'multibases/byte_array'
+require 'multibases/ord_table'
 
 module Multibases
   class Base2
@@ -10,12 +10,15 @@ module Multibases
     end
 
     def self.encode(plain)
-      plain = plain.map(&:chr).join if plain.is_a?(Array)
-      EncodedByteArray.new(plain.unpack1('B*').bytes)
+      plain = plain.pack('C*') if plain.is_a?(Array)
+      EncodedByteArray.new(
+        plain.unpack1('B*').bytes,
+        encoding: Encoding::US_ASCII
+      )
     end
 
     def self.decode(packed)
-      packed = packed.map(&:chr).join if packed.is_a?(Array)
+      packed = packed.pack('C*') if packed.is_a?(Array)
       # Pack only works on an array with a single bit string
       DecodedByteArray.new(Array(String(packed)).pack('B*').bytes)
     end
@@ -40,8 +43,8 @@ module Multibases
       end
     end
 
-    def initialize(alphabet, strict: false)
-      @table = Table.from(alphabet, strict: strict)
+    def initialize(alphabet, strict: false, encoding: nil)
+      @table = Table.from(alphabet, strict: strict, encoding: encoding)
     end
 
     def encode(plain)
@@ -50,7 +53,8 @@ module Multibases
 
       encoded.transcode(
         Default.table_ords(force_strict: @table.strict?),
-        table_ords
+        table_ords,
+        encoding: @table.encoding
       )
     end
 
@@ -58,7 +62,7 @@ module Multibases
       return DecodedByteArray::EMPTY if encoded.empty?
 
       unless encoded.is_a?(Array)
-        encoded = encoded.force_encoding(Encoding::ASCII_8BIT).bytes
+        encoded = encoded.force_encoding(@table.encoding).bytes
       end
 
       unless decodable?(encoded)
@@ -68,7 +72,8 @@ module Multibases
       unless default?
         encoded = ByteArray.new(encoded).transcode(
           table_ords,
-          Default.table_ords(force_strict: @table.strict?)
+          Default.table_ords(force_strict: @table.strict?),
+          encoding: Encoding::US_ASCII
         )
       end
 

data/lib/multibases/base32.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-require_relative './byte_array'
-require_relative './ord_table'
+require 'multibases/byte_array'
+require 'multibases/ord_table'
 
 module Multibases
   # RFC 3548
@@ -59,7 +59,7 @@ module Multibases
 
         c = bytes.inject(0) do |m, o|
           i = @table.index(o)
-          raise ArgumentError, "Invalid character '#{o.chr}'" if i.nil?
+          raise ArgumentError, "Invalid character '#{[o].pack('C*')}'" if i.nil?
 
           (m << 5) + i
         end >> p
@@ -79,14 +79,17 @@ module Multibases
       end
     end
 
-    def initialize(alphabet, strict: false)
-      @table = Table.from(alphabet, strict: strict)
+    def initialize(alphabet, strict: false, encoding: nil)
+      @table = Table.from(alphabet, strict: strict, encoding: encoding)
     end
 
     def encode(plain)
       return EncodedByteArray::EMPTY if plain.empty?
 
-      EncodedByteArray.new(chunks(plain, 5).collect(&:encode).flatten)
+      EncodedByteArray.new(
+        chunks(plain, 5).collect(&:encode).flatten,
+        encoding: @table.encoding
+      )
     end
 
     def decode(encoded)

data/lib/multibases/base64.rb

@@ -1,5 +1,9 @@
 # frozen_string_literal: true
 
+
+require 'multibases/byte_array'
+require 'multibases/ord_table'
+
 module Multibases
   class Base64
     def inspect
@@ -11,14 +15,17 @@ module Multibases
 
     # RFC 4648 implementation
     def self.encode(plain)
-      plain = plain.map(&:chr).join if plain.is_a?(Array)
+      plain = plain.pack('C*') if plain.is_a?(Array)
 
       # Base64.strict_encode(plain)
-      EncodedByteArray.new(Array(String(plain)).pack('m0').bytes)
+      EncodedByteArray.new(
+        Array(String(plain)).pack('m0').bytes,
+        encoding: Encoding::US_ASCII
+      )
     end
 
     def self.decode(packed)
-      packed = packed.map(&:chr).join if packed.is_a?(Array)
+      packed = packed.pack('C*') if packed.is_a?(Array)
       # Base64.strict_decode64("m").first
       # Don't use m0, as that requires padderding _always_
       DecodedByteArray.new(packed.unpack1('m').bytes)
@@ -48,8 +55,8 @@ module Multibases
       end
     end
 
-    def initialize(alphabet, strict: false)
-      @table = Table.from(alphabet, strict: strict)
+    def initialize(alphabet, strict: false, encoding: nil)
+      @table = Table.from(alphabet, strict: strict, encoding: encoding)
     end
 
     def encode(plain)
@@ -61,7 +68,8 @@ module Multibases
 
       encoded.transcode(
         Default.table_ords(force_strict: @table.strict?),
-        table_ords
+        table_ords,
+        encoding: @table.encoding
       )
     end
 
@@ -69,7 +77,7 @@ module Multibases
       return DecodedByteArray::EMPTY if encoded.empty?
 
       unless encoded.is_a?(Array)
-        encoded = encoded.force_encoding(Encoding::ASCII_8BIT).bytes
+        encoded = encoded.force_encoding(@table.encoding).bytes
       end
 
       unless decodable?(encoded)
@@ -79,7 +87,8 @@ module Multibases
       unless default?
         encoded = ByteArray.new(encoded).transcode(
           table_ords,
-          Default.table_ords(force_strict: @table.strict?)
+          Default.table_ords(force_strict: @table.strict?),
+          encoding: Encoding::US_ASCII
         )
       end
 

data/lib/multibases/base_x.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-require_relative './byte_array'
-require_relative './ord_table'
+require 'multibases/byte_array'
+require 'multibases/ord_table'
 
 module Multibases
   class BaseX
@@ -23,8 +23,8 @@ module Multibases
       end
     end
 
-    def initialize(alphabet, strict: false)
-      @table = Table.from(alphabet, strict: strict)
+    def initialize(alphabet, strict: false, encoding: nil)
+      @table = Table.from(alphabet, strict: strict, encoding: encoding)
     end
 
     ##
@@ -71,7 +71,7 @@ module Multibases
         end
       end
 
-      EncodedByteArray.new(output)
+      EncodedByteArray.new(output, encoding: @table.encoding)
     end
 
     ##
@@ -84,7 +84,7 @@ module Multibases
       return DecodedByteArray::EMPTY if encoded.empty?
 
       unless encoded.is_a?(Array)
-        encoded = encoded.force_encoding(Encoding::ASCII_8BIT).bytes
+        encoded = encoded.force_encoding(@table.encoding).bytes
       end
 
       unless decodable?(encoded)

data/lib/multibases/byte_array.rb

@@ -1,7 +1,16 @@
 # frozen_string_literal: true
 
+require 'multibases/error'
+
 module Multibases
+
   class ByteArray < DelegateClass(Array)
+    def initialize(array, encoding: nil)
+      super array
+
+      @encoding = encoding
+    end
+
     def hash
       __getobj__.hash
     end
@@ -18,11 +27,11 @@ module Multibases
       super || __getobj__.is_a?(klazz)
     end
 
-    def transcode(from, to)
+    def transcode(from, to, encoding: nil)
       from = from.each_with_index.to_h
       to = Hash[to.each_with_index.to_a.collect(&:reverse)]
 
-      self.class.new(map { |byte| to[from[byte]] })
+      self.class.new(map { |byte| to[from[byte]] }, encoding: encoding)
     end
 
     alias to_a to_arr
@@ -31,11 +40,14 @@ module Multibases
 
   class EncodedByteArray < ByteArray
     def inspect
-      "[Multibases::EncodedByteArray \"#{to_str}\"]"
+      encoding = @encoding || Encoding::BINARY
+      "[Multibases::EncodedByteArray \"#{to_str(encoding)}\"]"
     end
 
-    def to_str
-      map(&:chr).join.encode(Encoding::ASCII_8BIT)
+    def to_str(encoding = @encoding)
+      raise MissingEncoding unless encoding
+
+      pack('C*').force_encoding(encoding)
     end
 
     def chomp!(ord)
@@ -54,11 +66,14 @@ module Multibases
 
   class DecodedByteArray < ByteArray
     def inspect
-      "[Multibases::DecodedByteArray \"#{to_str}\"]"
+      encoding = @encoding || Encoding::BINARY
+      "[Multibases::DecodedByteArray \"#{to_str(encoding)}\"]"
     end
 
-    def to_str(encoding = Encoding::UTF_8)
-      map(&:chr).join.force_encoding(encoding)
+    def to_str(encoding = @encoding)
+      raise MissingEncoding unless encoding
+
+      pack('C*').force_encoding(encoding)
     end
 
     def force_encoding(*args)

data/lib/multibases/error.rb

@@ -0,0 +1,42 @@
+module Multibases
+  class Error < StandardError; end
+
+  class NoEngine < Error
+    def initialize(encoding)
+      super(
+        "There is no engine registered to encode or decode #{encoding}.\n" \
+          'Either pass it as an argument, or use Multibases.implement to ' \
+          'register it globally.'
+      )
+    end
+  end
+
+  class AlphabetOutOfRange < Error
+    def initialize(ord)
+      super(
+        'The multibase spec currently only allows for alphabet characters in ' \
+        "the 0-255 range. '#{ord}' is outside that range."
+      )
+    end
+  end
+
+  class AlphabetEncodingInvalid < Error
+    def initialize(encoding)
+      super(
+        "The encoding '#{encoding}' is invalid for the given alphabet. " \
+        'Supply an encoding that is valid for each character in the alphabet.'
+      )
+    end
+  end
+
+  class MissingEncoding < Error
+    def initialize
+      super 'Can not convert from ByteArray to string without encoding. Pass ' \
+            'the resulting string encoding as the first argument of to_s.' \
+            "\n" \
+            'This does not default to UTF-8 or US-ASCII because that would ' \
+            'hide issues until you have output that is NOT encoding as UTF-8 ' \
+            'or US-ASCII and does not fit in those ranges.'
+    end
+  end
+end

data/lib/multibases/ord_table.rb

@@ -1,28 +1,18 @@
 # frozen_string_literal: true
 
+require 'multibases/error'
+
 module Multibases
   class OrdTable
-    def initialize(ords, strict:, padder: nil)
+    def initialize(ords, strict:, padder: nil, encoding: nil)
       ords = ords.uniq
 
       @ords = ords
       @base = ords.length
       @padder = padder
 
-      chars = ords.map(&:chr)
-      chars_downcased = chars.map(&:downcase).uniq
-      chars_upcased = chars.map(&:upcase).uniq
-      chars_cased = chars_upcased - chars_downcased
-
-      # Strict means that the algorithm may _not_ treat incorrectly cased
-      # input the same as correctly cased input. In other words, the table is
-      # strict if a character exists that is both upcased and downcased and
-      # therefore has a canonical casing.
-      @strict = strict ||
-                chars_cased.empty? ||
-                chars.length != chars_downcased.length
-
-      @loose_ords = (chars + chars_downcased + chars_upcased).uniq.map(&:ord)
+      calculate_strictness(strict: strict)
+      calculate_encoding(encoding: encoding)
     end
 
     def eql?(other)
@@ -48,10 +38,52 @@ module Multibases
     end
 
     def alphabet
-      @ords.map(&:chr).join
+      @ords.pack('C*')
     end
 
-    attr_reader :base, :factor, :padder
+    attr_reader :base, :factor, :padder, :encoding
+
+    private
+
+    def calculate_strictness(strict:)
+      chars = alphabet.chars
+      chars_downcased = chars.map(&:downcase).uniq
+      chars_upcased = chars.map(&:upcase).uniq
+      chars_cased = chars_upcased - chars_downcased
+
+      # Strict means that the algorithm may _not_ treat incorrectly cased
+      # input the same as correctly cased input. In other words, the table is
+      # strict if a character exists that is both upcased and downcased and
+      # therefore has a canonical casing.
+      @strict = strict ||
+                chars_cased.empty? ||
+                chars.length != chars_downcased.length
+
+      @loose_ords = (chars + chars_downcased + chars_upcased).uniq.map(&:ord)
+    end
+
+    def calculate_encoding(encoding:)
+      invalid_ord = @ords.find { |ord| ord > 255 }
+      raise AlphabetOutOfBoundary, invalid_ord if invalid_ord
+
+      if encoding
+        raise AlphabetEncodingInvalid, encoding unless valid_encoding?(encoding)
+
+        @encoding = encoding
+        return
+      end
+
+      @encoding = fits_seven_bits? ? Encoding::US_ASCII : Encoding::ASCII_8BIT
+    end
+
+    def valid_encoding?(encoding)
+      ords = strict? ? @ords : @loose_ords
+      ords.pack('C*').force_encoding(encoding).valid_encoding?
+    end
+
+    def fits_seven_bits?
+      valid_encoding?(Encoding::US_ASCII)
+    end
   end
 
   class IndexedOrdTable < OrdTable

data/lib/multibases/registry.rb

@@ -27,11 +27,11 @@ module Multibases
     find_by(code: entry, encoding: entry)
   end
 
-  def implement(encoding, code, implementation = nil, alphabet = nil)
+  def implement(encoding, code, implementation = nil, alphabet = nil, alphabet_encoding = nil)
     Multibases::IMPLEMENTATIONS[encoding] = Registration.new(
       code,
       encoding,
-      implementation&.new(alphabet)
+      implementation&.new(alphabet, encoding: alphabet_encoding)
     )
   end
 
@@ -50,11 +50,11 @@ module Multibases
   end
 
   def codes
-    Multicodecs::REGISTRATIONS.values.map(&:code)
+    Multibases::IMPLEMENTATIONS.values.map(&:code)
   end
 
   def names
-    Multicodecs::REGISTRATIONS.keys
+    Multibases::IMPLEMENTATIONS.keys
   end
 
   def multibase_version(multibase_semver = nil)

data/lib/multibases/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Multibases
-  VERSION = '0.2.0'
+  VERSION = '0.3.0'
 end

data/lib/table.csv

@@ -1,23 +1,23 @@
-encoding,           code, description
-identity,           0x00, 8-bit binary (encoder and decoder keeps data unmodified)
-base1,              1,    unary (11111)
-base2,              0,    binary (01010101)
-base8,              7,    octal
-base10,             9,    decimal
-base16,             f,    hexadecimal
-base16upper,        F,    hexadecimal
-base32hex,          v,    rfc4648 no padding - highest char
-base32hexupper,     V,    rfc4648 no padding - highest char
-base32hexpad,       t,    rfc4648 with padding
-base32hexpadupper,  T,    rfc4648 with padding
-base32,             b,    rfc4648 no padding
-base32upper,        B,    rfc4648 no padding
-base32pad,          c,    rfc4648 with padding
-base32padupper,     C,    rfc4648 with padding
-base32z,            h,    z-base-32 (used by Tahoe-LAFS)
-base58flickr,       Z,    base58 flicker
-base58btc,          z,    base58 bitcoin
-base64,             m,    rfc4648 no padding
-base64pad,          M,    rfc4648 with padding - MIME encoding
-base64url,          u,    rfc4648 no padding
-base64urlpad,       U,    rfc4648 with padding
+encoding,           code, description
+identity,           0x00, 8-bit binary (encoder and decoder keeps data unmodified)
+base1,              1,    unary (11111)
+base2,              0,    binary (01010101)
+base8,              7,    octal
+base10,             9,    decimal
+base16,             f,    hexadecimal
+base16upper,        F,    hexadecimal
+base32hex,          v,    rfc4648 no padding - highest char
+base32hexupper,     V,    rfc4648 no padding - highest char
+base32hexpad,       t,    rfc4648 with padding
+base32hexpadupper,  T,    rfc4648 with padding
+base32,             b,    rfc4648 no padding
+base32upper,        B,    rfc4648 no padding
+base32pad,          c,    rfc4648 with padding
+base32padupper,     C,    rfc4648 with padding
+base32z,            h,    z-base-32 (used by Tahoe-LAFS)
+base58flickr,       Z,    base58 flicker
+base58btc,          z,    base58 bitcoin
+base64,             m,    rfc4648 no padding
+base64pad,          M,    rfc4648 with padding - MIME encoding
+base64url,          u,    rfc4648 no padding
+base64urlpad,       U,    rfc4648 with padding

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: multibases
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Derk-Jan Karrenbeld
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-06-20 00:00:00.000000000 Z
+date: 2019-06-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -81,6 +81,7 @@ files:
 - lib/multibases/base64.rb
 - lib/multibases/base_x.rb
 - lib/multibases/byte_array.rb
+- lib/multibases/error.rb
 - lib/multibases/ord_table.rb
 - lib/multibases/registry.rb
 - lib/multibases/version.rb
@@ -107,7 +108,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.0.2
 signing_key: 
 specification_version: 4
 summary: Ruby implementation of the multibase specification