sleeping_kangaroo12 0.0.1 → 0.0.5

data/lib/sleeping_kangaroo12/digest.rb

@@ -1,18 +1,35 @@
 # frozen_string_literal: true
 
+require 'base64'
+require 'ffi'
+require 'objspace'
 require_relative 'binding'
 
 module SleepingKangaroo12
+  # @example basic usage
+  #   digest = ::SleepingKangaroo12::Digest.new(output_length: 10)
+  #   digest << 'some input'
+  #   digest << 'some more input'
+  #   digest.hexdigest
+  #   #=> "cbea8144fbbf6150ceaf"
+  # See {file:README.md README} for more usage examples
   class Digest
+    module Error
+    end
+
     class UpdatingFailed < ::StandardError
+      include Error
     end
 
     class FinalizationFailed < ::StandardError
+      include Error
     end
 
     class Finalized < ::StandardError
+      include Error
     end
 
+    # Create a new Digest
     def initialize(output_length: 32, key: nil)
       raise ::TypeError, 'Hash length is not an Integer' unless output_length.is_a?(::Integer)
       raise ::ArgumentError, 'Hash length out of range' unless (1...(1 << 20)).include?(output_length)
@@ -28,22 +45,24 @@ module SleepingKangaroo12
       @result = nil
     end
 
+    # Feed in the data
     def update(data)
       raise Finalized if @finalized
-
       data_size = data.bytesize
       data_buffer = ::FFI::MemoryPointer.new(:char, data_size)
       data_buffer.put_bytes(0, data)
       Binding.update(@native_instance, data_buffer, data_size).tap do |result|
         raise UpdatingFailed unless result.zero?
       end
-      nil
+      self
     end
 
+    # Alias for {#update}
     def <<(*args, **kwargs)
       update(*args, **kwargs)
     end
 
+    # Finalize and output a binary hash
     def digest
       @finalized = true
       return @_digest if @_digest
@@ -63,30 +82,45 @@ module SleepingKangaroo12
       @_digest = data_buffer.get_bytes(0, @output_length)
     end
 
+    # Finalize and output a hexadecimal-encoded hash
     def hexdigest
       @_hexdigest ||= digest.unpack1('H*')
     end
 
+    # Finalize and output a Base64-encoded hash
     def base64digest
       @_base64digest ||= ::Base64.strict_encode64(digest)
     end
 
     class << self
+      # @!visibility private
       # https://www.mikeperham.com/2010/02/24/the-trouble-with-ruby-finalizers/
       def _create_finalizer(instance)
-        proc {
+        proc do
           Binding.destroy(instance)
-        }
+        end
       end
 
+      # Shortcut to calculate a raw digest
+      # @example basic usage
+      #   ::SleepingKangaroo12::Digest.digest('some input')
+      #   #=> "m\x9FJ\xDA\xE9\x96\xD1X\xC5K\xE83e(x\x8C\xD3o\xFBh\xB2\x17W ,\xD5\xED!\xE4D\xAF\xDD"
+      # @example with key (AKA: customization)
+      #   ::SleepingKangaroo12::Digest.digest('some input', key: 'secret')
+      #   #=> "\x96\xE2K\xC4\xCF\xFFGF\xE1\x05\xB9\xF6f\xF0-\xF8\x1F\a\n\xFC\xD7\xC9\x91\n\xFC\xFB\xA6hOx\x99<"
+      # @example controlled output length
+      #   ::SleepingKangaroo12::Digest.digest('some input', output_length: 5)
+      #   #=> "m\x9FJ\xDA\xE9"
       def digest(*args, **kwargs)
         _generic_digest(*args, **kwargs, &:digest)
       end
 
+      # Same as {.digest} but encode the output in hexadecimal format
       def hexdigest(*args, **kwargs)
         _generic_digest(*args, **kwargs, &:hexdigest)
       end
 
+      # Same as {.digest} but encode the output in Base64 format
       def base64digest(*args, **kwargs)
         _generic_digest(*args, **kwargs, &:base64digest)
       end

data/lib/sleeping_kangaroo12/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SleepingKangaroo12
-  VERSION = '0.0.1'
+  VERSION = '0.0.5'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sleeping_kangaroo12
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.5
 platform: ruby
 authors:
 - Sarun Rattanasiri
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-02-13 00:00:00.000000000 Z
+date: 2022-02-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -16,327 +16,85 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.15.5
+        version: 1.15.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.15.5
+        version: 1.15.0
 - !ruby/object:Gem::Dependency
   name: posix-spawn
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.15
+        version: 0.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.15
+        version: 0.3.0
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 13.0.6
+        version: 13.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 13.0.6
-description: This gem brought the hash algorithm, KangarooTwelve, to Ruby. It uses
-  the official library, XKCP, by the team members behind the original paper. The implementation
-  is highly optimized on popular hardware, including AVX512, AVX2, SSSE3 instruction
-  sets.
+        version: 13.0.0
+description: |-
+  KangarooTwelve binding for Ruby
+  The gem build on top of the official library, K12, maintained by the Keccak team themselves.
+  The implementation is highly optimized and supporting AVX512, AVX2, SSSE3 instruction sets.
 email: midnight_w@gmx.tw
 executables: []
 extensions:
 - ext/Rakefile
 extra_rdoc_files: []
 files:
+- LICENSE.md
 - README.md
 - ext/Rakefile
 - ext/binding/sleeping_kangaroo12.c
-- ext/config/xkcp.build
-- ext/xkcp/LICENSE
-- ext/xkcp/Makefile
-- ext/xkcp/Makefile.build
-- ext/xkcp/README.markdown
-- ext/xkcp/lib/HighLevel.build
-- ext/xkcp/lib/LowLevel.build
-- ext/xkcp/lib/common/align.h
-- ext/xkcp/lib/common/brg_endian.h
-- ext/xkcp/lib/high/KangarooTwelve/KangarooTwelve.c
-- ext/xkcp/lib/high/KangarooTwelve/KangarooTwelve.h
-- ext/xkcp/lib/high/Keccak/FIPS202/KeccakHash.c
-- ext/xkcp/lib/high/Keccak/FIPS202/KeccakHash.h
-- ext/xkcp/lib/high/Keccak/FIPS202/SimpleFIPS202.c
-- ext/xkcp/lib/high/Keccak/FIPS202/SimpleFIPS202.h
-- ext/xkcp/lib/high/Keccak/KeccakDuplex.c
-- ext/xkcp/lib/high/Keccak/KeccakDuplex.h
-- ext/xkcp/lib/high/Keccak/KeccakDuplex.inc
-- ext/xkcp/lib/high/Keccak/KeccakSponge.c
-- ext/xkcp/lib/high/Keccak/KeccakSponge.h
-- ext/xkcp/lib/high/Keccak/KeccakSponge.inc
-- ext/xkcp/lib/high/Keccak/PRG/KeccakPRG.c
-- ext/xkcp/lib/high/Keccak/PRG/KeccakPRG.h
-- ext/xkcp/lib/high/Keccak/PRG/KeccakPRG.inc
-- ext/xkcp/lib/high/Keccak/SP800-185/SP800-185.c
-- ext/xkcp/lib/high/Keccak/SP800-185/SP800-185.h
-- ext/xkcp/lib/high/Keccak/SP800-185/SP800-185.inc
-- ext/xkcp/lib/high/Ketje/Ketjev2.c
-- ext/xkcp/lib/high/Ketje/Ketjev2.h
-- ext/xkcp/lib/high/Ketje/Ketjev2.inc
-- ext/xkcp/lib/high/Keyak/Keyakv2.c
-- ext/xkcp/lib/high/Keyak/Keyakv2.h
-- ext/xkcp/lib/high/Keyak/Keyakv2.inc
-- ext/xkcp/lib/high/Keyak/Motorist.inc
-- ext/xkcp/lib/high/Kravatte/Kravatte.c
-- ext/xkcp/lib/high/Kravatte/Kravatte.h
-- ext/xkcp/lib/high/Kravatte/KravatteModes.c
-- ext/xkcp/lib/high/Kravatte/KravatteModes.h
-- ext/xkcp/lib/high/Xoodyak/Cyclist.h
-- ext/xkcp/lib/high/Xoodyak/Cyclist.inc
-- ext/xkcp/lib/high/Xoodyak/Xoodyak-parameters.h
-- ext/xkcp/lib/high/Xoodyak/Xoodyak.c
-- ext/xkcp/lib/high/Xoodyak/Xoodyak.h
-- ext/xkcp/lib/high/Xoofff/Xoofff.c
-- ext/xkcp/lib/high/Xoofff/Xoofff.h
-- ext/xkcp/lib/high/Xoofff/XoofffModes.c
-- ext/xkcp/lib/high/Xoofff/XoofffModes.h
-- ext/xkcp/lib/high/common/Phases.h
-- ext/xkcp/lib/low/KeccakP-1600-times2/ARMv7A-NEON/KeccakP-1600-inplace-pl2-armv7a-neon-le-armcc.s
-- ext/xkcp/lib/low/KeccakP-1600-times2/ARMv7A-NEON/KeccakP-1600-inplace-pl2-armv7a-neon-le-gcc.s
-- ext/xkcp/lib/low/KeccakP-1600-times2/ARMv7A-NEON/KeccakP-1600-times2-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600-times2/AVX512/AVX512u12/SIMD512-2-config.h
-- ext/xkcp/lib/low/KeccakP-1600-times2/AVX512/AVX512u4/SIMD512-2-config.h
-- ext/xkcp/lib/low/KeccakP-1600-times2/AVX512/AVX512ufull/SIMD512-2-config.h
-- ext/xkcp/lib/low/KeccakP-1600-times2/AVX512/KeccakP-1600-times2-SIMD512.c
-- ext/xkcp/lib/low/KeccakP-1600-times2/AVX512/KeccakP-1600-times2-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600-times2/SIMD128/KeccakP-1600-times2-SIMD128.c
-- ext/xkcp/lib/low/KeccakP-1600-times2/SIMD128/KeccakP-1600-times2-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600-times2/SIMD128/SSSE3-u2/SIMD128-config.h
-- ext/xkcp/lib/low/KeccakP-1600-times2/SIMD128/SSSE3-ua/SIMD128-config.h
-- ext/xkcp/lib/low/KeccakP-1600-times2/SIMD128/XOP-u2/SIMD128-config.h
-- ext/xkcp/lib/low/KeccakP-1600-times2/SIMD128/XOP-ua/SIMD128-config.h
-- ext/xkcp/lib/low/KeccakP-1600-times2/fallback-on1/KeccakP-1600-times2-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600-times2/fallback-on1/KeccakP-1600-times2-on1.c
-- ext/xkcp/lib/low/KeccakP-1600-times4/AVX2/KeccakP-1600-times4-SIMD256.c
-- ext/xkcp/lib/low/KeccakP-1600-times4/AVX2/KeccakP-1600-times4-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600-times4/AVX2/u12/SIMD256-config.h
-- ext/xkcp/lib/low/KeccakP-1600-times4/AVX2/u6/SIMD256-config.h
-- ext/xkcp/lib/low/KeccakP-1600-times4/AVX2/ua/SIMD256-config.h
-- ext/xkcp/lib/low/KeccakP-1600-times4/AVX512/AVX512u12/SIMD512-4-config.h
-- ext/xkcp/lib/low/KeccakP-1600-times4/AVX512/AVX512u4/SIMD512-4-config.h
-- ext/xkcp/lib/low/KeccakP-1600-times4/AVX512/AVX512ufull/SIMD512-4-config.h
-- ext/xkcp/lib/low/KeccakP-1600-times4/AVX512/KeccakP-1600-times4-SIMD512.c
-- ext/xkcp/lib/low/KeccakP-1600-times4/AVX512/KeccakP-1600-times4-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600-times4/fallback-on1/KeccakP-1600-times4-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600-times4/fallback-on1/KeccakP-1600-times4-on1.c
-- ext/xkcp/lib/low/KeccakP-1600-times4/fallback-on2/KeccakP-1600-times4-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600-times4/fallback-on2/KeccakP-1600-times4-on2.c
-- ext/xkcp/lib/low/KeccakP-1600-times8/AVX512/KeccakP-1600-times8-SIMD512.c
-- ext/xkcp/lib/low/KeccakP-1600-times8/AVX512/KeccakP-1600-times8-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600-times8/AVX512/u12/SIMD512-config.h
-- ext/xkcp/lib/low/KeccakP-1600-times8/AVX512/u4/SIMD512-config.h
-- ext/xkcp/lib/low/KeccakP-1600-times8/AVX512/ua/SIMD512-config.h
-- ext/xkcp/lib/low/KeccakP-1600-times8/fallback-on1/KeccakP-1600-times8-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600-times8/fallback-on1/KeccakP-1600-times8-on1.c
-- ext/xkcp/lib/low/KeccakP-1600-times8/fallback-on2/KeccakP-1600-times8-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600-times8/fallback-on2/KeccakP-1600-times8-on2.c
-- ext/xkcp/lib/low/KeccakP-1600-times8/fallback-on4/KeccakP-1600-times8-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600-times8/fallback-on4/KeccakP-1600-times8-on4.c
-- ext/xkcp/lib/low/KeccakP-1600/ARM/KeccakP-1600-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600/ARM/KeccakP-1600-inplace-32bi-armv6m-le-armcc.s
-- ext/xkcp/lib/low/KeccakP-1600/ARM/KeccakP-1600-inplace-32bi-armv6m-le-gcc.s
-- ext/xkcp/lib/low/KeccakP-1600/ARM/KeccakP-1600-inplace-32bi-armv7a-le-armcc.s
-- ext/xkcp/lib/low/KeccakP-1600/ARM/KeccakP-1600-inplace-32bi-armv7a-le-gcc.s
-- ext/xkcp/lib/low/KeccakP-1600/ARM/KeccakP-1600-inplace-32bi-armv7m-le-armcc.s
-- ext/xkcp/lib/low/KeccakP-1600/ARM/KeccakP-1600-inplace-32bi-armv7m-le-gcc.s
-- ext/xkcp/lib/low/KeccakP-1600/ARM/KeccakP-1600-u1-32bi-armv6m-le-armcc.s
-- ext/xkcp/lib/low/KeccakP-1600/ARM/KeccakP-1600-u1-32bi-armv6m-le-gcc.s
-- ext/xkcp/lib/low/KeccakP-1600/ARM/KeccakP-1600-u2-32bi-armv6m-le-armcc.s
-- ext/xkcp/lib/low/KeccakP-1600/ARM/KeccakP-1600-u2-32bi-armv6m-le-gcc.s
-- ext/xkcp/lib/low/KeccakP-1600/ARMv7A-NEON/KeccakP-1600-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600/ARMv7A-NEON/KeccakP-1600-armv7a-le-neon-armcc.s
-- ext/xkcp/lib/low/KeccakP-1600/ARMv7A-NEON/KeccakP-1600-armv7a-le-neon-gcc.s
-- ext/xkcp/lib/low/KeccakP-1600/ARMv8A/KeccakP-1600-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600/ARMv8A/KeccakP-1600-armv8a-neon.s
-- ext/xkcp/lib/low/KeccakP-1600/AVR8/KeccakP-1600-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600/AVR8/KeccakP-1600-avr8-compact.s
-- ext/xkcp/lib/low/KeccakP-1600/AVR8/KeccakP-1600-avr8-fast.s
-- ext/xkcp/lib/low/KeccakP-1600/AVX2/KeccakP-1600-AVX2.s
-- ext/xkcp/lib/low/KeccakP-1600/AVX2/KeccakP-1600-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600/AVX512/C/KeccakP-1600-AVX512.c
-- ext/xkcp/lib/low/KeccakP-1600/AVX512/C/KeccakP-1600-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600/AVX512/C/u12/KeccakP-1600-AVX512-config.h
-- ext/xkcp/lib/low/KeccakP-1600/AVX512/C/u6/KeccakP-1600-AVX512-config.h
-- ext/xkcp/lib/low/KeccakP-1600/AVX512/C/ua/KeccakP-1600-AVX512-config.h
-- ext/xkcp/lib/low/KeccakP-1600/AVX512/KeccakP-1600-AVX512.s
-- ext/xkcp/lib/low/KeccakP-1600/AVX512/KeccakP-1600-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600/XOP/KeccakP-1600-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600/XOP/KeccakP-1600-XOP.c
-- ext/xkcp/lib/low/KeccakP-1600/XOP/u6/KeccakP-1600-XOP-config.h
-- ext/xkcp/lib/low/KeccakP-1600/XOP/ua/KeccakP-1600-XOP-config.h
-- ext/xkcp/lib/low/KeccakP-1600/common/KeccakP-1600-64.macros
-- ext/xkcp/lib/low/KeccakP-1600/common/KeccakP-1600-unrolling.macros
-- ext/xkcp/lib/low/KeccakP-1600/compact/KeccakP-1600-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600/compact/KeccakP-1600-compact64.c
-- ext/xkcp/lib/low/KeccakP-1600/plain-32bits-inplace/KeccakP-1600-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600/plain-32bits-inplace/KeccakP-1600-inplace32BI.c
-- ext/xkcp/lib/low/KeccakP-1600/plain-64bits/KeccakP-1600-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600/plain-64bits/KeccakP-1600-opt64.c
-- ext/xkcp/lib/low/KeccakP-1600/plain-64bits/lcu6/KeccakP-1600-opt64-config.h
-- ext/xkcp/lib/low/KeccakP-1600/plain-64bits/lcua-shld/KeccakP-1600-opt64-config.h
-- ext/xkcp/lib/low/KeccakP-1600/plain-64bits/lcua/KeccakP-1600-opt64-config.h
-- ext/xkcp/lib/low/KeccakP-1600/plain-64bits/u6/KeccakP-1600-opt64-config.h
-- ext/xkcp/lib/low/KeccakP-1600/plain-64bits/ua/KeccakP-1600-opt64-config.h
-- ext/xkcp/lib/low/KeccakP-1600/ref-32bits/KeccakP-1600-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600/ref-32bits/KeccakP-1600-reference.h
-- ext/xkcp/lib/low/KeccakP-1600/ref-32bits/KeccakP-1600-reference32BI.c
-- ext/xkcp/lib/low/KeccakP-1600/ref-64bits/KeccakP-1600-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600/ref-64bits/KeccakP-1600-reference.c
-- ext/xkcp/lib/low/KeccakP-1600/ref-64bits/KeccakP-1600-reference.h
-- ext/xkcp/lib/low/KeccakP-1600/x86-64/KeccakP-1600-SnP.h
-- ext/xkcp/lib/low/KeccakP-1600/x86-64/KeccakP-1600-x86-64-gas.s
-- ext/xkcp/lib/low/KeccakP-1600/x86-64/KeccakP-1600-x86-64-gas_Apple.s
-- ext/xkcp/lib/low/KeccakP-1600/x86-64/KeccakP-1600-x86-64-shld-gas.s
-- ext/xkcp/lib/low/KeccakP-200/ARM/KeccakP-200-SnP.h
-- ext/xkcp/lib/low/KeccakP-200/ARM/KeccakP-200-armv6m-le-armcc.s
-- ext/xkcp/lib/low/KeccakP-200/ARM/KeccakP-200-armv6m-le-gcc.s
-- ext/xkcp/lib/low/KeccakP-200/ARM/KeccakP-200-armv7m-le-armcc.s
-- ext/xkcp/lib/low/KeccakP-200/ARM/KeccakP-200-armv7m-le-gcc.s
-- ext/xkcp/lib/low/KeccakP-200/AVR8/KeccakP-200-SnP.h
-- ext/xkcp/lib/low/KeccakP-200/AVR8/KeccakP-200-avr8-fast.s
-- ext/xkcp/lib/low/KeccakP-200/compact/KeccakP-200-SnP.h
-- ext/xkcp/lib/low/KeccakP-200/compact/KeccakP-200-compact.c
-- ext/xkcp/lib/low/KeccakP-200/ref/KeccakP-200-SnP.h
-- ext/xkcp/lib/low/KeccakP-200/ref/KeccakP-200-reference.c
-- ext/xkcp/lib/low/KeccakP-200/ref/KeccakP-200-reference.h
-- ext/xkcp/lib/low/KeccakP-400/ARM/KeccakP-400-SnP.h
-- ext/xkcp/lib/low/KeccakP-400/ARM/KeccakP-400-armv6m-le-armcc.s
-- ext/xkcp/lib/low/KeccakP-400/ARM/KeccakP-400-armv6m-le-gcc.s
-- ext/xkcp/lib/low/KeccakP-400/ARM/KeccakP-400-armv7m-le-armcc.s
-- ext/xkcp/lib/low/KeccakP-400/ARM/KeccakP-400-armv7m-le-gcc.s
-- ext/xkcp/lib/low/KeccakP-400/AVR8/KeccakP-400-SnP.h
-- ext/xkcp/lib/low/KeccakP-400/AVR8/KeccakP-400-avr8-fast.s
-- ext/xkcp/lib/low/KeccakP-400/ref/KeccakP-400-SnP.h
-- ext/xkcp/lib/low/KeccakP-400/ref/KeccakP-400-reference.c
-- ext/xkcp/lib/low/KeccakP-400/ref/KeccakP-400-reference.h
-- ext/xkcp/lib/low/KeccakP-800/ARM/KeccakP-800-SnP.h
-- ext/xkcp/lib/low/KeccakP-800/ARM/KeccakP-800-u1-armv6m-le-armcc.s
-- ext/xkcp/lib/low/KeccakP-800/ARM/KeccakP-800-u1-armv6m-le-gcc.s
-- ext/xkcp/lib/low/KeccakP-800/ARM/KeccakP-800-u2-armv6m-le-armcc.s
-- ext/xkcp/lib/low/KeccakP-800/ARM/KeccakP-800-u2-armv6m-le-gcc.s
-- ext/xkcp/lib/low/KeccakP-800/ARM/KeccakP-800-u2-armv7a-le-armcc.s
-- ext/xkcp/lib/low/KeccakP-800/ARM/KeccakP-800-u2-armv7a-le-gcc.s
-- ext/xkcp/lib/low/KeccakP-800/ARM/KeccakP-800-u2-armv7m-le-armcc.s
-- ext/xkcp/lib/low/KeccakP-800/ARM/KeccakP-800-u2-armv7m-le-gcc.s
-- ext/xkcp/lib/low/KeccakP-800/ARM/KeccakP-800-uf-armv7m-le-armcc.s
-- ext/xkcp/lib/low/KeccakP-800/ARM/KeccakP-800-uf-armv7m-le-gcc.s
-- ext/xkcp/lib/low/KeccakP-800/ARMv8A/KeccakP-800-SnP.h
-- ext/xkcp/lib/low/KeccakP-800/ARMv8A/KeccakP-800-armv8a-neon.s
-- ext/xkcp/lib/low/KeccakP-800/AVR8/KeccakP-800-SnP.h
-- ext/xkcp/lib/low/KeccakP-800/AVR8/KeccakP-800-avr8-fast.s
-- ext/xkcp/lib/low/KeccakP-800/compact/KeccakP-800-SnP.h
-- ext/xkcp/lib/low/KeccakP-800/compact/KeccakP-800-compact.c
-- ext/xkcp/lib/low/KeccakP-800/plain/KeccakP-800-SnP.h
-- ext/xkcp/lib/low/KeccakP-800/plain/KeccakP-800-opt32-bis.macros
-- ext/xkcp/lib/low/KeccakP-800/plain/KeccakP-800-opt32.c
-- ext/xkcp/lib/low/KeccakP-800/plain/KeccakP-800-opt32.macros
-- ext/xkcp/lib/low/KeccakP-800/plain/KeccakP-800-unrolling-bis.macros
-- ext/xkcp/lib/low/KeccakP-800/plain/KeccakP-800-unrolling.macros
-- ext/xkcp/lib/low/KeccakP-800/plain/lcu2/KeccakP-800-opt32-config.h
-- ext/xkcp/lib/low/KeccakP-800/plain/lcua/KeccakP-800-opt32-config.h
-- ext/xkcp/lib/low/KeccakP-800/plain/u2/KeccakP-800-opt32-config.h
-- ext/xkcp/lib/low/KeccakP-800/plain/ua/KeccakP-800-opt32-config.h
-- ext/xkcp/lib/low/KeccakP-800/ref/KeccakP-800-SnP.h
-- ext/xkcp/lib/low/KeccakP-800/ref/KeccakP-800-reference.c
-- ext/xkcp/lib/low/KeccakP-800/ref/KeccakP-800-reference.h
-- ext/xkcp/lib/low/Ketje/OptimizedAsmARM/Ket.h
-- ext/xkcp/lib/low/Ketje/OptimizedAsmARM/KetjeJr-armv7m-le-armcc.s
-- ext/xkcp/lib/low/Ketje/OptimizedAsmARM/KetjeJr-armv7m-le-gcc.s
-- ext/xkcp/lib/low/Ketje/OptimizedAsmARM/KetjeSr-armv7m-le-armcc.s
-- ext/xkcp/lib/low/Ketje/OptimizedAsmARM/KetjeSr-armv7m-le-gcc.s
-- ext/xkcp/lib/low/Ketje/OptimizedLE/Ket.c
-- ext/xkcp/lib/low/Ketje/OptimizedLE/Ket.h
-- ext/xkcp/lib/low/Ketje/OptimizedLE/Ket.inc
-- ext/xkcp/lib/low/Ketje/SnP-compliant/Ket.c
-- ext/xkcp/lib/low/Ketje/SnP-compliant/Ket.h
-- ext/xkcp/lib/low/Ketje/SnP-compliant/Ket.inc
-- ext/xkcp/lib/low/Xoodoo-times16/AVX512/Xoodoo-times16-SIMD512.c
-- ext/xkcp/lib/low/Xoodoo-times16/AVX512/Xoodoo-times16-SnP.h
-- ext/xkcp/lib/low/Xoodoo-times16/fallback-on1/Xoodoo-times16-SnP.h
-- ext/xkcp/lib/low/Xoodoo-times16/fallback-on1/Xoodoo-times16-on1.c
-- ext/xkcp/lib/low/Xoodoo-times4/ARMv7A-NEON/Xoodoo-times4-ARMv7A.s
-- ext/xkcp/lib/low/Xoodoo-times4/ARMv7A-NEON/Xoodoo-times4-SnP.h
-- ext/xkcp/lib/low/Xoodoo-times4/AVX512/Xoodoo-times4-SIMD512.c
-- ext/xkcp/lib/low/Xoodoo-times4/AVX512/Xoodoo-times4-SnP.h
-- ext/xkcp/lib/low/Xoodoo-times4/SSSE3/Xoodoo-times4-SIMD128.c
-- ext/xkcp/lib/low/Xoodoo-times4/SSSE3/Xoodoo-times4-SnP.h
-- ext/xkcp/lib/low/Xoodoo-times4/fallback-on1/Xoodoo-times4-SnP.h
-- ext/xkcp/lib/low/Xoodoo-times4/fallback-on1/Xoodoo-times4-on1.c
-- ext/xkcp/lib/low/Xoodoo-times8/AVX2/Xoodoo-times8-SIMD256.c
-- ext/xkcp/lib/low/Xoodoo-times8/AVX2/Xoodoo-times8-SnP.h
-- ext/xkcp/lib/low/Xoodoo-times8/AVX512/Xoodoo-times8-SIMD512.c
-- ext/xkcp/lib/low/Xoodoo-times8/AVX512/Xoodoo-times8-SnP.h
-- ext/xkcp/lib/low/Xoodoo-times8/fallback-on1/Xoodoo-times8-SnP.h
-- ext/xkcp/lib/low/Xoodoo-times8/fallback-on1/Xoodoo-times8-on1.c
-- ext/xkcp/lib/low/Xoodoo/ARM/Xoodoo-SnP.h
-- ext/xkcp/lib/low/Xoodoo/ARM/Xoodoo-u1-armv6m-le-armcc.s
-- ext/xkcp/lib/low/Xoodoo/ARM/Xoodoo-u1-armv6m-le-gcc.s
-- ext/xkcp/lib/low/Xoodoo/ARM/Xoodoo-uf-armv6-le-armcc.s
-- ext/xkcp/lib/low/Xoodoo/ARM/Xoodoo-uf-armv6-le-gcc.s
-- ext/xkcp/lib/low/Xoodoo/ARM/Xoodoo-uf-armv7m-le-armcc.s
-- ext/xkcp/lib/low/Xoodoo/ARM/Xoodoo-uf-armv7m-le-gcc.s
-- ext/xkcp/lib/low/Xoodoo/ARM/Xoodyak-u1-armv6m-le-armcc.s
-- ext/xkcp/lib/low/Xoodoo/ARM/Xoodyak-u1-armv6m-le-gcc.s
-- ext/xkcp/lib/low/Xoodoo/ARM/Xoodyak-uf-armv6-le-armcc.s
-- ext/xkcp/lib/low/Xoodoo/ARM/Xoodyak-uf-armv6-le-gcc.s
-- ext/xkcp/lib/low/Xoodoo/ARM/Xoodyak-uf-armv7m-le-armcc.s
-- ext/xkcp/lib/low/Xoodoo/ARM/Xoodyak-uf-armv7m-le-gcc.s
-- ext/xkcp/lib/low/Xoodoo/ARMv7A-NEON/Xoodoo-SnP.h
-- ext/xkcp/lib/low/Xoodoo/ARMv7A-NEON/Xoodoo-uf-armv7a-neon-le-armcc.s
-- ext/xkcp/lib/low/Xoodoo/ARMv7A-NEON/Xoodoo-uf-armv7a-neon-le-gcc.s
-- ext/xkcp/lib/low/Xoodoo/ARMv7A-NEON/Xoodyak-uf-armv7a-neon-le-armcc.s
-- ext/xkcp/lib/low/Xoodoo/ARMv7A-NEON/Xoodyak-uf-armv7a-neon-le-gcc.s
-- ext/xkcp/lib/low/Xoodoo/AVR8/Xoodoo-SnP.h
-- ext/xkcp/lib/low/Xoodoo/AVR8/Xoodoo-avr8-u1.s
-- ext/xkcp/lib/low/Xoodoo/AVX512/Xoodoo-SIMD512.c
-- ext/xkcp/lib/low/Xoodoo/AVX512/Xoodoo-SnP.h
-- ext/xkcp/lib/low/Xoodoo/AVX512/Xoodyak-full-block-SIMD512.c
-- ext/xkcp/lib/low/Xoodoo/SSE2/Xoodoo-SIMD128.c
-- ext/xkcp/lib/low/Xoodoo/SSE2/Xoodoo-SnP.h
-- ext/xkcp/lib/low/Xoodoo/SSE2/Xoodyak-full-block-SIMD128.c
-- ext/xkcp/lib/low/Xoodoo/Xoodoo.h
-- ext/xkcp/lib/low/Xoodoo/plain/Xoodoo-SnP.h
-- ext/xkcp/lib/low/Xoodoo/plain/Xoodoo-optimized.c
-- ext/xkcp/lib/low/Xoodoo/plain/Xoodyak-full-blocks.c
-- ext/xkcp/lib/low/Xoodoo/ref/Xoodoo-SnP.h
-- ext/xkcp/lib/low/Xoodoo/ref/Xoodoo-reference.c
-- ext/xkcp/lib/low/common/PlSnP-Fallback.inc
-- ext/xkcp/lib/low/common/SnP-Relaned.h
-- ext/xkcp/support/Build/ExpandProducts.xsl
-- ext/xkcp/support/Build/ToGlobalMakefile.xsl
-- ext/xkcp/support/Build/ToOneTarget.xsl
-- ext/xkcp/support/Build/ToTargetConfigFile.xsl
-- ext/xkcp/support/Build/ToTargetMakefile.xsl
-- ext/xkcp/support/Build/ToVCXProj.xsl
-- ext/xkcp/support/Kernel-PMU/Kernel-pmu.md
-- ext/xkcp/support/Kernel-PMU/Makefile
-- ext/xkcp/support/Kernel-PMU/enable_arm_pmu.c
-- ext/xkcp/support/Kernel-PMU/load-module
-- ext/xkcp/util/KeccakSum/KeccakSum.c
-- ext/xkcp/util/KeccakSum/base64.c
-- ext/xkcp/util/KeccakSum/base64.h
+- ext/k12/Makefile
+- ext/k12/Makefile.build
+- ext/k12/README.markdown
+- ext/k12/lib/ARMv8Asha3/KeccakP-1600-ARMv8Asha3.S
+- ext/k12/lib/ARMv8Asha3/KeccakP-1600-SnP.h
+- ext/k12/lib/ARMv8Asha3/KeccakP-1600-opt64.c
+- ext/k12/lib/Inplace32BI/KeccakP-1600-SnP.h
+- ext/k12/lib/Inplace32BI/KeccakP-1600-inplace32BI.c
+- ext/k12/lib/KangarooTwelve.c
+- ext/k12/lib/KangarooTwelve.h
+- ext/k12/lib/Optimized64/KeccakP-1600-AVX2.s
+- ext/k12/lib/Optimized64/KeccakP-1600-AVX512-plainC.c
+- ext/k12/lib/Optimized64/KeccakP-1600-AVX512.s
+- ext/k12/lib/Optimized64/KeccakP-1600-SnP.h
+- ext/k12/lib/Optimized64/KeccakP-1600-opt64.c
+- ext/k12/lib/Optimized64/KeccakP-1600-runtimeDispatch.c
+- ext/k12/lib/Optimized64/KeccakP-1600-timesN-AVX2.c
+- ext/k12/lib/Optimized64/KeccakP-1600-timesN-AVX512.c
+- ext/k12/lib/Optimized64/KeccakP-1600-timesN-SSSE3.c
+- ext/k12/lib/Plain64/KeccakP-1600-SnP.h
+- ext/k12/lib/Plain64/KeccakP-1600-plain64.c
+- ext/k12/lib/align.h
+- ext/k12/lib/brg_endian.h
+- ext/k12/support/Build/ExpandProducts.xsl
+- ext/k12/support/Build/ToGlobalMakefile.xsl
+- ext/k12/support/Build/ToOneTarget.xsl
+- ext/k12/support/Build/ToTargetConfigFile.xsl
+- ext/k12/support/Build/ToTargetMakefile.xsl
+- ext/k12/support/Build/ToVCXProj.xsl
 - lib/sleeping_kangaroo12.rb
 - lib/sleeping_kangaroo12/binding.rb
 - lib/sleeping_kangaroo12/build.rb
