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

@yowasp/runtime

v9.0.54-dev

Published

Common runtime for YoWASP packages

Downloads

99

Readme

YoWASP JavaScript runtime

This package is an internal support package for the YoWASP project. It handles interfacing with the WebAssembly runtime and the supported execution environments (Node.js and the browser). If you are writing code that is not part of the YoWASP project, you should only use functions from the @yowasp/runtime/util module.

Application API reference

All of the other JavaScript YoWASP packages use the common runtime functionality implemented here. They export the function runX where X is the name of the application, which can be called as:

const filesOut = await runX(args, filesIn, { stdout, stderr, decodeASCII: true });

Arguments and return value:

  • The args argument is an array of command line arguments, e.g. ['--version']. The 0th argument (program name) is not provided, since it is fixed and determined by the application.
  • The filesIn argument is an object associating filenames with contents, e.g. {"inv.v": "module inv(input a, output o); assign o = ~a; endmodule"}. The values can be strings or instances of Uint8Array (which specify files), or, recursively, the same kind of object (which specifies a directory). The specified files and directories are placed in the root of the virtual filesystem.
  • The filesOut return value is the same kind of object as filesIn, representing the state of the virtual filesystem after the application terminated. It contains all of the data provided in filesIn as well, unless these files were modified or removed by the application.

Options:

  • The stdout and stderr options are functions that are called with a sequence of bytes the application prints to the standard output and standard error streams respectively, or null to indicate that the stream is being flushed. If specified as null, the output on that stream is ignored. By default, each line of text from the combined streams is printed to the debugging console.
  • The decodeASCII option determines whether the values corresponding to files in filesOut are always instances of Uint8Array (if decodeASCII: false), or whether the values corresponding to text files will be strings (if decodeASCII: true). A file is considered a text file if it contains only bytes 0x09, 0x0a, 0x0d, or those in the range 0x20 to 0x7e inclusive. The default is decodeASCII: true.

If the application returns a non-zero exit code, the exception Exit (exported alongside the runX function) is raised. This exception has two properties:

  • The code property indicates the exit code. (Currently this is always 1 due to WebAssembly peculiarities.)
  • The files property represents the state of the virtual filesystem after the application terminated. This property can be used to retrieve log files or other data aiding in diagnosing the error.

Calling await runX() (with no arguments) does not run the application, but ensures that all of the necessary resources are fetched and available for use. Once this is done, the additional overload, below, becomes available, which executes the application synchronously instead of returning a promise. This form should only be used in Web Workers and similar non-UI threads, in contexts where the use of an asynchronous API is infeasible.

const filesOut = runX(args, filesIn, { ..., synchronously: true });

Utility API reference

This package also exports utilities that are useful when running other JavaScript YoWASP packages. These can be used as:

import { lineBuffered, chunked } from '@yowasp/runtime/util';
  • The lineBuffered(processLine) function takes a function processLine(line) that accepts a line of text (e.g. console.log), and returns a function processBytes(bytes) that accepts a Uint8Array of encoded characters (or null, which is ignored). Each byte sequence ending in the \n byte, not including it, is decoded as UTF-8 (invalid sequences are substituted with a replacement character) and passed to processLine().
  • The chunked(text) function takes text and returns a function getChunk(byteLength) that slices off a Uint8Array of UTF-8 code points of the requested length and returns it. Once it exhausts the input, getChunk() returns null whenever it is called.

License

This package is covered by the ISC license.