11c0e844e5
Some checks failed
dev bread-theme / build (push) Successful in 17s
dev bakery / build (push) Successful in 43s
beta (rc) bakery / build (push) Has been skipped
beta (rc) bread-theme / build (push) Has been skipped
Build and publish package / package (push) Successful in 1m46s
release bakery / build (push) Failing after 52s
release bread-theme / build (push) Failing after 14s
bread-app is the GTK bootstrap new tools should use instead of another copied main.rs: com.breadway.* app id, singleton lock, optional gtk_popup re-export, optional bread.command.<app>.** listen loop. Tests cover app-id helpers and command-verb parse. Existing apps are not migrated. bread-polkit is an own PolicyKit1 session authentication agent with a bread-theme GTK4 password prompt (not a polkit-gnome wrapper). Autostart via contrib/bread-polkit.desktop or exec-once. Not a bakery product; not added to the BOS ISO lockfile.
67 lines
2.4 KiB
Rust
67 lines
2.4 KiB
Rust
//! GTK application bootstrap for bread desktop tools.
|
|
//!
|
|
//! New GTK tools should depend on this crate instead of copying a sixth
|
|
//! `main.rs` that wires a `com.breadway.*` application id, a
|
|
//! [`bread_utils::singleton`] lock, a layer-shell overlay, and a
|
|
//! `bread.command.<app>.**` listen loop.
|
|
//!
|
|
//! # What this is
|
|
//!
|
|
//! The pieces every bread GTK binary already copies:
|
|
//!
|
|
//! - [`application_id`] / [`parse_app_name`] — reverse-DNS id
|
|
//! (`com.breadway.breadbox`) and the same name used for the singleton
|
|
//! pid file.
|
|
//! - [`try_acquire`] / [`toggle_or_kill`] — [`bread_utils::singleton`]
|
|
//! wrappers that reject an invalid name before touching the lock.
|
|
//! - feature `gtk` — re-exports [`gtk_popup`] (`bread_utils::gtk_popup`)
|
|
//! for the full-screen overlay breadbox / breadclip / breadcast start
|
|
//! from.
|
|
//! - feature `bread-client` — [`listen_commands`] plus [`command_verb`] /
|
|
//! [`command_pattern`] so a tool can honor `bread.command.<app>.**`
|
|
//! without re-deriving the prefix strip.
|
|
//!
|
|
//! This crate does **not** migrate existing apps. Callers still own their
|
|
//! widgets, CSS, and clap. Screenshot / `--screenshot` helpers stay in
|
|
//! [`bread_utils::screenshot_cli`].
|
|
//!
|
|
//! # Example
|
|
//!
|
|
//! ```ignore
|
|
//! let _guard = match bread_app::try_acquire("breadbox")? {
|
|
//! bread_app::singleton::Acquire::Acquired(g) => g,
|
|
//! bread_app::singleton::Acquire::HeldByOther(_) => return Ok(()),
|
|
//! };
|
|
//! let app = gtk4::Application::builder()
|
|
//! .application_id(&bread_app::application_id("breadbox")?)
|
|
//! .build();
|
|
//!
|
|
//! #[cfg(feature = "gtk")]
|
|
//! app.connect_activate(|app| {
|
|
//! let window = bread_app::gtk_popup::new_overlay_window(app, "breadbox");
|
|
//! window.present();
|
|
//! });
|
|
//!
|
|
//! #[cfg(feature = "bread-client")]
|
|
//! let _commands = bread_app::listen_commands("box", |verb, event| {
|
|
//! // verb is the single segment after `bread.command.box.`
|
|
//! let _ = (verb, event);
|
|
//! })?;
|
|
//! ```
|
|
|
|
pub use bread_utils::singleton;
|
|
|
|
#[cfg(feature = "gtk")]
|
|
pub use bread_utils::gtk_popup;
|
|
|
|
mod id;
|
|
|
|
pub use id::{application_id, parse_app_name, toggle_or_kill, try_acquire, InvalidAppId};
|
|
|
|
#[cfg(feature = "bread-client")]
|
|
mod command;
|
|
|
|
#[cfg(feature = "bread-client")]
|
|
pub use bread_utils::bread_client::{BreadClient, BreadEvent, Subscription};
|
|
#[cfg(feature = "bread-client")]
|
|
pub use command::{command_pattern, command_verb, listen_commands, parse_command_id};
|