This package is maintained by dud.cl, an independent digital and AI transformation studio for enterprises and corporations.

dud-cl-rut

Validate and format Chilean RUT values in Python.

The Python API matches the TypeScript behavior and uses snake_case names.

Motivation

The last releases of the legacy JavaScript libraries rut.js and rutjs were published in 2021 and 2013, respectively, and they still have open issues. This package brings strict validation and structured issues to Python while matching the TypeScript API. See the agent reference for complete contracts and recipes.

Install

pip install dud-cl-rut

Usage

from dud_cl import rut

value = rut.parse("21.272.789-K")
# "21272789K"

rut.format(value)                    # "21.272.789-K"
rut.format(value, dots=False)        # "21272789-K"
rut.format(value, uppercase=False)   # "21.272.789-k"

rut.safe_parse("21.272.789-0", "en")
# SafeParseFailure(
#     success=False,
#     issue=VerifierIssue(
#         kind="verifier",
#         message='RUT verifier does not match. Replace "0" with "K".',
#         input="21.272.789-0",
#         expected="K",
#         received="0",
#     ),
# )

rut.is_rut("21272789k")  # True (the TypeScript name is `is`)

rut.clean("0021.272.789-k")                # "21272789K"
rut.get_verifier("21.272.789")             # "K"
rut.compare("21.272.789-K", "21272789K")  # True

With Pydantic

parse raises RutError, a ValueError subclass. Use it directly with AfterValidator:

from typing import Annotated
from pydantic import AfterValidator, BaseModel
from dud_cl.rut import parse

class User(BaseModel):
    national_id: Annotated[str, AfterValidator(parse)]

user = User(national_id="21.272.789-K")
user.national_id  # "21272789K"

API

Errors use Spanish (es) by default. Pass en as the second argument to parse or safe_parse for English messages.

The canonical string contains 8 or 9 characters: a 7- or 8-digit body and its verifier. Pass a value returned by parse to format.

Development

uv sync --extra dev
uv run pytest
uv run mypy

License

MIT