sha3 1.0.1 → 1.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 4eb74d4c4626be8751f643664a1820c0227a88dd
-  data.tar.gz: bb6c33da2459890eeb083874e209cbf75b3ca83e
+SHA256:
+  metadata.gz: ae66a849bd5438b3b6d3fa4f5d33505a75e6f64556bfacc21d0efcf03a7d41d8
+  data.tar.gz: dea6beac49eeaeb12829af4e87b36dfc19ac1b66bb7872a7c6884441a70cf814
 SHA512:
-  metadata.gz: ed137cc7d02d2c376b256c96f55bd430305fead1d00942cc251f7027c9651d08877b1a31372c9822cb8daf5fcebae689683b59c216d5bf3ffe413e179a5258cb
-  data.tar.gz: 1446633b9181a36ed9b0fa04a3d2a7593add059fbe473a496ad35b9c0837da9dd690b167d8bb2d2ea036b6dca60f83b644e8e0719e728d8883aa72064ed8a32d
+  metadata.gz: d374e5f716056d6d888d862f97bc07d433c74f4d721d2342cc09f7865571e47eec50f7b1ecd9b284aedb1c908393b0da249e0c474f5792e215097263928d9195
+  data.tar.gz: 6ea6442adf3c90ca8849576f8539835630d968a032b385447a9c95e2f4be97861910f510ba528dbe398990c2eb71fac6b3966816807571855b855afa8c6af15b

data/.rspec

@@ -1 +1,3 @@
---colour --format documentation
+--format documentation
+--color
+--require ./spec/spec_helper

data/.rubocop.yml

@@ -0,0 +1,6 @@
+AllCops:
+  NewCops: enable
+  TargetRubyVersion: 2.6
+
+Layout/LineLength:
+  Max: 120

data/Gemfile

@@ -1,3 +1,5 @@
-source "http://rubygems.org"
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
 
 gemspec

data/README.md

@@ -1,17 +1,17 @@
 # sha3  
 
