Nanoseconds Produce Minutes

    cld
    TypeScript icon, indicating that this package has built-in type declarations

    2.8.4 • Public • Published

    node-cld

    *NIX Build Status Windows Build Status Dependencies NPM version

    Language detection for Javascript. Based on the CLD2 (Compact Language Detector) library from Google.

    Highly optimized for space and speed. Runs about 10x faster than other libraries. Detects over 160 languages. Full test coverage. Runs on Linux, OS X, and Windows.

    Installation

    $ npm install cld

    Linux users, make sure you have g++ >= 4.8. If this is not an option, you should be able to install node-cld 2.4.4 even with an older g++ build.

    Examples

    Simple

    const cld = require('cld');
    
    // As a promise
    cld.detect('This is a language recognition example').then((result) => {
      console.log(result);
    });
    
    // In an async function
    async function testCld() {
      const result = await cld.detect('This is a language recognition example');
      console.log(result);
    }

    Advanced

    const cld = require('cld');
    const text     = 'Това е пример за разпознаване на Български език';
    const options  = {
      isHTML       : false,
      languageHint : 'BULGARIAN',
      encodingHint : 'ISO_8859_5',
      tldHint      : 'bg',
      httpHint     : 'bg'
    };
    
    // As a promise
    cld.detect(text, options).then((result) => {
      console.log(result);
    });
    
    // In an async function
    async function testCld() {
      const result = await cld.detect(text, options);
      console.log(result);
    }

    Legacy

    Detect can be called leveraging the node callback pattern. If options are provided, the third parameter should be the callback.

    const cld = require('cld');
    
    cld.detect('This is a language recognition example', (err, result) => {
      console.log(result);
    });

    Options

    isHTML

    Set to true if the string contains HTML tags

    languageHint

    Pass a LANGUAGES key or value as a hint

    encodingHint

    Pass an ENCODINGS value as a hint

    tldHint

    Pass top level domain as a hint

    httpHint

    Pass an HTTP "Content-Encoding" value as a hint

    Warning

    Once the module has been installed, the underlying C sources will remain in the deps/cld folder and continue to occupy considerable space. This is because they will be required if you ever need to run npm rebuild. If you are under severe constraints you can delete this folder and reclam >100M

    Copyright

    Copyright 2011-2015, Blagovest Dachev.

    License

    Apache 2

    Install

    npm i cld

    DownloadsWeekly Downloads

    6,945

    Version

    2.8.4

    License

    none

    Unpacked Size

    109 MB

    Total Files

    117

    Last publish

    Collaborators

    • dachev
    • blago