hyperbuild 0.1.7 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ecfc9df750e45a3eb4af79ebd51b551c8c6a0a48ae92791d8ade077c16af7bd
-  data.tar.gz: 5963041909e364998ab9981591f60894e80df1258a4437f88827bb8c0e714a31
+  metadata.gz: 2d7fbd72c38ff0d0538916b9ff6e00a84adf12124666dd14d7813d7afe128242
+  data.tar.gz: 61e2dbc5bb2f90f2d7d09e85e8763ccf2394d40a2bc68273c7b9d2eccbc13c17
 SHA512:
-  metadata.gz: 82d0376c58ec634e53f2644919b8d3bcaa5032308fe098717e51c766e1e26f54a4b619d836db85a4a8ec6b7ab356f9349fe7505c80feb97aa4c8191215e2de67
-  data.tar.gz: ff461ddbc281e863b402d544cb3eef9c75ce0e15dbeead0df1a788bd092c4fd27c92e1af7eca3e446eec7dfc7ab5c80899f34a040f5cee2e5862e500a8106632
+  metadata.gz: c880cc9b43f1267b413b7966c7c372f3837c68f236b2051df048b848de4f04ef55a89e18de02a9d5c4178dee6c42e2a12d9e14be1f22fad032d2aeea7b3edd84
+  data.tar.gz: 8e42e3e6ba37452d39fcc516bfa6705f876eb4550dafe01cd1cebc3448b3fe0bae11fbd8c81358af8c0e40f091cc72d7bb81358770fe2fdf5ab67ea82f1c0cba

data/README.md

@@ -2,6 +2,8 @@
 
 A fast one-pass in-place HTML minifier written in Rust with context-aware whitespace handling.
 
