Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/axiosleo/node-koapp
About Design for quickly developing OpenAPI applications using Node.js
https://github.com/axiosleo/node-koapp
Last synced: 3 days ago
JSON representation
About Design for quickly developing OpenAPI applications using Node.js
- Host: GitHub
- URL: https://github.com/axiosleo/node-koapp
- Owner: AxiosLeo
- License: mit
- Created: 2022-07-25T06:53:28.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-20T01:00:25.000Z (3 months ago)
- Last Synced: 2024-09-21T13:11:05.369Z (about 2 months ago)
- Language: JavaScript
- Size: 130 KB
- Stars: 3
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# @axiosleo/koapp
[](https://npmjs.org/package/@axiosleo/koapp)
[](https://npmjs.org/package/@axiosleo/koapp)
[](https://github.com/AxiosLeo/node-koapp/actions/workflows/ci.yml)
[](https://codecov.io/gh/AxiosLeo/node-koapp)
[](LICENSE)
[](https://app.fossa.com/projects/git%2Bgithub.com%2FAxiosLeo%2Fnode-koapp/refs/branch/master)
> Design for quickly developing Web applications using Node.js
>
> Based on [koa](https://koajs.com/)
```bash
npm install @axiosleo/koapp
```
## Initialization
```bash
npx @axiosleo/koapp init -d
# show help info
# npx @axiosleo/koapp init -h
```
## Quick Start
```javascript
const { KoaApplication, Router, success } = require("@axiosleo/koapp");
const handle = async (ctx) => {
success({
message: "Hello World!",
});
};
const router = new Router("/test", {
method: "any",
handlers: [handle],
});
const app = new KoaApplication({
port: 8088,
listen_host: "localhost", // 0.0.0.0 for public access
routers: [router],
});
app.start();
// open http://localhost:8088/test
```
## More Examples
- Validation
> see [validatorjs](https://github.com/mikeerickson/validatorjs) for more rule examples
>
> see `Router` examples for more usage: [tests/bootstrap.js](tests/bootstrap.js)
```javascript
const { Router } = require("@axiosleo/koapp");
const router = new Router("/test", {
method: "any",
validator: {
// url params, like `/test/{:id}`, the 'id' is required and must be an integer
params: {
id: "required|integer",
},
query: {
name: "required|string",
},
body: {
age: "required|integer",
}
}
handlers: [],
});
```
## License
This project is open-sourced software licensed under [MIT](LICENSE).
[](https://app.fossa.com/projects/git%2Bgithub.com%2FAxiosLeo%2Fnode-koapp/refs/branch/master/)