digest-kangarootwelve 0.3.1 → 0.4.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 50d1bcef2a3a7241ec3ea218feff65028968e715bd275b004939b2add9c97474
-  data.tar.gz: 59ba3a8f2663ec6a735d8569b0991bfd77c72b7242ed866b44115dfa5d37cef7
+  metadata.gz: a6d704428596e208194d0a66067cd47fd93f86c87a4ed83aa68bf365dd118cc9
+  data.tar.gz: a582a30602bd9573c4188280a4b8a9d7e5ee5a9bb383b93be7c86434d274c4f9
 SHA512:
-  metadata.gz: 51b48a2c02ee71e2d5d196c7d66a06a98c724690c38074ff84632e0025ab02b3465e981b385ebba9b5ae6f89f8641e9000a667cabc35e220ccd5983d18cbf5da
-  data.tar.gz: '0195409da11e513282a80e960a52b4df548bb2d843f376e5dea19d3783e4491e94c0cf6b36ff471c66b6fb789fe0deebca83063edbd7f67ae5aa4f91fa131135'
+  metadata.gz: 78db569f6b9c4943f970aece5c07900f4e6d312bc9d294b70331d8cad4cc511af259ffb579531e1266f0ff1f0d31da82cefb7fe7dd377c7eecb613c444c684d1
+  data.tar.gz: 8e11295c04a7b274f4b60f6bbd789bc4bd3f3a1c391b69103aa45a17c68331c9e877539ec47208f04d31e4602f5236f20e811989ae9d7798f06ba85381939027

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2017 konsolebox
+Copyright (c) 2022 konsolebox
 
 MIT License
 

data/LICENSE.XKCP

