rematch-javascript
v1.2.2
Published
JavaScript bindings for REmatch, an information extraction focused regex library that uses constant delay algoirthms.
Downloads
248
Maintainers
Readme
REmatch-javascript: REmatch bindings for JavaScript
JavaScript bindings for REmatch, an information extraction focused regex library that uses constant delay algoirthms.
REmatch-javascript
generated bindings were compiled directly from REmatch's C++ source code using the emscripten compiler.
Installation - npm
npm install rematch-javascript
Then you can import the REmatch initializer function with:
import initREmatch from 'rematch-javascript';
Installation
Make the initREmatch
function available globally in browsers with:
<!-- Direct reference non-minified -->
<script src="./lib/index.umd.js"></script>
<!-- Direct reference minified -->
<script src="./lib/index.umd.min.js"></script>
<!-- unpkg CDN non-minified -->
<script src="https://unpkg.com/rematch-javascript@latest/lib/index.umd.js"></script>
<!-- unpkg CDN minified -->
<script src="https://unpkg.com/rematch-javascript@latest/lib/index.umd.min.js"></script>
<!-- jsDelivr CDN non-minified -->
<script src="https://cdn.jsdelivr.net/npm/rematch-javascript@latest/lib/index.umd.js"></script>
<!-- jsDelivr CDN minified -->
<script src="https://cdn.jsdelivr.net/npm/rematch-javascript@latest/lib/index.umd.min.js"></script>
For ESM modules:
// Direct reference
import initREmatch from './lib/index.esm.js';
// unpkg CDN
import initREmatch from 'https://unpkg.com/rematch-javascript@latest/lib/index.esm.js';
// jsDelivr CDN
import initREmatch from 'https://cdn.jsdelivr.net/npm/rematch-javascript@latest/lib/index.esm.js';
For CJS modules:
// Direct reference
const initREmatch = require('./lib/index.cjs');
// unpkg CDN
const initREmatch = require('https://unpkg.com/rematch-javascript@latest/lib/index.cjs');
// jsDelivr CDN
const initREmatch = require('https://cdn.jsdelivr.net/npm/rematch-javascript@latest/lib/index.cjs');
Usage
As said before, REmatch-javascript
was built with emscripten, so it uses WebAssembly to run. The .wasm
code is embedded directly into the library's code, so it is not needed to bundle or import it.
First you would need to load the REmatch module instance by importing the initREmatch
function:
// Create a REmatch module instance
const REmatch = await initREmatch();
// Define the document and pattern to search for
const document = "[email protected]\[email protected]\[email protected]";
const pattern = String.raw`@!domain{(\w+\.)+\w+}(\n|$)`;
// Create a REQL query
const query = REmatch.reql(pattern);
// Execute the query and show the matches
const matchIterator = query.findIter(document);
for (const match of matchIterator) {
console.log(`Match: ${match.toString()}`);
// Current match will no longer be used
match.free();
}
// Query and MatchIterator will no longer be used
query.free();
matchIterator.free();
As you notice in the previous snippet, due the lack of garbage collection in JavaScript, the bindings should be explicitly freed when you are done with them. Otherwise, it will lead to memory leaks.
Development
If you want to update the emscripten bindings, first make sure that you have the emscripten compiler installed. Then, if you want to the latest REmatch, do the following steps:
- Update the REmatch's submodule (at
/REmatch
) with the latest version - Build the emscripten bindings with
npm run build:bindings
- Build the project with
npm run build