hyperbuild 0.0.40 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9f2a6102a9052622a2adcb638efc16b689bec1a2cc081fd1c99aa682536f7707
-  data.tar.gz: 691368c264d4637f41f8b6248b1f902dfd2f5de08dda4d297d49680c169ca8b5
+  metadata.gz: 7bb6f0f8e73f9613317562e0a3daf1fa0b9d67f21bb659759d67b65f0cecf573
+  data.tar.gz: 33dab007c631e2f7fbe465c104185c900a7b05c33eaffe837ed77aad70e04599
 SHA512:
-  metadata.gz: 3742bc67d08738a164c6f96a9e77570b3894d3cd2ff1d40d5cf5ee97abf67e3dc95038976c57467eaa2002d2a0b0e48b4e4273e3049fff4aafc9bcb420b4ca8c
-  data.tar.gz: 4bcc6a195bc70b374cc628058d6789dcf0b700f2a15cf9dfd5b469e4defd5e756ef26436e32a1e3f75cba2dedc4140856220f9141bd7d923cad40a70d021e0e7
+  metadata.gz: 379e7d4f40fe1d42f0771ade0a09f9bf902aa5cfd0e6eeb6a92a7b7fb6b9da13dbe082724d6dd6485ddce9e9d85b90f8f85d68910fb83cf4a1961266c819df54
+  data.tar.gz: d90bc35584be1022996380f4e8a06782a8801ef94dd680f8e87677095277cbdd8b23c29cc7bf60aef427ed8795a5baec6ca9a2e08f8be1ab2997335f487932fb

data/README.md

@@ -15,21 +15,21 @@ Available as:
 
 ## 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). See [bench](./bench) folder for more details.
+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.0.40/average-speeds.png"> <img width="435" alt="Chart showing effectiveness of HTML minifiers" src="https://wilsonl.in/hyperbuild/bench/0.0.40/average-sizes.png">
+<img width="435" alt="Chart showing speed of HTML minifiers" src="https://wilsonl.in/hyperbuild/bench/0.1.2/average-speeds.png"> <img width="435" alt="Chart showing effectiveness of HTML minifiers" src="https://wilsonl.in/hyperbuild/bench/0.1.2/average-sizes.png">
 
 ## Usage
 
 ### CLI
 