@@ -0,0 +1,9 @@
+# Under which license is the XKCP distributed?
+
+Most of the source and header files in the XKCP are released to the **public domain** and associated to the [CC0](http://creativecommons.org/publicdomain/zero/1.0/) deed. The exceptions are the following:
+
+* [`lib/common/brg_endian.h`](lib/common/brg_endian.h) is copyrighted by Brian Gladman and comes with a BSD 3-clause license;
+* [`tests/UnitTests/genKAT.c`](tests/UnitTests/genKAT.c) is based on [SHA-3 contest's code by Larry Bassham, NIST](http://csrc.nist.gov/groups/ST/hash/sha-3/documents/KAT1.zip), which he licensed under a BSD 3-clause license;
+* [`tests/UnitTests/timing.h`](tests/UnitTests/timing.h) is adapted from Google Benchmark and is licensed under the Apache License, Version 2.0;
+* [`KeccakP-1600-AVX2.s`](lib/low/KeccakP-1600/AVX2/KeccakP-1600-AVX2.s) is licensed under the [CRYPTOGAMS license](http://www.openssl.org/~appro/cryptogams/) (BSD-like);
+* [`support/Kernel-PMU/enable_arm_pmu.c`](support/Kernel-PMU/enable_arm_pmu.c) is licensed under the GNU General Public License by Bruno Pairault.

data/README.md

@@ -1,63 +1,116 @@
-# digest-kangarootwelve-ruby
+# digest-kangarootwelve
 
-The digest-kangarootwelve gem is an implementation of KangarooTwelve for Ruby
-that works on top of `Digest::Base`.
+This gem is an implementation of KangarooTwelve for Ruby that works on top of
+the `Digest::Base` class.
 
-It allows hashing with different digest lengths and different customization
-strings.
+It can be configured to produce outputs with different digest lengths, and can
+be initilized with different customization strings.
 
-See http://kangarootwelve.org/ to know more about the hashing algorithm.
+To know more about the KangarooTwelve algorithm, visit
+https://keccak.team/kangarootwelve.html.
 
-The core implementation was extracted/generated from the KCP
-(https://github.com/gvanas/KeccakCodePackage).
+The core implementation of KangarooTwelve is part of the
+[XKCP](https://github.com/XKCP/XKCP) project.
 
-KCP provides implementations on many target platforms.  This gem used to only
-have the `compact` implementation, but it now has adopted all of them.
+XKCP provides multiple targets for different architecture-dependent builds.
 
-The available implementation targets are `armv6m`, `armv7a`, `armv7m`, `armv8a`,
-`asmx86-64`, `asmx86-64shld`, `avr8`, `bulldozer`, `compact`, `generic32`,
-`generic32lc`, `generic64`, `generic64lc`, `haswell`, `nehalem`, `reference`,
-`reference32bits`, `sandybridge`, and `skylakex`, with `compact`  being the
-default.
+This gem can be configured to compile differently based on the target specified.
 
-Instructions on how to select a target is written below.
+The current target implementations are `armv6`, `armv6m`, `armv7a`, `armv7m`,
+`armv8a`, `avr8`, `avx`, `avx2`, `avx2noasm`, `avx512`, `avx512noasm`,
+`compact`, `generic32`, `generic32lc`, `generic64`, `generic64lc`, `reference`,
+`reference32bits`, `ssse3`, and `xop`, with `compact` being the default target.
+
+Details on what architectures these targets support are provided in the
+[README.markdown](https://github.com/XKCP/XKCP/blob/master/README.markdown) file
+of XKCP.
 
 ## Installation
 
-Add this line to the application's Gemfile:
+To use the gem in an application, add the following line to the application's
+Gemfile:
 
     gem 'digest-kangarootwelve'
 
 And then execute:
 
-    $ bundle
+    bundle
+
+The gem can also be installed manually using the `gem` command:
+
+    gem install digest-kangarootwelve
 
-It can also be installed manually with:
+To build and install the gem against a different platform target, use a
+`--with-target` option that follows a `--`.  Example:
 
-    $ gem install digest-kangarootwelve
+    gem install digest-kangarootwelve -- --with-target=avx
 
-To install with a different platform target, use `--with-target`.  Example:
+Targets may also need `CFLAGS` specified.  Please see the
+[Build failures](#build-failures) section.
 
-    $ gem install digest-kangarootwelve -- --with-target=sandybridge
+It's also a good idea to test the gem before actively using it, especially when
+using a not so commonly used target.  Here's one way to test it:
 
-It's a good idea to test the gem when using a different target platform other
-than default as some platforms are not yet tested, and behavior of optimized
-code can vary on different machines or compilers.  This can be done by running
-the following command.  Replace VERSION with the installed gem's version.
+    cd GEM_DIR/gems/digest-kangarootwelve-VERSION
+    bundle
+    rake test
 
-    $ ( cd "$(ruby -e 'puts Gem.dir')"/gems/digest-kangarootwelve-VERSION && bundle && rake test )
+To know the right value of GEM_DIR, try running `gem info digest-kangarootwelve`.
 
-The library can also be installed in Gentoo system-wide using 'layman':
+## Installing in Gentoo
 
-    # Fetch remote list of overlays, and add 'konsolebox' overlay
+The library can also be globally installed in Gentoo using `layman`:
+
+    # Fetch remote list of overlays, and add 'konsolebox' overlay.
     layman -f && layman -a konsolebox
 
-    # Unmask unstable keyword
-    echo 'dev-ruby/digest-kangarootwelve' > /etc/portage/package.keywords/dev-ruby.digest-kangarootwelve
+    # Unmask unstable keyword.
+    echo 'dev-ruby/digest-kangarootwelve' > /etc/portage/package.accept_keywords/dev-ruby.digest-kangarootwelve
 
-    # Merge package
+    # Merge package.
     emerge dev-ruby/digest-kangarootwelve
 
+## Testing from source
+
+The gem can also be tested from source using the following commands:
+
+    # Clone this repo.
+    git clone https://github.com/konsolebox/digest-kangarootwelve-ruby.git -b master
+
+    # Change to directory.
+    cd digest-kangarootwelve-ruby
+
+    # Optionally checkout a tagged version.
+    git checkout v0.4.0
+
+    # Run bundle
+    bundle
+
+    # Finally run `rake` to compile the extension and test the gem.
+    rake
+
+    # A different target can also be specified.  Example:
+    rake clean clobber && rake -- --with-target=avx
+
+## Build failures
+
+Targets like AVX2 may fail to build unless an explicit `CFLAGS` with proper
+architecture-related options is specified.
+
+Specifying a `CFLAGS` can be done by using the `--with-cflags` option.  For example:
+
+    rake -- --with-target=avx2 --with-cflags="-march=native"
+
+    gem install digest-kangarootwelve -- --with-target=avx2 --with-cflags="-march=native"
+
+    bundle config build.digest-kangarootwelve --with-target=avx2 --with-cflags="-march=native"
+
+Compact (the default target) and AVX targets have been tested to not need a
+`CFLAGS` to compile and work.
+
+Please note that this gem has not been tested to work with cross-compilations,
+so please test the resulting runtime thoroughly.
+
 ## Example Usage
 
     Digest::KangarooTwelve[32].digest("abc")
@@ -113,5 +166,5 @@ https://rubygems.org/gems/digest-kangarootwelve
 4. Push to the branch (`git push origin my-new-feature`).
 5. Create a new Pull Request.
 
-[![Build Status](https://travis-ci.org/konsolebox/digest-kangarootwelve-ruby.svg?branch=master)](https://travis-ci.org/konsolebox/digest-kangarootwelve-ruby)
-[![Build status](https://ci.appveyor.com/api/projects/status/bwedifhi4wa5wik7?svg=true)](https://ci.appveyor.com/project/konsolebox/digest-kangarootwelve-ruby)
+[![Build Status](https://github.com/konsolebox/digest-kangarootwelve-ruby/actions/workflows/ruby.yml/badge.svg)](https://github.com/konsolebox/digest-kangarootwelve-ruby/actions/workflows/ruby.yml)
+[![Build Status](https://ci.appveyor.com/api/projects/status/bwedifhi4wa5wik7?svg=true)](https://ci.appveyor.com/project/konsolebox/digest-kangarootwelve-ruby)

data/Rakefile

@@ -1,18 +1,72 @@
-# build, clean, clobber, install, install:local, release[remote]
+# build, clean, clobber, release[remote]
 require 'bundler/gem_tasks'
 
-# clean, clobber, compile, compile:digest/kangarootwelve
+# compile, compile:digest/kangarootwelve
 require 'rake/extensiontask'
 Rake::ExtensionTask.new('digest/kangarootwelve', Bundler::GemHelper.gemspec)
 
+# initialize_xkcp
+desc "Initialize and update XKCP submodule"
+task :initialize_xkcp => ".git" do |t|
+  puts "Initializing and updating XKCP submodule"
+  system "git submodule init && git submodule update -f"
+end
+
+file "XKCP/Makefile.build" => :initialize_xkcp
+file "XKCP/README.markdown" => :initialize_xkcp
+
+# import_xkcp_license
+task :import_xkcp_license do
+  Rake::Task["XKCP/README.markdown"].invoke
+  puts "Extracting XKCP license from \"XKCP/README.markdown\" and saving it to \"LICENSE.XKCP\"."
+  license = File.binread("XKCP/README.markdown")
+                .scan(/# Under which license is the XKCP.*?(?=^#)/m).first
+  raise "No license extracted" unless license
+  File.binwrite("LICENSE.XKCP", license.strip + "\n")
+end.instance_eval do
+  def needed?
+    !File.exist?("LICENSE.XKCP") || File.exist?("XKCP/README.markdown") &&
+        File.mtime("LICENSE.XKCP") < File.mtime("XKCP/README.markdown")
+  end
+end
+
+Rake::Task[:build].prerequisites.unshift :import_xkcp_license
+
+# import_xkcp_files_lazy
+task :import_xkcp_files_lazy do
+  Rake::Task[:import_xkcp_files].invoke
+end.instance_eval do
+  def needed?
+    %w[XKCP targets].any?{ |dir| !File.exist?("ext/digest/kangarootwelve/#{dir}") }
+  end
+end
+
+Rake::Task[:build].prerequisites.unshift :import_xkcp_files_lazy
+Rake::Task[:compile].prerequisites.unshift :import_xkcp_files_lazy
+
+# compile_lazy
+task :compile_lazy do
+  Rake::Task[:compile].invoke
+end.instance_eval do
+  def needed?
+    !File.exist?("lib/digest/kangarootwelve.so")
+  end
+end
+
 # test
 require 'rake/testtask'
-Rake::TestTask.new(:test) do |t|
+Rake::TestTask.new(:test => :compile_lazy) do |t|
   t.test_files = FileList['test/test.rb']
   t.verbose = true
 end
 
-# Set 'test' as default task.
+# default
 task :default => [:compile, :test]
 
+if File.exist?(".git")
+  CLOBBER.include "LICENSE.XKCP"
+  CLOBBER.include "ext/digest/kangarootwelve/XKCP"
+  CLOBBER.include "ext/digest/kangarootwelve/targets"
+end
+
 # Run `rake --tasks` or `rake --tasks --all` for a list of tasks.

data/digest-kangarootwelve.gemspec

@@ -1,338 +1,47 @@
 # coding: utf-8
 
-lib = File.expand_path('../lib', __FILE__)
+lib = File.expand_path("../lib", __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'digest/kangarootwelve/version'
+require 'find'
 
 Gem::Specification.new do |spec|
-  spec.name          = 'digest-kangarootwelve'
+  spec.name          = "digest-kangarootwelve"
   spec.version       = Digest::KangarooTwelve::VERSION
-  spec.authors       = ['konsolebox']
-  spec.email         = ['konsolebox@gmail.com']
-  spec.summary       = 'KangarooTwelve for Ruby'
-  spec.description   = 'A KangarooTwelve library that works on top of Digest::Base.'
-  spec.homepage      = 'https://github.com/konsolebox/digest-kangarootwelve-ruby'
-  spec.license       = 'MIT'
+  spec.authors       = ["konsolebox"]
+  spec.email         = ["konsolebox@gmail.com"]
+  spec.summary       = "KangarooTwelve for Ruby"
+  spec.description   = "A KangarooTwelve library that utilizes the XKCP package and can be " \
+                       "optionally optimized during compile-time based on a target. It produces " \
+                       "implementation classes that work on top of Digest::Base and conform " \
+                       "with how Digest classes work."
+  spec.homepage      = "https://github.com/konsolebox/digest-kangarootwelve-ruby"
+  spec.license       = "MIT"
 
-  spec.required_ruby_version = '>= 2.2'
+  spec.required_ruby_version = ">= 2.2"
 
-  spec.files = %w{
+  spec.files = %w[
     Gemfile
     LICENSE
     README.md
     Rakefile
     digest-kangarootwelve.gemspec
-    ext/digest/kangarootwelve/extconf.rb
-    ext/digest/kangarootwelve/utils.h
-    ext/digest/kangarootwelve/keccak/armv6m/KangarooTwelve.link.c
-    ext/digest/kangarootwelve/keccak/armv6m/KeccakDuplexWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/armv6m/KeccakP-1600-SnP.h
-    ext/digest/kangarootwelve/keccak/armv6m/KeccakP-1600-times2-SnP.h
-    ext/digest/kangarootwelve/keccak/armv6m/KeccakP-1600-times2-on1.c
-    ext/digest/kangarootwelve/keccak/armv6m/KeccakP-1600-times4-SnP.h
-    ext/digest/kangarootwelve/keccak/armv6m/KeccakP-1600-times4-on1.c
-    ext/digest/kangarootwelve/keccak/armv6m/KeccakP-1600-times8-SnP.h
-    ext/digest/kangarootwelve/keccak/armv6m/KeccakP-1600-times8-on1.c
-    ext/digest/kangarootwelve/keccak/armv6m/KeccakP-1600-u2-32bi-armv6m-le-gcc.s
-    ext/digest/kangarootwelve/keccak/armv6m/KeccakSpongeWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/armv6m/PlSnP-Fallback.inc
-    ext/digest/kangarootwelve/keccak/armv6m/ext.link.c
-    ext/digest/kangarootwelve/keccak/armv7a/KangarooTwelve.link.c
-    ext/digest/kangarootwelve/keccak/armv7a/KeccakDuplexWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/armv7a/KeccakP-1600-SnP.h
-    ext/digest/kangarootwelve/keccak/armv7a/KeccakP-1600-armv7a-le-neon-gcc.s
-    ext/digest/kangarootwelve/keccak/armv7a/KeccakP-1600-inplace-pl2-armv7a-neon-le-gcc.s
-    ext/digest/kangarootwelve/keccak/armv7a/KeccakP-1600-times2-SnP.h
-    ext/digest/kangarootwelve/keccak/armv7a/KeccakP-1600-times4-SnP.h
-    ext/digest/kangarootwelve/keccak/armv7a/KeccakP-1600-times4-on2.c
-    ext/digest/kangarootwelve/keccak/armv7a/KeccakP-1600-times8-SnP.h
-    ext/digest/kangarootwelve/keccak/armv7a/KeccakP-1600-times8-on2.c
-    ext/digest/kangarootwelve/keccak/armv7a/KeccakSpongeWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/armv7a/PlSnP-Fallback.inc
-    ext/digest/kangarootwelve/keccak/armv7a/ext.link.c
-    ext/digest/kangarootwelve/keccak/armv7m/KangarooTwelve.link.c
-    ext/digest/kangarootwelve/keccak/armv7m/KeccakDuplexWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/armv7m/KeccakP-1600-SnP.h
-    ext/digest/kangarootwelve/keccak/armv7m/KeccakP-1600-inplace-32bi-armv7m-le-gcc.s
-    ext/digest/kangarootwelve/keccak/armv7m/KeccakP-1600-times2-SnP.h
-    ext/digest/kangarootwelve/keccak/armv7m/KeccakP-1600-times2-on1.c
-    ext/digest/kangarootwelve/keccak/armv7m/KeccakP-1600-times4-SnP.h
-    ext/digest/kangarootwelve/keccak/armv7m/KeccakP-1600-times4-on1.c
-    ext/digest/kangarootwelve/keccak/armv7m/KeccakP-1600-times8-SnP.h
-    ext/digest/kangarootwelve/keccak/armv7m/KeccakP-1600-times8-on1.c
-    ext/digest/kangarootwelve/keccak/armv7m/KeccakSpongeWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/armv7m/PlSnP-Fallback.inc
-    ext/digest/kangarootwelve/keccak/armv7m/ext.link.c
-    ext/digest/kangarootwelve/keccak/armv8a/KangarooTwelve.link.c
-    ext/digest/kangarootwelve/keccak/armv8a/KeccakDuplexWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/armv8a/KeccakP-1600-SnP.h
-    ext/digest/kangarootwelve/keccak/armv8a/KeccakP-1600-armv8a-neon.s
-    ext/digest/kangarootwelve/keccak/armv8a/KeccakP-1600-times2-SnP.h
-    ext/digest/kangarootwelve/keccak/armv8a/KeccakP-1600-times2-on1.c
-    ext/digest/kangarootwelve/keccak/armv8a/KeccakP-1600-times4-SnP.h
-    ext/digest/kangarootwelve/keccak/armv8a/KeccakP-1600-times4-on1.c
-    ext/digest/kangarootwelve/keccak/armv8a/KeccakP-1600-times8-SnP.h
-    ext/digest/kangarootwelve/keccak/armv8a/KeccakP-1600-times8-on1.c
-    ext/digest/kangarootwelve/keccak/armv8a/KeccakSpongeWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/armv8a/PlSnP-Fallback.inc
-    ext/digest/kangarootwelve/keccak/armv8a/ext.link.c
-    ext/digest/kangarootwelve/keccak/asmx86-64shld/KangarooTwelve.link.c
-    ext/digest/kangarootwelve/keccak/asmx86-64shld/KeccakDuplexWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/asmx86-64shld/KeccakP-1600-SnP.h
-    ext/digest/kangarootwelve/keccak/asmx86-64shld/KeccakP-1600-times2-SnP.h
-    ext/digest/kangarootwelve/keccak/asmx86-64shld/KeccakP-1600-times2-on1.c
-    ext/digest/kangarootwelve/keccak/asmx86-64shld/KeccakP-1600-times4-SnP.h
-    ext/digest/kangarootwelve/keccak/asmx86-64shld/KeccakP-1600-times4-on1.c
-    ext/digest/kangarootwelve/keccak/asmx86-64shld/KeccakP-1600-times8-SnP.h
-    ext/digest/kangarootwelve/keccak/asmx86-64shld/KeccakP-1600-times8-on1.c
-    ext/digest/kangarootwelve/keccak/asmx86-64shld/KeccakP-1600-x86-64-shld-gas.s
-    ext/digest/kangarootwelve/keccak/asmx86-64shld/KeccakSpongeWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/asmx86-64shld/PlSnP-Fallback.inc
-    ext/digest/kangarootwelve/keccak/asmx86-64shld/ext.link.c
-    ext/digest/kangarootwelve/keccak/asmx86-64/KangarooTwelve.link.c
-    ext/digest/kangarootwelve/keccak/asmx86-64/KeccakDuplexWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/asmx86-64/KeccakP-1600-SnP.h
-    ext/digest/kangarootwelve/keccak/asmx86-64/KeccakP-1600-times2-SnP.h
-    ext/digest/kangarootwelve/keccak/asmx86-64/KeccakP-1600-times2-on1.c
-    ext/digest/kangarootwelve/keccak/asmx86-64/KeccakP-1600-times4-SnP.h
-    ext/digest/kangarootwelve/keccak/asmx86-64/KeccakP-1600-times4-on1.c
-    ext/digest/kangarootwelve/keccak/asmx86-64/KeccakP-1600-times8-SnP.h
-    ext/digest/kangarootwelve/keccak/asmx86-64/KeccakP-1600-times8-on1.c
-    ext/digest/kangarootwelve/keccak/asmx86-64/KeccakP-1600-x86-64-gas.s
-    ext/digest/kangarootwelve/keccak/asmx86-64/KeccakSpongeWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/asmx86-64/PlSnP-Fallback.inc
-    ext/digest/kangarootwelve/keccak/asmx86-64/ext.link.c
-    ext/digest/kangarootwelve/keccak/avr8/KangarooTwelve.link.c
-    ext/digest/kangarootwelve/keccak/avr8/KeccakDuplexWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/avr8/KeccakP-1600-SnP.h
-    ext/digest/kangarootwelve/keccak/avr8/KeccakP-1600-avr8-fast.s
-    ext/digest/kangarootwelve/keccak/avr8/KeccakP-1600-times2-SnP.h
-    ext/digest/kangarootwelve/keccak/avr8/KeccakP-1600-times2-on1.c
-    ext/digest/kangarootwelve/keccak/avr8/KeccakP-1600-times4-SnP.h
-    ext/digest/kangarootwelve/keccak/avr8/KeccakP-1600-times4-on1.c
-    ext/digest/kangarootwelve/keccak/avr8/KeccakP-1600-times8-SnP.h
-    ext/digest/kangarootwelve/keccak/avr8/KeccakP-1600-times8-on1.c
-    ext/digest/kangarootwelve/keccak/avr8/KeccakSpongeWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/avr8/PlSnP-Fallback.inc
-    ext/digest/kangarootwelve/keccak/avr8/ext.link.c
-    ext/digest/kangarootwelve/keccak/bulldozer/KangarooTwelve.link.c
-    ext/digest/kangarootwelve/keccak/bulldozer/KeccakDuplexWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/bulldozer/KeccakP-1600-SnP.h
-    ext/digest/kangarootwelve/keccak/bulldozer/KeccakP-1600-XOP.c
-    ext/digest/kangarootwelve/keccak/bulldozer/KeccakP-1600-XOP-config.h
-    ext/digest/kangarootwelve/keccak/bulldozer/KeccakP-1600-times2-SIMD128.c
-    ext/digest/kangarootwelve/keccak/bulldozer/KeccakP-1600-times2-SnP.h
-    ext/digest/kangarootwelve/keccak/bulldozer/KeccakP-1600-times4-SnP.h
-    ext/digest/kangarootwelve/keccak/bulldozer/KeccakP-1600-times4-on2.c
-    ext/digest/kangarootwelve/keccak/bulldozer/KeccakP-1600-times8-SnP.h
-    ext/digest/kangarootwelve/keccak/bulldozer/KeccakP-1600-times8-on2.c
-    ext/digest/kangarootwelve/keccak/bulldozer/KeccakP-1600-unrolling.macros
-    ext/digest/kangarootwelve/keccak/bulldozer/KeccakSpongeWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/bulldozer/PlSnP-Fallback.inc
-    ext/digest/kangarootwelve/keccak/bulldozer/SIMD128-config.h
-    ext/digest/kangarootwelve/keccak/bulldozer/SnP-Relaned.h
-    ext/digest/kangarootwelve/keccak/bulldozer/ext.link.c
-    ext/digest/kangarootwelve/keccak/common/KangarooTwelve.c
-    ext/digest/kangarootwelve/keccak/common/KangarooTwelve.h
-    ext/digest/kangarootwelve/keccak/common/KeccakDuplex.inc
-    ext/digest/kangarootwelve/keccak/common/KeccakDuplexWidth1600.c
-    ext/digest/kangarootwelve/keccak/common/KeccakDuplexWidth1600.h
-    ext/digest/kangarootwelve/keccak/common/KeccakDuplex-common.h
-    ext/digest/kangarootwelve/keccak/common/KeccakSponge.inc
-    ext/digest/kangarootwelve/keccak/common/KeccakSpongeWidth1600.c
-    ext/digest/kangarootwelve/keccak/common/KeccakSpongeWidth1600.h
-    ext/digest/kangarootwelve/keccak/common/KeccakSponge-common.h
-    ext/digest/kangarootwelve/keccak/common/Phases.h
-    ext/digest/kangarootwelve/keccak/common/align.h
-    ext/digest/kangarootwelve/keccak/common/brg_endian.h
-    ext/digest/kangarootwelve/keccak/compact/KangarooTwelve.link.c
-    ext/digest/kangarootwelve/keccak/compact/KeccakDuplexWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/compact/KeccakP-1600-SnP.h
-    ext/digest/kangarootwelve/keccak/compact/KeccakP-1600-compact64.c
-    ext/digest/kangarootwelve/keccak/compact/KeccakP-1600-times2-SnP.h
-    ext/digest/kangarootwelve/keccak/compact/KeccakP-1600-times2-on1.c
-    ext/digest/kangarootwelve/keccak/compact/KeccakP-1600-times4-SnP.h
-    ext/digest/kangarootwelve/keccak/compact/KeccakP-1600-times4-on1.c
-    ext/digest/kangarootwelve/keccak/compact/KeccakP-1600-times8-SnP.h
-    ext/digest/kangarootwelve/keccak/compact/KeccakP-1600-times8-on1.c
-    ext/digest/kangarootwelve/keccak/compact/KeccakSpongeWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/compact/PlSnP-Fallback.inc
-    ext/digest/kangarootwelve/keccak/compact/SnP-Relaned.h
-    ext/digest/kangarootwelve/keccak/compact/ext.link.c
-    ext/digest/kangarootwelve/keccak/generic32lc/KangarooTwelve.link.c
-    ext/digest/kangarootwelve/keccak/generic32lc/KeccakDuplexWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/generic32lc/KeccakP-1600-SnP.h
-    ext/digest/kangarootwelve/keccak/generic32lc/KeccakP-1600-inplace32BI.c
-    ext/digest/kangarootwelve/keccak/generic32lc/KeccakP-1600-times2-SnP.h
-    ext/digest/kangarootwelve/keccak/generic32lc/KeccakP-1600-times2-on1.c
-    ext/digest/kangarootwelve/keccak/generic32lc/KeccakP-1600-times4-SnP.h
-    ext/digest/kangarootwelve/keccak/generic32lc/KeccakP-1600-times4-on1.c
-    ext/digest/kangarootwelve/keccak/generic32lc/KeccakP-1600-times8-SnP.h
-    ext/digest/kangarootwelve/keccak/generic32lc/KeccakP-1600-times8-on1.c
-    ext/digest/kangarootwelve/keccak/generic32lc/KeccakSpongeWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/generic32lc/PlSnP-Fallback.inc
-    ext/digest/kangarootwelve/keccak/generic32lc/SnP-Relaned.h
-    ext/digest/kangarootwelve/keccak/generic32lc/ext.link.c
-    ext/digest/kangarootwelve/keccak/generic32/KangarooTwelve.link.c
-    ext/digest/kangarootwelve/keccak/generic32/KeccakDuplexWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/generic32/KeccakP-1600-SnP.h
-    ext/digest/kangarootwelve/keccak/generic32/KeccakP-1600-inplace32BI.c
-    ext/digest/kangarootwelve/keccak/generic32/KeccakP-1600-times2-SnP.h
-    ext/digest/kangarootwelve/keccak/generic32/KeccakP-1600-times2-on1.c
-    ext/digest/kangarootwelve/keccak/generic32/KeccakP-1600-times4-SnP.h
-    ext/digest/kangarootwelve/keccak/generic32/KeccakP-1600-times4-on1.c
-    ext/digest/kangarootwelve/keccak/generic32/KeccakP-1600-times8-SnP.h
-    ext/digest/kangarootwelve/keccak/generic32/KeccakP-1600-times8-on1.c
-    ext/digest/kangarootwelve/keccak/generic32/KeccakSpongeWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/generic32/PlSnP-Fallback.inc
-    ext/digest/kangarootwelve/keccak/generic32/SnP-Relaned.h
-    ext/digest/kangarootwelve/keccak/generic32/ext.link.c
-    ext/digest/kangarootwelve/keccak/generic64lc/KangarooTwelve.link.c
-    ext/digest/kangarootwelve/keccak/generic64lc/KeccakDuplexWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/generic64lc/KeccakP-1600-64.macros
-    ext/digest/kangarootwelve/keccak/generic64lc/KeccakP-1600-SnP.h
-    ext/digest/kangarootwelve/keccak/generic64lc/KeccakP-1600-opt64.c
-    ext/digest/kangarootwelve/keccak/generic64lc/KeccakP-1600-opt64-config.h
-    ext/digest/kangarootwelve/keccak/generic64lc/KeccakP-1600-times2-SnP.h
-    ext/digest/kangarootwelve/keccak/generic64lc/KeccakP-1600-times2-on1.c
-    ext/digest/kangarootwelve/keccak/generic64lc/KeccakP-1600-times4-SnP.h
-    ext/digest/kangarootwelve/keccak/generic64lc/KeccakP-1600-times4-on1.c
-    ext/digest/kangarootwelve/keccak/generic64lc/KeccakP-1600-times8-SnP.h
-    ext/digest/kangarootwelve/keccak/generic64lc/KeccakP-1600-times8-on1.c
-    ext/digest/kangarootwelve/keccak/generic64lc/KeccakP-1600-unrolling.macros
-    ext/digest/kangarootwelve/keccak/generic64lc/KeccakSpongeWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/generic64lc/PlSnP-Fallback.inc
-    ext/digest/kangarootwelve/keccak/generic64lc/SnP-Relaned.h
-    ext/digest/kangarootwelve/keccak/generic64lc/ext.link.c
-    ext/digest/kangarootwelve/keccak/generic64/KangarooTwelve.link.c
-    ext/digest/kangarootwelve/keccak/generic64/KeccakDuplexWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/generic64/KeccakP-1600-64.macros
-    ext/digest/kangarootwelve/keccak/generic64/KeccakP-1600-SnP.h
-    ext/digest/kangarootwelve/keccak/generic64/KeccakP-1600-opt64.c
-    ext/digest/kangarootwelve/keccak/generic64/KeccakP-1600-opt64-config.h
-    ext/digest/kangarootwelve/keccak/generic64/KeccakP-1600-times2-SnP.h
-    ext/digest/kangarootwelve/keccak/generic64/KeccakP-1600-times2-on1.c
-    ext/digest/kangarootwelve/keccak/generic64/KeccakP-1600-times4-SnP.h
-    ext/digest/kangarootwelve/keccak/generic64/KeccakP-1600-times4-on1.c
-    ext/digest/kangarootwelve/keccak/generic64/KeccakP-1600-times8-SnP.h
-    ext/digest/kangarootwelve/keccak/generic64/KeccakP-1600-times8-on1.c
-    ext/digest/kangarootwelve/keccak/generic64/KeccakP-1600-unrolling.macros
-    ext/digest/kangarootwelve/keccak/generic64/KeccakSpongeWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/generic64/PlSnP-Fallback.inc
-    ext/digest/kangarootwelve/keccak/generic64/SnP-Relaned.h
-    ext/digest/kangarootwelve/keccak/generic64/ext.link.c
-    ext/digest/kangarootwelve/keccak/haswell/KangarooTwelve.link.c
-    ext/digest/kangarootwelve/keccak/haswell/KeccakDuplexWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/haswell/KeccakP-1600-AVX2.s
-    ext/digest/kangarootwelve/keccak/haswell/KeccakP-1600-SnP.h
-    ext/digest/kangarootwelve/keccak/haswell/KeccakP-1600-times2-SIMD128.c
-    ext/digest/kangarootwelve/keccak/haswell/KeccakP-1600-times2-SnP.h
-    ext/digest/kangarootwelve/keccak/haswell/KeccakP-1600-times4-SIMD256.c
-    ext/digest/kangarootwelve/keccak/haswell/KeccakP-1600-times4-SnP.h
-    ext/digest/kangarootwelve/keccak/haswell/KeccakP-1600-times8-SnP.h
-    ext/digest/kangarootwelve/keccak/haswell/KeccakP-1600-times8-on4.c
-    ext/digest/kangarootwelve/keccak/haswell/KeccakP-1600-unrolling.macros
-    ext/digest/kangarootwelve/keccak/haswell/KeccakSpongeWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/haswell/PlSnP-Fallback.inc
-    ext/digest/kangarootwelve/keccak/haswell/SIMD128-config.h
-    ext/digest/kangarootwelve/keccak/haswell/SIMD256-config.h
-    ext/digest/kangarootwelve/keccak/haswell/ext.link.c
-    ext/digest/kangarootwelve/keccak/nehalem/KangarooTwelve.link.c
-    ext/digest/kangarootwelve/keccak/nehalem/KeccakDuplexWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/nehalem/KeccakP-1600-64.macros
-    ext/digest/kangarootwelve/keccak/nehalem/KeccakP-1600-SnP.h
-    ext/digest/kangarootwelve/keccak/nehalem/KeccakP-1600-opt64.c
-    ext/digest/kangarootwelve/keccak/nehalem/KeccakP-1600-opt64-config.h
-    ext/digest/kangarootwelve/keccak/nehalem/KeccakP-1600-times2-SIMD128.c
-    ext/digest/kangarootwelve/keccak/nehalem/KeccakP-1600-times2-SnP.h
-    ext/digest/kangarootwelve/keccak/nehalem/KeccakP-1600-times4-SnP.h
-    ext/digest/kangarootwelve/keccak/nehalem/KeccakP-1600-times4-on2.c
-    ext/digest/kangarootwelve/keccak/nehalem/KeccakP-1600-times8-SnP.h
-    ext/digest/kangarootwelve/keccak/nehalem/KeccakP-1600-times8-on2.c
-    ext/digest/kangarootwelve/keccak/nehalem/KeccakP-1600-unrolling.macros
-    ext/digest/kangarootwelve/keccak/nehalem/KeccakSpongeWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/nehalem/PlSnP-Fallback.inc
-    ext/digest/kangarootwelve/keccak/nehalem/SIMD128-config.h
-    ext/digest/kangarootwelve/keccak/nehalem/SnP-Relaned.h
-    ext/digest/kangarootwelve/keccak/nehalem/ext.link.c
-    ext/digest/kangarootwelve/keccak/reference32bits/KangarooTwelve.link.c
-    ext/digest/kangarootwelve/keccak/reference32bits/KeccakDuplexWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/reference32bits/KeccakP-1600-SnP.h
-    ext/digest/kangarootwelve/keccak/reference32bits/KeccakP-1600-reference.h
-    ext/digest/kangarootwelve/keccak/reference32bits/KeccakP-1600-reference32BI.c
-    ext/digest/kangarootwelve/keccak/reference32bits/KeccakP-1600-times2-SnP.h
-    ext/digest/kangarootwelve/keccak/reference32bits/KeccakP-1600-times2-on1.c
-    ext/digest/kangarootwelve/keccak/reference32bits/KeccakP-1600-times4-SnP.h
-    ext/digest/kangarootwelve/keccak/reference32bits/KeccakP-1600-times4-on1.c
-    ext/digest/kangarootwelve/keccak/reference32bits/KeccakP-1600-times8-SnP.h
-    ext/digest/kangarootwelve/keccak/reference32bits/KeccakP-1600-times8-on1.c
-    ext/digest/kangarootwelve/keccak/reference32bits/KeccakSpongeWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/reference32bits/PlSnP-Fallback.inc
-    ext/digest/kangarootwelve/keccak/reference32bits/displayIntermediateValues.c
-    ext/digest/kangarootwelve/keccak/reference32bits/displayIntermediateValues.h
-    ext/digest/kangarootwelve/keccak/reference32bits/ext.link.c
-    ext/digest/kangarootwelve/keccak/reference/KangarooTwelve.link.c
-    ext/digest/kangarootwelve/keccak/reference/KeccakDuplexWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/reference/KeccakP-1600-SnP.h
-    ext/digest/kangarootwelve/keccak/reference/KeccakP-1600-reference.c
-    ext/digest/kangarootwelve/keccak/reference/KeccakP-1600-reference.h
-    ext/digest/kangarootwelve/keccak/reference/KeccakP-1600-times2-SnP.h
-    ext/digest/kangarootwelve/keccak/reference/KeccakP-1600-times2-on1.c
-    ext/digest/kangarootwelve/keccak/reference/KeccakP-1600-times4-SnP.h
-    ext/digest/kangarootwelve/keccak/reference/KeccakP-1600-times4-on1.c
-    ext/digest/kangarootwelve/keccak/reference/KeccakP-1600-times8-SnP.h
-    ext/digest/kangarootwelve/keccak/reference/KeccakP-1600-times8-on1.c
-    ext/digest/kangarootwelve/keccak/reference/KeccakSpongeWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/reference/PlSnP-Fallback.inc
-    ext/digest/kangarootwelve/keccak/reference/displayIntermediateValues.c
-    ext/digest/kangarootwelve/keccak/reference/displayIntermediateValues.h
-    ext/digest/kangarootwelve/keccak/reference/ext.link.c
-    ext/digest/kangarootwelve/keccak/sandybridge/KangarooTwelve.link.c
-    ext/digest/kangarootwelve/keccak/sandybridge/KeccakDuplexWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/sandybridge/KeccakP-1600-64.macros
-    ext/digest/kangarootwelve/keccak/sandybridge/KeccakP-1600-SnP.h
-    ext/digest/kangarootwelve/keccak/sandybridge/KeccakP-1600-opt64.c
-    ext/digest/kangarootwelve/keccak/sandybridge/KeccakP-1600-opt64-config.h
-    ext/digest/kangarootwelve/keccak/sandybridge/KeccakP-1600-times2-SIMD128.c
-    ext/digest/kangarootwelve/keccak/sandybridge/KeccakP-1600-times2-SnP.h
-    ext/digest/kangarootwelve/keccak/sandybridge/KeccakP-1600-times4-SnP.h
-    ext/digest/kangarootwelve/keccak/sandybridge/KeccakP-1600-times4-on2.c
-    ext/digest/kangarootwelve/keccak/sandybridge/KeccakP-1600-times8-SnP.h
-    ext/digest/kangarootwelve/keccak/sandybridge/KeccakP-1600-times8-on2.c
-    ext/digest/kangarootwelve/keccak/sandybridge/KeccakP-1600-unrolling.macros
-    ext/digest/kangarootwelve/keccak/sandybridge/KeccakSpongeWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/sandybridge/PlSnP-Fallback.inc
-    ext/digest/kangarootwelve/keccak/sandybridge/SIMD128-config.h
-    ext/digest/kangarootwelve/keccak/sandybridge/SnP-Relaned.h
-    ext/digest/kangarootwelve/keccak/sandybridge/ext.link.c
-    ext/digest/kangarootwelve/keccak/skylakex/KangarooTwelve.link.c
-    ext/digest/kangarootwelve/keccak/skylakex/KeccakDuplexWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/skylakex/KeccakP-1600-AVX512.c
-    ext/digest/kangarootwelve/keccak/skylakex/KeccakP-1600-AVX512-config.h
-    ext/digest/kangarootwelve/keccak/skylakex/KeccakP-1600-SnP.h
-    ext/digest/kangarootwelve/keccak/skylakex/KeccakP-1600-times2-SIMD512.c
-    ext/digest/kangarootwelve/keccak/skylakex/KeccakP-1600-times2-SnP.h
-    ext/digest/kangarootwelve/keccak/skylakex/KeccakP-1600-times4-SIMD512.c
-    ext/digest/kangarootwelve/keccak/skylakex/KeccakP-1600-times4-SnP.h
-    ext/digest/kangarootwelve/keccak/skylakex/KeccakP-1600-times8-SIMD512.c
-    ext/digest/kangarootwelve/keccak/skylakex/KeccakP-1600-times8-SnP.h
-    ext/digest/kangarootwelve/keccak/skylakex/KeccakSpongeWidth1600.link.c
-    ext/digest/kangarootwelve/keccak/skylakex/SIMD512-2-config.h
-    ext/digest/kangarootwelve/keccak/skylakex/SIMD512-4-config.h
-    ext/digest/kangarootwelve/keccak/skylakex/SIMD512-config.h
-    ext/digest/kangarootwelve/keccak/skylakex/ext.link.c
-    ext/digest/kangarootwelve/ext.c
     lib/digest/kangarootwelve/version.rb
+    rakelib/alt-install-task.rake
     test/test.rb
-  }
+  ]
+  spec.files += Find.find("ext").to_a
+  spec.files += ["LICENSE.XKCP"] if File.exist? "LICENSE.XKCP"
 
   spec.executables   = []
-  spec.test_files    = ['test/test.rb']
-  spec.require_paths = ['lib']
+  spec.test_files    = ["test/test.rb"]
+  spec.require_paths = ["lib"]
 
-  spec.add_development_dependency 'rake'
-  spec.add_development_dependency 'rake-compiler', '~> 1.0'
-  spec.add_development_dependency 'minitest', '~> 5.8'
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rake-compiler", "~> 1.0"
+  spec.add_development_dependency "minitest", "~> 5.8"
+  spec.add_development_dependency "nori"
+  spec.add_development_dependency "nokogiri"
 
   spec.extensions = %w[ext/digest/kangarootwelve/extconf.rb]
 end