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

prorenata

v1.0.53

Published

Declarative task runner with commands that work on file path hierarchies

Downloads

4

Readme

Prorenata

P.R.N. (As the circumstance arises)

Motivation

The venerable make command is the inspiration for prorenata.

Building, testing and deploying software requires a sequence a steps which need to be followed each time a file or one of its dependencies changes. In most cases, these steps should be conditioned on file timestamps, where a step should only be redone when the output of its previous execution is older than the corresponding input file's timestamp. In other words, only execute the step on an as needed basis.

The name of this utility comes from nursing jargon prorenata (p.r.n.) which means "as the circumstance arises".

Prerequisites and installation

The prorenata utility uses Node.js. Package installation is done via NPM.

This utility requires the BLUE-PHRASE parser, which is distributed with each copy of validly licensed Read Write Tools premium tools.

To install the utility and make it available to your Bash shell, use this command.

[user@host]# npm install -g prorenata

Usage

The software is invoked from the command line with:

[user@host]# renata [script-file]

The script file contains commands in this form:

command {
   parameter value
}

Commands

There are 6 built-in commands:

  1. copy recursively copies all files in to
  2. compare lists files that are in but not in
  3. clean removes files that are older than
  4. recurse runs a template-defined command recursively over all files in
  5. run executes an arbitrary shell command
  6. template defines new commands for use with the parameter of recurse

Any name that does not match one of these 6 is considered to be a user-defined command, and it may be used as a command in a template.

Parameters

The are 15 built-in parameters:

  1. source an absolute or relative path
  2. dest an absolute or relative path
  3. include+ a file pattern to include, if omitted defaults to '*'
  4. exclude+ a file pattern to exclude
  5. extension the filename extension to apply to destination filenames
  6. exec a command name defined in the template section
  7. overwrite: always | older | never‡
  8. mkdir: true‡ | false (create missing directories)
  9. preserve: true | false‡ (preserve timestamps)
  10. trigger an absolute or relative filename
  11. dependent+ an absolute or relative path
  12. sh+ a shell command to execute
  13. if+ a conditional if [hostname ==] | [hostname !=] then ... else ...
  14. progress: verbose | regular‡ | none
  15. onerror: continue | halt‡

+ parameter that may be provided multiple times

‡ optional parameter default value

Any name that does not match one of these 15 is considered to be a user-defined parameter. Both built-in and user-defined parameters may be used as substitution variables in a template.

The parameters that may be used with each command are:

* required parameter

A pair of less-than and greater-than characters are used to enclose a named substitution variable. Use substitutions with recurse, copy and compare commands. Place substitution variables in a template, and the current path or filename will be substituted.

The substitution variables:

Examples

Here is an example using copy to recursively copy files with *.html extension from 'foo' to 'bar'

copy {
   source  foo
   dest    bar
   include '*.html'
}

Here is an example using template and recurse to compile LESS into CSS from 'foo' to 'bar'

template {
   compile-css lessc <source> <dest>
}
recurse {
   source    foo
   dest      bar
   include   '*.less'
   extension '.css'
   exec      compile-css
}

Here is an example using template and a user-defined command to count the number of files in 'foo' with an 'html' extension

template {
   count-by-ext ls -l <path> | grep <ext> | wc -l
}
count-by-ext {
   path      foo
   ext       html
}

License

The prorenata command line utility is licensed under the MIT License.

Availability