archive_extract — FILEIO archive op

• Data kinds: any × text → any

• Call: import fullseye as fs; fs.ledger.archive_extract(data_or_path, dest, *, members=None, max_total_bytes=2147483648, max_members=100000) (to call the implementation directly, import fileio; fileio.archive_extract(data_or_path, dest, *, members=None, max_total_bytes=2147483648, max_members=100000); from the registry, opsfileio.get("archive_extract"))

• GPU: none (CPU reference implementation only)

Usage

Safely extract an archive into an empty destination and return relative paths.

> The detailed description below is the original text — the summary and the headings are translated.

zip-slip(絶対path・..・drive文字)、link、特殊ファイル、重複名、10万件超、既定2 GiB超、

1:1000超の圧縮率を拒否する。dest は存在しないか空の実directoryに限り、検証済みの一時directoryを最後に置換するため失敗時に半端な出力を残さない。

Example: paths = archive_extract(payload, out_dir, members=["data/a.bin"]).

References (sample data, literature)

• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).

• Operator provenance and references — the sources of the research/methods this op family came from.

• The canonical algorithm (author, year) and its uses are named in the family usage guide above.

Runnable examples (verified samples that actually call this op)

• archive_roundtrip — py -3.11 examples/archive_roundtrip.py

Ops the type connects to (they accept any as input)

table_write_csv · table_read_csv · mesh_write_ply · mesh_read_ply · mesh_write_stl · mesh_read_stl · mesh_write_obj · mesh_read_obj

Same category (archive)

archive_probe · archive_list · archive_create

*Provenance: fileio.py — FILEIO operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.