36 个版本

0.3.11	2024年7月17日
0.3.9	2023年5月5日
0.2.5	2023年3月31日
0.1.20	2022年7月31日
0.1.7	2022年3月31日

#224 in 网页编程

每月下载 135 次
用于 3 crates

GPL-3.0-only

63KB
974 行

Windmark

Windmark 是一个优雅且高性能的异步 Gemini 服务器框架，适用于现代时代！

现在支持 Tokio 和 async-std！

用法

Windmark 正在开发一个基于宏的 "struct-router"。目前可以通过它使用 Windmark 的一些功能子集。有关更多信息，请查看 Rossweisse！

特性

特性	描述
`default`	使用 Tokio 的基本 Windmark 框架
`logger`	启用默认的 `pretty_env_logger` 集成
`auto-deduce-mime`	公开 `Response` 和宏，自动填充非 Gemini 响应的 MIME
`response-macros`	所有 `Response` 的简单宏
`tokio`	将 Tokio 标记为异步运行时
`async-std`	将 `async-std` 标记为异步运行时
`prelude`	公开包含最常用 Windmark 特性的 `prelude` 模块

添加 Windmark 和 Tokio 作为依赖项

# 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"] }

实现 Windmark 服务器

// 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
}

使用 Rossweisse 实现 Windmark 服务器

// 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!")
  }
}

// ...