hyperbuild 0.1.8 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bf56e4e3ef3a4d85fb29001ce6414edc7459e7eabcecd3d91aea9ac328636a58
-  data.tar.gz: 7b354352afb385250008b6441ef5049f55a7f3aeca961b09c417b1dea0175e10
+  metadata.gz: 47317f7fad5e5633c4f962895d67a580dedb973ff1b124cf26415b5bc0a75bf6
+  data.tar.gz: 54c8be85456af68447db90121e38b9faa90f5ea69c23f10c58a2d911d8d7b217
 SHA512:
-  metadata.gz: edcb75247975e1cebf8be8717f6858c1fe19dbbbb42f463d4e5b687f1c883bfee643ae0d12c0cb561ec3e219f663a34030cb49fcf2fcb277d747ff41d295061e
-  data.tar.gz: c19fad266ab12e32112b1ec2a92f48e238c7e8c52a0084d1d27ed994ac4f22d80ffeb2d034e2292c60ea50588d15951359531f81f314473cef8c72d080c886ad
+  metadata.gz: 8a74b8742c441a840017fb309e5d571376d34d48ac533e4f240ccf46e6731a9f815ce36734513b2a21ad9151c0486ad5263cfcd6a75b766e3208cb9f3d020866
+  data.tar.gz: 3c0feacc11bd5f91be61f0bbaf53c7c2c2bb5b0bb06e56644504da6f9f534b2836073359c4bcc4324c55440f19b5addea0c225cc4d2e4352e8edbdd549e71988

data/README.md

@@ -2,8 +2,10 @@
 
 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.
+- CLI for macOS and Linux.
 - Rust library.
 - Native library for Node.js, Python, Java, and Ruby.
 
@@ -12,27 +14,31 @@ 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.8/average-speeds.png"> <img width="435" alt="Chart showing effectiveness of HTML minifiers" src="https://wilsonl.in/hyperbuild/bench/0.1.8/average-sizes.png">
+<img width="435" alt="Chart showing speed of HTML minifiers" src="https://wilsonl.in/hyperbuild/bench/0.2.3/average-speeds.png"> <img width="435" alt="Chart showing effectiveness of HTML minifiers" src="https://wilsonl.in/hyperbuild/bench/0.2.3/average-sizes.png">
 
 ## Usage
 
 ### CLI
 
-Precompiled binaries are available for x86-64 Windows, macOS, and Linux.
+Precompiled binaries are available for x86-64 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.8-windows-x86_64.exe) |
-[macOS](https://wilsonl.in/hyperbuild/bin/0.1.8-macos-x86_64) |
-[Linux](https://wilsonl.in/hyperbuild/bin/0.1.8-linux-x86_64)
+[macOS](https://wilsonl.in/hyperbuild/bin/0.2.3-macos-x86_64) |
+[Linux](https://wilsonl.in/hyperbuild/bin/0.2.3-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 +52,37 @@ hyperbuild --src /path/to/src.html --out /path/to/output.min.html
 
 ```toml
 [dependencies]
-hyperbuild = "0.1.8"
+hyperbuild = "0.2.3"
 ```
 
 ##### 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 +90,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 +127,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 +141,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 +161,7 @@ Add as a Maven dependency:
 <dependency>
   <groupId>in.wilsonl.hyperbuild</groupId>
   <artifactId>hyperbuild</artifactId>
-  <version>0.1.8</version>
+  <version>0.2.3</version>
 </dependency>
 ```
 
@@ -159,15 +170,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 +201,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 +222,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 +450,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 +466,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.8
+  version: 0.2.3
 platform: ruby
 authors:
 - Wilson Lin
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-07-04 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: []