https://github.com/kwonoj/cld3-asm

WebAssembly based Javascript bindings for google Compact Language Detector v3
https://github.com/kwonoj/cld3-asm

cld cld3 compact-language-detector detection language language-detector typescript wasm webassembly

Last synced: 3 days ago
JSON representation

WebAssembly based Javascript bindings for google Compact Language Detector v3

• Host: GitHub
• URL: https://github.com/kwonoj/cld3-asm
• Owner: kwonoj
• License: mit
• Created: 2017-08-25T04:58:34.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2023-12-31T20:50:24.000Z (9 months ago)
• Last Synced: 2024-09-15T00:28:41.785Z (20 days ago)
• Topics: cld, cld3, compact-language-detector, detection, language, language-detector, typescript, wasm, webassembly
• Language: TypeScript
• Homepage:
• Size: 3.47 MB
• Stars: 55
• Watchers: 4
• Forks: 7
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![npm](https://img.shields.io/npm/v/cld3-asm.svg)](https://www.npmjs.com/package/cld3-asm)

[![node](https://img.shields.io/badge/node-=>8.0-blue.svg?style=flat)](https://www.npmjs.com/package/cld3-asm)

# cld3-asm

`cld3-asm` is isomorphic javascript binding to google's [compact language detector v3](https://github.com/google/cld3) based on WebAssembly cld3 binary. This module aims to provide thin, lightweight interface to cld3 without requiring native modules.

# Install

```sh

npm install cld3-asm

```

# Usage

## Loading module asynchronously

`cld3-asm` relies on wasm binary of cld3, which need to be initialized first.

```js

import { loadModule } from 'cld3-asm';

const cldFactory = await loadModule();

```

`loadModule` loads wasm binary, initialize it, and returns factory function to create instance of cld3 [language identifier.](https://github.com/kwonoj/cld3-asm/blob/1a86bb67abcebc2cd0e90a83149292eb044e4122/src/cldAsmModule.ts#L70-L97)

```js

loadModule({ timeout?: number }): Promise

```

It allows to specify timeout to wait until wasm binary compliation & load.

## Creating language identifier

```js

create(minBytes?: number, maxBytes?: number): LanguageIdentifier

```

`LanguageIdentifier` exposes minimal interfaces to cld3's `NNetLanguageIdentifier`.

- `findLanguage(text: string): Readonly` : Finds the most likely language for the given text.

- `findMostFrequentLanguages(text: string, numLangs: number): Array>` : Splits the input text into spans based on the script, predicts a language for each span, and returns a vector storing the top num_langs most frequent languages

- `dispose(): void` : Destroy current instance of language identifier. It is important to note created instance will not be destroyed automatically.

There are simple [examples](https://github.com/kwonoj/cld3-asm/tree/master/examples) for each environments. In each example directory do `npm install && npm start`.

# Building / Testing

Few npm scripts are supported for build / test code.

- `build`: Transpiles code to ES5 commonjs to `dist`.

- `test`: Run `cld` / `cld3-asm` test both. Does not require `build` before execute test.

- `test:cld`: Run integration test for actual cld3 wasm binary, using [cld's test case](https://github.com/google/cld3/blob/2afbfc6f8b82cb7a5557c81862509e06f4f23ac4/src/nnet_lang_id_test.cc).

- `test:cld3-asm`: Run unit test against `cld3-asm` interface

- `lint`: Run lint over all codebases

- `lint:staged`: Run lint only for staged changes. This'll be executed automatically with precommit hook.

- `commit`: Commit wizard to write commit message

# License

- cld3: [original license](https://github.com/google/cld3/blob/master/LICENSE)

- cld3-asm: [MIT](https://github.com/kwonoj/cld3-asm/blob/master/LICENSE)