New Case Study:See how Anthropic automated 95% of dependency reviews with Socket.Learn More
Socket
Sign inDemoInstall
Socket

piping-no-error-suppression

Package Overview
Dependencies
Maintainers
1
Versions
2
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

piping-no-error-suppression

Keep your code piping hot! Live code reloading without additional binaries

  • 0.3.1
  • latest
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
2
decreased by-60%
Maintainers
1
Weekly downloads
 
Created
Source

Piping

There are already node "wrappers" that handle watching for file changes and restarting your application (such as node-supervisor), as well as reloading on crash, but I wasn't fond of having that. Piping adds "hot reloading" functionality to node, watching all your project files and reloading when anything changes, without requiring a "wrapper" binary.

Piping uses the currently unstable "cluster" API to spawn your application in a thread and then kill/reload it when necessary. Because of this, piping should be considered unstable and should not be used in production (why would you ever need live code reloading in production anyway). Currently, at least on windows, the cluster API seems stable enough for development.

Also check out piping-browser which does a similar job for the browser using browserify

Installation

npm install piping

Usage

Piping is not a binary, so you can continue using your current workflow for running your application ("wooo!"). Basic usage is as follows:

if (require("piping")()) {
  // application logic here
  express = require("express");
  app = express();
  app.listen(3000);
}

or in coffeescript:

if require("piping")()
  # application logic here
  express = require "express"
  app = express()
  app.listen 3000

This if condition is necessary because your file will be invoked twice, but should only actually do anything the second time, when it is spawned as a separate node process, supervised by piping. Piping returns true when its good to go.

the function returned by piping also accepts an options object. The following options are supported:

  • main (path): The path to the "top" file of your application. Defaults to require.main.filename, which should be sufficient provided you launch your application via "node yourapp.js". Other launch methods may require this to be set manually. If your app doesn't reload/reloads when it shouldn't, try changing this.
  • hook (true/false): Whether to hook into node's "require" function and only watch required files. Defaults to false, which means piping will watch all the files in the folder in which main resides. The require hook can only detect files required after invoking this module!
  • includeModules (true/false): Whether to include required files than reside in node_modules folders. Defaults to false. Only has an effect when hook is true. For ignoring node_modules when hook is false, please use ignore.
  • ignore (regex): Files/paths matching this regex will not be watched. Defaults to /(\/\.|~$)/
  • language (string): The name of a module that will be required before your main is invoked. This allows for "coffee-script" to be specified to support a coffeescript main, launchable though "coffee". Probably works for other languages as well. Coffeescripters don't actually need this, as coffee-script is required automatically if main is a .coffee file.
  • usePolling (true/false) : From chokidar. Default false. Whether to use fs.watchFile (backed by polling), or fs.watch. It is typically necessary to set this to true to successfully watch files over a network.
  • interval (true/false) : From chokidar. Polling specific. Interval of file system polling (default 100).
  • binaryInterval (true/false) : From chokidar. Polling specific. Interval of file system polling for binary files.
  • respawnOnExit (true/false) : Default true. Whether the application should respawn after exiting. If you experience problems with infinite loops, try setting this to false.

Example:

if (require("piping")({main:"./app/server.js",hook:true})){
  // app logic
}

Piping can also be used just by passing a string. In this case, the string is taken to be the "main" option:

if (require("piping")("./app/server.js")){
  // app logic
}

One negative of all the examples above is the extra indent added to your code. To avoid this, you can choose to return when piping is false:

if (!require("piping")()) { return; }
// application logic here

or in coffeescript:

if not require("piping")() then return
# application logic here

Keywords

FAQs

Package last updated on 22 Mar 2016

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc