summaryrefslogtreecommitdiffstats
path: root/src/pure/application.rs
diff options
context:
space:
mode:
authorLibravatar Héctor Ramón Jiménez <hector0193@gmail.com>2022-07-27 06:49:20 +0200
committerLibravatar Héctor Ramón Jiménez <hector0193@gmail.com>2022-07-27 06:49:20 +0200
commitff2519b1d43d481987351a83b6dd7237524c21f0 (patch)
tree5731eeb7eb1247d4a8951de0d5bc5d8102640559 /src/pure/application.rs
parentc44267b85f7aaa2997e3caf1323b837d95818c22 (diff)
downloadiced-ff2519b1d43d481987351a83b6dd7237524c21f0.tar.gz
iced-ff2519b1d43d481987351a83b6dd7237524c21f0.tar.bz2
iced-ff2519b1d43d481987351a83b6dd7237524c21f0.zip
Replace stateful widgets with new `iced_pure` API
Diffstat (limited to 'src/pure/application.rs')
-rw-r--r--src/pure/application.rs195
1 files changed, 0 insertions, 195 deletions
diff --git a/src/pure/application.rs b/src/pure/application.rs
deleted file mode 100644
index 396854ad..00000000
--- a/src/pure/application.rs
+++ /dev/null
@@ -1,195 +0,0 @@
-//! Build interactive cross-platform applications.
-use crate::pure::{self, Pure};
-use crate::window;
-use crate::{Command, Executor, Settings, Subscription};
-
-pub use iced_native::application::StyleSheet;
-
-/// A pure version of [`Application`].
-///
-/// Unlike the impure version, the `view` method of this trait takes an
-/// immutable reference to `self` and returns a pure [`Element`].
-///
-/// [`Application`]: crate::Application
-/// [`Element`]: pure::Element
-pub trait Application: Sized {
- /// The [`Executor`] that will run commands and subscriptions.
- ///
- /// The [default executor] can be a good starting point!
- ///
- /// [`Executor`]: Self::Executor
- /// [default executor]: crate::executor::Default
- type Executor: Executor;
-
- /// The type of __messages__ your [`Application`] will produce.
- type Message: std::fmt::Debug + Send;
-
- /// The theme of your [`Application`].
- type Theme: Default + StyleSheet;
-
- /// The data needed to initialize your [`Application`].
- type Flags;
-
- /// Initializes the [`Application`] with the flags provided to
- /// [`run`] as part of the [`Settings`].
- ///
- /// Here is where you should return the initial state of your app.
- ///
- /// Additionally, you can return a [`Command`] if you need to perform some
- /// async action in the background on startup. This is useful if you want to
- /// load state from a file, perform an initial HTTP request, etc.
- ///
- /// [`run`]: Self::run
- fn new(flags: Self::Flags) -> (Self, Command<Self::Message>);
-
- /// Returns the current title of the [`Application`].
- ///
- /// This title can be dynamic! The runtime will automatically update the
- /// title of your application when necessary.
- fn title(&self) -> String;
-
- /// Handles a __message__ and updates the state of the [`Application`].
- ///
- /// This is where you define your __update logic__. All the __messages__,
- /// produced by either user interactions or commands, will be handled by
- /// this method.
- ///
- /// Any [`Command`] returned will be executed immediately in the background.
- fn update(&mut self, message: Self::Message) -> Command<Self::Message>;
-
- /// Returns the widgets to display in the [`Application`].
- ///
- /// These widgets can produce __messages__ based on user interaction.
- fn view(
- &self,
- ) -> pure::Element<'_, Self::Message, crate::Renderer<Self::Theme>>;
-
- /// Returns the current [`Theme`] of the [`Application`].
- fn theme(&self) -> Self::Theme {
- Self::Theme::default()
- }
-
- /// Returns the event [`Subscription`] for the current state of the
- /// application.
- ///
- /// A [`Subscription`] will be kept alive as long as you keep returning it,
- /// and the __messages__ produced will be handled by
- /// [`update`](#tymethod.update).
- ///
- /// By default, this method returns an empty [`Subscription`].
- fn subscription(&self) -> Subscription<Self::Message> {
- Subscription::none()
- }
-
- /// Returns the current [`Application`] mode.
- ///
- /// The runtime will automatically transition your application if a new mode
- /// is returned.
- ///
- /// Currently, the mode only has an effect in native platforms.
- ///
- /// By default, an application will run in windowed mode.
- fn mode(&self) -> window::Mode {
- window::Mode::Windowed
- }
-
- /// Returns the scale factor of the [`Application`].
- ///
- /// It can be used to dynamically control the size of the UI at runtime
- /// (i.e. zooming).
- ///
- /// For instance, a scale factor of `2.0` will make widgets twice as big,
- /// while a scale factor of `0.5` will shrink them to half their size.
- ///
- /// By default, it returns `1.0`.
- fn scale_factor(&self) -> f64 {
- 1.0
- }
-
- /// Returns whether the [`Application`] should be terminated.
- ///
- /// By default, it returns `false`.
- fn should_exit(&self) -> bool {
- false
- }
-
- /// Runs the [`Application`].
- ///
- /// On native platforms, this method will take control of the current thread
- /// until the [`Application`] exits.
- ///
- /// On the web platform, this method __will NOT return__ unless there is an
- /// [`Error`] during startup.
- ///
- /// [`Error`]: crate::Error
- fn run(settings: Settings<Self::Flags>) -> crate::Result
- where
- Self: 'static,
- {
- <Instance<Self> as crate::Application>::run(settings)
- }
-}
-
-struct Instance<A: Application> {
- application: A,
- state: pure::State,
-}
-
-impl<A> crate::Application for Instance<A>
-where
- A: Application,
- A::Message: 'static,
-{
- type Executor = A::Executor;
- type Message = A::Message;
- type Flags = A::Flags;
- type Theme = A::Theme;
-
- fn new(flags: Self::Flags) -> (Self, Command<Self::Message>) {
- let (application, command) = A::new(flags);
-
- (
- Instance {
- application,
- state: pure::State::new(),
- },
- command,
- )
- }
-
- fn title(&self) -> String {
- A::title(&self.application)
- }
-
- fn update(&mut self, message: Self::Message) -> Command<Self::Message> {
- A::update(&mut self.application, message)
- }
-
- fn subscription(&self) -> Subscription<Self::Message> {
- A::subscription(&self.application)
- }
-
- fn view(
- &mut self,
- ) -> crate::Element<'_, Self::Message, crate::Renderer<Self::Theme>> {
- let content = A::view(&self.application);
-
- Pure::new(&mut self.state, content).into()
- }
-
- fn theme(&self) -> Self::Theme {
- A::theme(&self.application)
- }
-
- fn mode(&self) -> window::Mode {
- A::mode(&self.application)
- }
-
- fn scale_factor(&self) -> f64 {
- A::scale_factor(&self.application)
- }
-
- fn should_exit(&self) -> bool {
- A::should_exit(&self.application)
- }
-}