sodium 0.0.0 → 0.5.0

data/test/sodium/random_test.rb

@@ -0,0 +1,25 @@
+require 'test_helper'
+
+describe Sodium::Random do
+  subject { Sodium::Random }
+
+  it '::bytes must generate a byte string of desired length' do
+    subject.bytes( 30).bytesize.must_equal  30
+    subject.bytes(400).bytesize.must_equal 400
+  end
+
+  it '::bytes must generate random bytes' do
+    1_000.times.map { subject.bytes(16) }.uniq.length.
+      must_equal 1_000
+  end
+
+  it '::integer must generate a single random number' do
+    1_000.times.map { subject.integer }.uniq.length.
+      must_equal 1_000
+  end
+
+  it 'must generate random numbers up to a given max' do
+    1_000.times.map { subject.integer(4) }.any? {|n| n >= 4 }.
+      must_equal false
+  end
+end

data/test/sodium/secret_box/xsalsa20poly1305_test.rb

@@ -0,0 +1,50 @@
+require 'test_helper'
+
+describe Sodium::SecretBox::XSalsa20Poly1305 do
+  include SodiumTestHelpers
+
+  subject { self.klass.new(self.key) }
+
+  let(:klass)     { Sodium::SecretBox::XSalsa20Poly1305 }
+  let(:primitive) { :xsalsa20poly1305 }
+
+  let :constants do
+    { :KEYBYTES     => 32,
+      :NONCEBYTES   => 24,
+      :ZEROBYTES    => 32,
+      :BOXZEROBYTES => 16, }
+  end
+
+  let_64(:key)        { 'MawdlglK6Ue29vbh+4vJb074PlFShQ6H1Cm6x2LiIP0=' }
+  let_64(:nonce)      { 'COwsnSeFSTeld0BQESGuuxyaCN4qeIyX' }
+  let_64(:ciphertext) { 'LrBMC/PJUh73zZKq+VY0kEXSH0EOaLU=' }
+  let_64(:plaintext)  { 'bWVzc2FnZQ==' }
+
+  it '::primitive must be correct' do
+    self.klass.primitive.must_equal self.primitive
+  end
+
+  it 'must have correct values for its constants' do
+    self.constants.each_pair do |name, value|
+      self.klass[name].must_equal value
+    end
+  end
+
+  it 'must mint keys' do
+    self.klass.key.bytesize.must_equal self.klass[:KEYBYTES]
+  end
+
+  it 'must generate closed secret boxes' do
+    self.subject.secret_box(
+      self.plaintext,
+      self.nonce
+    ).to_str.must_equal self.ciphertext
+  end
+
+  it 'must open boxes' do
+    self.subject.open(
+      self.ciphertext,
+      self.nonce
+    ).to_str.must_equal self.plaintext
+  end
+end

data/test/sodium/secret_box_test.rb

@@ -0,0 +1,56 @@
+require 'test_helper'
+
+describe Sodium::SecretBox do
+  include SodiumTestHelpers
+
+  subject     { self.klass.new(self.key) }
+  let(:klass) { Sodium::SecretBox }
+  let(:key)   { self.klass.key }
+
+  it 'must default to the XSalsa20Poly1305 implementation' do
+    self.klass.implementation.
+      must_equal Sodium::SecretBox::XSalsa20Poly1305
+  end
+
+  it 'must allow access to alternate implementations' do
+    self.klass.implementation(:xyz).
+      must_equal nil
+  end
+
+  it 'must instantiate the default implementation' do
+    self.subject.
+      must_be_kind_of Sodium::SecretBox::XSalsa20Poly1305
+  end
+
+  it 'must mint keys from the default implmentation' do
+    sodium_mock_default(self.klass) do |klass, mock|
+      mock.expect :[], 0, [:KEYBYTES]
+
+      klass.key.to_str.must_equal ''
+    end
+  end
+
+  it 'must raise when instantiating with an invalid key' do
+    lambda { self.klass.new(self.key.to_str[0..-2]) }.
+      must_raise Sodium::LengthError
+  end
+
+  it 'must raise when receiving an invalid nonce' do
+    lambda { self.subject.secret_box('message', self.subject.nonce.to_str[0..-2]) }.
+      must_raise Sodium::LengthError
+  end
+
+  it 'must raise when failing to close a box' do
+    sodium_stub_failure(self.klass, :nacl) do
+      lambda { self.subject.secret_box('message', self.subject.nonce) }.
+        must_raise Sodium::CryptoError
+    end
+  end
+
+  it 'must raise when failing to open a box' do
+    sodium_stub_failure(self.klass, :nacl_open) do
+      lambda { self.subject.open('ciphertext', self.subject.nonce) }.
+        must_raise Sodium::CryptoError
+    end
+  end
+end

