Struct ConfigEnv 

pub struct ConfigEnv {
    pub service_name: String,
    pub service_vers: String,
    pub pispas_host: String,
    pub remote_host: String,
    pub remote_port: u16,
    pub remote_ussl: bool,
    pub local_host: String,
    pub local_port: u16,
    pub local_ussl: bool,
    pub modules: Vec<String>,
    pub list_printers: Option<Vec<String>>,
}

Runtime configuration loaded from the install’s .env file.

ConfigEnv is the single struct that every binary reads at startup. Fields are plain POD (strings, booleans, ports) so the type is trivially serializable to JSON for the Tauri configurator UI.

Lifecycle

1. The installer writes a default .env via init_env on first run.
2. Each binary calls ConfigEnv::load at startup, which reads the .env through dotenv::from_path and materialises the struct.
3. The configurator calls ConfigEnv::save after the user edits a field, then pushes an IPC restart message to pispas-modules.

Invariants

• local_ussl = true requires the embedded TLS cert and a client that connects via wss://local.unpispas.es:<local_port>. Binding to 127.0.0.1 is fine because DNS resolves local.unpispas.es there.
• modules is an ordered list used by pispas_modules::load_services to instantiate the services. Names not in the match arm are logged and ignored.

Extending

Adding a field requires touching four places — see CLAUDE.md § 5. Forgetting one of them silently resets the new field to its default every time the user saves from the configurator.

Fields

service_name: String

Stable identity of this install. Used as the Windows Service name and echoed back in every WebSocket message envelope.

service_vers: String

Build version tag, echoed in message envelopes for log correlation.

pispas_host: String

Backend REST API hostname (e.g. api.unpispas.es).

remote_host: String

Backend WebSocket hostname that pispas-modules keeps an outbound connection to (e.g. wss.unpispas.es).

remote_port: u16

Backend WebSocket port. Usually 443.

remote_ussl: bool

true → connect with wss://, false → ws://.

local_host: String

Bind address for the local WebSocket server. Almost always 127.0.0.1. See docs/CONFIGURATION.md before changing.

local_port: u16

Bind port for the local WebSocket server. Default 5005.

local_ussl: bool

true → accept TLS on the local socket (recommended for browser clients that require wss://). The listener is dual-mode and still accepts plain ws:// when this is on.

modules: Vec<String>

Ordered list of service modules to load at boot (base, print, paytef, …).

list_printers: Option<Vec<String>>

Cached printer list shown in the configurator UI. Refreshed by the service on demand.

Implementations

impl ConfigEnv

pub fn load() -> Self

pub fn change_service_name(&mut self, new_name: &str)

pub fn change_service_vers(&mut self, new_vers: &str)

pub fn change_pispas_host(&mut self, new_host: &str)

pub fn change_remote_host(&mut self, new_host: &str)

pub fn change_remote_port(&mut self, new_port: u16)

pub fn change_remote_ussl(&mut self, ussl: bool)

pub fn change_local_host(&mut self, new_host: &str)

pub fn change_local_port(&mut self, new_port: u16)

pub fn change_local_ussl(&mut self, ussl: bool)

pub fn change_modules(&mut self, new_modules: Vec<String>)

pub fn save(&self)

Trait Implementations

impl Clone for ConfigEnv

fn clone(&self) -> ConfigEnv

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConfigEnv

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

Formats the value using the given formatter.

impl Default for ConfigEnv

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ConfigEnv

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ConfigEnv

fn eq(&self, other: &ConfigEnv) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ConfigEnv

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ConfigEnv