asar 0.3.0

A crate to read and write asar archives, often used by Electron apps.
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
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

// SPDX-License-Identifier: Apache-2.0 OR MIT
use clap::{Args, Parser, Subcommand};
use std::path::PathBuf;

#[derive(Parser)]
#[clap(author, version, about, long_about = None, propagate_version = true)]
pub struct AppArgs {
	/// Whether to read unpacked files or not.
	#[clap(short = 'u', long)]
	pub read_unpacked: bool,
	#[clap(subcommand)]
	pub subcommand: AppSubcommand,
}

#[derive(Subcommand)]
pub enum AppSubcommand {
	Pack(PackArgs),
	List(ListArgs),
	Extract(ExtractArgs),
	ExtractFile(ExtractFileArgs),
}

/// Create asar archive
#[derive(Args)]
pub struct PackArgs {
	/// Path to a text file for ordering contents
	#[clap(long)]
	pub ordering: Option<PathBuf>,
	/// Do not pack files matching glob <expression>
	#[clap(long)]
	pub unpack: Option<String>,
	/// Do not pack dirs matching glob <expression> or starting with literal
	/// <expression>
	#[clap(long)]
	pub unpack_dir: Option<String>,
	/// Exclude hidden files
	#[clap(long)]
	pub exclude_hidden: bool,
	/// The directory to pack
	#[clap(value_parser)]
	pub dir: PathBuf,
	/// The output asar archive
	#[clap(value_parser)]
	pub output: PathBuf,
}

/// List files of asar archive
#[derive(Args)]
pub struct ListArgs {
	/// The asar archive to list
	#[clap(value_parser)]
	pub archive: PathBuf,
}

/// Extract an asar archive
#[derive(Args)]
pub struct ExtractArgs {
	/// Archive to extract
	#[clap(value_parser)]
	pub archive: PathBuf,
	/// The directory to extract to
	#[clap(value_parser)]
	pub destination: PathBuf,
}

/// Extract one file from an asar archive
#[derive(Args)]
pub struct ExtractFileArgs {
	/// Archive to extract
	#[clap(value_parser)]
	pub archive: PathBuf,
	/// The file to extract from the archive
	#[clap(value_parser)]
	pub filename: PathBuf,
}