Struct DebFile

pub struct DebFile { /* private fields */ }

Used in the DebPackage struct to represent files in a package’s archives.

This struct contains the file’s contents, permissions, and it’s path in the final package.

Implementations

impl DebFile

pub fn from_path<F, T>(from: F, to: T) -> Result<Self>

where F: AsRef<Path>, T: AsRef<OsStr>,

Creates a DebFile from a path.

from is a path to a file on your system that you’re trying to add to the package. to is where the file will go once the package is installed on a user’s system.

On Unix systems, the file’s mode will automatically be set based on from. On Windows, the file’s mode will be set to 33188.

Errors

This function will return an error if from does not exist or can’t be read.

Example

use deb_rust::DebFile;
use deb_rust::binary::DebPackage;

let mut package = DebPackage::new("example")
    .with_file(DebFile::from_path(
        "target/release/example",
        "/usr/bin/example",
    ).unwrap());

pub fn from_buf<T>(buf: Vec<u8>, to: T) -> Self

where T: AsRef<OsStr>,

Creates a DebFile from a buffer.

buf is a buffer which will be added as the file’s contents. to is where the file will go once the package is installed on a user’s system.

The file’s mode is set to 33188. Permission’s must be managed manually.

Example

use deb_rust::DebFile;
use deb_rust::binary::DebPackage;

let mut package = DebPackage::new("example")
    .with_file(DebFile::from_buf(
        "#!/usr/bin/bash\necho Hello world!"
            .as_bytes()
            .to_vec(),
        "/usr/bin/example",
    ).is_exec());

pub fn is_exec(self) -> Self

Sets the file’s mode to have executable permissions.

pub fn is_conf(self) -> Self

Sets the file’s mode to have read/write permissions, without executable.

pub fn set_contents(self, contents: Vec<u8>) -> Self

Sets the file’s contents to contents.

pub fn set_mode(self, mode: u32) -> Self

Sets the file’s mode to mode.

pub fn set_path<T: AsRef<OsStr>>(self, to: T) -> Self

Sets the file’s path to to.

pub fn contents(&self) -> &Vec<u8>

Returns the file’s contents.

pub fn mode(&self) -> &u32

Returns the file’s mode.

pub fn path(&self) -> &PathBuf

Returns the file’s path.

Trait Implementations

impl Debug for DebFile

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

Formats the value using the given formatter.