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

@jfhbrook/just

v1.0.0

Published

a wrapper for casey/just

Downloads

5

Readme

@jfhbrook/just

a wrapper for casey/just.

I like using just to coordinate running pipelines of mostly shell code, something node is mediocre for at best. but I sometimes want to use it from wrapper scripts, which may have more sophisticated options parsing, configure environments, and so on. other times, I want to have tighter integration between gulp and just. this lil library helps.

examples

running a just recipe

suppose you bundle a justfile in your node app:

# ./justfile

set dotenv-load := false

hello message:
  echo "{{message}}"

here's how you can execute just hello world from nodejs:

// ./index.js

const path = require('path');
const { Just } = require('@jfhbrook/just');

(async function main() {
  const just = new Just(path.join(__dirname, 'justfile'));

  // just hello world
  await just.run('hello', 'world');
})();

calling just recipes from gulp (beta)

here's how you can get gulp-cli to run just recipes:

const path = require('path');

const { registry, series } = require('gulp');

const { JustRegistry } = require('@jfhbrook/just/gulp');

registry(new JustRegistry(path.join(__dirname, 'justfile')));

exports.default = series('just:task');

I haven't figured out how to pass parameters to just in a reasonable way yet, so expect this to change quite a bit.

install

in order for this to work, you'll need to install just. your package manager probably has it, and cargo definitely has it. I might bundle a few builds in the future but haven't decided to yet.

afterwards, run npm install @jfhbrook/just and you should be off to the races.

api

Just

const just = new Just(JUSTFILE);

create a new just instance with the supplied justfile.

just.run

await just.run(...args)

run a just command, using the instance's justfile. stdio are inherited and non-zero exits will throw an error.

my needs don't require piping the output elsewhere and finding an ergonomic child process api in node is a yak I am NOT shaving today.

just.dump

const dump = await just.dump();

runs just --unstable --dump --dump-format json and parses and returns the results. note the --unstable flag - I've historically had to install a beta version of just to get it working. idk if that's still required today because I haven't messed with it in a while!

development

I actually wrote tests!! you can run them with npm test.

no linting or prettifier. I think my code is pretty.

license

MIT!