reserve

REserve 2️⃣ Documentation

[!IMPORTANT] Migration guide From v1 to v2

✅ Configuration

There are two ways to use REserve :

• Run as a standalone command line with a configuration file (default name is reserve.json)
• Embed with its configuration in a custom application

In both cases, the configuration must comply with the properties and mappings documented here.

[!TIP] tips & tricks

⚙ Handlers

REserve is delivered with the following default handlers :

• file : to serve resources from the file system
• status : to end response with a specific status
• url : to serve resources from a web address
• custom : to enable custom coding
• use : to integrate packaged middlewares (express)

Other additional handlers can be installed separately and plugged through the handlers configuration property. If you plan to build your own handler, here is what you need to know.

⚡ Server events

The REserve server object implements an interface that mimics the EventEmitter::on method and, during execution, it triggers events with parameters to notify any listener of its activity.

🧰 Helpers

REserve offers some helpers to simplify implementations :

• log : to handle and output server logs
• interpolate : to interpolate values in a string or an object
• body : to read a request body
• send : to build a response
• capture : to copy the response stream to another stream (for instance: to create a cache)
• punycache : a minimalist cache implementation

🧪 Testing / Mocking

REserve includes a mocking environment to ease the tests. It takes the configuration and returns a fake server object augmented with a request method to simulate incoming requests.

⌛ Version history

Here is the history of versions with their associated changes.

📚 Articles

Rational

Sometimes, a simple idea leads to very interesting projects. This article explains the creation of REserve best described as a lightweight web server statically configurable with regular expressions that can also be embedded and extended.

Technical details

Based on a clean concept, the development of REserve follows a simple architecture that enables flexibility and extensibility. This article provides keys to understand the modular structure of the implementation.

Serving an OpenUI5 application

The best way to explain what REserve can do is to demonstrate some of its features through a concrete use case. This article illustrates how one can quickly setup a server to facilitate the execution of OpenUI5 applications.

Cache and Proxy

With version 1.8.0, REserve offers the capture helper that enables the copy of the response content while processing a request. In this article, an example will be presented in two different flavors to illustrate the new possibilities introduced by this tool.

This site is open source. Improve this page.