data/test/sodium/sign/ed25519_test.rb

@@ -0,0 +1,52 @@
+require 'test_helper'
+
+describe Sodium::Sign::Ed25519 do
+  include SodiumTestHelpers
+
+  subject { self.klass.new(self.secret_key) }
+
+  let(:klass)     { Sodium::Sign::Ed25519 }
+  let(:primitive) { :ed25519 }
+
+  let :constants do
+    { :BYTES          => 64,
+      :PUBLICKEYBYTES => 32,
+      :SECRETKEYBYTES => 64, }
+  end
+
+  let_64(:secret_key) { 'PZstPgy/LfTLN47rK69qHv9FPFRhoNRrIcjrxpIl4U0PhSflLvk7kqOrVPJdefT0Cvdwhx7Nyss0TItOCvPH4g==' }
+  let_64(:public_key) { 'D4Un5S75O5Kjq1TyXXn09Ar3cIcezcrLNEyLTgrzx+I=' }
+  let_64(:plaintext)  { 'bWVzc2FnZQ==' }
+  let_64(:signature)  do
+    %{ gBIV6VdlmL9aicHsrWMYhqGiQg3t1QGWmuj5oUNI2DN6FeaKKIkjPZ/N7vTM
+       R7ebY7+C7teQJMSrxlqTnrcnCw== }
+  end
+
+  it '::primitive must be correct' do
+    self.klass.primitive.must_equal self.primitive
+  end
+
+  it 'must have correct values for its constants' do
+    self.constants.each_pair do |name, value|
+      self.klass[name].must_equal value
+    end
+  end
+
+  it 'must mint secret keys' do
+    self.klass.keypair[0].bytesize.must_equal self.klass[:SECRETKEYBYTES]
+  end
+
+  it 'must mint public keys' do
+    self.klass.keypair[1].bytesize.must_equal self.klass[:PUBLICKEYBYTES]
+  end
+
+  it 'must generate message signatures' do
+    self.subject.sign(self.plaintext).to_str.
+      must_equal self.signature
+  end
+
+  it 'must verify message signatures' do
+    self.klass.verify(self.public_key, self.plaintext, self.signature).
+      must_equal true
+  end
+end

data/test/sodium/sign_test.rb

