blake2b 0.9.0

data/lib/blake2b.rb

@@ -0,0 +1,29 @@
+require 'blake2b_ext'
+require 'blake2b/key'
+
+class Blake2b
+  def self.hex(input, key = Blake2b::Key.none, out_len = 32)
+    check_if_valid!(input, key, out_len)
+    Blake2b.new(out_len, key).digest(input, :to_hex)
+  end
+
+  def self.bytes(input, key = Blake2b::Key.none, out_len = 32)
+    check_if_valid!(input, key, out_len)
+    Blake2b.new(out_len, key).digest(input, :to_bytes)
+  end
+
+  def self.check_if_valid!(input, key, out_len)
+    unless input.is_a?(String)
+      raise ArgumentError, 'input arg must be a String'
+    end
+
+    unless key.is_a?(Blake2b::Key)
+      raise ArgumentError, 'key arg must be a Blake2b::Key'
+    end
+
+    unless out_len.is_a?(Integer) && out_len.between?(1, 64)
+      raise ArgumentError, 'out_len arg must be an Integer between 1 and 64 inclusive'
+    end
+  end
+  private_class_method :check_if_valid!
+end

data/lib/blake2b/key.rb

@@ -0,0 +1,55 @@
+class Blake2b
+  # Validate and normalize an HMAC key, provided in different formats,
+  # into an Array of Integer Bytes.
+  class Key
+    attr_reader :bytes
+
+    def initialize(bytes)
+      @bytes = bytes
+    end
+
+    # Create a blank Key
+    #
+    # @return [Blake2b::Key] a Blake2b::Key object with a `bytes` attr
+    def self.none
+      new([])
+    end
+
+    # Create a key from an ASCII String
+    #
+    # @param str [String] an ASCII String key
+    # @return [Blake2b::Key] a Blake2b::Key object with a `bytes` attr
+    def self.from_string(str)
+      if str.is_a?(String) && str.ascii_only?
+        new(str.bytes)
+      else
+        raise ArgumentError, 'key must be an ASCII String'
+      end
+    end
+
+    # Create a key from a Hex String [a-fA-F0-9]
+    #
+    # @param str [String] a Hex String key
+    # @return [Blake2b::Key] a Blake2b::Key object with a `bytes` attr
+    def self.from_hex(str)
+      if str.is_a?(String) && str.match(/^[a-fA-F0-9]+$/)
+        new([str].pack('H*').bytes)
+      else
+        raise ArgumentError, 'key must be a Hex String [a-fA-F0-9]'
+      end
+    end
+
+    # Create a key from Array of Integer (0-255) Bytes.
+    # This simply validates and passes through the Array.
+    #
+    # @param str [Array] an Array of Integer (0-255) Bytes
+    # @return [Blake2b::Key] a Blake2b::Key object with a `bytes` attr
+    def self.from_bytes(bytes)
+      if bytes.all? { |b| b.is_a?(Integer) && b.between?(0, 255) }
+        new(bytes)
+      else
+        raise ArgumentError, 'key must be a Byte Array of Integers (0-255)'
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,118 @@
+--- !ruby/object:Gem::Specification
+name: blake2b
+version: !ruby/object:Gem::Version
+  version: 0.9.0
+platform: ruby
+authors:
+- Franck Verrot
+- Mauricio Gomes
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-05-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake-compiler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11.1'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.11'
+description: A cryptographic hash function faster than MD5, SHA-1, SHA-2, and SHA-3
+  for 64-bit systems.
+email:
+- mauricio@edge14.com
+executables: []
+extensions:
+- ext/blake2b_ext/extconf.rb
+extra_rdoc_files: []
+files:
+- ".circleci/config.yml"
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- blake2b.gemspec
+- ext/blake2b_ext/blake2-impl.h
+- ext/blake2b_ext/blake2.h
+- ext/blake2b_ext/blake2b-ref.c
+- ext/blake2b_ext/extconf.rb
+- ext/blake2b_ext/rbext.c
+- lib/blake2b.rb
+- lib/blake2b/key.rb
+homepage: https://github.com/mgomes/blake2b
+licenses:
+- GPL-3.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.6
+signing_key: 
+specification_version: 4
+summary: A cryptographic hash function faster than MD5, SHA-1, SHA-2, and SHA-3 for
+  64-bit systems.
+test_files: []