Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/livesey-finance/livesey-routing
a lightweight HTTP router
https://github.com/livesey-finance/livesey-routing
http javascript npm npm-module npm-package routing
Last synced: about 1 month ago
JSON representation
a lightweight HTTP router
- Host: GitHub
- URL: https://github.com/livesey-finance/livesey-routing
- Owner: livesey-finance
- License: mit
- Created: 2024-08-20T09:00:19.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-09-25T13:06:48.000Z (3 months ago)
- Last Synced: 2024-10-13T08:04:29.809Z (2 months ago)
- Topics: http, javascript, npm, npm-module, npm-package, routing
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/livesey-routing
- Size: 37.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
`livesey-routing` is a lightweight HTTP router for Node.js that simplifies handling requests and responses. It provides tools to manage HTTP methods, URL parameters, request bodies, and custom routes.
## Table of Contents
- [Getting Started](#getting-started)
- [Installation](#installation)
- [Usage](#usage)
- [Features](#features)
- [Request Class](#request-class)
- [Response Class](#response-class)
- [Routing](#routing)
- [Contributing](#contributing)
- [License](#license)
- [Contact](#contact)
## Getting Started
### Installation
You can install the module via npm:
```bash
npm install livesey-routing
```
## Usage
Module supports both `ECMAScript` and `CommonJS`:
To use the module in your project(**ESM**):
```js
import http from 'node:http';
import { Router, RouteBuilder } from 'livesey-routing';
const router = new RouteBuilder()
.get('/hello/:name', (req, res) => {
const name = req.params.name;
res.json({ message: `Hello, ${name}!` });
})
.post('/data', async (req, res) => {
const data = await req.parseBody();
res.json({ received: data });
})
.build();
(async () => {
const server = http.createServer((req, res) => {
router.handleRequest(req, res);
});
const port = 3000;
server.listen(port, () => {
console.log(`Server running at http://localhost:${port}/`);
});
})();
```
To use the module in your project(**CJS**):
```js
const http = require('node:http');
const { Router, RouteBuilder } = require('livesey-routing');
const router = new RouteBuilder()
.get('/hello/:name', (req, res) => {
const name = req.params.name;
res.json({ message: `Hello, ${name}!` });
})
.post('/data', async (req, res) => {
const data = await req.parseBody();
res.json({ received: data });
})
.build();
(async () => {
const server = http.createServer((req, res) => {
router.handleRequest(req, res);
});
const port = 3000;
server.listen(port, () => {
console.log(`Server running at http://localhost:${port}/`);
});
})();
```
## Features
### Request Class
The `Request` class provides methods to handle and parse incoming HTTP requests, including access to URL parameters, headers, and the request body.
```js
import { Request } from 'livesey-routing';
const request = new Request(req);
// Access request method
const method = request.method;
// Access URL parameters
const params = request.extractParams('/hello/:name');
// Access request body
const body = await request.parseBody();
```
### Response Class
The `Response` class simplifies sending responses to the client.
```js
import { Response } from 'livesey-routing';
const response = new Response(res);
// Send a JSON response
response.json({ message: 'Success' });
// Send a plain text response
response.send('Hello, world!');
// Set status code
response.status(404).send('Not Found');
```
### Routing
Routing allows you to define custom routes and their associated handlers using the `RouteBuilder` class.
```js
import { RouteBuilder } from 'livesey-routing';
const router = new RouteBuilder()
.get('/user/:id', (req, res) => {
const userId = req.params.id;
res.json({ userId });
})
.post('/submit', async (req, res) => {
const data = await req.parseBody();
res.json({ received: data });
})
.put('/update/:id', async (req, res) => {
const userId = req.params.id;
res.json({ message: `Updated user ${userId}` });
})
.delete('/delete/:id', (req, res) => {
const userId = req.params.id;
res.json({ message: `Deleted user ${userId}` });
})
.build();
```
### Middleware and Nested Routers
You can use middleware and nested routers to structure your application routes more effectively.
```js
import { Router, RouteBuilder } from 'livesey-routing';
const apiRouter = new RouteBuilder()
.get('/search/:query', (req, res) => {
const query = req.params.query;
res.json({ query });
})
.build();
const appRouter = Router.use('/api', apiRouter);
const server = http.createServer((req, res) => {
appRouter.handleRequest(req, res);
});
const port = 3000;
server.listen(port, () => {
console.log(`Server running at http://localhost:${port}/`);
});
```
## Contributing
Contributions are welcome! Please submit a pull request or open an issue to discuss any changes.
## License
This project is licensed under the MIT License.s
## Contact
For any questions or inquiries, please contact [email protected].