# pithyx pack

> pithyx pack prüft ein App-Projekt und schreibt sein deterministisches Paket <id>-<version>.pithyxapp.

Source: https://pithyx.org/de/docs/reference/cli/pack/
Markdown: https://pithyx.org/de/docs/reference/cli/pack.md

`pithyx pack` führt die Prüfungen von [`pithyx validate`](https://pithyx.org/de/docs/reference/cli/validate/) aus und schreibt, wenn es keinen Fehler gibt, das App-Paket `<id>-<version>.pithyxapp`: ein gzip-komprimiertes tar-Archiv, das du im Store installierst oder in einem Katalog veröffentlichst. Dieselben Dateien ergeben immer dieselben Bytes.

## Aufruf

```sh
pithyx pack [project folder] [--frontend <folder>] [--out <path>] [--images]
```

## Optionen

| Option       | Wert       | Typ     | Standard    | Beschreibung                                                                                                                                                                                                                                                                         |
| ------------ | ---------- | ------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `--frontend` | `<folder>` | string  | `dist`      | The built frontend                                                                                                                                                                                                                                                                   |
| `--out`      | `<path>`   | string  | the project | The package file, or a folder for it                                                                                                                                                                                                                                                 |
| `--images`   | –          | boolean | aus         | Add backend/images/&lt;arch&gt;/&lt;id&gt;.tar for offline installs, saved with the local docker (save, or pull first, per architecture of the lock). Needs Docker with access to the registries; the images make the package large, and their bytes depend on Docker's save format. |

Ein `--out`, das auf `.pithyxapp` endet, ist die Paketdatei selbst; alles andere ist ein Ordner, der `<id>-<version>.pithyxapp` bekommt. Ein Ordner, den es noch nicht gibt, wird angelegt, auch der Ordner eines `.pithyxapp`-Pfads.

## Das Paket

- Zuerst `pithyx.json` und `icon.svg`, dann jeder andere Pfad nach Code-Einheiten sortiert.
- `frontend/` mit jeder Datei des gebauten Frontends außer versteckten.
- `README.md`, `README`, `LICENSE`, `LICENSE.md`, `LICENSE.txt`, wenn sie im Projektordner liegen.
- Mit Backend: seine Compose-Datei und `backend/images.lock.json`.
- `CHECKSUMS`: der SHA-256 jeder anderen Datei im Format von `sha256sum`, sodass `sha256sum -c CHECKSUMS` ein entpacktes Paket prüft.
- Mit `--images`: `backend/images/<arch>/<image id>.tar` für jedes Image und jede Architektur des Locks. Jedes Image wird mit `docker save` aus deinem Docker gespeichert, wenn es dort liegt (Images von `pithyx build`): über seine Image-ID beim klassischen Image-Store, über seinen Manifest-Digest beim containerd-Image-Store (Standard seit Docker 29), mit `--platform`, wo Docker es kennt. Jedes andere Image wird zuerst mit `docker pull --platform` über seinen Digest geholt; ein Image von `pithyx build` (`pithyx.local/...`) wird nie geholt. Das gespeicherte Archiv muss die Image-Konfiguration des Locks enthalten. Klappt nichts, nennt der Fehler jeden Versuch. Die Archive machen das Paket groß, und ihre Bytes hängen vom Speicherformat von Docker ab.

Feste Modi, Besitzer und Zeiten und keine Zeit im gzip-Header machen das Archiv deterministisch.

## Dateien

| Datei                                                     | Zugriff                                                       |
| --------------------------------------------------------- | ------------------------------------------------------------- |
| alles, was `validate` liest                               | gelesen                                                       |
| das Paket (Standard `<project>/<id>-<version>.pithyxapp`) | geschrieben, ersetzt, wenn vorhanden                          |
| ein temporärer Ordner `pithyx-images-*`                   | hält mit `--images` die gespeicherten Images, danach entfernt |

## Exit-Codes

| Code | Wann                                                                                                                                                      |
| ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 0    | Gepackt: `Packed <path> (<n> bytes).`                                                                                                                     |
| 1    | Ein Befund der Stufe Fehler (`Not packed: fix the errors above first.`), keine gültige `pithyx.json`, oder Docker scheitert mit `--images`.               |
| 2    | `--out` ist weder eine `.pithyxapp`-Datei noch ein Ordner, `--images` für eine App ohne Backend oder ohne gültigen Lock, oder mehr als ein Projektordner. |

## Befunde

Dieselben wie bei [`pithyx validate`](https://pithyx.org/de/docs/reference/cli/validate/#befunde); siehe [Befunde](https://pithyx.org/de/docs/reference/cli/findings/).

## Beispiele

```sh
pithyx pack                          # ./com.example.notes-1.0.0.pithyxapp
pithyx pack --out dist-packages/     # in einen Ordner, bei Bedarf angelegt
pithyx pack --out notes.pithyxapp    # ein eigener Dateiname
pithyx pack --images                 # mit den Backend-Images für Offline-Installationen
```