Hash algorithms (digest)

All hash algorithms are located in the buddy.core.hash namespace.

Available hash algorithms:

Hash algorithm name Digest size
SHA1 160
SHA2 256, 384, 512
SHA3 256, 384, 512
MD5 128
Tiger 192
Blake2b 512
Skein 256, 512, 1024, arbitrary size
Whirlpool 512
RIPEMD128 128
RIPEMD160 160
RIPEMD256 256
RIPEMD320 320

Basic usage

Import namespace example:

(require '[buddy.core.hash :as hash])
(require '[buddy.core.codecs :refer :all])

Usage examples:

(hash/sha256 "foo bar")
;; -> #<byte[] [B@162a657e>

(-> (hash/sha256 "foo bar")
    (bytes->hex))
;; -> "fbc1a9f858ea9e177916964bd88c3d37b91a1e84412765e29950777f265c4b75"

Advanced usage

Hash functions are implemented using protocols and can be extended to other types. The default implementations come with support for file-like objects (*File*, URL, URI* and InputStream).

Make hash of file example:

;; Additional import for easy open files
(require '[clojure.java.io :as io])

(-> (hash/sha256 (io/input-stream "/tmp/some-file"))
    (bytes->hex))
;; -> "bba878639499c8449f69efbfc699413eebfaf41d4b7a7faa560bfaf7e93a43dd"

You can extend it for your own types using the buddy.core.hash/IDigest protocol:

(defprotocol Digest
  (-digest [data engine]))

NOTE: Functions like sha256 are aliases for the more generic function digest.