caslex 0.2.5

Tools for creating web services
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

# caslex

`caslex` is a set of tools for creating web services.

![GitHub CI](https://github.com/mkbeh/rust-simple-chat/actions/workflows/ci.yml/badge.svg)
[![Latest Version](https://img.shields.io/crates/v/caslex.svg)](https://crates.io/crates/caslex)
[![Documentation](https://docs.rs/caslex/badge.svg)](https://docs.rs/caslex)

More information about this crate can be found in the [crate documentation](https://docs.rs/caslex/latest/caslex/).

## High level features

* HTTP web server
* HTTP middlewares (auth, metrics, trace)
* Builtin OpenAPI visualizer
* Errors handling
* JWT
* Postgres Pool
* Observability
* Extra utils

## Usage example

```rust
use caslex::server::{Config, Server};
use utoipa_axum::{router::OpenApiRouter, routes};

#[utoipa::path(
    get,
    path = "/",
    responses(
        (status = 200, description = "Ok")
    )
)]
async fn handler() -> &'static str {
    "Hello, World!"
}

#[tokio::main]
async fn main() {
    let config = Config::parse();
    let router = OpenApiRouter::new().routes(routes!(handler));

    let result = Server::new(config).router(router).run().await;
    match result {
        Ok(_) => std::process::exit(0),
        Err(_) => {
            std::process::exit(1);
        }
    }
}
```

You can find this [example](https://github.com/mkbeh/caslex/tree/main/examples/http-hello-world) as well as other example projects in the [example directory](https://github.com/mkbeh/caslex/tree/main/examples).

See the [crate documentation](https://docs.rs/caslex/latest/caslex/) for way more examples.

## Safety

This crate uses `#![forbid(unsafe_code)]` to ensure everything is implemented in 100% safe Rust.

## Examples

The [examples](https://github.com/mkbeh/caslex/tree/main/examples) folder contains various examples of how to use axum. The [docs](https://docs.rs/caslex/latest/caslex/) also provide lots of code snippets and examples.

## Projects

List of projects using `caslex`:

- [rust-simple-chat](https://github.com/mkbeh/rust-simple-chat): sample project.

## License

This project is licensed under the [MIT license](https://github.com/mkbeh/caslex/tree/main/caslex/LICENSE).