Multi format UTF-8 escape utility
So, your project is chocked full of UTF-8 literals 😊, but you need to deploy to a platform that only supports ASCII 😒... Point utf8-escape at your project directory and it will apply escape notations to all supported UTF-8 encoded files 😏. Supports js, json, css, svg, html and can be extended with more.
npm install -g utf8-escapeman utf8-escapeThis tool parses bytes not source. This can be a problematic if a format has inconsistent escape support. For example if literals are allowed in both strings and identifiers but escape sequences are not allowed in identifiers, you should operate on copies and use git diff --word-diff to verify.
Basic usage with CLI:
# Check first
utf8-escape -nvR ./dist
# Do it now!
utf8-escape -R ./dist
# Glob glob
utf8-escape './dist/**' '!./dist/libs/**'Basic usage with Gulp:
const gulp = require('gulp');
const utf8Escape = require('utf8-escape');
gulp.task('Escape', () => gulp.src('src/**/*')
.pipe(utf8Escape({
quiet: true
}))
.pipe(gulp.dest('dist'));
);Basic usage with Gurt:
const utf8Escape = require('utf8-escape');
module.exports['Escape'] = (stream) => stream
.pipe(utf8Escape({
quiet: true
}));Type: Boolean
Increase output verbosity, output encoding details for every file. Lists all selected files regardless of encoding or support, as UTF-8, ASCII or BINARY.
Type: Boolean
Decrease output verbosity, suppress all output including errors. Useful when invoking from a shell script or as part of a build pipeline e.g Gulp / Gurt.
Type: Object
Define custom escape notation formats where {b:p:s} denotes the code point and it's numeric base (b), zero padding width (p), and use of surrogates (s):
// ES5
format: {
js: '\\u{16:4:1}'
}
// ES6
format: {
js: '\\u{{16:0:0}}'
}Suggestions and contributions will be considered. When crafting a pull request please consider if your contribution is a good fit with the project, follow contribution best practices and use the github "flow" workflow.