-Precompiled binaries are available for x86-64 Windows, macOS, and Linux. To compile and install from source, run `cargo install hyperbuild`, which requires [Rust](https://www.rust-lang.org/tools/install).
+Precompiled binaries are available for x86-64 Windows, macOS, and Linux.
 
 ##### Get
 
-[Windows](https://wilsonl.in/hyperbuild/bin/0.0.40-windows-x86_64.exe) |
-[macOS](https://wilsonl.in/hyperbuild/bin/0.0.40-macos-x86_64) |
-[Linux](https://wilsonl.in/hyperbuild/bin/0.0.40-linux-x86_64)
+[Windows](https://wilsonl.in/hyperbuild/bin/0.1.2-windows-x86_64.exe) |
+[macOS](https://wilsonl.in/hyperbuild/bin/0.1.2-macos-x86_64) |
+[Linux](https://wilsonl.in/hyperbuild/bin/0.1.2-linux-x86_64)
 
 ##### Use
 
@@ -46,19 +46,48 @@ hyperbuild --src /path/to/src.html --out /path/to/output.min.html
 
 ```toml
 [dependencies]
-hyperbuild = "0.0.40"
+hyperbuild = "0.1.2"
 ```
 
 ##### Use
 
 ```rust
-use hyperbuild::hyperbuild;
+use hyperbuild::{FriendlyError, hyperbuild};
 
 fn main() {
     let mut code = b"<p>  Hello, world!  </p>".to_vec();
+
+    // 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) {
         Ok(minified_len) => {}
-        Err((error_type, error_at_char_no)) => {}
+        Err((error_type, error_position)) => {}
+    };
+
+    // Creates a vector copy containing only minified code
+    // instead of minifying in-place.
+    match hyperbuild_copy(&code) {
+        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) {
+        Ok(()) => {}
+        Err((error_type, error_position)) => {}
+    };
+
+    // 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) {
+        Ok(minified_len) => {}
+        Err(FriendlyError { position, message, code_context }) => {
+            eprintln!("Failed at character {}:", position);
+            eprintln!("{}", message);
+            eprintln!("{}", code_context);
+        }
     };
 }
 ```
@@ -90,6 +119,20 @@ yarn add hyperbuild
 const hyperbuild = require("hyperbuild");
 
 const minified = hyperbuild.minify("<p>  Hello, world!  </p>");
+
+// Alternatively, minify in place to avoid copying.
+const source = Buffer.from("<p>  Hello, world!  </p>");
+hyperbuild.minifyInPlace(source);
+```
+
+hyperbuild is also available for TypeScript:
+
+```ts
+import * as hyperbuild from "hyperbuild";
+import * as fs from "fs";
+
+const minified = hyperbuild.minify("<p>  Hello, world!  </p>");
+hyperbuild.minifyInPlace(fs.readFileSync("source.html"));
 ```
 
 </details>
@@ -107,7 +150,7 @@ Add as a Maven dependency:
 <dependency>
   <groupId>in.wilsonl.hyperbuild</groupId>
   <artifactId>hyperbuild</artifactId>
-  <version>0.0.40</version>
+  <version>0.1.2</version>
 </dependency>
 ```
 
@@ -116,11 +159,15 @@ Add as a Maven dependency:
 ```java
 import in.wilsonl.hyperbuild.Hyperbuild;
 
-class Main {
-    public static void main(String[] args) {
-        String minified = Hyperbuild.minify("<p>  Hello, world!  </p>");
-    }
+try {
+    String minified = Hyperbuild.minify("<p>  Hello, world!  </p>");
+} catch (Hyperbuild.SyntaxException e) {
+    System.err.println(e.getMessage());
 }
+
+// Alternatively, minify in place:
+assert source instanceof ByteBuffer && source.isDirect();
+Hyperbuild.minifyInPlace(source);
 ```
 
 </details>
@@ -139,7 +186,10 @@ Add the PyPI project as a dependency and install it using `pip` or `pipenv`.
 ```python
 import hyperbuild
 
-minified = hyperbuild.minify("<p>  Hello, world!  </p>")
+try:
+    minified = hyperbuild.minify("<p>  Hello, world!  </p>")
+except SyntaxError as e:
+    print(e)
 ```
 
 </details>
@@ -165,6 +215,10 @@ print Hyperbuild.minify "  Hello, world!  "
 
 ## 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:
@@ -208,7 +262,7 @@ Reduce a sequence of whitespace characters in text nodes to a single space (U+00
 
 > **Applies to:** any element except [whitespace sensitive](./src/spec/tag/whitespace.rs), [content](src/spec/tag/whitespace.rs), [content-first](./src/spec/tag/whitespace.rs), and [formatting](./src/spec/tag/whitespace.rs) elements.
 
-Remove any text nodes that only consist of whitespace characters.
+Remove any text nodes between tags that only consist of whitespace characters.
 
 <table><thead><tr><th>Before<th>After<tbody><tr><td>
 
@@ -383,10 +437,10 @@ Spaces are removed between attributes if possible.
 Entities are decoded if valid (see relevant parsing section) and their decoded characters as UTF-8 is shorter or equal in length.
 
 Numeric entities that do not refer to a valid [Unicode Scalar Value](https://www.unicode.org/glossary/#unicode_scalar_value) are replaced with the [replacement character](https://en.wikipedia.org/wiki/Specials_(Unicode_block)#Replacement_character).
- 
+
 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`.
 
-Right chevrons after any decoding in text are encoded to `&GT` if possible or `&GT;` otherwise. 
+Left chevrons after any decoding in text are encoded to `&LT` if possible or `&LT;` otherwise.
 
 ### Comments
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hyperbuild
 version: !ruby/object:Gem::Version
-  version: 0.0.40
+  version: 0.1.2
 platform: ruby
 authors:
 - Wilson Lin
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-01-26 00:00:00.000000000 Z
+date: 2020-06-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fiddle