Struct DashboardConfig

pub struct DashboardConfig {
    pub bind_address: String,
    pub port: u16,
    pub database_url: String,
    pub pool_size: u32,
    pub static_dir: PathBuf,
    pub auth: AuthConfig,
    pub websocket: WebSocketConfig,
    pub enable_cors: bool,
    pub request_timeout: Duration,
}

Main configuration for the web dashboard.

This struct contains all configuration options for the Hammerwork web dashboard, including server settings, database connection, authentication, and WebSocket options.

Examples

use hammerwork_web::config::DashboardConfig;
use std::path::PathBuf;

// Create with defaults
let config = DashboardConfig::default();
assert_eq!(config.bind_address, "127.0.0.1");
assert_eq!(config.port, 8080);

// Use builder pattern
let config = DashboardConfig::new()
    .with_bind_address("0.0.0.0", 9090)
    .with_database_url("postgresql://localhost/hammerwork")
    .with_cors(true);

assert_eq!(config.bind_addr(), "0.0.0.0:9090");
assert!(config.enable_cors);

Fields

bind_address: String

Server bind address

port: u16

Server port

database_url: String

Database connection URL

pool_size: u32

Database connection pool size

static_dir: PathBuf

Directory containing static assets (HTML, CSS, JS)

auth: AuthConfig

Authentication configuration

websocket: WebSocketConfig

WebSocket configuration

enable_cors: bool

Enable CORS for cross-origin requests

request_timeout: Duration

Request timeout duration

Implementations

impl DashboardConfig

pub fn new() -> Self

Create a new configuration with defaults.

Examples

use hammerwork_web::config::DashboardConfig;

let config = DashboardConfig::new();
assert_eq!(config.bind_address, "127.0.0.1");
assert_eq!(config.port, 8080);
assert_eq!(config.database_url, "postgresql://localhost/hammerwork");

pub fn with_bind_address(self, address: &str, port: u16) -> Self

Set the server bind address and port.

Examples

use hammerwork_web::config::DashboardConfig;

let config = DashboardConfig::new()
    .with_bind_address("0.0.0.0", 9090);

assert_eq!(config.bind_address, "0.0.0.0");
assert_eq!(config.port, 9090);
assert_eq!(config.bind_addr(), "0.0.0.0:9090");

pub fn with_database_url(self, url: &str) -> Self

Set the database URL.

Supports both PostgreSQL and MySQL database URLs.

Examples

use hammerwork_web::config::DashboardConfig;

// PostgreSQL
let pg_config = DashboardConfig::new()
    .with_database_url("postgresql://user:pass@localhost/hammerwork");
assert_eq!(pg_config.database_url, "postgresql://user:pass@localhost/hammerwork");

// MySQL
let mysql_config = DashboardConfig::new()
    .with_database_url("mysql://root:password@localhost/hammerwork");
assert_eq!(mysql_config.database_url, "mysql://root:password@localhost/hammerwork");

pub fn with_static_dir(self, dir: PathBuf) -> Self

Set the static assets directory.

Examples

use hammerwork_web::config::DashboardConfig;
use std::path::PathBuf;

let config = DashboardConfig::new()
    .with_static_dir(PathBuf::from("/var/www/dashboard"));

assert_eq!(config.static_dir, PathBuf::from("/var/www/dashboard"));

pub fn with_auth(self, username: &str, password_hash: &str) -> Self

Enable authentication with username and password hash.

The password should be a bcrypt hash for security. When authentication is enabled, all API endpoints and WebSocket connections will require basic authentication.

Examples

use hammerwork_web::config::DashboardConfig;

let config = DashboardConfig::new()
    .with_auth("admin", "$2b$12$hash...");

assert!(config.auth.enabled);
assert_eq!(config.auth.username, "admin");
assert_eq!(config.auth.password_hash, "$2b$12$hash...");

pub fn with_cors(self, enabled: bool) -> Self

Enable or disable CORS support.

When enabled, the server will accept cross-origin requests from any domain. This is useful for development or when the dashboard is accessed from different domains.

Examples

use hammerwork_web::config::DashboardConfig;

let config = DashboardConfig::new()
    .with_cors(true);

assert!(config.enable_cors);

let config = DashboardConfig::new()
    .with_cors(false);

assert!(!config.enable_cors);

pub fn from_file(path: &str) -> Result<Self>

Load configuration from a TOML file

pub fn save_to_file(&self, path: &str) -> Result<()>

Save configuration to a TOML file

pub fn bind_addr(&self) -> String

Get the full bind address (address:port)

Trait Implementations

impl Clone for DashboardConfig

fn clone(&self) -> DashboardConfig

Returns a duplicate of the value.

const fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DashboardConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for DashboardConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DashboardConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for DashboardConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.