npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

node-sword-interface

v1.0.31

Published

Javascript (N-API) interface to SWORD library

Downloads

821

Readme

node-sword-interface

node-sword-interface is a nodejs module that wraps the SWORD library which gives access to Bible text modules and related ressources. It has been created for use within the Ezra Bible App Bible study software, but it can also be used for any other nodejs-based software that needs to interface with the SWORD library. node-sword-interface supports Bible modules and dictionary modules that are keyed with Strong's numbers. node-sword-interface works on Windows, macOS, Linux and Android (via nodejs-mobile).

The currently used SWORD version is SVN Rev. 3894 (1.9.x / sword trunk from November 2023).

Features

node-sword-interface focusses on discovery, installation/removal and text loading of SWORD modules. It currently covers the following usecases:

  • Update SWORD repository configuration
  • List SWORD repositories
  • List remote modules (Bible modules or dictionary modules)
  • List local modules (Bible modules or dictionary modules)
  • Get a list of updated modules
  • Install a module
  • Uninstall a module
  • Get information about a module
  • Get the text of a Bible book
  • Get the text of the whole Bible
  • Search within a Bible module
  • Retrieve info based on Strong's number

Example: Installing the KJV module

The following example can be executed (after building node-sword-interface) using the following command:

node examples/install_kjv.js
const NodeSwordInterface = require('node-sword-interface');
var interface = new NodeSwordInterface();

async function installKJV() {
  console.log("Updating repository configuration ...");
  await interface.updateRepositoryConfig();

  console.log("Installing King James module");
  // Install the King James Version (Uses the internet connection to download and install the module)
  await interface.installModule('KJV');
}

installKJV().then(() => {
  console.log("Installation of KJV successfully completed!");
});

Example: Printing module info and the Gospel of Matthew (KJV)

The following example can be executed (after building node-sword-interface) using the following command:

node examples/print_kjv_matthew.js
const NodeSwordInterface = require('node-sword-interface');
var interface = new NodeSwordInterface();

function printKjvInfo() {
  // Print some module information
  var kjv = interface.getLocalModule('KJV');
  console.log(kjv.description);
  console.log(kjv.about);
}

function printMatthew() {
  // Get the verses of the Gospel of Matthew
  var verses = interface.getBookText('KJV', 'Mat');

  // Do something with the verses
  for (var i = 0; i < verses.length; i++) {
    var currentVerse = verses[i];
    var verseReference = currentVerse.chapter + ':' + currentVerse.verseNr;
    console.log(verseReference + ' '  + currentVerse.content);
  }
}

printKjvInfo();
printMatthew();

API Docs

The Javascript API of node-sword-interface is documented here.

Installation

Dependencies

Before installing node-sword-interface you need to make sure that the following dependencies are installed:

  • C++11 compiler toolchain
  • nodejs (A version that supports N-API version >= 4, like 8.16.0, 10.16.0 or 12.0.0 (see N-API Version Matrix))
  • Git
  • Mac/Linux dependencies:
    • CURL library with development headers
    • CMake (for building the SWORD library)

Below you find the OS-specific instructions for installing the dependencies.

Install dependencies on Linux

These installation instructions are working on Debian/Ubuntu based Linux distributions.

To install the dependencies issue the following command on a Debian/Ubuntu based distribution:

sudo apt-get install build-essential nodejs npm libcurl4-gnutls-dev zlib1g-dev pkg-config cmake subversion

Install dependencies on macOS

  1. Install XCode from the App Store
  2. Install Command Line Developer Tools (contains Compiler toolchain, git, etc.) by running this command: xcode-select --install
  3. Install the homebrew package manager by running this command: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  4. Install some packages with homebrew by running this command: brew install pkg-config cmake npm

Install dependencies on Windows

  1. Install git.
  2. Install nodejs. Important note: Ensure to install the x86 version (32-bit) of nodejs 14.x. Furthermore, when the setup assistant asks about Tools for native modules, make sure to tick the checkbox Automatically install the necessary tools. This will then install the windows build tools required to build node-sword-interface.

Tools for native addons

Install from npmjs

Once the dependencies are available you can install and build the latest node-sword-interface release from npmjs.com by issuing the following command:

npm install node-sword-interface

On Windows, you need to add --arch=ia32 at the end of the command:

npm install node-sword-interface --arch=ia32