Argos

Argos makes it easy to create a stand-alone web application backend server.

Usage

Simple Example

Step 1: Define your API function

You can define your api function with a macro-attribute:

```rust

[route(GET, path = "/api/hello", formatter = "text")]

pub fn hello(req: HttpRequest) -> Result> { let urlparams = req.urlparams(); let name = urlparams.get("name"); match name { Some(name) => Ok(format!("hello {}!", name)), None => Err( ReturnError::new( 400, "name is required".tostring(), ) ), } } ```

this function define a http interface with GET method, and url path is /api/hello.

Step 2: Start a server

You can start your server like this: ```rust

[tokio::main]

async fn main() { let server = Server::builder(([127, 0, 0, 1], 3000).into()) .build() .await .unwrap(); server.start().await.unwrap(); } ```

Your server will bind in 127.0.0.1:3000, so you can send a http request to call this API:

shell curl http://127.0.0.1:3000/api/hello?name=liudao

Filter

You can define a filter to filt the request:

```rust

[filter(path_pattern="/api/hello.*", order=1)]

pub fn pathfilter(mut req: HttpRequest) -> Chain { let attr = req.attributesmut(); attr.insert("kk".tostring(), "value".tostring()); // let method = req.methodmut(); if req.headers().containskey("token") { Chain::Continune(req) } else { let mut returnerr = ReturnError::new( 401, "not authorized".tostring(), ); returnerr.headers.append("filter", HeaderValue::fromstr("rejected").unwrap()); Chain::Reject(returnerr) }

} ```

Filter now only support path_pattern, using regexp. The attribute order represents the priority of the filter, the smaller the number, the higher the priority.

See more examples in core/examples.

License

Argos is provided under the MIT license. See LICENSE.