Metadata-Version: 2.4
Name: oip-checksum-validator
Version: 0.1.2
Project-URL: Homepage, https://openinnovation.ai/
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: Implementation :: CPython
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: blake3>=1.0.8

# OI Checksum Validator

OICM checksum generator for data verification.

## Installation

```bash
pip install oip-checksum-validator
```

## Usage

Generate a checksum:
```bash
oic /path/to/directory

# OR invoke oip-checksum-validator via uvx, no permanent install needed
uvx --from oip-checksum-validator oic /path/to/directory
```

Verify against a reference checksum:
```bash
oic /path/to/directory -c <expected_checksum>

# OR invoke oip-checksum-validator via uvx, no permanent install needed
uvx --from oip-checksum-validator oic /path/to/directory -c <expected_checksum>
```

## How it works

The tool creates a deterministic hash by:
1. Sorting directory entries alphabetically
2. Recursively processing subdirectories
3. Hashing file contents with BLAKE3
4. Recording symlink targets
5. Combining all hashes into a final checksum

## Requirements

- `Python>=3.12`
- `blake3`
