---
url: 'https://sema-lang.com/docs/stdlib/archive.md'
---

# Archives

Gzip, zip, and tar.

::: tip Sandbox capabilities
Archive operations work without extra configuration in Sema's default mode.
`zip/list` requires `fs-read`; `zip/create`, `zip/extract`, `tar/create`, and
`tar/extract` require `fs-write`. A denied operation returns `PermissionDenied`.
The in-memory `gzip/*` functions require neither capability. See the
[CLI sandbox documentation](/docs/cli#sandbox).
:::

```sema
(gzip/compress (string->bytevector "hello"))   ; => gzip bytevector
(gzip/decompress bytes)
(zip/create "out.zip" '("a.txt" "b.txt"))      ; => entry count
(zip/extract "out.zip" "dest/")                ; zip-slip guarded
(zip/list "out.zip")
(tar/create "out.tar.gz" '("a.txt"))           ; .tar.gz/.tgz auto-gzips
(tar/extract "out.tar.gz" "dest/")             ; traversal + symlink guarded
```

Extraction refuses entries that would escape the destination (`..`, absolute
paths, traversal symlinks) and rejects two entries that map to the same target.