Struct GitwayConfig 

pub struct GitwayConfig {
    pub host: String,
    pub port: u16,
    pub username: String,
    pub identity_file: Option<PathBuf>,
    pub cert_file: Option<PathBuf>,
    pub skip_host_check: bool,
    pub inactivity_timeout: Duration,
    pub custom_known_hosts: Option<PathBuf>,
    pub verbose: bool,
    pub fallback: Option<(String, u16)>,
}

Immutable configuration for a GitwaySession.

Construct via GitwayConfig::builder, or use one of the convenience constructors (github, gitlab, codeberg) for the most common targets.

Fields

host: String

Primary SSH host (e.g. github.com, gitlab.com, codeberg.org).

port: u16

Primary SSH port (default: 22).

username: String

Remote username (always git for hosted services; FR-13).

identity_file: Option<PathBuf>

Explicit identity file path supplied via --identity.

cert_file: Option<PathBuf>

OpenSSH certificate path supplied via --cert.

skip_host_check: bool

When true, skip host-key verification (FR-8).

inactivity_timeout: Duration

Inactivity timeout for the SSH session (FR-5).

GitHub’s idle threshold is around 60 s; this is the configured client-side inactivity timeout, not a per-packet deadline.

custom_known_hosts: Option<PathBuf>

Path to a known_hosts-style file for custom or self-hosted instances (FR-7). Format: one hostname SHA256:<fp> entry per line.

verbose: bool

Enable verbose debug logging when true.

fallback: Option<(String, u16)>

Optional fallback host when port 22 is unavailable (FR-1).

GitHub: ssh.github.com:443. GitLab: altssh.gitlab.com:443. Codeberg has no published port-443 fallback.

Implementations

impl GitwayConfig

pub fn builder(host: impl Into<String>) -> GitwayConfigBuilder

Begin building a config targeting host.

All optional fields default to sensible values. No fallback host is set by default; use the provider-specific convenience constructors (github, gitlab) if you want the port-443 fallback pre-configured.

pub fn github() -> Self

Convenience constructor for the default GitHub target (github.com:22).

Includes the ssh.github.com:443 fallback pre-configured.

pub fn gitlab() -> Self

Convenience constructor for the default GitLab target (gitlab.com:22).

Includes the altssh.gitlab.com:443 fallback pre-configured.

pub fn codeberg() -> Self

Convenience constructor for Codeberg (codeberg.org:22).

Codeberg has no published port-443 SSH fallback; no fallback is set.

Trait Implementations

impl Clone for GitwayConfig

fn clone(&self) -> GitwayConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GitwayConfig

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

Formats the value using the given formatter.