-[![Gem Version](https://badge.fury.io/rb/sha3.svg)](https://badge.fury.io/rb/sha3) [![CI](https://secure.travis-ci.org/johanns/sha3.png)](https://secure.travis-ci.org/johanns/sha3) [![Dependencies](https://gemnasium.com/johanns/sha3.png)](https://gemnasium.com/johanns/sha3) [![CodeClimate](https://codeclimate.com/github/johanns/sha3.png)](https://codeclimate.com/github/johanns/sha3)
+[![Gem Version](https://badge.fury.io/rb/sha3.svg)](https://badge.fury.io/rb/sha3) [![Ruby](https://github.com/johanns/sha3/actions/workflows/main.yml/badge.svg)](https://github.com/johanns/sha3/actions/workflows/main.yml)
 
 **SHA3 for Ruby** is a native (C) binding to SHA3 (Keccak FIPS 202) cryptographic hashing algorithm.
 
-- Home :: [https://github.com/johanns/sha3#readme]()
-- Issues :: [https://github.com/johanns/sha3/issues]()
-- Documentation :: [http://rubydoc.info/gems/sha3/frames]()
+- [Home](https://github.com/johanns/sha3#readme)
+- [Issues](https://github.com/johanns/sha3/issues)
+- [Documentation](http://rubydoc.info/gems/sha3/frames)
 
 ## Warnings
 
-- Version 1.0+ breaks compatibility with previous versions of this gem.
-- Do NOT use SHA3 to hash passwords; use either ```bcrypt``` or ```scrypt``` instead!
+- Please do NOT use SHA3 to hash passwords -- use a slow hashing function instead (e.g.: `pbkdf2`, `argon2`, `bcrypt` or `scrypt`)
+- Version 1.0 introduces new API and is incompatible with previous versions (0.x).
 
 ## Module details
 
@@ -97,7 +97,7 @@ s = SHA3::Digest.file("tests.sh")
 * Native build tools (e.g., GCC, Minigw, etc.)
 * Gems: rubygems-tasks, rake, rspec, yard
 
-### Testing + RSpec
+### Testing
 
 Call ```rake``` to run the included RSpec tests.
 
@@ -107,39 +107,14 @@ Only a small subset of test vectors are included in the source repository; howev
 
 ### Rubies
 
-Tested with Rubies:
+Supported Ruby versions:
 
-  - MRI Ruby-Head
-  - MRI 2.1.0
-  - MRI 2.0.0
-  - MRI 1.9.3
-  - MRI 1.9.2
-  - MRI 1.8.7
-  - Rubinius 2
+  - MRI Ruby 2.4 - 3.1
 
-On:
 
-  - Ubuntu 12.04, 12.10, 13.04, 14.04, 15.04
-  - Windows 7, 8, 8.1, 10
-  - Mac OS X 10.6 - 10.11
-
-## Releases
-
-- *1.0.1* :: FIPS 202 compliance (breaks compatibility with earlier releases)
-- *0.2.6* :: Fixed bug #4
-- *0.2.5* :: Bug fixes. (See ChangeLog.rdoc)
-- *0.2.4* :: Bug fixes. (YANKED)
-- *0.2.3* :: Added documentation file (decoupled form C source); refactored C source.
-- *0.2.2* :: Added sub-class for each SHA3 supported bit-lengths (example: SHA3::Digest::SHA256). Minor bug fix.
-- *0.2.0* :: Production worthy, but breaks API compatibility with 0.1.x. Backward-compatibility will be maintained henceforth.
-- *0.1.x* :: Alpha code, and not suitable for production.
-
-## TO DO
-
-- Add SHAKE128/256 support
 
 ## Copyright
 
-Copyright (c) 2012 - 2015 Johanns Gregorian (https://github.com/johanns)
+Copyright (c) 2012 - 2022 Johanns Gregorian (https://github.com/johanns)
 
 **See LICENSE.txt for details.**

data/Rakefile

@@ -1,56 +1,27 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
-require 'rubygems'
-require 'rake'
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
 
-begin
-  gem 'rubygems-tasks'
-  require 'rubygems/tasks'
+RSpec::Core::RakeTask.new(:spec)
 
-  Gem::Tasks.new
-rescue LoadError => e
-  warn e.message
-  warn "Run `gem install rubygems-tasks` to install Gem::Tasks."
-end
+require 'rubocop/rake_task'
 
-begin
-  gem 'rspec', '~> 3.3'
-  require 'rspec/core/rake_task'
+RuboCop::RakeTask.new
 
-  RSpec::Core::RakeTask.new
-rescue LoadError => e
-  task :spec do
-    abort "Please run `gem install rspec` to install RSpec."
-  end
-end
-
-task :test    => :spec
-task :default => [:compile, :spec]
+require 'rake/extensiontask'
 
 begin
-  gem 'yard'
-  require 'yard'
-
-  YARD::Rake::YardocTask.new
-rescue LoadError => e
-  task :yard do
-    abort "Please run `gem install yard` to install YARD."
-  end
-end
-task :doc => :yard
-
-begin
-  gem 'rake-compiler'
-  require 'rake/extensiontask'
-
-  Rake::ExtensionTask.new do |ext|
+  Rake::ExtensionTask.new :compile do |ext|
     ext.name = 'sha3_n'
     ext.ext_dir = 'ext/sha3'
     ext.tmp_dir = 'tmp'
-    ext.source_pattern = "*.{c}"
+    ext.source_pattern = '*.{c}'
   end
-rescue LoadError => e
+rescue LoadError
   task :compile do
-    abort "Please run `gem install rake-compiler` to install Rake-Compiler."
+    abort 'Please run `gem install rake-compiler` to install Rake-Compiler.'
   end
 end
+
+task default: %i[compile spec]

data/certs/johanns.pem

@@ -0,0 +1,24 @@
+-----BEGIN CERTIFICATE-----
+MIIEFDCCAnygAwIBAgIBATANBgkqhkiG9w0BAQsFADAaMRgwFgYDVQQDDA9pby9E
+Qz1qc2cvREM9aW8wHhcNMjIwMzA5MDcyODEwWhcNMjMwMzA5MDcyODEwWjAaMRgw
+FgYDVQQDDA9pby9EQz1qc2cvREM9aW8wggGiMA0GCSqGSIb3DQEBAQUAA4IBjwAw
+ggGKAoIBgQCuPwkDs4uoBV6pQhKp3uA58LkDPRR7VoI4QryuH7PbIwuO3xbuyR6T
+xEqwcb9GgVnMxiFyXeVkWiriuGXqZ26Pp5zH/xxQNgPGCIyXuXeJMpASkWjJ9J6h
++jOdaG5jdL6zRcw/5XaJSQTLGO32BNOIezUZCF9JtMoEBQYHRWFjoD5BryjYnU3f
+SstXg9nD8KOyk5Vzqk/wvJs5X+b2jcZL0KmSP1UgaCakfTCKf8LA9I5zAbvv2M9n
+F0JQfKw4AUlmykzmOMEsITVxtM8lIVxm99KAS+lFn19xEjOs7nr3GktyLJxav8qI
+3yXW/q5wUbOFrj/e1tk6r/W3bM6TQzGFBsBJgXEoFFZ+OQdEW8PXU0H5CIg59SxB
+lXwSC1rKlxSeGNcKDXeIN1AU3pqv/PJj2SKg2+uQ9Staya0Mtek/caPDVfIy8AgH
+ulTeTVN7m5SdVjVBl3rIehH/j0R/JF7ygsMkJEQAxrwPxqmazXkPAGLNNIqppaxi
+VyHhxSnGefUCAwEAAaNlMGMwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0O
+BBYEFBZFuuJYra4ctzMvtfzlTq3pW4idMBQGA1UdEQQNMAuBCWlvQGpzZy5pbzAU
+BgNVHRIEDTALgQlpb0Bqc2cuaW8wDQYJKoZIhvcNAQELBQADggGBAF2jXh+4LzPg
+Mj8gTCVTxj4/OhQ303cS5gasgh+R9Zxcf1cfTXOxEeIXdrqJiMhILWVWgCYZxagL
+B5pU6MOyIOi4XAm5RMO3mIyTrY05Q/JbQ5j2ccuIOlL+XvhjAYKZmt9BkJLKfLEp
+hagXHZe40Hd3qwkgJ3ug3T28gkBWaTq8FSbTOfCVX9uNjQrukAP/VrfnKZiNnpJ7
+FOtEKDk3l9JWCyX8LQwfljPmQhvFHYnMRyt0l2b0I5li6MWUE4JmrbtK8/Fyo0I0
+PChRryVpy0HnKvqoKQyqeMspLbbKCsO1PRS5VFZ/ybrPy63paFPdikeKMZIH3oJQ
+wePRJFEp3gdQZcSjfkzC38QFh9JuKFJFMC4Y3e5uVeeydEGGUekH1s/B5/EuBCRi
+vaoldWA6C6e/X/XQsMNdC04+d7IdgNRf8NkN/atZdJLcFVcaXGS9MncPZnwBC2GD
+GBMFs3s6mx0HRpclYTMXK71jLsfqtM2SriIbx1VqiuUMUtddNrGcOw==
+-----END CERTIFICATE-----

data/ext/sha3/digest.c

@@ -21,232 +21,250 @@ VALUE eSHA3DigestError;
 
 static void free_allox(MDX *mdx)
 {
-  if (mdx) {
-    if (mdx->state) {
-      free(mdx->state);
+    if (mdx)
+    {
+        if (mdx->state)
+        {
+            free(mdx->state);
+        }
+
+        free(mdx);
     }
 
-    free(mdx);
-  }
-
-  return;
+    return;
 }
 
 static VALUE c_digest_alloc(VALUE klass)
 {
-  MDX *mdx;
-  VALUE obj;
+    MDX *mdx;
+    VALUE obj;
 
-  mdx = (MDX *) malloc(sizeof(MDX));
-  if (!mdx) {
-    rb_raise(eSHA3DigestError, "failed to allocate object memory");
-  }
+    mdx = (MDX *)malloc(sizeof(MDX));
+    if (!mdx)
+    {
+        rb_raise(eSHA3DigestError, "failed to allocate object memory");
+    }
 
-  mdx->state = (Keccak_HashInstance *) malloc(sizeof(Keccak_HashInstance));
-  if (!mdx->state) {
-    free_allox(mdx);
-    rb_raise(eSHA3DigestError, "failed to allocate state memory");
-  }
+    mdx->state = (Keccak_HashInstance *)malloc(sizeof(Keccak_HashInstance));
+    if (!mdx->state)
+    {
+        free_allox(mdx);
+        rb_raise(eSHA3DigestError, "failed to allocate state memory");
+    }
 
-  obj = Data_Wrap_Struct(klass, 0, free_allox, mdx);
+    obj = Data_Wrap_Struct(klass, 0, free_allox, mdx);
 
-  memset(mdx->state, 0, sizeof(Keccak_HashInstance));
-  mdx->hashbitlen = 0;
+    memset(mdx->state, 0, sizeof(Keccak_HashInstance));
+    mdx->hashbitlen = 0;
 
-  return obj;
+    return obj;
 }
 
 static VALUE c_digest_update(VALUE, VALUE);
 
 HashReturn c_keccak_hash_initialize(MDX *mdx)
 {
-  HashReturn r = FAIL;
+    HashReturn r = FAIL;
 
-  switch (mdx->hashbitlen) {
+    switch (mdx->hashbitlen)
+    {
     case 224:
-      r = Keccak_HashInitialize_SHA3_224(mdx->state);
-      break;
+        r = Keccak_HashInitialize_SHA3_224(mdx->state);
+        break;
     case 256:
-      r = Keccak_HashInitialize_SHA3_256(mdx->state);
-      break;
+        r = Keccak_HashInitialize_SHA3_256(mdx->state);
+        break;
     case 384:
-      r = Keccak_HashInitialize_SHA3_384(mdx->state);
-      break;
+        r = Keccak_HashInitialize_SHA3_384(mdx->state);
+        break;
     case 512:
-      r = Keccak_HashInitialize_SHA3_512(mdx->state);
-      break;
+        r = Keccak_HashInitialize_SHA3_512(mdx->state);
+        break;
     }
 
-  return r;
+    return r;
 }
 
 // SHA3::Digest.new(type, [data]) -> self
 static VALUE c_digest_init(int argc, VALUE *argv, VALUE self)
 {
-  MDX *mdx;
-  VALUE hlen, data;
+    MDX *mdx;
+    VALUE hlen, data;
 
-  rb_scan_args(argc, argv, "02", &hlen, &data);
-  GETMDX(self, mdx);
+    rb_scan_args(argc, argv, "02", &hlen, &data);
+    GETMDX(self, mdx);
 
-  if (!NIL_P(hlen)) {
-    mdx->hashbitlen = get_hlen(hlen);
-  } else {
-    mdx->hashbitlen = 256;
-  }
+    if (!NIL_P(hlen))
+    {
+        mdx->hashbitlen = get_hlen(hlen);
+    }
+    else
+    {
+        mdx->hashbitlen = 256;
+    }
 
-  if (c_keccak_hash_initialize(mdx) != SUCCESS) {
-    rb_raise(eSHA3DigestError, "failed to initialize algorithm state");
-  }
+    if (c_keccak_hash_initialize(mdx) != SUCCESS)
+    {
+        rb_raise(eSHA3DigestError, "failed to initialize algorithm state");
+    }
 
-  if (!NIL_P(data)) {
-    return c_digest_update(self, data);
-  }
+    if (!NIL_P(data))
+    {
+        return c_digest_update(self, data);
+    }
 
-  return self;
+    return self;
 }
 
 // SHA3::Digest.update(data) -> self
 static VALUE c_digest_update(VALUE self, VALUE data)
 {
-  MDX *mdx;
-  DataLength dlen;
+    MDX *mdx;
+    DataLength dlen;
 
-  StringValue(data);
-  GETMDX(self, mdx);
+    StringValue(data);
+    GETMDX(self, mdx);
 
-  dlen = (RSTRING_LEN(data) * 8);
+    dlen = (RSTRING_LEN(data) * 8);
 
-  if (Keccak_HashUpdate(mdx->state, (BitSequence *) RSTRING_PTR(data), dlen) != SUCCESS) {
-    rb_raise(eSHA3DigestError, "failed to update hash data");
-  }
+    if (Keccak_HashUpdate(mdx->state, (BitSequence *)RSTRING_PTR(data), dlen) != SUCCESS)
+    {
+        rb_raise(eSHA3DigestError, "failed to update hash data");
+    }
 
-  return self;
+    return self;
 }
 
 // SHA3::Digest.reset() -> self
 static VALUE c_digest_reset(VALUE self)
 {
-  MDX *mdx;
+    MDX *mdx;
 
-  GETMDX(self, mdx);
+    GETMDX(self, mdx);
 
-  memset(mdx->state, 0, sizeof(Keccak_HashInstance));
+    memset(mdx->state, 0, sizeof(Keccak_HashInstance));
 
-  if (c_keccak_hash_initialize(mdx) != SUCCESS) {
-    rb_raise(eSHA3DigestError, "failed to reset internal state");
-  }
+    if (c_keccak_hash_initialize(mdx) != SUCCESS)
+    {
+        rb_raise(eSHA3DigestError, "failed to reset internal state");
+    }
 
-  return self;
+    return self;
 }
 
 static int cmp_states(MDX *mdx1, MDX *mdx2)
 {
     return (
-      (mdx1->hashbitlen == mdx2->hashbitlen) &&
-      (strcmp((const char *) mdx1->state->sponge.state, (const char *)mdx2->state->sponge.state) == 0) &&
-      (mdx1->state->sponge.rate == mdx2->state->sponge.rate) &&
-      (mdx1->state->sponge.byteIOIndex == mdx2->state->sponge.byteIOIndex) &&
-      (mdx1->state->sponge.squeezing == mdx2->state->sponge.squeezing) &&
-      (mdx1->state->fixedOutputLength == mdx2->state->fixedOutputLength) &&
-      (mdx1->state->delimitedSuffix == mdx2->state->delimitedSuffix)
-    );
+        (mdx1->hashbitlen == mdx2->hashbitlen) &&
+        (strcmp((const char *)mdx1->state->sponge.state, (const char *)mdx2->state->sponge.state) == 0) &&
+        (mdx1->state->sponge.rate == mdx2->state->sponge.rate) &&
+        (mdx1->state->sponge.byteIOIndex == mdx2->state->sponge.byteIOIndex) &&
+        (mdx1->state->sponge.squeezing == mdx2->state->sponge.squeezing) &&
+        (mdx1->state->fixedOutputLength == mdx2->state->fixedOutputLength) &&
+        (mdx1->state->delimitedSuffix == mdx2->state->delimitedSuffix));
 }
 
 // SHA3::Digest.copy(obj) -> self
 static VALUE c_digest_copy(VALUE self, VALUE obj)
 {
-  MDX *mdx1, *mdx2;
+    MDX *mdx1, *mdx2;
 
-  rb_check_frozen(self);
-  if (self == obj) {
-    return self;
-  }
+    rb_check_frozen(self);
+    if (self == obj)
+    {
+        return self;
+    }
+
+    GETMDX(self, mdx1);
+    SAFEGETMDX(obj, mdx2);
 
-  GETMDX(self, mdx1);
-  SAFEGETMDX(obj, mdx2);
+    memcpy(mdx1->state, mdx2->state, sizeof(Keccak_HashInstance));
+    mdx1->hashbitlen = mdx2->hashbitlen;
 
-  memcpy(mdx1->state, mdx2->state, sizeof(Keccak_HashInstance));
-  mdx1->hashbitlen = mdx2->hashbitlen;
+    // Fetch the data again to make sure it was copied
+    GETMDX(self, mdx1);
+    SAFEGETMDX(obj, mdx2);
 
-  // Fetch the data again to make sure it was copied
-  GETMDX(self, mdx1);
-  SAFEGETMDX(obj, mdx2);
-  if (!cmp_states(mdx1, mdx2)) {
-    rb_raise(eSHA3DigestError, "failed to copy state");
-  }
+    if (!cmp_states(mdx1, mdx2))
+    {
+        rb_raise(eSHA3DigestError, "failed to copy state");
+    }
 
-  return self;
+    return self;
 }
 
 // SHA3::Digest.digest_length -> Integer
 static VALUE c_digest_length(VALUE self)
 {
-  MDX *mdx;
-  GETMDX(self, mdx);
+    MDX *mdx;
+    GETMDX(self, mdx);
 
-  return ULL2NUM(mdx->hashbitlen / 8);
+    return ULL2NUM(mdx->hashbitlen / 8);
 }
 
 // SHA3::Digest.block_length -> Integer
 static VALUE c_digest_block_length(VALUE self)
 {
-  MDX *mdx;
-  GETMDX(self, mdx);
+    MDX *mdx;
+    GETMDX(self, mdx);
 
-  return ULL2NUM(200 - (2 * (mdx->hashbitlen / 8)));
+    return ULL2NUM(200 - (2 * (mdx->hashbitlen / 8)));
 }
 
 // SHA3::Digest.name -> String
 static VALUE c_digest_name(VALUE self)
 {
-  return rb_str_new2("SHA3");
+    return rb_str_new2("SHA3");
 }
 
 // SHA3::Digest.finish() -> String
 static VALUE c_digest_finish(int argc, VALUE *argv, VALUE self)
 {
-  MDX *mdx;
-  VALUE str;
+    MDX *mdx;
+    VALUE str;
 
-  rb_scan_args(argc, argv, "01", &str);
-  GETMDX(self, mdx);
+    rb_scan_args(argc, argv, "01", &str);
+    GETMDX(self, mdx);
 
-  if (NIL_P(str)) {
-    str = rb_str_new(0, mdx->hashbitlen / 8);
-  } else {
-    StringValue(str);
-    rb_str_resize(str, mdx->hashbitlen / 8);
-  }
+    if (NIL_P(str))
+    {
+        str = rb_str_new(0, mdx->hashbitlen / 8);
+    }
+    else
+    {
+        StringValue(str);
+        rb_str_resize(str, mdx->hashbitlen / 8);
+    }
 
-  if (Keccak_HashFinal(mdx->state, (BitSequence *) RSTRING_PTR(str)) != SUCCESS) {
-    rb_raise(eSHA3DigestError, "failed to finalize digest");
-  }
+    if (Keccak_HashFinal(mdx->state, (BitSequence *)RSTRING_PTR(str)) != SUCCESS)
+    {
+        rb_raise(eSHA3DigestError, "failed to finalize digest");
+    }
 
-  return str;
+    return str;
 }
 
 void Init_sha3_n_digest()
 {
-  rb_require("digest");
-
-  /* SHA3::Digest (class) */
-  cSHA3Digest = rb_define_class_under(mSHA3, "Digest", rb_path2class("Digest::Class"));
-  /* SHA3::Digest::DigestError (class) */
-  eSHA3DigestError = rb_define_class_under(cSHA3Digest, "DigestError", rb_eStandardError);
-
-  // SHA3::Digest (class) methods
-  rb_define_alloc_func(cSHA3Digest, c_digest_alloc);
-  rb_define_method(cSHA3Digest, "initialize", c_digest_init, -1);
-  rb_define_method(cSHA3Digest, "update", c_digest_update, 1);
-  rb_define_method(cSHA3Digest, "reset", c_digest_reset, 0);
-  rb_define_method(cSHA3Digest, "initialize_copy", c_digest_copy, 1);
-  rb_define_method(cSHA3Digest, "digest_length", c_digest_length, 0);
-  rb_define_method(cSHA3Digest, "block_length", c_digest_block_length, 0);
-  rb_define_method(cSHA3Digest, "name", c_digest_name, 0);
-  rb_define_private_method(cSHA3Digest, "finish", c_digest_finish, -1);
-
-  rb_define_alias(cSHA3Digest, "<<", "update");
-
-  return;
+    rb_require("digest");
+
+    /* SHA3::Digest (class) */
+    cSHA3Digest = rb_define_class_under(mSHA3, "Digest", rb_path2class("Digest::Class"));
+    /* SHA3::Digest::DigestError (class) */
+    eSHA3DigestError = rb_define_class_under(cSHA3Digest, "DigestError", rb_eStandardError);
+
+    // SHA3::Digest (class) methods
+    rb_define_alloc_func(cSHA3Digest, c_digest_alloc);
+    rb_define_method(cSHA3Digest, "initialize", c_digest_init, -1);
+    rb_define_method(cSHA3Digest, "update", c_digest_update, 1);
+    rb_define_method(cSHA3Digest, "reset", c_digest_reset, 0);
+    rb_define_method(cSHA3Digest, "initialize_copy", c_digest_copy, 1);
+    rb_define_method(cSHA3Digest, "digest_length", c_digest_length, 0);
+    rb_define_method(cSHA3Digest, "block_length", c_digest_block_length, 0);
+    rb_define_method(cSHA3Digest, "name", c_digest_name, 0);
+    rb_define_private_method(cSHA3Digest, "finish", c_digest_finish, -1);
+
+    rb_define_alias(cSHA3Digest, "<<", "update");
+
+    return;
 }

data/ext/sha3/digest.h

@@ -3,37 +3,45 @@
 #ifndef _DIGEST_H_
 #define _DIGEST_H_
 
-#ifdef  __cplusplus
-extern "C" {
+#ifdef __cplusplus
+extern "C"
+{
 #endif
 
 // From ruby/ext/openssl/ossl_digest.c
-#define GETMDX(obj, mdx) do {                                    \
-  Data_Get_Struct((obj), MDX, (mdx));                            \
-  if (!(mdx)) {                                                  \
-    rb_raise(rb_eRuntimeError, "Digest data not initialized!");  \
-  }                                                              \
-} while (0)
-
-#define SAFEGETMDX(obj, mdx) do {                                \
-  if (!rb_obj_is_kind_of(obj, cSHA3Digest)) {                        \
-    rb_raise(rb_eTypeError, "wrong argument (%s)! (expected %s)",\
-             rb_obj_classname(obj), rb_class2name(cSHA3Digest));     \
-  }                                                              \
-  GETMDX(obj, mdx);                                              \
-} while(0)
-
-extern VALUE cSHA3Digest;
-extern VALUE eSHA3DigestError;
-
-typedef struct {
-  Keccak_HashInstance *state;
-  int hashbitlen;
-} MDX;
-
-void Init_sha3_n_digest(void);
-
-#ifdef  __cplusplus
+#define GETMDX(obj, mdx)                                                \
+    do                                                                  \
+    {                                                                   \
+        Data_Get_Struct((obj), MDX, (mdx));                             \
+        if (!(mdx))                                                     \
+        {                                                               \
+            rb_raise(rb_eRuntimeError, "Digest data not initialized!"); \
+        }                                                               \
+    } while (0)
+
+#define SAFEGETMDX(obj, mdx)                                              \
+    do                                                                    \
+    {                                                                     \
+        if (!rb_obj_is_kind_of(obj, cSHA3Digest))                         \
+        {                                                                 \
+            rb_raise(rb_eTypeError, "wrong argument (%s)! (expected %s)", \
+                     rb_obj_classname(obj), rb_class2name(cSHA3Digest));  \
+        }                                                                 \
+        GETMDX(obj, mdx);                                                 \
+    } while (0)
+
+    extern VALUE cSHA3Digest;
+    extern VALUE eSHA3DigestError;
+
+    typedef struct
+    {
+        Keccak_HashInstance *state;
+        int hashbitlen;
+    } MDX;
+
+    void Init_sha3_n_digest(void);
+
+#ifdef __cplusplus
 }
 #endif