gropius

KO | EN

gitlite — search

#javascript #python #typescript #llm #go #android #rust #nodejs #awesome #cli #pytorch #security #mcp #ios

(★ 9)

Armchair API architecture

gropius Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![Bauhaus-Archiv Darmstadt (1964–1968), Preliminary planning for a plot of land on Rosenhöhe, view from the north-west, Architects: Walter Gropius and Louis McMillen, 1964](https://raw.githubusercontent.com/BauplanLabs/gropius/main/docs/gropius.png)

# Gropius

Gropius is a Rust toolkit for designing APIs. It's compatible with OpenAPI 3.1.x, but, unlike most toolkits, it lets you generate the spec from the code, instead of the code from the spec:

```rust
/// A chair designed by Walter Gropius.
#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema)]
struct Chair {
    id: String,
    year: u32,
    description: String,
}

#[gropius::api(tags = ["chairs"])]
/// Explore chairs designed by Walter Gropius.
trait ChairApi {
    /// List chairs by year.
    #[endpoint(GET, "/chairs/{year}")]
    async fn list_chairs(&self, path: gropius::Path<u16>) -> Result<Vec<Chair>, ApiError>;

/// Get a chair by ID.
    #[endpoint(GET, "/chairs/{year}/{id}")]
    async fn get_chair(&self, path: gropius::Path<(u64, String)>) -> Result<Widget, ApiError>;
}
```

For more details, head to the [docs](https://docs.rs/gropius).

## Features

The crate is new and is currently **alpha quality**. However, it has several distinguishing features compared to similar libraries:

- Integrates with `tower::Service` and `hyper` on the server
 - Integrates with either `reqwest` or `ureq` on the client 
 - Supports grouping endpoints into multiple traits, which can then be combined in a single API surface
 - Supports OpenAPI 3.1.x, with 3.2.x support planned

## Similar crates

Gropius is inspired by and indebted to these libraries, which have a similar approach:

- [`oxidecomputer/dropshot`](https://github.com/oxidecomputer/dropshot)
 - [`juhaku/utoipa`](https://github.com/juhaku/utoipa)

gropius

gropius Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

gropius

gropius Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README