@@ -344,12 +102,14 @@ files:
 - lib/sleeping_kangaroo12/build/platform.rb
 - lib/sleeping_kangaroo12/digest.rb
 - lib/sleeping_kangaroo12/version.rb
-homepage: https://slime.systems/
+homepage: https://github.com/the-cave/sleeping-kangaroo12
 licenses:
 - BSD-3-Clause
 metadata:
-  homepage_uri: https://slime.systems/
-  source_code_uri: https://github.com/the-cave/sleeping-kangaroo12/tree/v0.0.1
+  homepage_uri: https://github.com/the-cave/sleeping-kangaroo12
+  source_code_uri: https://github.com/the-cave/sleeping-kangaroo12/tree/v0.0.5
+  documentation_uri: https://rubydoc.info/gems/sleeping_kangaroo12/0.0.5
+  bug_tracker_uri: https://github.com/the-cave/sleeping-kangaroo12/issues
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -368,5 +128,5 @@ requirements: []
 rubygems_version: 3.2.32
 signing_key:
 specification_version: 4
-summary: A binding of the KangarooTwelve hash algorithm for Ruby
+summary: KangarooTwelve, the hash algorithm, native binding for Ruby
 test_files: []

data/ext/config/xkcp.build

@@ -1,17 +0,0 @@
-<build all="all" xmlns:xi="http://www.w3.org/2001/XInclude">
-    <xi:include href="../xkcp/lib/HighLevel.build"/>
-    <xi:include href="../xkcp/lib/LowLevel.build"/>
-
-    <fragment name="common">
-        <h>../xkcp/lib/common/align.h</h>
-        <h>../xkcp/lib/common/brg_endian.h</h>
-    </fragment>
-
-   <target name="libK12-generic.a" inherits="KangarooTwelve K1600-compact"/>
-   <target name="libK12-generic-64.a" inherits="KangarooTwelve K1600-plain-64bits-u6"/>
-   <target name="libK12-ssse3.a" inherits="KangarooTwelve K1600-compact K1600x2-SSSE3-u2"/>
-   <target name="libK12-ssse3-64.a" inherits="KangarooTwelve K1600-plain-64bits-u6 K1600x2-SSSE3-u2"/>
-   <target name="libK12-avx2.a" inherits="KangarooTwelve K1600-AVX2 K1600x4-AVX2-u12"/>
-   <target name="libK12-avx2-ssse3.a" inherits="KangarooTwelve K1600-AVX2 K1600x2-SSSE3-u2 K1600x4-AVX2-u12"/>
-   <target name="libK12-avx512.a" inherits="KangarooTwelve K1600-AVX512 K1600x2-AVX512-u12 K1600x4-AVX512-u12 K1600x8-AVX512-u12"/>
-</build>

data/ext/xkcp/LICENSE

@@ -1 +0,0 @@
-See in file README.markdown, after the line starting with "# Under which license is the KCP distributed?".