Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eddelbuettel/digest
R package to create compact hash digests of R objects
https://github.com/eddelbuettel/digest
cran hash-digest r r-package
Last synced: about 2 months ago
JSON representation
R package to create compact hash digests of R objects
- Host: GitHub
- URL: https://github.com/eddelbuettel/digest
- Owner: eddelbuettel
- Created: 2013-12-04T01:48:12.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2024-07-16T02:05:56.000Z (2 months ago)
- Last Synced: 2024-07-16T05:16:36.859Z (2 months ago)
- Topics: cran, hash-digest, r, r-package
- Language: C++
- Homepage: https://eddelbuettel.github.io/digest
- Size: 2.35 MB
- Stars: 109
- Watchers: 6
- Forks: 44
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog
Awesome Lists containing this project
- jimsghstars - eddelbuettel/digest - R package to create compact hash digests of R objects (C++)
README
## digest: Compact hash representations of arbitrary R objects
[](https://github.com/eddelbuettel/digest/actions?query=workflow%3Aci)
[](http://www.gnu.org/licenses/gpl-2.0.html)
[](https://cran.r-project.org/package=digest)
[](https://cran.r-project.org/package=digest)
[](https://packages.debian.org/sid/r-cran-digest)
[](https://eddelbuettel.r-universe.dev/digest)
[](https://www.r-pkg.org:443/pkg/digest)
[](https://www.r-pkg.org:443/pkg/digest)
[](https://cran.r-project.org/package=digest)
[](https://cran.r-project.org/package=digest)
[](https://cran.r-project.org/package=digest)
[](https://app.codecov.io/gh/eddelbuettel/digest)
[](https://github.com/eddelbuettel/digest)
[](https://eddelbuettel.github.io/digest/)
Compact hash representations of arbitrary R objects
### Overview
The digest package provides a principal function `digest()` for the creation
of hash digests of arbitrary R objects (using the md5, sha-1, sha-256, crc32,
xxhash, murmurhash, spookyhash, blake3, crc32c, xxh3\_64, and xxh3\_128
algorithms) permitting easy comparison of R language objects.
Extensive documentation is available at the [package documentation site](https://eddelbuettel.github.io/digest/).
#### Examples
As R can serialize any object, we can run `digest()` on any object:
```r
R> library(digest)
R> digest(trees)
[1] "12412cbfa6629c5c80029209b2717f08"
R> digest(lm(log(Height) ~ log(Girth), data=trees))
[1] "e25b62de327d079b3ccb98f3e96987b1"
R> digest(summary(lm(log(Height) ~ log(Girth), data=trees)))
[1] "86c8c979ee41a09006949e2ad95feb41"
R>
```
By using the hash sum, which is very likely to be unique, to identify an
underlying object or calculation, one can easily implement caching strategies.
This is a common use of the digest package.
#### Other Functions
A small number of additional functions is available:
- `sha1()` for numerally stable hashsums,
- `hmac()` for hashed message authentication codes based on a key,
- `AES()` for Advanced Encryption Standard block ciphers,
- `getVDigest()` as a function generator for vectorised versions.
### Note
Please note that this package is not meant to be deployed for
cryptographic purposes. More comprehensive and widely tested
libraries such as OpenSSL should be used instead.
### Installation
The package is on [CRAN](https://cran.r-project.org) and can be installed
via a standard
```r
install.packages("digest")
```
### Continued Testing
As we rely on the [tinytest](https://cran.r-project.org/package=tinytest) package, the
already-installed package can also be verified via
```r
tinytest::test_package("digest")
```
at any later point.
### Author
Dirk Eddelbuettel, with contributions by Antoine Lucas, Jarek Tuszynski,
Henrik Bengtsson, Simon Urbanek, Mario Frasca, Bryan Lewis, Murray Stokely,
Hannes Muehleisen, Duncan Murdoch, Jim Hester, Wush Wu, Qiang Kou, Thierry
Onkelinx, Michel Lang, Viliam Simko, Kurt Hornik, Radford Neal, Kendon Bell,
Matthew de Queljoe, Ion Suruceanu, Bill Denney, Dirk Schumacher, Winston
Chang, Dean Attali, and Michael Chirico.
### License
GPL (>= 2)