2 releases

0.1.1	Aug 14, 2024
0.1.0	Jul 26, 2024

#253 in Configuration

70 downloads per month

MIT license

8KB
140 lines

webserver-config

A Rust crate for generating configuration files for web servers. Supported web servers include Apache2 and nginx.

Features

Very Simple: Easy to use and integrate, with a small and manageable codebase.
Extensible: Easily extendable to support additional web servers or configuration options.
No Dependencies: Does not rely on external crates, ensuring lightweight and fast performance.

Installation

Add this crate to your Cargo.toml or use the command bellow:

cargo add webserver-config

Usage

Below are examples of using the crate to generate configurations for Apache2 and nginx web servers.

Apache2 Config

Here's how you can generate a configuration for Apache2 web server:

let mut config = Config::new();

let mut block = Block::new("VirtualHost", "*:80");
block.modify_config(|c| {
	c.add("ServerName", "example.com");
	c.add_multi("ServerAlias", vec!["www.example.com", "example.net", "www.example.net"]);
	c.add("DocumentRoot", "/var/www/example");
});
config.add_block(block);

println!("{}", config.to_apache());

The code above will produce the following output:

<VirtualHost *:80>
    ServerName example.com
    ServerAlias www.example.com example.net www.example.net
    DocumentRoot /var/www/example
</VirtualHost>

nginx Config

Here's how you can generate a configuration for nginx web server:

let mut config = Config::new();

let mut block = Block::new_simple("server");
block.modify_config(|c| {
	c.add("listen", "80");
	c.add("listen", "[::]:80");
	c.add_multi("server_name", vec!["example.com", "www.example.com"]);
	c.add("root", "/var/www/example");
});
config.add_block(block);

println!("{}", config.to_nginx());

The code above will produce the following output:

server {
    listen 80;
    listen [::]:80;
    server_name example.com www.example.com;
    root /var/www/example;
}