Struct self_update::backends::s3::UpdateBuilder

pub struct UpdateBuilder { /* fields omitted */ }

s3::Update builder

Configure download and installation from https://<bucket_name>.s3.<region>.amazonaws.com/<asset filename>

Implementations

impl UpdateBuilder

Configure download and installation from bucket

pub fn new() -> Self

Initialize a new builder

pub fn end_point(&mut self, end_point: EndPoint) -> &mut Self

Set the end point

pub fn bucket_name(&mut self, name: &str) -> &mut Self

Set the bucket name, used to build a s3 api url

pub fn asset_prefix(&mut self, prefix: &str) -> &mut Self

Set the optional asset name prefix, used to filter available assets with a prefix string

pub fn region(&mut self, region: &str) -> &mut Self

Set the S3 region used in the download url

pub fn current_version(&mut self, ver: &str) -> &mut Self

Set the current app version, used to compare against the latest available version. The cargo_crate_version! macro can be used to pull the version from your Cargo.toml

pub fn target_version_tag(&mut self, ver: &str) -> &mut Self

Set the target version tag to update to. This will be used to search for a release by tag name: /repos/:owner/:repo/releases/tags/:tag

If not specified, the latest available release is used.

pub fn target(&mut self, target: &str) -> &mut Self

Set the target triple that will be downloaded, e.g. x86_64-unknown-linux-gnu.

If unspecified, the build target of the crate will be used

pub fn bin_name(&mut self, name: &str) -> &mut Self

Set the exe’s name. Also sets bin_path_in_archive if it hasn’t already been set.

pub fn bin_install_path<A: AsRef<Path>>(
    &mut self,
    bin_install_path: A
) -> &mut Self

Set the installation path for the new exe, defaults to the current executable’s path

pub fn bin_path_in_archive(&mut self, bin_path: &str) -> &mut Self

Set the path of the exe inside the release tarball. This is the location of the executable relative to the base of the tar’d directory and is the path that will be copied to the bin_install_path. If not specified, this will default to the value of bin_name. This only needs to be specified if the path to the binary (from the root of the tarball) is not equal to just the bin_name.

Example

For a tarball myapp.tar.gz with the contents:

myapp.tar/
 |------- bin/
 |         |--- myapp  # <-- executable

The path provided should be:

Update::configure()
    .bin_path_in_archive("bin/myapp")

pub fn show_download_progress(&mut self, show: bool) -> &mut Self

Toggle download progress bar, defaults to off.

pub fn set_progress_style(&mut self, progress_style: ProgressStyle) -> &mut Self

Toggle download progress bar, defaults to off.

pub fn show_output(&mut self, show: bool) -> &mut Self

Toggle update output information, defaults to true.

pub fn no_confirm(&mut self, no_confirm: bool) -> &mut Self

Toggle download confirmation. Defaults to false.

pub fn auth_token(&mut self, auth_token: &str) -> &mut Self

pub fn build(&self) -> Result<Box<dyn ReleaseUpdate>>

Confirm config and create a ready-to-use Update

• Errors:
  • Config - Invalid Update configuration

Trait Implementations

impl Debug for UpdateBuilder

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

Formats the value using the given formatter.

impl Default for UpdateBuilder

fn default() -> Self

Returns the “default value” for a type.