Struct PackageLimits 

pub struct PackageLimits {
    pub max_total_uncompressed: u64,
    pub max_single_uncompressed: u64,
    pub max_compression_ratio: u64,
    pub max_entries: usize,
    pub max_filename_len: usize,
}

ZIP archive size and complexity limits to prevent decompression bombs and element explosion attacks.

Examples

use easydoc_reader::security::PackageLimits;

let limits = PackageLimits::new();
// Default: 100 MB total, 50 MB per entry, 100x ratio, 10 000 entries
assert_eq!(limits.max_total_uncompressed, 100 * 1024 * 1024);

Fields

max_total_uncompressed: u64

Maximum total uncompressed size across all entries (bytes). Default: 100 MB.

max_single_uncompressed: u64

Maximum uncompressed size for a single entry (bytes). Default: 50 MB.

max_compression_ratio: u64

Maximum allowed compression ratio (uncompressed / compressed). Default: 100.

max_entries: usize

Maximum number of entries in the archive. Default: 10 000.

max_filename_len: usize

Maximum length of a single filename (bytes). Default: 256.

Implementations

impl PackageLimits

pub fn new() -> Self

Creates limits with the default conservative policy.

pub fn validate_archive<R: Read + Seek>( &self, archive: &mut ZipArchive<R>, ) -> Result<(), String>

Validates a ZIP archive against all configured limits.

Checks:

1. Entry count does not exceed max_entries.
2. Each filename is within max_filename_len.
3. No path traversal (.. or leading /) – Zip Slip prevention.
4. No single entry exceeds max_single_uncompressed.
5. Per-entry compression ratio does not exceed max_compression_ratio.
6. Total uncompressed size does not exceed max_total_uncompressed.
7. Overall compression ratio does not exceed max_compression_ratio.

Errors

Returns a human-readable error describing which limit was exceeded.

Trait Implementations

impl Clone for PackageLimits

fn clone(&self) -> PackageLimits

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PackageLimits

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

Formats the value using the given formatter.

impl Default for PackageLimits

fn default() -> Self

Returns the “default value” for a type.