Toy HTTP server built in Rust on top of roa.
It's main objective is to support advanced web server features purely with accessible filesystem-based configuration. This will be accomplished through a cascading flat-file configuration and naming conventions.
Don't actually use this for anything. Keep away from public-facing interfaces. The server listens on the loopback interface by default and is not configurable for this reason.
What can polyserve do?
- Asynchronously serve files from the web root
- TLS connections
- Cascading configuration via
.config.tomlfiles (analogous to Apache's .htaccess) - Indexes and Auto-Index support
- Extension elision and trailing slash redirects
- Expose your system and all your secrets to the entire internet
What's next?
- Handlebars rendering (WIP):
- layout templates
- content templates
- partials
- script helpers
- Markdown rendering
- Tests
- Queryable cascading context data, file frontmatter (SQLite?)
- Cache layer
- Get fat and grow a big white beard
- Implement cool stuff like federated login, ActivityPub, etc.
This project is not on crates.io yet! Clone this repo and build with rustc.
polyserve -p 3000 ./some-http-root# Cargo.toml
[dependencies]
polyserve = { git = "https://github.com/richardcarls/polyserve/" }
async-std = { version = "1.10.0", features = ["attributes"] }use polyserve::App;
#[async_std::main]
fn main() {
let app = App::default();
app.listen("127.0.0.1:8080", "./some-http-root").await?;
}See include/default.toml for all options.
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
I am not looking for contributors at this time, but would love to hear feedback from anyone brave enough to use this.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.