archive_probe — FILEIO archive op

• Data kinds: any → text

• Call: import fullseye as fs; fs.ledger.archive_probe(data_or_path) (to call the implementation directly, import fileio; fileio.archive_probe(data_or_path); from the registry, opsfileio.get("archive_probe"))

• GPU: none (CPU reference implementation only)

Usage

Probe archive magic and return its format name.

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

入力は bytes または既存ファイルの path。返り値は zip/tar/tar.gz/tar.bz2/tar.xz/7z/rar のいずれかで、拡張子だけでは判定しない。未知・切断・圧縮tarでないgzip等は明示して拒否する。

Example: fmt = archive_probe(payload).

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 text as input)

table_read_csv · mesh_read_ply · mesh_read_stl · mesh_read_obj · mesh_read_off · points_read_xyz · e57_read · archive_list

Same category (archive)

archive_list · archive_extract · 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.