upgrade 2.0.1

A helpful library for upgradeing your standalone executables.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

#![doc = include_str!("../README.md")]
#![forbid(unsafe_code)]
#![warn(missing_docs)]

pub extern crate self_replace;

use std::env::current_exe;
use std::ffi::OsStr;
use std::fs::remove_file;
use std::io::Result;
use std::path::Path;
use std::process::Command;

/// Replace the current exe with the source path.
///
/// You may exit the program as soon as possible after it returns Ok.
///
/// See: [`Command`] and [`Command::args`]
pub fn run_upgrade<P: AsRef<Path>, S: AsRef<OsStr>, A: IntoIterator<Item=S>>(source: P, delete: bool, args: A) -> Result<()> {
    let source = source.as_ref();
    let current = current_exe()?.canonicalize()?;
    self_replace::self_replace(source)?;
    Command::new(&current).args(args).spawn()?;
    if delete { remove_file(source)?; }
    Ok(())
}

/// A shortcut of [`run_upgrade`] without args.
///
/// You may exit the program as soon as possible after it returns Ok.
#[inline]
pub fn upgrade<P: AsRef<Path>>(path: P) -> Result<()> {
    run_upgrade::<_, &str, _>(path, true, [])
}