pycodify

pycodify serializes Python objects to executable Python source while resolving imports and name collisions.

Quick start

from dataclasses import dataclass
from pycodify import Assignment, generate_python_source

@dataclass
class Config:
    name: str = "default"
    value: int = 42

config = Config(name="production", value=100)
code = generate_python_source(Assignment("config", config))

Explicit mode is the default (clean_mode=False) and includes default-valued fields. Pass clean_mode=True only when default elision is desired.

• Usage Guide
  • Basic Usage
  • Clean Mode vs Explicit Mode
  • Working with Enums
  • Handling Import Collisions
  • Formatting one value
  • Typed rendering extensions
  • Nested Dataclasses
  • Executing Generated Code
• API orientation
  • Public API
• Architecture
  • Two-Pass Algorithm
  • Extensible Formatter Registry
  • Core Components
  • Immutable typed context extensions
  • Clean Mode
  • Stability and trust boundary
  • Lazy Dataclass Integration
  • Module Structure

Ownership

pycodify owns source fragments, imports, formatter registration, collision handling, and generic Python formatting. Host packages own their domain formatters and round-trip policies.