Struct Desktop 

pub struct Desktop {
    pub version: &'static str,
    pub archives: &'static [Archive],
    pub install_dir: &'static str,
    pub program: &'static str,
    pub flags: &'static [&'static str],
    pub packages: &'static [&'static str],
    pub image_mib: u64,
}

A harness that opens a window: where its application comes from, what the image needs beside the base image to run it, and how the window is started.

The application is never carried inside a QCode image. Its terms permit running it, not redistributing it, so the image is built on the person’s own machine and fetches the archive from the maker’s address at install time, exactly as a command-line harness is installed from its own registry.

Fields

version: &'static str

The version this record was read from and checked against.

archives: &'static [Archive]

The maker’s archives of that version, one for each processor the image may be built on.

The image picks one while it is built, by the machine it is built on, and not QCode by the machine it was compiled for: the engine may build for another processor than QCode’s own.

install_dir: &'static str

Where the archive unpacks to in the image, the one directory inside it stripped away.

program: &'static str

The program that opens the window, by its name under Desktop::install_dir.

The archive’s own launcher script is not used: it runs the real program through sh, and a container whose first process is that shell never passes the stop signal on, so every stop costs the engine’s ten-second timeout and a kill.

flags: &'static [&'static str]

The arguments the window is always opened with.

packages: &'static [&'static str]

The Debian packages the application needs beside what the base image brings.

image_mib: u64

How much room the built image takes, in whole mebibytes, as it was measured on top of qcode/base, which is what the recipe builds on. The person is told this before they ask for the image: a desktop image is an order of magnitude larger than a command-line harness’s.

Measure it the way the recipe builds it, not on a bare Debian: the first number here was taken on debian:trixie-slim during the trial and understated the image by 900 MiB, which is a promise broken before the download even starts. The live test the_image_builds_from_the_makers_archive_and_carries_the_application_and_its_settings prints the built size, so a re-measure is one run away.

Implementations

impl Desktop

pub fn command(&self) -> String

The program that opens the window, as an absolute path in the image.

pub fn command_line(&self, workspace: &str) -> Vec<String>

The whole line that opens the window on the workspace at workspace: the program, the arguments it always takes, and the folder to open.

Trait Implementations

impl Clone for Desktop

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Desktop

impl Debug for Desktop

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

Formats the value using the given formatter.

impl Eq for Desktop

impl PartialEq for Desktop

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Desktop