hub / github.com/djc/mendes
github.com/djc/mendes @main
Chat with this repo
265 symbols
410 edges
19 files
17 documented · 6%
Browse by type
What it actually does AI analysis from the code graph — generated when you open this
loading…
README
Mendes: web toolkit for impatient perfectionists
Mendes is a Rust web toolkit for impatient perfectionists (apologies to Django). It aims to be:
- Modular: less framework, more library; pick and choose components
- Async: async/await from the start
- Low boilerplate: easy to get started, but with limited "magic"
- Type-safe: leverage the type system to make error handling low effort
- Secure: provide security by default; no unsafe code in this project
- Run on stable Rust (no promises on MSRV though)
Mendes is currently in an extremely early phase and probably not ready for anything but experiments for those who are curious. Feedback is always welcome though!
Minimal example
This should definitely become more minimal over time.
use async_trait::async_trait;
use hyper::Body;
use mendes::application::IntoResponse;
use mendes::http::request::Parts;
use mendes::http::{Response, StatusCode};
use mendes::{handler, route, Application, Context};
#[handler(GET)]
async fn hello(_: &App) -> Result<Response<Body>, Error> {
Ok(Response::builder()
.status(StatusCode::OK)
.body("Hello, world".into())
.unwrap())
}
struct App {}
#[async_trait]
impl Application for App {
type RequestBody = ();
type ResponseBody = Body;
type Error = Error;
async fn handle(mut cx: Context<Self>) -> Response<Body> {
route!(match cx.path() {
_ => hello,
})
}
}
#[derive(Debug)]
enum Error {
Mendes(mendes::Error),
}
impl From<mendes::Error> for Error {
fn from(e: mendes::Error) -> Self {
Error::Mendes(e)
}
}
impl From<&Error> for StatusCode {
fn from(e: &Error) -> StatusCode {
let Error::Mendes(e) = e;
StatusCode::from(e)
}
}
impl IntoResponse<App> for Error {
fn into_response(self, _: &App, _: &Parts) -> Response<Body> {
let Error::Mendes(err) = self;
Response::builder()
.status(StatusCode::from(&err))
.body(err.to_string().into())
.unwrap()
}
}
All feedback welcome. Feel free to file bugs, requests for documentation and any other feedback to the issue tracker.
Mendes was created and is maintained by Dirkjan Ochtman.
Extension points exported contracts — how you extend this code
ToField (Interface)
(no doc) [12 implementers]
mendes/src/forms.rs
IntoResponse (Interface)
(no doc) [9 implementers]
mendes/src/application.rs
FromContext (Interface)
(no doc) [16 implementers]
mendes/src/application.rs
Application (Interface)
(no doc) [5 implementers]
mendes/src/application.rs
AppWithCookies (Interface)
Cookie manipulation methods, contingent upon the `Application`'s access to an AEAD `Key` [1 implementers]
mendes/src/cookies.rs
Core symbols most depended-on inside this repo
path
called by 11
mendes/src/application.rs
next
called by 10
mendes/src/application.rs
path_str
called by 5
mendes/src/application.rs
parse
called by 4
mendes-macros/src/forms.rs
visibility
called by 4
mendes-macros/src/route.rs
uri
called by 4
mendes/src/application.rs
size_hint
called by 4
mendes/src/body.rs
as_str
called by 3
mendes/src/body.rs
Shape
Languages
Rust100%
Modules by API surface
mendes/src/multipart.rs41 symbols
mendes/tests/basic.rs32 symbols
mendes/src/application.rs32 symbols
mendes/src/forms.rs26 symbols
mendes/src/body.rs22 symbols
mendes/src/cookies.rs19 symbols
mendes/src/hyper.rs17 symbols
mendes/tests/hyper.rs12 symbols
mendes/tests/cookies.rs11 symbols
mendes/tests/body.rs11 symbols
mendes-macros/src/route.rs8 symbols
mendes/src/key.rs7 symbols
For agents
$ claude mcp add mendes \
-- python -m otcore.mcp_server <graph>