exarch-core 0.7.0

Memory-safe archive extraction library with security validation
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

//! Archive inspection without extraction.
//!
//! This module provides functions to inspect archive contents and verify
//! their security without writing files to disk.
//!
//! # Examples
//!
//! ```no_run
//! use exarch_core::SecurityConfig;
//! use exarch_core::list_archive;
//! use exarch_core::verify_archive;
//!
//! # fn main() -> Result<(), Box<dyn std::error::Error>> {
//! let config = SecurityConfig::default();
//!
//! // List archive contents
//! let manifest = list_archive("archive.tar.gz", &config)?;
//! println!("Archive contains {} files", manifest.total_entries());
//!
//! // Verify archive security
//! let report = verify_archive("archive.tar.gz", &config)?;
//! if report.is_safe() {
//!     println!("Archive is safe to extract");
//! }
//! # Ok(())
//! # }
//! ```

pub(crate) mod integrity;
pub mod list;
pub mod manifest;
pub mod report;
pub mod verify;

pub use list::list_archive;
pub use list::list_archive_with_options;
pub use manifest::ArchiveEntry;
pub use manifest::ArchiveManifest;
pub use manifest::EntryCompression;
pub use manifest::LinkTarget;
pub use manifest::ManifestEntryKind;
pub use manifest::ManifestEntryType;
pub use manifest::OversizedEntry;
pub use manifest::SolidBlock;
pub use report::CheckStatus;
pub use report::IntegrityGaps;
pub use report::IntegrityStatus;
pub use report::IssueCategory;
pub use report::IssueSeverity;
pub use report::UnverifiedEntry;
pub use report::UnverifiedReason;
pub use report::VerificationIssue;
pub use report::VerificationReport;
pub use report::VerificationStatus;
pub use verify::verify_archive;
pub use verify::verify_archive_with_options;