hyperbuild 0.1.12 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4cad15272abd95d79881d6d56d99f743627436488cddfbcf1bee632b912e1f58
-  data.tar.gz: cd671f2a74fc1b577396cb04411431b5f1865f363747a0a578673551a011e790
+  metadata.gz: 2d7fbd72c38ff0d0538916b9ff6e00a84adf12124666dd14d7813d7afe128242
+  data.tar.gz: 61e2dbc5bb2f90f2d7d09e85e8763ccf2394d40a2bc68273c7b9d2eccbc13c17
 SHA512:
-  metadata.gz: '05259be3bcb59ead8c44b7574f6e6e2a21b4cb2f82fbea9ee54608fbb5b31f5fd4f24071be31d509b215190c77fb9155364a8a8b41111093a9b6c62d2f107af1'
-  data.tar.gz: afada323b7945068258a5c956c008f68cdde3b91bef2a6976927510ef4da3f39fa6db0ec25a30ff15fb891a5d0e2fc8764ae14a4289bb32f11666060bac845d2
+  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.12/average-speeds.png"> <img width="435" alt="Chart showing effectiveness of HTML minifiers" src="https://wilsonl.in/hyperbuild/bench/0.1.12/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.12-windows-x86_64.exe) |
-[macOS](https://wilsonl.in/hyperbuild/bin/0.1.12-macos-x86_64) |
-[Linux](https://wilsonl.in/hyperbuild/bin/0.1.12-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.12"
+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.12</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:
@@ -456,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,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hyperbuild
 version: !ruby/object:Gem::Version
-  version: 0.1.12
+  version: 0.2.2
 platform: ruby
 authors:
 - Wilson Lin
@@ -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: []