divisions v0.1.4
Divisions šæ
Minimalist modular backend development
Modular Node.js backend development, management, and orchestration of backend applications.
It promotes a clean separation of concerns by structuring applications into distinct functional units, called "divisions".
Features
- š§© Modular Design: Clean architectural separation into distinct divisions.
- š Dependency Management: Ensures correct initialization order of divisions.
- ā Environment Variables Validation: JSON Schema validation for environment variables.
- š„ CLI Integration: Defines and executes division-specific commands.
- š Dynamic Lifecycle Management: Custom setup and teardown routines for resource management.
Motivation
In complex applications, managing configurations, dependencies, and initialization order can become challenging.
Divisions was created to address these challenges by offering a structured way to organize application logic into manageable, isolated modules.
This approach not only improves code maintainability but also enhances the development workflow by providing clear interfaces for each part of the application.
Inspired by the modular philosophy, Divisions aims to bring simplicity, clarity, and efficiency to backend application development.
Getting Started
Prerequisites
Node.js version 20.11.0 or higher is required.
Installation
Install divisions
via npm/yarn/pnpm:
npm install divisions
Setup
Our goal is to create a division called http
to create our http server.
- Create the
divisions
directory. It will contains all our divisions directories. - Create your first division directory
divisions/http
. - Create
divisions/http/index.js
with the following content:
// divisions/http/index.js
import http from "node:http";
export const meta = {
// Define environment variables schema for validation
envSchema: {
type: "object",
properties: {
PORT: { type: "integer" },
},
required: ["PORT"],
},
};
// Define division setup
export function setup({ config }) {
const httpServer = http.createServer((_request, response) => {
response.writeHead(200, { "Content-Type": "text/plain" });
response.end("Hello from http division š");
});
return {
// On start `http` division
start() {
httpServer.listen(config.PORT, () => {
console.info(`HTTP Server running at http://localhost:${config.PORT}`);
});
return {
// Close `http` division in a clean way
cleanup() {
httpServer.close();
console.info("HTTP Server has been closed");
},
};
},
};
}
- Create a
.env
file at the root of your project containing all environment variables used by our divisions.
PORT=3000
- Create
index.js
to start divisions. This operation will import your divisions and execute them.
import { startDivisions } from "divisions";
startDivisions().catch(console.error);
By the end, your project structure should look like this:
.
āāā divisions
ā āāā http
ā āāā index.js
āāā index.js
āāā package.json
- Launch it !
āÆ node index.js
HTTP Server running at http://localhost:3000
āÆ curl http://localhost:3000
Hello from http division š
Contributing
Contributions are welcome! Submit issues, feature requests, or pull requests š¤.
License
Made with š
Published under the MIT license.
Acknowledgements
Inspired by the modular design philosophy and contributions to the open-source Node.js ecosystem by developers worldwide š
3 months ago
3 months ago
3 months ago
3 months ago
3 months ago
3 months ago
4 months ago
4 months ago
4 months ago
4 months ago
4 months ago
4 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago