Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ngyn-rs/ngyn
A progressive Rust framework for building scalable web applications through an opinionated architecture.
https://github.com/ngyn-rs/ngyn
backend framework hyper macros-rust rust server vercel web
Last synced: 8 days ago
JSON representation
A progressive Rust framework for building scalable web applications through an opinionated architecture.
- Host: GitHub
- URL: https://github.com/ngyn-rs/ngyn
- Owner: ngyn-rs
- License: mit
- Created: 2023-08-15T05:38:53.000Z (about 1 year ago)
- Default Branch: dev
- Last Pushed: 2024-10-22T04:13:40.000Z (16 days ago)
- Last Synced: 2024-10-23T06:29:24.877Z (15 days ago)
- Topics: backend, framework, hyper, macros-rust, rust, server, vercel, web
- Language: Rust
- Homepage: https://ngyn.rs
- Size: 1.27 MB
- Stars: 21
- Watchers: 3
- Forks: 1
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# ngyn (`en·jn`)
[](https://crates.io/crates/ngyn)
[](https://ngyn.rs)
[](LICENSE.md)
[](https://github.com/acekyd/made-in-nigeria)
A progressive framework in [Rust](https://www.rust-lang.org/) for building scalable web servers through an opinionated architecture.
More information about Ngyn can be found in the [documentation](https://ngyn.rs).
## Features
- Macro API for organizing your application into reusable components
- Asynchronous middleware for handling requests and responses
- Asynchronous routing support for defining routes
- [Platform-agnostic](#platform-agnosticism) for supporting multiple libraries and frameworks
Please note that Ngyn is still in its early stages of development, and the API is subject to change.
## Example
This example demonstrates how to create a simple web server using Ngyn and [Hyper](https://hyper.rs) Platform.
```toml
[dependencies]
ngyn = { version = "0.4" }
```
And here's the code:
```rust ignore
use ngyn::prelude::*;
use ngyn_hyper::HyperApplication;
#[controller]
struct MyController;
#[routes]
impl MyController {
#[get("/")]
fn index(&self) -> String {
"Hello World!".to_string()
}
#[get("/hello/")]
fn hello(&self, param: Param) -> String {
let name = param.get("name").unwrap();
format!("Hello, {}!", name)
}
}
#[module(controllers = [MyController])]
struct MyAppModule;
#[main]
async fn main() {
let app = NgynFactory::::create::();
let _ = app.listen("127.0.0.1:8080").await;
}
```
## Philosophy
### Description
Ngyn proposes an opinionated, modular, and scalable architecture, largely inspired by [NestJS](https://nestjs.com/) and structured around the concept of modules - discrete, reusable components that collectively shape an application. These modules, each addressing specific functionalities, can be nested to form a functional hierarchy. This modular design simplifies organization and enhances reusability across various projects.
### Platform Agnosticism
A platform (more properly called platform engine) in Ngyn refers to the underlying library or framework that is used to build your application. For example, you could build your web server using [Actix](https://actix.rs/) or [Warp](https://docs.rs/warp) or [Tide](https://docs.rs/tide), and each of these platforms would provide a different set of features for building your web server.
By default, Ngyn uses [Hyper](https://hyper.rs) as its underlying platform. However, you're not limited to this and can choose to also create your own platform engines.
## Contribution
Ngyn is an open-source project, and we welcome contributions from the community. Feel free to report issues, suggest enhancements, or submit pull requests to help us improve Ngyn.
## License
Ngyn is licensed under the [MIT License](LICENSE.md), allowing you to use, modify, and distribute the framework freely.