@artsy/express-reloadable
Development tool that enables hot-swapping Express server code without a restart
Last updated 5 months ago by artsy-engineering .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @artsy/express-reloadable 
SYNC missed versions from official npm registry.

@artsy/express-reloadable

When developing a Node app it's common to rely on tools like node-dev or nodemon to make the development process more rapid by automatically restarting the server instance on file-change. What express-reloadable does is listen for source-code changes within a subset of your app and, scanning Node's internal module cache, clears the require call if found. This tricks Node into thinking the module has not yet been loaded, effectively hot-swapping out your code without a full restart. Additionally, when the watchModules option is passed, express-reloadable will listen for changes to NPM module code and reload on change. Useful when working with yarn link across packages / repos. Crazy-fast development speed!

(Disclaimer: While this works for most of our use-cases, this is an example of "require hacking" and hasn't been tested in all environments. Your mileage may vary :)

How it works:

  • express-reloadable is called with a path to an app, which it then mounts
  • When source-code within that folder / app changes an internal lookup is made to Node, scanning its require cache for the changed file
  • If found, it is cleared internally via delete require.cache[id]
  • When a new request is made express-reloadable executes a callback that re-requires the code and changes are instantly available.

Installation:

yarn add @artsy/express-reloadable

Example:

The below example assumes that the folders /api and /client exist, and that each contain an index file that exports a mountable express.js route.

import express from 'express'
import { createReloadable, isDevelopment } from '@artsy/express-reloadable'

const app = express()

if (isDevelopment) {

  // Pass in `app` and current `require` context
  const mountAndReload = createReloadable(app, require)

  // Pass in the path to an express sub-app and everything is taken care of
  mountAndReload(path.resolve(__dirname, './client'))

  // Full example:
  app.use('/api', mountAndReload(path.resolve(__dirname, './api')), {

    // If you need to mount an app at a particular root (`/api`), pass in
    // `mountPoint` as an option.
    mountPoint: '/api',

    // Or if you're using `yarn link` (or npm) to symlink external dependencies
    // during dev, pass in an array of modules to watch. Changes made internally
    // will be instantly available in the app. Additionally, using something like 
    // `glob`, other modules outside of express route path can be passed.
    watchModules: [
      '@artsy/reaction',
      '@artsy/artsy-xapp'
    ]
  }))

  // If prod, mount apps like normal
} else {
  app.use('/api', require('./api')
  app.use(require('./client')
}

app.listen(3000, () => {
  console.log(`Listening on port 3000`)
})

Troubleshooting:

Help! I've mounted my app using reloadable but I'm not seeing any changes?

For the utility to work you need to a) ensure that NODE_ENV=development (for safety) and b) the path to your app is absolute:

// Incorrect
app.use(reloadAndMount('./path/to/app'))

// Correct :)
app.use(reloadAndMount(path.resolve(__dirname, 'path/to/app')))

Thanks:

This package was heavily inspired by @glenjamin's ultimate-hot-loading-example.

Current Tags

  • 1.4.9-canary.40.206.0                                ...           canary (3 months ago)
  • 1.4.8                                ...           latest (5 months ago)

38 Versions

  • 1.4.9-canary.40.206.0                                ...           3 months ago
  • 1.4.9-canary.40.207.0                                ...           3 months ago
  • 1.4.9-canary.40.195.0                                ...           3 months ago
  • 1.4.9-canary.38.186.0                                ...           3 months ago
  • 1.4.9-canary.37.180.0                                ...           3 months ago
  • 1.4.9-canary.35.173.0                                ...           3 months ago
  • 1.4.9-canary.35.174.0                                ...           3 months ago
  • 1.4.9-canary.36.165.0                                ...           3 months ago
  • 1.4.9-canary.35.164.0                                ...           3 months ago
  • 1.4.9-canary.34.156.0                                ...           4 months ago
  • 1.4.8                                ...           5 months ago
  • 1.4.7                                ...           a year ago
  • 1.4.6                                ...           a year ago
  • 1.4.5                                ...           a year ago
  • 1.4.4                                ...           a year ago
  • 1.4.3                                ...           a year ago
  • 1.4.2                                ...           a year ago
  • 1.4.1                                ...           a year ago
  • 1.4.0                                ...           2 years ago
  • 1.3.1                                ...           2 years ago
  • 1.3.0                                ...           2 years ago
  • 1.2.3                                ...           2 years ago
  • 1.2.2                                ...           3 years ago
  • 1.2.1                                ...           3 years ago
  • 1.2.0                                ...           3 years ago
  • 1.1.2                                ...           3 years ago
  • 1.1.1                                ...           3 years ago
  • 1.1.0                                ...           3 years ago
  • 1.0.9                                ...           3 years ago
  • 1.0.8                                ...           3 years ago
  • 1.0.7                                ...           3 years ago
  • 1.0.6                                ...           3 years ago
  • 1.0.5                                ...           3 years ago
  • 1.0.4                                ...           3 years ago
  • 1.0.3                                ...           3 years ago
  • 1.0.2                                ...           3 years ago
  • 1.0.1                                ...           3 years ago
  • 1.0.0                                ...           3 years ago
Downloads
Today 0
This Week 0
This Month 1
Last Day 0
Last Week 1
Last Month 1
Dependencies (3)
Dev Dependencies (3)
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |