6 releases

0.4.5 Sep 9, 2024
0.4.1 Jul 7, 2024
0.3.0 Dec 27, 2023
0.2.8 Nov 26, 2023

#195 in HTTP server

Download history 20/week @ 2024-08-16 144/week @ 2024-08-23 5/week @ 2024-08-30 108/week @ 2024-09-06 101/week @ 2024-09-13 41/week @ 2024-09-20 20/week @ 2024-09-27 3/week @ 2024-10-04

1,070 downloads per month
Used in ngyn-swagger

MIT license

97KB
1.5K SLoC

ngyn (en·jn)

Crates.io Docs.rs License MSRV Made in Nigeria

A progressive framework in Rust for building scalable web servers through an opinionated architecture.

More information about Ngyn can be found in the documentation.

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 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 Platform.

[dependencies]
ngyn = { version = "0.4" }

And here's the code:

use ngyn::prelude::*;
use ngyn_hyper::HyperApplication;

#[controller]
struct MyController;

#[routes]
impl MyController {
    #[get("/")]
    fn index(&self) -> String {
        "Hello World!".to_string()
    }

    #[get("/hello/<name>")]
    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::<HyperApplication>::create::<MyAppModule>();
    let _ = app.listen("127.0.0.1:8080").await;
}

Philosophy

Description

Ngyn proposes an opinionated, modular, and scalable architecture, largely inspired by NestJS 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 or Warp or Tide, and each of these platforms would provide a different set of features for building your web server.

By default, Ngyn uses Hyper 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, allowing you to use, modify, and distribute the framework freely.

Dependencies

~13–25MB
~381K SLoC