egelm 0.3.1

A simple message-driven framework for building GUI applications in Rust using egui.
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

//! Errors returned by application and event-loop operations.

use egui_winit::winit;

/// An error that can prevent an [`crate::window::App`] from running.
///
/// These errors cover event-loop creation and execution, internal message
/// delivery, root error routing, and optional Ctrl-C handler installation.
///
/// # Examples
///
/// ```
/// use egelm::error::Error;
///
/// let error = Error::SendingOverChannel;
/// assert_eq!(error.to_string(), "could not send message over channel: channel disconnected");
/// ```
#[derive(thiserror::Error, Debug)]
pub enum Error {
	/// The platform event loop stopped with an error.
	#[error("event loop failed: {0}")]
	EventLoopFail(#[source] winit::error::EventLoopError),

	/// The platform event loop could not be built.
	#[error("could not build event loop: {0}")]
	EventLoopBuildFail(#[source] winit::error::EventLoopError),

	/// An internal channel was disconnected before a message could be sent.
	#[error("could not send message over channel: channel disconnected")]
	SendingOverChannel,

	/// The requested renderer was not enabled at compile time.
	#[error("the {0} renderer is not enabled")]
	RendererUnavailable(&'static str),

	#[cfg(all(feature = "ctrlc", not(target_os = "android")))]
	/// The process Ctrl-C handler could not be installed.
	#[error("could not set ctrlc handler: {0}")]
	SetSigHandler(#[source] ctrlc::Error),
}