Struct DebianConfig 

#[non_exhaustive]
pub struct DebianConfig {
    pub depends: Option<Dependencies>,
    pub desktop_template: Option<PathBuf>,
    pub section: Option<String>,
    pub priority: Option<String>,
    pub files: Option<HashMap<String, String>>,
    pub package_name: Option<String>,
}

The Linux Debian configuration.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

depends: Option<Dependencies>

The list of Debian dependencies.

desktop_template: Option<PathBuf>

Path to a custom desktop file Handlebars template.

Available variables: categories, comment (optional), exec, icon and name.

Default file contents:

[Desktop Entry]
Categories={{categories}}
{{#if comment}}
Comment={{comment}}
{{/if}}
Exec={{exec}} {{exec_arg}}
Icon={{icon}}
Name={{name}}
Terminal=false
Type=Application
{{#if mime_type}}
MimeType={{mime_type}}
{{/if}}

The {{exec_arg}} will be set to:

• “%F”, if at least one Config::file_associations was specified but no deep link protocols were given.
  • The “%F” arg means that your application can be invoked with multiple file paths.
• “%U”, if at least one Config::deep_link_protocols was specified.
  • The “%U” arg means that your application can be invoked with multiple URLs.
  • If both Config::file_associations and Config::deep_link_protocols were specified, the “%U” arg will be used, causing the file paths to be passed to your app as file:// URLs.
• An empty string “” (nothing) if neither are given.
  • This means that your application will never be invoked with any URLs or file paths.

To specify a custom exec_arg, just use plaintext directly instead of {{exec_arg}}:

Exec={{exec}} %u

See more here: https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html#exec-variables.

section: Option<String>

Define the section in Debian Control file. See : https://www.debian.org/doc/debian-policy/ch-archive.html#s-subsections

priority: Option<String>

Change the priority of the Debian Package. By default, it is set to optional. Recognized Priorities as of now are : required, important, standard, optional, extra

files: Option<HashMap<String, String>>

List of custom files to add to the deb package. Maps a dir/file to a dir/file inside the debian package.

package_name: Option<String>

Name to use for the Package field in the Debian Control file. Defaults to Config::product_name converted to kebab-case.

Implementations

impl DebianConfig

pub fn new() -> Self

Creates a new DebianConfig.

pub fn depends<I, S>(self, depends: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Set the list of Debian dependencies directly using an iterator of strings.

pub fn depends_path<P>(self, path: P) -> Self

where P: Into<PathBuf>,

Set the list of Debian dependencies indirectly via a path to a file, which must contain one dependency (a package name) per line.

pub fn desktop_template<P: Into<PathBuf>>(self, desktop_template: P) -> Self

Set the path to a custom desktop file Handlebars template.

Available variables: categories, comment (optional), exec, icon and name.

Default file contents:

[Desktop Entry]
Categories={{categories}}
{{#if comment}}
Comment={{comment}}
{{/if}}
Exec={{exec}} {{exec_arg}}
Icon={{icon}}
Name={{name}}
Terminal=false
Type=Application
{{#if mime_type}}
MimeType={{mime_type}}
{{/if}}

pub fn section<S: Into<String>>(self, section: S) -> Self

Define the section in Debian Control file. See : https://www.debian.org/doc/debian-policy/ch-archive.html#s-subsections

pub fn priority<S: Into<String>>(self, priority: S) -> Self

Change the priority of the Debian Package. By default, it is set to optional. Recognized Priorities as of now are : required, important, standard, optional, extra

pub fn files<I, S, T>(self, files: I) -> Self

where I: IntoIterator<Item = (S, T)>, S: Into<String>, T: Into<String>,

Set the list of custom files to add to the deb package. Maps a dir/file to a dir/file inside the debian package.

Trait Implementations

impl Clone for DebianConfig

fn clone(&self) -> DebianConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DebianConfig

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

Formats the value using the given formatter.

impl Default for DebianConfig

fn default() -> DebianConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DebianConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for DebianConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.