获取

[dependencies]
hyperbuild = { version = "0.2.4", features = ["js-esbuild"] }

使用 js-esbuild 功能需要安装 Go 编译器，以构建 JS 压缩器。

如果未启用 js-esbuild 功能，则 cfg.minify_js 不会有任何效果。

使用

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, 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, 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, cfg) {
        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, cfg) {
        Ok(minified_len) => {}
        Err(FriendlyError { position, message, code_context }) => {
            eprintln!("Failed at character {}:", position);
            eprintln!("{}", message);
            eprintln!("{}", code_context);
        }
    };
}

hyperbuild 已在 npm 上发布，作为 Node.js 原生模块 提供，并支持 Node.js 8 及更高版本。

获取

使用 npm

npm i hyperbuild

使用 Yarn

yarn add hyperbuild

使用

const hyperbuild = require("hyperbuild");

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>", cfg);
hyperbuild.minifyInPlace(source);

hyperbuild 也适用于 TypeScript

import * as hyperbuild from "hyperbuild";
import * as fs from "fs";

const cfg = { minifyJs: false };
const minified = hyperbuild.minify("<p>  Hello, world!  </p>", cfg);
hyperbuild.minifyInPlace(fs.readFileSync("source.html"), cfg);

hyperbuild 通过 JNI 提供，并支持 Java 7 及更高版本。

获取

作为 Maven 依赖项添加

<dependency>
  <groupId>in.wilsonl.hyperbuild</groupId>
  <artifactId>hyperbuild</artifactId>
  <version>0.2.4</version>
</dependency>

使用

import in.wilsonl.hyperbuild.Hyperbuild;

Hyperbuild.Configuration cfg = new Hyperbuild.Configuration.Builder()
    .setMinifyJs(false)
    .build();
try {
    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, cfg);

hyperbuild 已在 PyPI 上发布，可以作为 原生模块 使用，并支持 CPython（默认 Python 解释器）3.5 及以上版本。

获取

将 PyPI 项目添加为依赖项，并使用 pip 或 pipenv 进行安装。

使用

import hyperbuild

try:
    minified = hyperbuild.minify("<p>  Hello, world!  </p>", minify_js=False)
except SyntaxError as e:
    print(e)

hyperbuild 在 RubyGems 上发布，作为 macOS 和 Linux 的 原生模块，并支持 Ruby 2.5 及以上版本。

获取

将库作为依赖项添加到 Gemfile 或 *.gemspec。

使用

require 'hyperbuild'

print Hyperbuild.minify("<p>  Hello, world!  </p>", { :minify_js => false })

适用于：任何元素，除了 对空格敏感 的元素。

将文本节点中的连续空格字符序列缩减为一个空格（U+0020）。

<p>↵
··The·quick·brown·fox↵
··jumps·over·the·lazy↵
··dog.↵
</p>

<p>·The·quick·brown·fox·jumps·over·the·lazy·dog.·</p>

适用于：任何元素，除了 对空格敏感、内容、内容优先 和 格式化 元素。

移除标签之间的只包含空格字符的任何文本节点。

<ul>↵
··<li>A</li>↵
··<li>B</li>↵
··<li>C</li>↵
</ul>

<ul>↵
··<li>A</li><li>B</li><li>C</li>↵
</ul>

适用于：任何元素，除了 对空格敏感 和 格式化 元素。

移除任何标签的前导/尾随空格。

<p>↵
··Hey,·I·<em>just</em>·found↵
··out·about·this·<strong>cool</strong>·website!↵
··<sup>[1]</sup>↵
</p>

<p>Hey,·I·<em>just</em>·found↵
··out·about·this·<strong>cool</strong>·website!↵
··<sup>[1]</sup></p>

空格被压缩。

格式化元素通常是内联元素，它们围绕内容元素中的某些文本，因此其空格不会被修剪，因为它们可能是内容的一部分。

空格被修剪和压缩。

内容元素通常代表连续且完整的单位内容，如段落。因此，空格很重要，但连续的空格序列很可能是由于格式化引起的。

之前

<p>↵
··Hey,·I·<em>just</em>·found↵
··out·about·this·<strong>cool</strong>·website!↵
··<sup>[1]</sup>↵
</p>

之后

<p>Hey,·I·<em>just</em>·found·out·about·this·<strong>cool</strong>·website!·<sup>[1]</sup></p>

空格被修剪和压缩。整个空格被移除。

这些元素应只包含其他元素，不包含任何文本。这使得可以删除整个空白，这在使用: inline-block时非常有用，因为元素之间的空白（例如缩进）不会改变布局和样式。

之前

<ul>↵
··<li>A</li>↵
··<li>B</li>↵
··<li>C</li>↵
</ul>

之后

<ul><li>A</li><li>B</li><li>C</li></ul>

空格被修剪和压缩。

这些元素通常像内容元素，但偶尔也会用作具有一个子元素的布局元素。整个空白不会删除，因为它可能包含内容，但在用作布局时是OK的，因为只有一个子元素，空白会被修剪。

之前

<li>↵
··<article>↵
····<section></section>↵
····<section></section>↵
··</article>↵
</li>

之后

<li><article><section></section><section></section></article></li>