@@ -0,0 +1,58 @@
+require 'test_helper'
+
+describe Sodium::Sign do
+  include SodiumTestHelpers
+
+  subject       { self.klass.new(self.keypair.first) }
+  let(:klass)   { Sodium::Sign }
+  let(:keypair) { self.klass.keypair }
+
+  it 'must default to the Ed25519 implementation' do
+    self.klass.implementation.
+      must_equal Sodium::Sign::Ed25519
+  end
+
+  it 'must allow access to alternate implementations' do
+    self.klass.implementation(:xyz).
+      must_equal nil
+  end
+
+  it 'must instantiate the default implementation' do
+    self.subject.
+      must_be_kind_of Sodium::Sign::Ed25519
+  end
+
+  it 'must mint keys from the default implementation' do
+    sodium_mock_default(self.klass) do |klass, mock|
+      mock.expect :nacl_keypair, true, ['', '']
+      mock.expect :[],           0,    [:PUBLICKEYBYTES]
+      mock.expect :[],           0,    [:SECRETKEYBYTES]
+
+      sk, pk = klass.keypair
+
+      sk.to_str.must_equal ''
+      pk.to_str.must_equal ''
+    end
+  end
+
+  it 'must raise when instantiating with an invalid key' do
+    secret_key = self.keypair.first
+
+    lambda { self.klass.new(secret_key.to_str[0..-2]) }.
+      must_raise Sodium::LengthError
+  end
+
+  it 'must raise when failing to generate keypairs' do
+    sodium_stub_failure(self.klass, :nacl_keypair) do
+      lambda { self.keypair }.
+        must_raise Sodium::CryptoError
+    end
+  end
+
+  it 'must raise when failing to sign a message' do
+    sodium_stub_failure(self.klass, :nacl) do
+      lambda { self.subject.sign('message') }.
+        must_raise Sodium::CryptoError
+    end
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,44 @@
+require 'coveralls'
+require 'simplecov'
+
+SimpleCov.start do
+  add_filter '/test/'
+  add_filter '/vendor/'
+end
+
+Coveralls.wear! if ENV['TRAVIS']
+
+require 'minitest/autorun'
+require 'minitest/spec'
+require 'minitest/pride'
+
+require 'sodium'
+require 'base64'
+
+module SodiumTestHelpers
+  module ClassMethods
+    def let_64(name)
+      define_method(name) { Base64.decode64 yield }
+    end
+  end
+
+  def self.included(subclass)
+    subclass.extend ClassMethods
+  end
+
+  def sodium_override_default(klass, implementation)
+    klass                = klass.dup
+    klass.implementation = implementation
+    yield klass
+  end
+
+  def sodium_mock_default(klass)
+    mock = MiniTest::Mock.new
+    sodium_override_default(klass, mock) {|dup| yield dup, mock }
+    mock.verify
+  end
+
+  def sodium_stub_failure(klass, method, &block)
+    klass.implementation.stub(method, false, &block)
+  end
+end

metadata

@@ -1,44 +1,153 @@
 --- !ruby/object:Gem::Specification
 name: sodium
 version: !ruby/object:Gem::Version
-  version: 0.0.0
+  version: 0.5.0
+  prerelease: 
 platform: ruby
 authors:
 - Stephen Touset
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-03-14 00:00:00.000000000 Z
-dependencies: []
-description: TBD
+date: 2013-06-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ffi
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '5'
+- !ruby/object:Gem::Dependency
+  name: version
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1'
+description: A library for performing cryptography based on modern ciphers and protocols
 email: stephen@touset.org
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- README.md
+- Rakefile
+- VERSION
+- config/nacl_ffi.yml
 - lib/sodium.rb
+- lib/sodium/auth.rb
+- lib/sodium/box.rb
+- lib/sodium/buffer.rb
+- lib/sodium/delegate.rb
+- lib/sodium/ffi.rb
+- lib/sodium/ffi/crypto.rb
+- lib/sodium/ffi/lib_c.rb
+- lib/sodium/ffi/random.rb
+- lib/sodium/hash.rb
+- lib/sodium/one_time_auth.rb
+- lib/sodium/random.rb
+- lib/sodium/secret_box.rb
+- lib/sodium/sign.rb
+- lib/sodium/version.rb
 - sodium.gemspec
+- sodium.pub.gpg
+- tasks/libsodium.rake
+- tasks/test.rake
+- tasks/version.rake
+- test/sodium/auth/hmacsha256_test.rb
+- test/sodium/auth/hmacsha512256_test.rb
+- test/sodium/auth_test.rb
+- test/sodium/box/curve25519xsalsa20poly1305_test.rb
+- test/sodium/box_test.rb
+- test/sodium/buffer_test.rb
+- test/sodium/delegate_test.rb
+- test/sodium/hash/sha256_test.rb
+- test/sodium/hash/sha512_test.rb
+- test/sodium/hash_test.rb
+- test/sodium/one_time_auth/poly1305_test.rb
+- test/sodium/one_time_auth_test.rb
+- test/sodium/random_test.rb
+- test/sodium/secret_box/xsalsa20poly1305_test.rb
+- test/sodium/secret_box_test.rb
+- test/sodium/sign/ed25519_test.rb
+- test/sodium/sign_test.rb
+- test/test_helper.rb
 homepage: https://github.com/stouset/sodium
 licenses: []
-metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
   - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
   - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.0
+rubygems_version: 1.8.25
 signing_key: 
-specification_version: 4
-summary: TBD
+specification_version: 3
+summary: A Ruby binding to the easy-to-use high-speed crypto library libsodium
 test_files: []