https://github.com/pmarreck/mini_blar

Constrained subset of the BLAR archive format — for embedded/bootstrap use
https://github.com/pmarreck/mini_blar

Last synced: 19 days ago
JSON representation

Constrained subset of the BLAR archive format — for embedded/bootstrap use

• Host: GitHub
• URL: https://github.com/pmarreck/mini_blar
• Owner: pmarreck
• License: mit
• Created: 2026-05-05T00:10:48.000Z (about 2 months ago)
• Default Branch: yolo
• Last Pushed: 2026-05-14T23:02:45.000Z (about 1 month ago)
• Last Synced: 2026-05-15T01:13:17.473Z (about 1 month ago)
• Language: Zig
• Size: 11.6 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# mini_blar

A constrained subset of the [blar](https://github.com/pmarreck/blar) archive

format — for embedded systems, bootstrap environments, and any context where

the full blar feature set (compression, encryption, codec expansion, signatures)

is overkill.

mini_blar archives are valid blar archives: any blar implementation can read

them. mini_blar's writer only emits a profile of the format, and its reader

only handles that profile.

Built on [BLIP](https://github.com/pmarreck/BLIP).

## Profile

mini_blar archives:

- May contain `FILE` and `DIR` entries (TYPE=5, TYPE=7)

- Use only `TYPE`, `CSUM`, `VAL` attributes (no `COMP`, `ENC`, `SEG`, `SIG`)

- Use only `xxhash64` for content checksums

- Have no compression, no encryption, no container expansion

If you need any of those, use blar.

## Build

```bash

./build         # release (via nix build)

./build debug   # debug (via zig build)

./test          # run unit + CLI tests

```

## Relationship to blar and BLIP

```

                        ┌──────────┐

                        │   BLIP   │  varint + LP envelope + generic containers

                        └────┬─────┘

                             │

              ┌──────────────┴──────────────┐

              ▼                             ▼

       ┌─────────────┐              ┌──────────────┐

       │  mini_blar  │              │     blar     │

       │  (this)     │              │  (sister)    │

       └─────────────┘              └──────────────┘

       constrained                  full feature set

       FILE/DIR only                + codecs, comp, enc

       xxhash64 only                + GUI, signatures

```

mini_blar and blar are **sister projects**. mini_blar does not depend on blar.

Both depend on BLIP. The two impls share a wire-format profile, not code.

## License

See [LICENSE](LICENSE).