# oxiarc-cli - Development Status (v0.3.1, 2026-05-30)
## Completed Features (COMPLETE)
### Commands
- [x] `list` (alias: `l`) - List archive contents
- [x] Simple file listing
- [x] Verbose mode with sizes and ratios
- [x] ZIP format support
- [x] TAR format support
- [x] LZH format support
- [x] GZIP format support
- [x] `extract` (alias: `x`) - Extract files
- [x] ZIP extraction with directory creation
- [x] GZIP extraction
- [x] Output directory option (`-o`)
- [x] `info` (alias: `i`) - Show archive information
- [x] Format detection
- [x] File metadata
- [x] Content statistics
- [x] `detect` - Detect archive format
- [x] Magic byte display
- [x] Format classification
### Infrastructure (332 lines)
- [x] clap-based argument parsing
- [x] Subcommand structure
- [x] Error handling with exit codes
- [x] Format auto-detection
- [x] Path sanitization for security
## Future Enhancements
### Commands Status
- [x] `create` (alias: `c`) - Create archives (COMPLETED)
- [x] ZIP creation
- [x] GZIP creation
- [x] TAR creation
- [x] LZH creation (LH0 stored mode and LH5 compression)
- [x] XZ creation
- [x] LZ4 creation
- [x] Zstandard creation
- [x] Bzip2 creation
- [x] Brotli creation (.br/.brotli)
- [x] Snappy creation (.sz/.snappy)
- [x] Compression level option
- [x] `test` (alias: `t`) - Test archive integrity (COMPLETED)
- [x] CRC verification
- [x] Header validation
- [x] Report corrupted entries
- [x] Brotli and Snappy format testing support
- [x] `convert` - Convert between formats (COMPLETED)
- [x] ZIP/TAR/GZIP/LZH/XZ/7z/CAB/LZ4/Zstd/Bzip2/Brotli/Snappy interconversion
### Extract Features
- [x] TAR extraction
- [x] LZH extraction
- [x] ZIP extraction
- [x] GZIP extraction
- [x] XZ extraction
- [x] 7z extraction
- [x] CAB extraction
- [x] LZ4 extraction
- [x] Zstandard extraction
- [x] Bzip2 extraction
- [x] Brotli extraction (.br/.brotli)
- [x] Snappy extraction (.sz/.snappy)
- [x] File pattern filtering (include/exclude)
- [x] Progress bars
- [x] Preserve timestamps
- [x] Preserve permissions
- [x] Overwrite prompts
- [x] Skip existing files
### List Improvements
- [x] JSON output (`--json`)
- [x] Sorting options (name, size, date, ratio)
- [x] Filter by pattern
- [x] Show modification times
- [x] Tree view (verified 2026-04-20 with `cli_tree.rs` integration test — guards `├`/`└` connectors and nested path rendering)
### Create Command Options
- [x] Compression level (`-l 0-9`)
- [x] Recursive directory inclusion
- [x] Exclude patterns
- [x] Store vs. compress threshold (2026-04-20 — `--compress-threshold N`, files below N bytes bypass deflate; verified with `cli_create_threshold.rs`)
- [x] Add files to existing archive (2026-04-20 — `oxiarc add <archive> <files>` for ZIP/TAR/LZH, with `--dry-run`; verified with `cli_add.rs`)
### User Experience
- [x] Progress bars (indicatif)
- [x] Colored output (colored/termcolor) (planned 2026-04-20) — verified with integration tests across list/info/detect/extract + NO_COLOR env
- **Goal:** `oxiarc list`, `oxiarc info`, and `oxiarc detect` produce colored output on terminals, plain output when piped, with a global `--color {auto,always,never}` flag. Errors → red; dirs/files/symlinks → distinct hues.
- **Design:** Add `owo-colors` (latest, pure Rust) and `supports-color` (latest, pure Rust) to `oxiarc-cli/Cargo.toml`. New `src/style.rs` (~80 lines) centralizes `ColorChoice` enum, TTY detection (`NO_COLOR`/`FORCE_COLOR` respected), and styled helpers. Root clap command gains `#[arg(long, value_enum, default_value_t = ColorChoice::Auto, global = true)]`. Four commands (`list`, `info`, `detect`, `extract --verbose`) route output through style helpers.
- **Files:** `oxiarc-cli/Cargo.toml` (MODIFY +2 deps), `src/style.rs` (NEW), `src/main.rs` (MODIFY), `src/list.rs`, `src/info.rs`, `src/detect.rs`, `src/extract.rs` (MODIFY)
- **Prerequisites:** none
- **Tests:** unit in style.rs (Auto+no-tty→plain, Always→ANSI, Never→plain); integration via assert_cmd (`oxiarc list --color=never` → no ESC sequences)
- **Risk:** owo-colors is pure Rust; no policy issue
- [ ] Interactive mode
- [x] Verbose/quiet modes (`-v`, `-q`)
- [x] Dry-run mode (`--dry-run`, `-n`) for create and extract commands
### I/O Options
- [x] Stdin/stdout support (`-`)
- [x] Password for encrypted archives (2026-04-20 — `--password` on `extract` plus interactive prompt via `rpassword`; wrong password exits 2; verified with `cli_password.rs`)
- [ ] Multi-volume archives
- [x] CLI `--memory-limit <BYTES>` for extract/list (completed 2026-05-06)
- **Goal:** `oxiarc extract --memory-limit 100M` and `oxiarc list --memory-limit 100M` cap peak in-memory allocation per entry. Entry exceeding cap → clear error with entry name + required vs allowed bytes. Default = unlimited.
- **Design:** Add `#[arg(long, value_parser = parse_byte_size)] memory_limit: Option<u64>` to `Commands::Extract` and `Commands::List` in main.rs. Helper `parse_byte_size(s: &str) -> Result<u64>`: accepts `100`, `100K`, `100M`, `100G` (decimal multipliers 1000/1_000_000/1_000_000_000). In extract.rs and list.rs pre-flight check: compare `entry.uncompressed_size()` against limit; error: `"entry '{name}' requires {req} bytes, exceeds --memory-limit {lim}"`. Place helper in `oxiarc-cli/src/util.rs` (reuse if exists).
- **Files:** MODIFY `oxiarc-cli/src/main.rs`, MODIFY `oxiarc-cli/src/commands/extract.rs`, MODIFY `oxiarc-cli/src/commands/list.rs`, possibly NEW/MODIFY `oxiarc-cli/src/util.rs`
- **Tests:** unit `parse_byte_size` tests (100→100, "100K"→100_000, "garbage"→Err); CLI integration: ZIP with 1KB + 1MB + `--memory-limit 10K` → 1KB ok, 1MB errors with entry name; default-unlimited test
- **Risk:** very low — pre-flight check only
### Platform
- [x] Shell completion scripts (bash, zsh, fish, powershell) - COMPLETED
- [x] Hidden `completion` subcommand
- [x] Bash completion generation
- [x] Zsh completion generation
- [x] Fish completion generation
- [x] PowerShell completion generation
- [x] Installation instructions in README
- [x] Man page generation (planned 2026-04-20) — verified with integration test; generates .TH/.SH-compliant roff files
- **Goal:** `oxiarc man [OUTPUT_DIR]` writes mandoc-format man pages (one per subcommand + top-level) to a given directory. Default output dir: `./man/`.
- **Design:** Add `clap_mangen = "0.2"` (latest, pure Rust) to `oxiarc-cli/Cargo.toml`. New `src/commands/man.rs` (~70 lines) or `src/man.rs` (mirroring existing command layout) builds `clap_mangen::Man` for each subcommand via `Cli::command()` tree, writes `oxiarc-<subcmd>.1` and `oxiarc.1`.
- **Files:** `oxiarc-cli/Cargo.toml` (MODIFY +1 dep), new man command file (MODIFY/NEW), `src/main.rs` (MODIFY — register subcommand)
- **Prerequisites:** none
- **Tests:** integration via assert_cmd (`oxiarc man /tmp/<tempdir>` → oxiarc.1 and oxiarc-list.1 exist, start with `.TH OXIARC`). Use `std::env::temp_dir()`.
- **Risk:** none; clap_mangen is well-trodden
- [x] Windows-specific handling (2026-04-20 — `src/windows.rs` sanitizes reserved basenames CON/PRN/AUX/NUL/COM1-9/LPT1-9 on extract, appends `_` to stem, `--strict-names` refuses; long paths auto-prefixed with `\\?\` on Windows; verified with `cli_windows_names.rs`)
## Test Coverage
- Integration tests needed
- Currently relies on library tests
## Code Statistics
| File | Lines |
|------|-------|
| main.rs | ~1,886 |
| utils.rs | ~129 |
| create.rs | ~200 |
| extract.rs | ~200 |
| (other modules) | ~28 |
| **Total** | **~2,443** |
## Command Reference
```
oxiarc 0.2.6
The Oxidized Archiver - Pure Rust archive utility
USAGE:
oxiarc <COMMAND>
COMMANDS:
list List contents of an archive [aliases: l]
extract Extract files from an archive [aliases: x]
info Show information about an archive [aliases: i]
detect Detect archive format
test Test archive integrity [aliases: t]
create Create an archive [aliases: c]
convert Convert between archive formats
help Print help information
OPTIONS:
-h, --help Print help information
-V, --version Print version information
```
## Known Limitations
1. No encrypted archive support
2. No interactive mode