basic-http-server

一个简单的静态HTTP服务器，用于学习和本地开发。

basic-http-server 设计用于以下两个目的

• 作为教学工具。它是一个简单且注释良好的基本 tokio，hyper 和异步Rust编程示例，具有 async / await。

• 用于本地开发。它提供静态HTML内容，并通过 -x 标志提供对创建开发者文档有用的便利功能，包括Markdown渲染和目录列表。

设置 hyper HTTP服务器的整个参考源包含在 main.rs 中。文件 ext.rs 包含开发扩展。

开发扩展

当传递 -x 标志时，basic-http-server 启用对本地开发有用的额外便利功能。这些扩展包括

• 将扩展名为 ".md" 的文件渲染为Markdown。

• 当找不到 "index.html" 文件时列出目录。

• 将常见的源代码文件作为 "text/plain" 提供以在浏览器中渲染。

这使得 basic-http-server 在以下场景中非常有用

• 预览Markdown内容。在推送到GitHub之前，在本地预览 README.md 的更改。

• 导航到本地文档，包括Rust API文档。只需在项目目录中运行basic-http-server -x，然后使用目录列表导航到target/doc，然后在其中找到要读取的crate（cargo doc不在target/doc中放置index.html文件）。

安装和使用

请注意，basic-http-server不是生产就绪的，不应暴露给互联网。它是一个学习和开发工具。

使用cargo install进行安装

$ cargo install basic-http-server
$ basic-http-server

要启用开发者扩展，请传递-x

$ basic-http-server -x

要增加日志详细程度，请使用RUST_LOG

RUST_LOG=basic_http_server=trace basic-http-server -x

命令行参数

USAGE:
        basic-http-server [FLAGS] [OPTIONS] [ARGS]

FLAGS:
    -x               Enable developer extensions
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
    -a, --addr <ADDR>    Sets the IP:PORT combination (default "127.0.0.1:4000")

ARGS:
    ROOT    Sets the root directory (default ".")

许可协议

MIT/Apache-2.0