exarch_core/
lib.rs

1//! Memory-safe archive extraction library with security validation.
2//!
3//! `exarch-core` provides a safe API for extracting archive files (tar, zip)
4//! with built-in protection against common security vulnerabilities like
5//! path traversal, zip bombs, symlink attacks, and hardlink attacks.
6//!
7//! # Examples
8//!
9//! ```no_run
10//! use exarch_core::SecurityConfig;
11//! use exarch_core::extract_archive;
12//!
13//! # fn main() -> Result<(), Box<dyn std::error::Error>> {
14//! let config = SecurityConfig::default();
15//! let report = extract_archive("archive.tar.gz", "/output/dir", &config)?;
16//! println!("Extracted {} files", report.files_extracted);
17//! # Ok(())
18//! # }
19//! ```
20
21#![deny(unsafe_code)]
22#![warn(missing_docs)]
23
24pub mod api;
25pub mod archive;
26pub mod config;
27pub mod copy;
28pub mod creation;
29pub mod error;
30pub mod extraction;
31pub mod formats;
32pub mod inspection;
33pub mod report;
34pub mod security;
35pub mod types;
36
37// Re-export main API types
38pub use api::create_archive;
39pub use api::create_archive_with_progress;
40pub use api::extract_archive;
41pub use api::extract_archive_with_progress;
42pub use api::list_archive;
43pub use api::verify_archive;
44pub use archive::Archive;
45pub use archive::ArchiveBuilder;
46pub use config::SecurityConfig;
47pub use error::ExtractionError;
48pub use error::QuotaResource;
49pub use error::Result;
50pub use report::ExtractionReport;
51pub use report::NoopProgress;
52pub use report::ProgressCallback;
53
54// Re-export creation types
55pub use creation::ArchiveCreator;
56pub use creation::CreationConfig;
57pub use creation::CreationReport;
58
59// Re-export inspection types
60pub use inspection::ArchiveEntry;
61pub use inspection::ArchiveManifest;
62pub use inspection::CheckStatus;
63pub use inspection::IssueCategory;
64pub use inspection::IssueSeverity;
65pub use inspection::ManifestEntryType;
66pub use inspection::VerificationIssue;
67pub use inspection::VerificationReport;
68pub use inspection::VerificationStatus;
69
70// Re-export types module for easier access
71pub use types::DestDir;
72pub use types::EntryType;
73pub use types::SafePath;
74pub use types::SafeSymlink;