Metadata-Version: 2.4
Name: pyuuid7
Version: 0.1.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Rust
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Software Development :: Libraries
License-File: LICENSE
Summary: Fast UUID v4, v5, v7 generation in Rust
Keywords: uuid,uuid7,uuid5,uuid4,rust
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Repository, https://github.com/tarcisio/pyuuid7

# PyUUID7

Fast UUID v4, v5, and v7 generation in Rust for Python.

## Installation

```bash
pip install pyuuid7
```

## Usage

```python
import pyuuid7

# Generate UUIDs
uuid_v4 = pyuuid7.uuid4()          # Random UUID
uuid_v7 = pyuuid7.uuid7()          # Time-sortable UUID
uuid_v5 = pyuuid7.uuid5(           # Name-based UUID
    "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "example.com"
)

# Validation and parsing
pyuuid7.is_valid("a1b2c3d4-...")   # True/False
pyuuid7.get_version("a1b2c3d4-...") # 4, 5, 7, etc.
pyuuid7.parse("A1B2C3D4-...")      # Lowercase canonical format
```

## UUID Versions

| Version | Description |
|---------|-------------|
| v4 | Random UUID (122 random bits) |
| v5 | Name-based UUID using SHA-1 |
| v7 | Time-sortable UUID (Unix timestamp + random) |

## Development

```bash
# Setup environment
mise install
mise run setup

# Build and test
mise run dev
mise run test
```

## License

MIT

