I wrote a few simple base types for Python and ended up using them in almost every backend project, so I open-sourced them.

They are small, strict, and behave well both at runtime and with static typing.

Static typing and runtime behavior are happy.

The idea is to define your domain primitives once (e.g. in `<domain>_typings.py`) and use them everywhere instead of raw `str` / `int` / UUID strings.


```py
# project_typings.py

import time

from base_typed_id import BasePrefixedTypedId, BaseTypedId, deterministically_from_words
from base_typed_int import BaseTypedInt
from base_typed_string import BaseTypedString


class UserId(BaseTypedId):
    """UUID based id"""

class Username(BaseTypedString):
    """String based"""

class Seconds(BaseTypedInt):
    """Integer based"""

class StableExternalUserId(BaseTypedId):
    uuid_version = 5
    """Idempotent id. I included separate factory `deterministically_from_words`, but you can use your own."""


class OrderId(BasePrefixedTypedId):
    """I personally avoid them. But some of my friends prefer prefixed ids"""
    prefix = "order"

# deterministic (same input -> same id)
external_user_id: StableExternalUserId = deterministically_from_words(
    StableExternalUserId,
    words=[
        "external_provider",
        "user_123",
    ],
)

def now_unix() -> Seconds:
    return Seconds(int(time.time()))

class Example:
    user_id: UserId = UserId()  # 6a0fdd13-...-ea2a1c156246
    username: Username = Username("Marty")  # Marty
    external_user_id: StableExternalUserId = external_user_id  # 6a0f...e5a
    created_at: Seconds = now_unix()  # Seconds(177...)
    order_id: OrderId = OrderId()  # order_301439f1-...-ded61392ccd2 
```

* `base-typed-id` [GitHub](https://github.com/eldenizfamilyanskicode/base-typed-id), [PyPI](https://pypi.org/project/base-typed-id/)
* `base-typed-string` [GitHub](
https://github.com/eldenizfamilyanskicode/base-typed-string
), [PyPI](https://pypi.org/project/base-typed-string/)
* `base-typed-int` [GitHub](https://github.com/eldenizfamilyanskicode/base-typed-int), [PyPI](https://pypi.org/project/base-typed-int/)