#axum #tera #tera-templates #web #web-framework #http #web-interface

lib-humus

Helps creating configurable frontends for humans and computers using axum, Tera and toml

2 releases

0.2.1 Feb 11, 2024
0.2.0 Feb 11, 2024

#1306 in HTTP server


Used in unobtanium-viewer

AGPL-3.0-or-later

33KB
414 lines

lib-humus 🌱

Helps creating frontends for humans and computers using axum, Tera and toml.

⚠️ Consider the interface unstable until a version that says that it is stable is released.

Where does the name come from?

It's something to grow new projects on and it includes ter(r)a, so humus it is.

What does it do?

Render Templates

The HumusEngine uses Tera and the axum framework to produce http responses with minimal code overhead in the main logic. It is able to serve both a UI and an API from one datastructure.

Use the axum-view (enabled by default) feature flag for this. The axum-view+cookie feature flag enables additional cookie setting logic.

Load Templates

For templates to be useful they have to make it from disk into memory. The TemplateEngineLoader takes care of loading a whole directory of configurable templates at once.

It is behind the enabled by default tera-loader feature flag.

Load Toml

Coming up with a sophisticated configuration system is fun, but serde and a toml file is usually more than enought. The read_toml_from_file() function makes this even easier. Filepath in, parsed struct or Error out.

It is behind the enabled by default toml feature flag.

Compatibility

  • lib humus 0.2 is compatible with axum 0.7
  • lib-humus 0.1 is made to be compatible with axum 0.6

Documentation

You can find the documentation over on docs.rs

Or you can build the offline documentation yourself:

cargo doc -F full
firefox target/doc/lib_humus/index.html

License

This project is licensed under an AGPL-3.0-or-later License this is to ensure that it isn't used in proprietary software.

Dependencies

~4–15MB
~180K SLoC