remapper 1.0.0

Transform objects to and from similar structural mappings.

remapper

Transform objects to and from similar structural mappings. Useful for translating between sources of truth and presentational models of data.

Supports Python 3.8+. No dependencies.

Installation

$ pdm add remapper
# or
$ python -m pip install --user remapper

Usage

A trivial example for remap is converting one dataclass into another without having to manually pass attributes:

from dataclasses import dataclass

from remapper import remap

@dataclass
class Source:
    a: int
    b: int
    c: int

@dataclass
class Destination:
    a: int
    b: int
    c: int


dest = remap(Source(a=1, b=2, c=3), Destination)
# >> Destination(a=1, b=2, c=3)

A more useful example would be a mapping an internal database model to an externally-facing dataclass:

from dataclasses import dataclass

from remapper import remap
from sqlalchemy.orm import DeclarativeBase, Mapped, MappedAsDataclass

class Base(DeclarativeBase, MappedAsDataclass):
    pass

class Source(Base):
    id: Mapped[int] = mapped_column(init=False, primary_key=True)

    a: Mapped[int]
    b: Mapped[int]
    c: Mapped[int]

@dataclass
class Destination:
    a: int
    b: int
    c: int

source = Source(a=1, b=2, c=3)
await session.commit(source)

dest = remap(source, Destination)
# >> Destination(a=1, b=2, c=3)

License

This software is licensed under the BSD 3-Clause Clear License.