feat(i18n): Add Spanish translation and i18n setup (#91)

* deps: added y18n

* docs: a few readme tweaks + documenting setLocale

* docs: translate README to Spanish

* deps: add cross-env devDep

* feat(i18n): add Spanish localisation for messages

* fixup for docs

Author: zkat

README.es.md

@@ -8,6 +8,8 @@ get corrupted or manipulated.
 It was originally written to be used as [npm](https://npm.im)'s local cache, but
 can just as easily be used on its own
 
+_Translations: [español](README.es.md)_
+
 ## Install
 
 `$ npm install --save cacache`
@@ -33,6 +35,7 @@ can just as easily be used on its own
     * [`rm.entry`](#rm-entry)
     * [`rm.content`](#rm-content)
   * Utilities
+    * [`setLocale`](#set-locale)
     * [`clearMemoized`](#clear-memoized)
     * [`tmp.mkdir`](#tmp-mkdir)
     * [`tmp.withTmp`](#with-tmp)
@@ -105,7 +108,7 @@ Happy hacking!
 
 ### API
 
-#### <a name="ls"></a> `> cacache.ls(cache) -> Promise`
+#### <a name="ls"></a> `> cacache.ls(cache) -> Promise<Object>`
 
 Lists info for all entries currently in the cache as a single large object. Each
 entry in the object will be keyed by the unique index key, with corresponding
@@ -301,14 +304,6 @@ Looks up a [Subresource Integrity hash](#integrity) in the cache. If content
 exists for this `integrity`, it will return an object, with the specific single integrity hash
 that was found in `sri` key, and the size of the found content as `size`. If no content exists for this integrity, it will return `false`.
 
-##### Fields
-
-* `source` - The [Subresource Integrity hash](#integrity) that was provided as an
-argument and subsequently found in the cache.
-* `algorithm` - The algorithm used in the hash.
-* `digest` - The digest portion of the hash.
-* `options`
-
 ##### Example
 
 ```javascript
@@ -422,9 +417,8 @@ If `opts.memoize` is an object or a `Map`-like (that is, an object with `get`
 and `set` methods), it will be written to instead of the global memoization
 cache.
 
-Reading from existing memoized data can be forced by explicitly passing
-`memoize: false` to the reader functions, but their default will be to read from
-memory.
+Reading from disk data can be forced by explicitly passing `memoize: false` to
+the reader functions, but their default will be to read from memory.
 
 #### <a name="rm-all"></a> `> cacache.rm.all(cache) -> Promise`
 
@@ -471,6 +465,14 @@ cacache.rm.content(cachePath, 'sha512-SoMeDIGest/IN+BaSE64==').then(() => {
 })
 ```
 
+#### <a name="set-locale"></a> `> cacache.setLocale(locale)`
+
+Configure the language/locale used for messages and errors coming from cacache.
+The list of available locales is in the `./locales` directory in the project
+root.
+
+_Interested in contributing more languages! [Submit a PR](CONTRIBUTING.md)!_
+
 #### <a name="clear-memoized"></a> `> cacache.clearMemoized()`
 
 Completely resets the in-memory entry cache.

README.md

@@ -6,6 +6,7 @@ module.exports = {
   put: require('./put'),
   rm: require('./rm'),
   verify: require('./verify'),
+  setLocale: require('./lib/util/y.js').setLocale,
   clearMemoized: require('./lib/memoization').clearMemoized,
   tmp: require('./lib/util/tmp')
 }

index.js

@@ -7,6 +7,7 @@ const fs = require('graceful-fs')
 const PassThrough = require('stream').PassThrough
 const pipe = BB.promisify(require('mississippi').pipe)
 const ssri = require('ssri')
+const Y = require('../util/y.js')
 
 BB.promisifyAll(fs)
 
@@ -86,15 +87,15 @@ function pickContentSri (cache, integrity) {
 }
 
 function sizeError (expected, found) {
-  var err = new Error('stream data size mismatch')
+  var err = new Error(Y`Bad data size: expected inserted data to be ${expected} bytes, but got ${found} instead`)
   err.expected = expected
   err.found = found
   err.code = 'EBADSIZE'
   return err
 }
 
 function integrityError (sri, path) {
-  var err = new Error(`Integrity verification failed for ${sri} (${path})`)
+  var err = new Error(Y`Integrity verification failed for ${sri} (${path})`)
   err.code = 'EINTEGRITY'
   err.sri = sri
   err.path = path

lib/content/read.js

@@ -13,6 +13,7 @@ const rimraf = BB.promisify(require('rimraf'))
 const ssri = require('ssri')
 const to = require('mississippi').to
 const uniqueFilename = require('unique-filename')
+const Y = require('../util/y.js')
 
 const writeFileAsync = BB.promisify(fs.writeFile)
 
@@ -21,7 +22,7 @@ function write (cache, data, opts) {
   opts = opts || {}
   if (opts.algorithms && opts.algorithms.length > 1) {
     throw new Error(
-      'opts.algorithms only supports a single algorithm for now'
+      Y`opts.algorithms only supports a single algorithm for now`
     )
   }
   if (typeof opts.size === 'number' && data.length !== opts.size) {
@@ -58,7 +59,7 @@ function writeStream (cache, opts) {
   }, cb => {
     inputStream.end(() => {
       if (!allDone) {
-        const e = new Error('Input stream was empty')
+        const e = new Error(Y`Cache input stream was empty`)
         e.code = 'ENODATA'
         return ret.emit('error', e)
       }
@@ -143,15 +144,17 @@ function moveToDestination (tmp, cache, sri, opts, errCheck) {
 }
 
 function sizeError (expected, found) {
-  var err = new Error('stream data size mismatch')
+  var err = new Error(Y`Bad data size: expected inserted data to be ${expected} bytes, but got ${found} instead`)
   err.expected = expected
   err.found = found
   err.code = 'EBADSIZE'
   return err
 }
 
 function checksumError (expected, found) {
-  var err = new Error('checksum failed')
+  var err = new Error(Y`Integrity check failed:
+  Wanted: ${expected}
+   Found: ${found}`)
   err.code = 'EINTEGRITY'
   err.expected = expected
   err.found = found

lib/content/write.js

@@ -10,6 +10,7 @@ const hashToSegments = require('./util/hash-to-segments')
 const ms = require('mississippi')
 const path = require('path')
 const ssri = require('ssri')
+const Y = require('./util/y.js')
 
 const indexV = require('../package.json')['cache-version'].index
 
@@ -21,7 +22,7 @@ const from = ms.from
 
 module.exports.NotFoundError = class NotFoundError extends Error {
   constructor (cache, key) {
-    super('content not found')
+    super(Y`No cache entry for \`${key}\` found in \`${cache}\``)
     this.code = 'ENOENT'
     this.cache = cache
     this.key = key

lib/entry-index.js

@@ -0,0 +1,25 @@
+'use strict'
+
+const path = require('path')
+const y18n = require('y18n')({
+  directory: path.join(__dirname, '../../locales'),
+  locale: 'en',
+  updateFiles: process.env.CACACHE_UPDATE_LOCALE_FILES === 'true'
+})
+
+module.exports = yTag
+function yTag (parts) {
+  let str = ''
+  parts.forEach((part, i) => {
+    const arg = arguments[i + 1]
+    str += part
+    if (arg) {
+      str += '%s'
+    }
+  })
+  return y18n.__.apply(null, [str].concat([].slice.call(arguments, 1)))
+}
+
+module.exports.setLocale = locale => {
+  y18n.setLocale(locale)
+}

lib/util/y.js

@@ -0,0 +1,6 @@
+{
+  "No cache entry for `%s` found in `%s`": "No cache entry for %s found in %s",
+  "Integrity verification failed for %s (%s)": "Integrity verification failed for %s (%s)",
+  "Bad data size: expected inserted data to be %s bytes, but got %s instead": "Bad data size: expected inserted data to be %s bytes, but got %s instead",
+  "Cache input stream was empty": "Cache input stream was empty"
+}

locales/en.json

@@ -0,0 +1,6 @@
+{
+  "No cache entry for `%s` found in `%s`": "No existe ninguna entrada para «%s» en «%s»",
+  "Integrity verification failed for %s (%s)": "Verificación de integridad falló para «%s» (%s)",
+  "Bad data size: expected inserted data to be %s bytes, but got %s instead": "Tamaño incorrecto de datos: los datos insertados debieron haber sido %s octetos, pero fueron %s",
+  "Cache input stream was empty": "El stream de entrada al caché estaba vacío"
+}