LombokECC

Reed-Solomon error-correction codes over GF(256) — RS(255, 239), t = 8. Zero-dependency TypeScript library with ports in PHP, Python, Go, Rust, and C++. Licensed Apache-2.0.

---

GitHub

npm

GitHub Packages

Packagist

PyPI

Quality

SourceForge

Community

Lombok Ecosystem

---

Changes from v0.1.0

• Multi-language ports added (PHP, Python, Go, Rust, C++)
• Test vectors v1 (42 cases, JSON + flat text)
• Root-level composer.json for Packagist auto-discovery
• Root-level pyproject.toml for PyPI builds
• ArticleEccCodec prototype (phase6)
• Each port has its own README with usage examples

Parameters

Parameter	Value
Codeword length (n)	255
Message length (k)	239
Parity bytes	16
Correctable errors (t)	8 bytes per block
Field	GF(256), primitive polynomial 0x11D

Ports

All ports validate against the same test vector set (42 test cases).

Language	Registry	Package	Install	Status
TypeScript	npm	lombokecc	npm install lombokecc	✅ 42/42
TypeScript	GPR	@codinglombok/lombokecc	npm install @codinglombok/lombokecc	✅ 42/42
PHP	Packagist	codinglombok/lombokecc	composer require codinglombok/lombokecc	✅ 42/42
Python	PyPI	lombokecc	pip install lombokecc	✅ 42/42
Go	Go	LombokECC-go	go get github.com/codinglombok/LombokECC-go	✅ 42/42
Rust	crates.io	lombokecc	cargo add lombokecc	✅ 42/42
C++	Header-only	—	Copy ports/cpp/include/lombok_ecc.hpp	✅ 42/42

Installation & Usage

TypeScript / JavaScript

npm install lombokecc

import { ReedSolomon } from 'lombokecc';
const rs = new ReedSolomon(255, 239);
const codeword = rs.encode(new Uint8Array([1, 2, 3, 4, 5]));
const decoded  = rs.decode(codeword);

PHP

composer require codinglombok/lombokecc

use CodingLombok\LombokEcc\ReedSolomon;
$rs = new ReedSolomon(255, 239);
$codeword = $rs->encode([1, 2, 3, 4, 5]);
$decoded  = $rs->decode($codeword);

Python

pip install lombokecc

from lombok_ecc import ReedSolomon
rs = ReedSolomon(255, 239)
codeword = rs.encode(bytes([1, 2, 3, 4, 5]))
decoded  = rs.decode(codeword)

Go

go get github.com/codinglombok/LombokECC-go

rs := lombokecc.New(255, 239)
codeword := rs.Encode([]byte{1, 2, 3, 4, 5})
decoded, _ := rs.Decode(codeword)

Rust

cargo add lombokecc

let rs = lombokecc::ReedSolomon::new(255, 239);
let codeword = rs.encode(&[1, 2, 3, 4, 5]);
let decoded = rs.decode(&codeword).unwrap();

C++

#include "lombok_ecc.hpp"
auto rs = lombokecc::ReedSolomon(255, 239);
auto codeword = rs.encode({1, 2, 3, 4, 5});
auto decoded = rs.decode(codeword);

Testing

# TypeScript
npm ci && npm run build && npm run test:full
bash mutate.sh            # mutation testing

# All ports
cd ports && bash run-all.sh

Project structure

├── package.json             ← npm (lombokecc)
├── composer.json            ← Packagist (codinglombok/lombokecc)
├── pyproject.toml           ← PyPI (lombokecc)
├── gf256.ts                 # GF(256) field arithmetic
├── reed-solomon.ts          # RS encoder + decoder
├── test-*.ts                # 5 test suites
├── bench.ts                 # benchmark
├── mutate.sh                # mutation testing
├── .github/workflows/
│   ├── ci.yml               # test + mutation + packaging + benchmark
│   └── publish-packages.yml # auto-publish on release
└── ports/
    ├── php/                 # Packagist (composer.json at root)
    ├── python/              # PyPI (pyproject.toml at root)
    ├── go/                  # Go module
    ├── rust/                # crates.io
    ├── cpp/                 # header-only
    └── vectors/             # 42 test cases (JSON + flat text)

License

Apache-2.0 — see LICENSE

---

Author: codinglombok Repository: github.com/codinglombok/LombokECC