Skip to content

Architecture Docs → Commands

bio.dehydrate()

Convert an Entity back to a serializable dict.

Synopsis

from alienbio import bio

raw: dict = bio.dehydrate(entity: Entity)

Description

Dehydration reverses hydration, converting a typed Entity back to a plain dict that can be serialized to YAML. This is the inverse of the hydration step in the processing pipeline: name → .fetch() → dict → .hydrate() → entity → .build() → expanded → .eval() → result

Use Cases

Export generated scenarios: 

# Generate variants and save them
base = bio.fetch("scenarios.baseline")
for rate in [0.1, 0.2, 0.5]:
    variant = base.child({"reaction_rate": rate})
    raw = bio.dehydrate(variant)
    save_yaml(f"variant_{rate}.yaml", raw)

Round-trip for testing: 

raw = bio.fetch("spec.yaml", raw=True)
entity = bio.hydrate(raw)
restored = bio.dehydrate(entity)
# raw == restored (structurally)

Debug intermediate states: 

scenario = bio.fetch("complex.yaml")
# Inspect what hydration produced
print(bio.dehydrate(scenario))

What Gets Dehydrated

Object Becomes
Scenario dict with scenario fields
World dict with molecules, reactions, containers
Scope dict with bindings
Evaluable !ev tagged string
Quoted !_ tagged string

Typed objects call their to_spec() method to produce the dict representation.

See Also