This is not GitHub.com

Like what you see? Install OctoLinker now!

Skip to content
The development environment for `micro`
JavaScript
Branch: master
Clone or download
trotzig and timneutkens Use `npm run` consistently throughout README (#93)
I was reading through the README and noticed that one of the command examples uses `yarn run` instead of `npm run` (like all others examples). Not that I have anything against yarn, but it feels better to be consistent about this throughout the document.
Latest commit 7ea8ae0 Jan 8, 2019

README.md

This command line interface provides a belt full of tools that make building microservices using micro a breeze! It's only meant to be used in development, not in production (that's where micro comes in).

CircleCI Join the community on Spectrum

Features

  • Hot Reloading: When making changes to your code, the server will restart by itself
  • Logs: Incoming and outgoing requests will be logged to stdout
  • Beautiful JSON: When JSON bodies are logged, they're styled and prettified
  • Clipboard Support: The local address is pasted to the clipboard automatically
  • Port Selection: Automatic detection and use of an open port (if the specified one is in use)
  • Debug in Your Network: The network address shown in addition to local one
  • Duration Logs: Calculates and shows the duration for each request
  • Pretty Errors: Prettifies the Error object if any exceptions are thrown

Usage

Important: This tool is only meant to be used in development. In production, you should use micro, which is much lighter and faster (and also comes without the belt of tools used when developing microservices).

When preparing your development environment, firstly install micro-dev:

npm install --save-dev micro-dev

Note: You'll need at least Node.js v7.6.0 to run micro-dev.

Next, add a new script property below micro inside package.json:

"scripts": {
  "start": "micro",
  "dev": "micro-dev"
}

As the final step, start the development server like this:

npm run dev

Debugging

The package can be used in conjunction with the Node.js inspector like this:

"scripts": {
  "inspect": "node --inspect node_modules/.bin/micro-dev"
}

As the final step, start the development server like this:

npm run inspect

Contributing

  1. Fork this repository to your own GitHub account and then clone it to your local device
  2. Move into the directory of the clone: cd micro-dev
  3. Link it to the global module directory of Node.js: npm link

Inside the project where you want to test your clone of the package, you can now either use npm link micro-dev to link the cloned source to your project's local dependencies or run micro-dev right in your terminal.

Authors

You can’t perform that action at this time.