36 releases
0.3.11 | Jul 17, 2024 |
---|---|
0.3.9 | May 5, 2023 |
0.2.5 | Mar 31, 2023 |
0.1.20 | Jul 31, 2022 |
0.1.7 | Mar 31, 2022 |
#227 in Web programming
117 downloads per month
Used in 3 crates
63KB
974 lines
Windmark
Windmark is an elegant and highly performant, async Gemini server framework for the modern age!
Now supporting both Tokio and async-std
!
Usage
A macro-based "struct
-router" is currently being developed for Windmark. A
subset of Windmark's features are currently available for use through it. Check
out Rossweisse for more information!
Features
Feature | Description |
---|---|
default |
Base Windmark framework using Tokio |
logger |
Enables the default pretty_env_logger integration |
auto-deduce-mime |
Exposes Response s and macros that automatically fill MIMEs for non-Gemini responses |
response-macros |
Simple macros for all Response s |
tokio |
Marks Tokio as the asynchronous runtime |
async-std |
Marks async-std as the asynchronous runtime |
prelude |
Exposes the prelude module containing the most used Windmark features |
Add Windmark and Tokio as Dependencies
# Cargo.toml
[dependencies]
windmark = "0.3.9"
tokio = { version = "1.26.0", features = ["full"] }
# If you would like to use the built-in logger (recommended)
# windmark = { version = "0.3.9", features = ["logger"] }
# If you would like to use the built-in MIME dedection when `Success`-ing a file
# (recommended)
# windmark = { version = "0.3.9", features = ["auto-deduce-mime"] }
# If you would like to use macro-based responses (as seen below)
# windmark = { version = "0.3.9", features = ["response-macros"] }
Implement a Windmark server
// src/main.rs
// ...
#[windmark::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
windmark::router::Router::new()
.set_private_key_file("windmark_private.pem")
.set_certificate_file("windmark_public.pem")
.mount("/", windmark::success!("Hello, World!"))
.set_error_handler(|_|
windmark::response::Response::permanent_failure("This route does not exist!")
)
.run()
.await
}
Implement a Windmark server using Rossweisse
// src/main.rs
// ...
#[rossweisse::router]
struct Router;
#[rossweisse::router]
impl Router {
#[route(index)]
pub fn index(
_context: windmark::context::RouteContext,
) -> Response {
Response::success("Hello, World!")
}
}
// ...
Examples
Examples can be found within the
examples/
directory
along with a rundown of each of their purposes and useful facts.
An example of a fully featured Gemini capsule written using Windmark can be found here. This example Gemini capsule also happens to be the source code for Fuwn's (this library's author) personal Gemini capsule!
Modules
Modules are reusable extensions which can be procedurally mounted onto Windmark routers.
Capsules using Windmark
License
This project is licensed with the GNU General Public License v3.0.
Dependencies
~5–18MB
~261K SLoC