zkat / cacache
94%
latest: 89%

LAST BUILD BRANCH: greenkeeper/tap-14.4.0
DEFAULT BRANCH: latest
Repo Added
Files 22
Badge
Embed ▾
README BADGES
x

If you need to use a raster PNG badge, change the '.svg' to '.png' in the link

Markdown

Textile

RDoc

HTML

Rst

LAST BUILD ON BRANCH zkat/integrity
branch: zkat/integrity
CHANGE BRANCH
x

415

push

travis-ci

zkat 
feat(integrity): subresource integrity support

BREAKING CHANGE: The entire API has been overhauled to use SRI hashes instead of digest/hashAlgorithm pairs. SRI hashes follow the Subresource Integrity standard and support strings and objects compatible with [`ssri`](https://npm.im/ssri).

* This change bumps the index version, which will invalidate all previous index entries. Content entries will remain intact, and existing caches will automatically reuse any content from before this breaking change.

* `cacache.get.info()`, `cacache.ls(), and `cacache.ls.stream()` will now return objects that looks like this:

```
{
  key: String,
  integrity: '<algorithm>-<base64hash>',
  path: ContentPath,
  time: Date<ms>,
  metadata: Any
}
```

* `opts.digest` and `opts.hashAlgorithm` are obsolete for any API calls that used them.

* Anywhere `opts.digest` was accepted, `opts.integrity` is now an option. Any valid SRI hash is accepted here -- multiple hash entries will be resolved according to the standard: first, the "strongest" hash algorithm will be picked, and then each of the entries for that algorithm will be matched against the content. Content will be validated if *any* of the entries match (so, a single integrity string can be used for multiple "versions" of the same document/data).

* `put.byDigest()`, `put.stream.byDigest`, `get.byDigest()` and `get.stream.byDigest() now expect an SRI instead of a `digest` + `opts.hashAlgorithm` pairing.

* `get.hasContent()` now expects an integrity hash instead of a digest. If content exists, it will return the specific single integrity hash that was found in the cache.

* `verify()` has learned to handle integrity-based caches, and forgotten how to handle old-style cache indices due to the format change.

* `cacache.rm.content()` now expects an integrity hash instead of a hex digest.

204 of 258 branches covered (79.07%)

94 of 94 new or added lines in 10 files covered. (100.0%)

542 of 578 relevant lines covered (93.77%)

38.78 hits per line

Relevant lines Covered
578 RELEVANT LINES 542 COVERED LINES
38.78 HITS PER LINE
Source Files on zkat/integrity
Coverage ∆ File Lines Relevant Covered Missed Hits/Line Branch Hits Branch Misses

Recent builds

Builds Branch Commit Type Ran Committer Via Coverage
415 zkat/integrity feat(integrity): subresource integrity support BREAKING CHANGE: The entire API has been overhauled to use SRI hashes instead of digest/hashAlgorithm pairs. SRI hashes follow the Subresource Integrity standard and support strings and objects compa... push zkat travis-ci pending completion  
413 zkat/integrity fix(read): skip reading the filesystem if our integrity hash is single-entry push zkat travis-ci pending completion  
411 zkat/integrity docs: removed references to hexToIntegrity and integrityToHex push zkat travis-ci pending completion  
401 zkat/integrity docs: document new integrity api push zkat travis-ci pending completion  
See All Builds (638)