Skip to content

gds_software.dfd.elements

DFD element declarations -- frozen Pydantic models for user-facing declarations.

Bases: BaseModel

An external actor that produces or consumes data.

Maps to: GDS BoundaryAction (exogenous input U). Emits a Signal port; has no internal inputs.

Source code in packages/gds-software/gds_software/dfd/elements.py 
10
11
12
13
14
15
16
17
18
class ExternalEntity(BaseModel, frozen=True):
    """An external actor that produces or consumes data.

    Maps to: GDS BoundaryAction (exogenous input U).
    Emits a Signal port; has no internal inputs.
    """

    name: str
    description: str = ""

Bases: BaseModel

A data transformation or processing step.

Maps to: GDS Policy (decision logic g). Receives data flows as input, produces data flows as output.

Source code in packages/gds-software/gds_software/dfd/elements.py 
21
22
23
24
25
26
27
28
29
class Process(BaseModel, frozen=True):
    """A data transformation or processing step.

    Maps to: GDS Policy (decision logic g).
    Receives data flows as input, produces data flows as output.
    """

    name: str
    description: str = ""

Bases: BaseModel

A data repository or database.

Maps to: GDS Mechanism (state update f) + Entity (state X). Receives write flows, emits content for read flows.

Source code in packages/gds-software/gds_software/dfd/elements.py 
32
33
34
35
36
37
38
39
40
class DataStore(BaseModel, frozen=True):
    """A data repository or database.

    Maps to: GDS Mechanism (state update f) + Entity (state X).
    Receives write flows, emits content for read flows.
    """

    name: str
    description: str = ""

Bases: BaseModel

A directed data flow between DFD elements.

Maps to: GDS Wiring (connects elements). The source and target reference element names.

Source code in packages/gds-software/gds_software/dfd/elements.py 
43
44
45
46
47
48
49
50
51
52
53
class DataFlow(BaseModel, frozen=True):
    """A directed data flow between DFD elements.

    Maps to: GDS Wiring (connects elements).
    The source and target reference element names.
    """

    name: str
    source: str
    target: str
    data: str = Field(default="", description="Description of data carried")