cl-forge 1.0.0

Simple yet powerful Chilean and other tools written in Rust and Python.

Welcome to CL Forge!

Simple yet powerful Chilean tools written in Rust and Python.

cl-forge provides a collection of high-performance utilities for common Chilean data formats and API integrations. The core logic is implemented in Rust for maximum speed, with a clean and easy-to-use Python interface.

Features

• High Performance: Core logic written in Rust.
• Verify: Efficiently validate Chilean RUT/RUN and PPU (License Plates).
• API Integrations: Simple clients to interact with the CMF and Public Market APIs.
• Type Safety: Full type hints and .pyi stubs for excellent IDE support.

Examples

Validate

You can validate if a verifier digit is correct for a given numeric part of a RUT/RUN.

from cl_forge import verify

is_valid = verify.validate_rut(8750720, "3")

print(f"RUT is valid: {is_valid}")
# RUT is valid: True

... Or you can calculate the verifier digit yourself.

from cl_forge import verify

dv = verify.calculate_verifier(8750720)

print(f"Verifier digit: {dv}")
# Verifier digit: 3

Generate

Need to generate a bunch of random, unique and valid RUTs? No problem! And you can even specify a random seed, so you can reproduce the same results every time.

from cl_forge import verify

ruts = verify.generate(
   n=100,
   min=1_000_000,
   max=20_000_000,
   seed=42
)

print(ruts)
# [{'correlative': 8750720, 'verifier': '3'}, ...]

API Clients

The CMF API client allows you to easily interact with the CMF API.

from cl_forge.cmf import CmfClient

client = CmfClient(api_key="your-api-key")

# Get latest IPC data
ipc_data = client.get(path="/ipc")

print(ipc_data)
# {'IPCs': [{'Valor': '-0,2', 'Fecha': '2025-12-01'}]}

[!NOTE] To use the CMF API, you need an API key. You can request one at CMF Chile.

See the CMF API documentation for details about the available endpoints.

Contributing

Pull requests are welcome. For changes and reporting bugs, please open an issue first to discuss it. Read our Contributing Guide for more details.

License

This project is licensed under the Apache 2.0 License - see the LICENSE file for details.