Introduction

What is Serilux?

Serilux is a powerful, flexible serialization framework for Python objects. It provides a simple and intuitive API for serializing and deserializing complex object hierarchies with minimal boilerplate code.

Key Features

  • Simple API: Just inherit from Serializable and you’re ready to go

  • Automatic Type Registration: Classes are automatically registered for deserialization

  • Class Name Conflict Detection: Automatically detects and prevents class name conflicts

  • Type Safety: Built-in validation ensures objects can be properly deserialized

  • Nested Objects: Automatically handles nested Serializable objects, lists, and dictionaries

  • Deeply Nested Containers: Supports arbitrarily deep nesting (dict -> list -> dict -> Serializable, etc.)

  • Callable Serialization: Full support for serializing functions, methods, and lambda expressions

  • Automatic Object Registration: Nested objects are automatically registered for method deserialization

  • Security: Strict mode prevents deserialization of unknown fields

  • Zero Dependencies: Pure Python with no external dependencies

Use Cases

Serilux is perfect for:

  • Object Persistence: Save and restore complex object states

  • Configuration Management: Serialize configuration objects to JSON/YAML

  • Data Transfer: Convert objects to dictionaries for API communication

  • State Management: Save application state for recovery

  • Workflow Orchestration: Serialize workflow definitions and states

  • Testing: Create test fixtures from serialized objects

Next Steps