Struct Limits 

pub struct Limits {
    pub max_archive_size: u64,
    pub max_entry_uncompressed_size: u64,
    pub max_total_uncompressed_size: u64,
    pub max_entries: usize,
    pub max_compression_ratio: f64,
}

Safety guardrails for archive size and expansion limits.

These limits protect against zip bombs, resource exhaustion, and other denial-of-service attacks via malicious archives.

Examples

use openpack::Limits;

// Use default limits for most use cases
let limits = Limits::default();
assert!(limits.max_archive_size > 0);

Fields

max_archive_size: u64

Maximum size of the archive file itself in bytes.

Default: 256 MiB

max_entry_uncompressed_size: u64

Maximum uncompressed size of any single entry in bytes.

Default: 50 MiB

max_total_uncompressed_size: u64

Maximum total uncompressed size of all entries combined in bytes.

Default: 128 MiB

max_entries: usize

Maximum number of entries allowed in the archive.

Default: 2048

max_compression_ratio: f64

Maximum compression ratio (uncompressed / compressed) allowed. Higher ratios may indicate zip bombs.

Default: 100.0

Implementations

impl Limits

pub fn strict() -> Self

Provides very restrictive limits for highly untrusted archives.

Examples

use openpack::Limits;
let limits = Limits::strict();

pub fn permissive() -> Self

Provides extremely loose limits for trusted archives only.

Examples

use openpack::Limits;
let limits = Limits::permissive();

pub fn from_toml(raw: &str) -> Result<Self, OpenPackError>

Parses limits from a TOML string.

Examples

use openpack::Limits;
let toml_str = r#"
max_archive_size = 104857600
max_entry_uncompressed_size = 10485760
max_total_uncompressed_size = 52428800
max_entries = 1000
max_compression_ratio = 50.0
"#;
let limits = Limits::from_toml(toml_str).unwrap();

pub fn from_toml_file(path: &Path) -> Result<Self, OpenPackError>

Parses limits from a TOML file.

pub fn builtin() -> Self

Loads the builtin limits compiled into the binary.

Examples

use openpack::Limits;
let limits = Limits::builtin();

Trait Implementations

impl Clone for Limits

fn clone(&self) -> Limits

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Limits

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

Formats the value using the given formatter.

impl Default for Limits

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Limits

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Limits

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

where __S: Serializer,

Serialize this value into the given Serde serializer.