fsv 0.1.3

fsv
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

use serde::{Deserialize, Serialize};
use std::path::PathBuf;
use std::sync::atomic::AtomicUsize;
use tokio::sync::{broadcast, oneshot};

use crate::error::FsvError;

/// Server startup configuration.
pub struct Config {
    pub path: PathBuf,
    pub port: u16,
}

/// A handle to control the running server after startup.
pub struct ServerHandle {
    pub(crate) shutdown_tx: Option<oneshot::Sender<()>>,
    pub(crate) ws_tx: broadcast::Sender<String>,
}

impl ServerHandle {
    /// Gracefully shuts down the server.
    pub fn shutdown(&mut self) -> Result<(), FsvError> {
        self.shutdown_tx
            .take()
            .ok_or_else(|| {
                FsvError::Shutdown("Server already shut down or handle uninitialized".into())
            })?
            .send(())
            .map_err(|_| FsvError::Shutdown("Failed to send shutdown signal".into()))
    }

    /// Broadcasts a message to all connected WebSocket clients.
    /// Returns the number of active receivers.
    pub fn send(&self, message: &str) -> Result<usize, FsvError> {
        match self.ws_tx.send(message.to_string()) {
            Ok(count) => Ok(count),
            // No receivers is not an error — just zero clients connected.
            Err(_) => Ok(0),
        }
    }
}

/// Shared application state injected into every Axum handler.
#[derive(Clone)]
pub struct AppState {
    pub root_path: PathBuf,
    pub ws_tx: broadcast::Sender<String>,
    pub ws_connections: std::sync::Arc<AtomicUsize>,
}

/// Metadata for a single file or directory entry.
#[derive(Serialize)]
pub struct FileInfo {
    pub name: String,
    pub path: String,
    pub is_dir: bool,
    pub size: u64,
    pub modified: Option<u64>,
}

/// Query parameters accepted by the files and download endpoints.
#[derive(Deserialize, Default)]
pub struct FileParams {
    pub path: Option<String>,
}