InitO

Boilerplate elimination for Python — Lombok-inspired, zero-dependency.

InitO generates constructors, repr, equality/hashing, accessors, and fluent builders once at class-decoration time — never at instance construction or attribute-access time — so the generated classes perform like handwritten ones.

from inito import Data


@Data
class User:
    name: str
    age: int = 0


# @Data wrote __init__, __repr__, __eq__, __hash__, get_name/set_name, ...
user = User("Ada", age=30)
print(user)              # User(name='Ada', age=30)
print(user.get_name())   # Ada

Get started

Install InitO and tour every decorator in a few minutes.

Quick start

User Guide

Task-oriented docs: a dedicated page per decorator, plus DI, recipes, and migration.

User Guide

API reference

Every decorator, option, and exception, generated from the source.

API reference

Concepts

The boilerplate problem InitO solves — and how it stays fast.

Concepts: the problem inito solves

Dependency injection

Wire object graphs with @Service/@Singleton/@Inject and a Container.

Dependency injection

Recipes

Real-world, copy-pasteable patterns combining several decorators.

Recipes

Why InitO

• Real methods, generated once. Each decorator builds true Python functions from source at decoration time and attaches them to the class — no __getattr__, proxies, or descriptors. At runtime your objects are ordinary instances, so construction, attribute access, ==, and hash() run at handwritten speed.

• Pick exactly what you need. @Data is the all-in-one, but every capability is also a standalone decorator (@Getter, @ToString, @EqualsAndHashCode, …), matching Lombok’s à-la-carte style.

• Composes with the standard library. Stack any decorator with @dataclass; @Builder and the accessors work on plain classes too.

• Typed. A bundled mypy plugin makes mypy --strict see every generated member; @Data/@Value/ @AllArgsConstructor also type-check under pyright via a dataclass_transform stub.

• Batteries for services. A small dependency-injection layer (@Service/@Singleton/@Inject + a Container) wires constructors together lazily and thread-safely.

Decorators at a glance

Decorator	Generates
@Data	constructor, __repr__, __eq__, __hash__, get_x/set_x — the all-in-one
@Value	like @Data but immutable and setter-free
@Getter / @Setter	get_x() / set_x(value) accessors only
@ToString	__repr__ only
@EqualsAndHashCode	__eq__ + __hash__ only
@NoArgsConstructor	zero-argument constructor using each field’s default
@AllArgsConstructor	constructor taking every field
@RequiredArgsConstructor	constructor taking only fields without a default
@Builder / builder	fluent Cls.builder().x(1).build(), optional .to_builder()
@Service / @Singleton / @Inject	dependency injection via a Container

Every PascalCase decorator has a lowercase alias (data, builder, …) bound to the same object.