Initial project import

tools/v/vlib/compress/bzip2/README.md

@@ -0,0 +1,51 @@
+# compress.bzip2
+
+Pure V bzip2 encoder/decoder.
+
+## Features
+
+- Pure V implementation (no C wrappers)
+- bzip2 stream compression (`BZh1`..`BZh9`)
+- bzip2 stream decompression
+- Block and stream CRC validation
+- Deterministic output for identical input/params
+
+## API
+
+```v
+import compress.bzip2
+
+compressed := bzip2.compress('hello'.bytes())!
+plain := bzip2.decompress(compressed)!
+assert plain.bytestr() == 'hello'
+```
+
+With params:
+
+```v
+import compress.bzip2
+
+data := 'hello'.bytes()
+compressed := bzip2.compress(data, block_size: 1)!
+plain := bzip2.decompress(compressed, verify_crc: true)!
+assert plain.bytestr() == 'hello'
+```
+
+## Notes
+
+- Randomized legacy bzip2 blocks are intentionally rejected.
+- API currently works on full byte slices (no streaming interface yet).
+
+## Test
+
+```bash
+v test vlib/compress/bzip2/
+```
+
+## Proof
+
+- tested against the official bzip2 C library using a variety of inputs and parameters.
+- deterministic and produces identical output for identical input and parameters.
+- includes CRC validation to ensure data integrity during compression and decompression.
+- rejects randomized legacy bzip2 blocks, ensuring only valid bzip2 streams are processed.
+- tested with a variety of inputs, including edge cases, to ensure robustness and reliability.