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

promirepl

v2.0.1

Published

Promise infused REPL

Downloads

16,394

Readme

promirepl

A promise infused REPL.

Promirepl provides a Node.js REPL which will automagically unwrap promise values. It also is Node module, with a function that can add these magical promise inspecting capabilities to your own custom REPLs.

This allows you to use promise based APIs from the REPL just as easily as old fashioned synchronous APIs, without a lot of messing around with callbacks and console.log to get at asynchronous values from the REPL.

Installation

Promirepl can be installed with npm install -g promirepl. This installs the prominode executable, which starts a Node.js REPL that has magical promise unwraping capabilities.

Usage

$ prominode

Whenever a value evaluates to a promise (well, technically a thenable), promirepl will wait for the promise to resolve.

> Promise.resolve('hello')
'hello'

> new Promise((resolve) => {
... setTimeout(() => { resolve('some time later'); }, 3000);
... })
'some time later'

If the promise is rejected, it will evaluate as a thrown error.

> Promise.reject(new Error('boom'))
Error: boom
    at repl:1:16
    at REPLServer.defaultEval (repl.js:135:27)

If you would like to stop waiting on a promise, hit escape.

> new Promise(function () {})
Hit escape to stop waiting on promise
break.

If you would like to disable promise unwrapping, enter the .promise command.

> .promise
Promise auto-eval disabled

> Promise.resolve('hello')
{}

> Promise.reject(new Error('boom'))
{}

Programmatic Usage

If you would like to use promirepl within your own custom REPL, use the exported promirepl function.

const customRepl = createCustomRepl();
const { promirepl } = require('promirepl');
promirepl(customRepl.start({}));