Struct ServerManager

pub struct ServerManager<F> { /* private fields */ }

Title: ServerManager structure for managing the server process

Parameters:

• None

Returns:

• None

This structure encapsulates the server management operations and holds the user-provided configuration and the server function.

Implementations

impl<F, Fut> ServerManager<F>

where F: Fn() -> Fut, Fut: Future<Output = ()>,

pub fn new(config: ServerManagerConfig, server_fn: F) -> ServerManager<F>

Create a new ServerManager instance

Parameters:

• config: The server configuration containing PID file path and log paths.
• server_fn: A closure representing the asynchronous server function.

Returns:

• ServerManager<F>: A new instance of ServerManager.

pub async fn start(&self)

Start the server in foreground mode

Parameters:

• None

Returns:

• (): No return value.

This function writes the current process ID to the PID file specified in the configuration and then runs the server function asynchronously.

pub fn stop(&self) -> Result<(), Box<dyn Error>>

Stop the server

Parameters:

• None

Returns:

• ServerManagerResult: Operation result.

This function reads the process ID from the PID file and attempts to kill the process using a SIGTERM signal.

pub fn start_daemon(&self) -> Result<(), Box<dyn Error>>

Start the server in daemon (background) mode on Unix platforms. Start the server in daemon mode on non-Unix platforms

Parameters:

• None

Returns:

• ServerManagerResult: Operation result.

This function returns an error because daemon mode is not supported on non-Unix platforms.

pub fn hot_restart(&self, run_args: &[&str]) -> Result<(), Box<dyn Error>>

Start the server with hot-reloading using cargo-watch

Parameters:

• run_args: Arguments to pass to cargo-watch.

Returns:

• ServerManagerResult: Operation result.

This function checks for cargo-watch installation, installs it if missing, and then uses it to run the server with hot-reloading.

pub fn hot_restart_wait(&self, run_args: &[&str]) -> Result<(), Box<dyn Error>>

Start the server with hot-reloading using cargo-watch and exit immediately

Parameters:

• run_args: Arguments to pass to cargo-watch.

Returns:

• ServerManagerResult: Operation result.

Same as hot_restart but does not wait for the process to finish.