+Also supports JS minification by plugging into [esbuild](https://github.com/evanw/esbuild).
+
 Available as:
 - CLI for Windows, macOS, and Linux.
 - Rust library.
@@ -12,12 +14,13 @@ Available as:
 - Minification is done in one pass with no backtracking or DOM/AST building.
 - No extra heap memory is allocated during processing, which increases performance.
 - Context-aware whitespace handling allows maximum minification while retaining desired spaces.
+- Well tested with a large test suite and extensive [fuzzing](./fuzz).
 
 ## Performance
 
 Speed and effectiveness of Node.js version compared to [html-minfier](https://github.com/kangax/html-minifier) and [minimize](https://github.com/Swaagie/minimize), run on popular already-minified web pages. See [bench](./bench) folder for more details.
 
-<img width="435" alt="Chart showing speed of HTML minifiers" src="https://wilsonl.in/hyperbuild/bench/0.1.7/average-speeds.png"> <img width="435" alt="Chart showing effectiveness of HTML minifiers" src="https://wilsonl.in/hyperbuild/bench/0.1.7/average-sizes.png">
+<img width="435" alt="Chart showing speed of HTML minifiers" src="https://wilsonl.in/hyperbuild/bench/0.2.2/average-speeds.png"> <img width="435" alt="Chart showing effectiveness of HTML minifiers" src="https://wilsonl.in/hyperbuild/bench/0.2.2/average-sizes.png">
 
 ## Usage
 
@@ -25,14 +28,18 @@ Speed and effectiveness of Node.js version compared to [html-minfier](https://gi
 
 Precompiled binaries are available for x86-64 Windows, macOS, and Linux.
 
+Building from source currently requires the Go compiler to be installed as well, to build the [JS minifier](https://github.com/evanw/esbuild).
+
 ##### Get
 
-[Windows](https://wilsonl.in/hyperbuild/bin/0.1.7-windows-x86_64.exe) |
-[macOS](https://wilsonl.in/hyperbuild/bin/0.1.7-macos-x86_64) |
-[Linux](https://wilsonl.in/hyperbuild/bin/0.1.7-linux-x86_64)
+[Windows](https://wilsonl.in/hyperbuild/bin/0.2.2-windows-x86_64.exe) |
+[macOS](https://wilsonl.in/hyperbuild/bin/0.2.2-macos-x86_64) |
+[Linux](https://wilsonl.in/hyperbuild/bin/0.2.2-linux-x86_64)
 
 ##### Use
 
+Use the `--help` argument for more details.
+
 ```bash
 hyperbuild --src /path/to/src.html --out /path/to/output.min.html
 ```
@@ -46,34 +53,37 @@ hyperbuild --src /path/to/src.html --out /path/to/output.min.html
 
 ```toml
 [dependencies]
-hyperbuild = "0.1.7"
+hyperbuild = "0.2.2"
 ```
 
 ##### Use
 
 ```rust
-use hyperbuild::{FriendlyError, hyperbuild};
+use hyperbuild::{Cfg, FriendlyError, hyperbuild, hyperbuild_copy, hyperbuild_friendly_error, hyperbuild_truncate};
 
 fn main() {
     let mut code = b"<p>  Hello, world!  </p>".to_vec();
+    let cfg = &Cfg {
+        minify_js: false,
+    };
 
     // Minifies a slice in-place and returns the new minified length,
     // but leaves any original code after the minified code intact.
-    match hyperbuild(&mut code) {
+    match hyperbuild(&mut code, cfg) {
         Ok(minified_len) => {}
         Err((error_type, error_position)) => {}
     };
 
     // Creates a vector copy containing only minified code
     // instead of minifying in-place.
-    match hyperbuild_copy(&code) {
+    match hyperbuild_copy(&code, cfg) {
         Ok(minified) => {}
         Err((error_type, error_position)) => {}
     };
 
     // Minifies a vector in-place, and then truncates the
     // vector to the new minified length.
-    match hyperbuild_truncate(&mut code) {
+    match hyperbuild_truncate(&mut code, cfg) {
         Ok(()) => {}
         Err((error_type, error_position)) => {}
     };
@@ -81,7 +91,7 @@ fn main() {
     // Identical to `hyperbuild` except with FriendlyError instead.
     // `code_context` is a string of a visual representation of the source,
     // with line numbers and position markers to aid in debugging syntax.
-    match hyperbuild_friendly_error(&mut code) {
+    match hyperbuild_friendly_error(&mut code, cfg) {
         Ok(minified_len) => {}
         Err(FriendlyError { position, message, code_context }) => {
             eprintln!("Failed at character {}:", position);
@@ -118,10 +128,11 @@ yarn add hyperbuild
 ```js
 const hyperbuild = require("hyperbuild");
 
-const minified = hyperbuild.minify("<p>  Hello, world!  </p>");
+const cfg = { minifyJs: false };
+const minified = hyperbuild.minify("<p>  Hello, world!  </p>", cfg);
 
 // Alternatively, minify in place to avoid copying.
-const source = Buffer.from("<p>  Hello, world!  </p>");
+const source = Buffer.from("<p>  Hello, world!  </p>", cfg);
 hyperbuild.minifyInPlace(source);
 ```
 
@@ -131,8 +142,9 @@ hyperbuild is also available for TypeScript:
 import * as hyperbuild from "hyperbuild";
 import * as fs from "fs";
 
-const minified = hyperbuild.minify("<p>  Hello, world!  </p>");
-hyperbuild.minifyInPlace(fs.readFileSync("source.html"));
+const cfg = { minifyJs: false };
+const minified = hyperbuild.minify("<p>  Hello, world!  </p>", cfg);
+hyperbuild.minifyInPlace(fs.readFileSync("source.html"), cfg);
 ```
 
 </details>
@@ -150,7 +162,7 @@ Add as a Maven dependency:
 <dependency>
   <groupId>in.wilsonl.hyperbuild</groupId>
   <artifactId>hyperbuild</artifactId>
-  <version>0.1.7</version>
+  <version>0.2.2</version>
 </dependency>
 ```
 
@@ -159,15 +171,18 @@ Add as a Maven dependency:
 ```java
 import in.wilsonl.hyperbuild.Hyperbuild;
 
+Hyperbuild.Configuration cfg = new Hyperbuild.Configuration.Builder()
+    .setMinifyJs(false)
+    .build();
 try {
-    String minified = Hyperbuild.minify("<p>  Hello, world!  </p>");
+    String minified = Hyperbuild.minify("<p>  Hello, world!  </p>", cfg);
 } catch (Hyperbuild.SyntaxException e) {
     System.err.println(e.getMessage());
 }
 
 // Alternatively, minify in place:
 assert source instanceof ByteBuffer && source.isDirect();
-Hyperbuild.minifyInPlace(source);
+Hyperbuild.minifyInPlace(source, cfg);
 ```
 
 </details>
@@ -187,7 +202,7 @@ Add the PyPI project as a dependency and install it using `pip` or `pipenv`.
 import hyperbuild
 
 try:
-    minified = hyperbuild.minify("<p>  Hello, world!  </p>")
+    minified = hyperbuild.minify("<p>  Hello, world!  </p>", minify_js=False)
 except SyntaxError as e:
     print(e)
 ```
@@ -208,17 +223,13 @@ Add the library as a dependency to `Gemfile` or `*.gemspec`.
 ```ruby
 require 'hyperbuild'
 
-print Hyperbuild.minify "<p>  Hello, world!  </p>"
+print Hyperbuild.minify("<p>  Hello, world!  </p>", { :minify_js => false })
 ```
 
 </details>
 
 ## Minification
 
-### Configurability
-
-Configuration of minification is currently WIP across all languages. The behaviour mentioned below is the default.
-
 ### Whitespace
 
 hyperbuild has advanced context-aware whitespace minification that does things such as:
@@ -440,6 +451,8 @@ Numeric entities that do not refer to a valid [Unicode Scalar Value](https://www
 
 If an entity is unintentionally formed after decoding, the leading ampersand is encoded, e.g. `&&#97;&#109;&#112;;` becomes `&ampamp;`. This is done as `&amp` is equal to or shorter than all other entity representations of characters part of an entity (`[&#a-zA-Z0-9;]`), and there is no other conflicting entity name that starts with `amp`.
 
+It's possible to get an unintentional entity after removing comments, e.g. `&am<!-- -->p`.
+
 Left chevrons after any decoding in text are encoded to `&LT` if possible or `&LT;` otherwise.
 
 ### Comments
@@ -454,7 +467,7 @@ Bangs, [processing instructions](https://en.wikipedia.org/wiki/Processing_Instru
 
 Only UTF-8/ASCII-encoded HTML code is supported.
 
-hyperbuild simply does HTML minification, and almost does no syntax checking or standards enforcement for performance and code complexity reasons.
+hyperbuild does no syntax checking or standards enforcement for performance and code complexity reasons.
 
 For example, this means that it's not an error to have self-closing tags, declare multiple `<body>` elements, use incorrect attribute names and values, or write something like `<br>alert('');</br>`
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hyperbuild
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.2.2
 platform: ruby
 authors:
 - Wilson Lin
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-07-03 00:00:00.000000000 Z
+date: 2020-07-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fiddle
@@ -62,6 +62,5 @@ rubyforge_project:
 rubygems_version: 2.7.6.2
 signing_key: 
 specification_version: 4
-summary: Fast one-pass in-place HTML minifier written in Rust with context-aware whitespace
-  handling
+summary: Fast allocation-less HTML minifier with smart whitespace handling
 test_files: []