Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hpcc-systems/hpcc-js-wasm
HPCC-Systems Web-Assembly (JavaScript)
https://github.com/hpcc-systems/hpcc-js-wasm
base91 dot expat expat-xml-parser graphviz graphviz-dot typescript wasm webassembly webassemby zstandard zstd
Last synced: 1 day ago
JSON representation
HPCC-Systems Web-Assembly (JavaScript)
- Host: GitHub
- URL: https://github.com/hpcc-systems/hpcc-js-wasm
- Owner: hpcc-systems
- License: apache-2.0
- Created: 2019-06-13T05:44:37.000Z (over 5 years ago)
- Default Branch: trunk
- Last Pushed: 2024-11-24T07:57:12.000Z (20 days ago)
- Last Synced: 2024-12-05T20:07:41.258Z (8 days ago)
- Topics: base91, dot, expat, expat-xml-parser, graphviz, graphviz-dot, typescript, wasm, webassembly, webassemby, zstandard, zstd
- Language: TypeScript
- Homepage: https://hpcc-systems.github.io/hpcc-js-wasm/
- Size: 3.27 MB
- Stars: 322
- Watchers: 10
- Forks: 24
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-list - hpcc-js-wasm - Systems Web-Assembly (JavaScript) | hpcc-systems | 92 | (TypeScript)
README
# @hpcc-js/wasm - Version 3
[](https://coveralls.io/github/GordonSmith/hpcc-js-wasm?branch=BUMP_VERSIONS)
**Note: @hpcc-js/wasm is now an ESM by default package** - this is a good thing, but does require some breaking changes.
This repository contains a collection of useful c++ libraries compiled to WASM for (re)use in Node JS, Web Browsers and JavaScript Libraries:
- [base91](https://base91.sourceforge.net/) - v0.6.0
- [duckdb](https://github.com/duckdb/duckdb) - v1.1.1
- [expat](https://libexpat.github.io/) - v2.6.2
- [graphviz](https://www.graphviz.org/) - v12.2.1
- [llama.cpp](https://github.com/ggerganov/llama.cpp) - b3718
- [zstd](https://github.com/facebook/zstd) - v1.5.6
- ...more to follow...
Built with:
- [emsdk](https://github.com/emscripten-core/emsdk) - v3.1.73
## Homepage and Documents
* [Homepage](https://hpcc-systems.github.io/hpcc-js-wasm/)
* [Base91](https://hpcc-systems.github.io/hpcc-js-wasm/base91/src/base91/classes/Base91.html)
* [DuckDB](https://hpcc-systems.github.io/hpcc-js-wasm/duckdb/src/duckdb/classes/DuckDB.html)
* [Expat](https://hpcc-systems.github.io/hpcc-js-wasm/expat/src/expat/classes/Expat.html)
* [Graphviz](https://hpcc-systems.github.io/hpcc-js-wasm/graphviz/src/graphviz/classes/Graphviz.html)
* [Llama](https://hpcc-systems.github.io/hpcc-js-wasm/llama/src/llama/classes/Llama.html)
* [Zstd](https://hpcc-systems.github.io/hpcc-js-wasm/zstd/src/zstd/classes/Zstd.html)
## Version 3 Changes
Converted this repository to a monorepo with the following packages:
- @hpcc-js/wasm-base91
- @hpcc-js/wasm-duckdb
- @hpcc-js/wasm-expat
- @hpcc-js/wasm-graphviz
- @hpcc-js/wasm-graphviz-cli
- @hpcc-js/wasm-zstd
- @hpcc-js/wasm (meta package for backward compatibility)
## Quick Start
```ts
import { Base91 } from "@hpcc-js/wasm-base91";
import { Graphviz } from "@hpcc-js/wasm-graphviz";
import { Zstd } from "@hpcc-js/wasm-zstd";
// Graphviz ---
async function dot2svg() {
const graphviz = await Graphviz.load();
console.log("svg: ", graphviz.dot('digraph G { Hello -> World }'));
}
dot2svg();
// Base91 + Zstd ---
const text = "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed non risus. Suspendisse lectus tortor, dignissim sit amet, adipiscing nec, ultricies sed, dolor. Cras elementum ultrices diam. Maecenas ligula massa, varius a, semper congue, euismod non, mi. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed non risus. Suspendisse lectus tortor, dignissim sit amet, adipiscing nec, ultricies sed, dolor. Cras elementum ultrices diam. Maecenas ligula massa, varius a, semper congue, euismod non, mi.";
const data = new TextEncoder().encode(text);
async function compressDecompress() {
const zstd = await Zstd.load();
const compressed_data = zstd.compress(data);
const base91 = await Base91.load();
const base91Str = base91.encode(compressed_data);
const compressed_data2 = base91.decode(base91Str);
const data2 = zstd.decompress(compressed_data2);
const text2 = new TextDecoder().decode(data2);
console.log("Text Length: ", text.length);
console.log("Compressed Length: ", compressed_data.length);
console.log("Base91 Length: ", base91Str.length);
console.log("Passed: ", text === text2);
}
compressDecompress();
```
## Quick Migration from v1
v1.x.x
```ts
import { graphviz, wasmFolder } from "@hpcc-js/wasm";
wasmFolder("https://cdn.jsdelivr.net/npm/@hpcc-js/wasm/dist");
const dot = "digraph G { Hello -> World }";
graphviz.dot(dot).then(svg => {
const div = document.getElementById("placeholder");
div.innerHTML = svg;
});
graphvizVersion.then(version => console.log(version));
```
v2.x.x
```ts
import { Graphviz } from "@hpcc-js/wasm";
const dot = "digraph G { Hello -> World }";
Graphviz.load().then(graphviz => {
const svg = graphviz.dot(dot);
const div = document.getElementById("placeholder");
div.innerHTML = svg;
console.log(graphviz.version());
});
```
Notes:
* wasmFolder is no longer needed
* All wasm libraries have the same asynchronous load pattern
- `const instance = await .load();`
v3.x.x
```ts
import { Graphviz } from "@hpcc-js/wasm-graphviz";
const dot = "digraph G { Hello -> World }";
Graphviz.load().then(graphviz => {
const svg = graphviz.dot(dot);
const div = document.getElementById("placeholder");
div.innerHTML = svg;
console.log(graphviz.version());
});
```