# Rohanasan
### An extremely fast backend framework built for rust
[](https://crates.io/crates/rohanasan)
[](https://docs.rs/rohanasan)
[](https://opensource.org/licenses/MIT)
**Made with Performance, optimization and ease of use in mind.**
**Currently available in C/C++/Rust programming languages only.**
**This library has been built from scratch using tokio.**
# Basic hello world example:
> Basic Html implementation of hello world:
```rust
use rohanasan::{
rohanasan, send_http_response, serve, Request, DEFAULT_HTML_HEADER,
};
fn handle(req: Request) -> String {
send_http_response(DEFAULT_HTML_HEADER, "Hello!
", req)
}
fn main() {
rohanasan! {
serve(8080, handle)
}
}
```
# How to use in your project?
- Open terminal inside the parent folder where you would like to create the folder of your project
- Run:
```shell
cargo install rohanasanpm
rohanasanpm new my_proj
```
- `cd` into my_proj
- `cargo run` to run your project.
- Go to: `localhost:8080`.
- Enjoy using Rohanasan!
# How to run the example?
```shell
git clone https://github.com/rohanasan/rohanasan-rs.git
cd rohanasan-rs
cd examples
cargo run --example standard
```
## Discord server link:
[https://discord.gg/Yg2A3mEret](https://discord.gg/Yg2A3mEret)
## Performance:
### Machine Specs:
OS: Garuda Linux x86_64
Laptop: Dell Inspiron 5590
Kernel: 6.8.1-zen1-1-zen
Mode: GUI mode (terminal was running like a window)
Shell: fish 3.7.0
Terminal: konsole 24.2.1
CPU: Intel(R) Core(TM) i3-10110U (4) @ 4.10 GHz
GPU: Intel UHD Graphics (The CPU itself)
Memory: 11.47 GiB
Command used to run test: wrk -t 2 -c 100 http://localhost:8080
### Results:
| Thread Stats | Avg | Stdev | Max | +/- Stdev |
|--------------|----------|----------|--------|-----------|
| Latency | 844.10us | 480.14us | 4.14ms | 64.85% |
| Req/Sec | 26.24k | 831.40 | 28.10k | 70.00% |
Output: 522523 requests in 10.02s, 46.84MB read
Requests/sec: 52142.29
Transfer/sec: 4.67MB
Program that was run: examples/hello_world.rs
### Current Features:
- Can run a server at a specified port
- Can serve a folder named static at /static
- Can send files as http response
- Can give you the path, method and protocol
### TODO:
- Add feature to change the directory path of the public folder ☑️ Done!!!!
- Asynchronous file request handling ☑️ Done!!!!
- Add feature to give the user an option to add index.html to static folder ☑️ Done!!!!
- Add feature of `request.post_request()`
- Add feature to... currently it's just a pre alpha release I have to add a lot of features right now!
### Contribute:
- Please support rohanasan:
[https://www.buymeacoffee.com/rohanvashisht](https://www.buymeacoffee.com/rohanvashisht)
- Please star rohanasan's github repo:
[https://github.com/rohanasan/rohanasan-rs](https://github.com/rohanasan/rohanasan-rs)
# Examples
- **Hello world (Html File):**
> Basic Html implementation of hello world:
```rust
use rohanasan::{
rohanasan, send_file, serve, Request, DEFAULT_HTML_HEADER,
};
fn handle(req: Request) -> String {
send_file(DEFAULT_HTML_HEADER, "./html/index.html", req)
}
fn main() {
rohanasan! {
serve(8080, handle)
}
}
```
## Points to remember:
- There is no need to import tokio for using rohanasan macro.
- By default, rohanasan serves any folder named static present in the same directory where you are running the server.