Project Map

This page is generated from the current AST map and summarizes package size and stitching points.

Regenerating the map

This page is regenerated automatically during packaged docs builds. To refresh it manually, run:

python -m data_engine.devtools.project_ast_map src/data_engine --write-docs src/data_engine/docs/sphinx_source/guides

Package Rollup

These counts are package-level rollups from the current AST snapshot.

Package

Modules

Functions

Classes

Flows

Lines

data_engine

1

1

0

0

37

data_engine.application

7

6

19

0

1129

data_engine.authoring

3

9

2

0

293

data_engine.core

5

14

17

0

1572

data_engine.daemon_bootstrap

1

9

0

0

276

data_engine.devtools

3

44

5

0

1371

data_engine.docs

2

0

0

0

41

data_engine.domain

17

10

44

0

2235

data_engine.flow_modules

3

22

3

0

518

data_engine.helpers

10

94

8

0

4701

data_engine.hosts

20

110

29

0

6711

data_engine.platform

13

137

27

0

4468

data_engine.runtime

20

90

51

0

6300

data_engine.services

23

42

87

0

5637

data_engine.ui

58

264

34

0

13145

data_engine.views

11

35

10

0

1199

Largest Modules

Module

Lines

Functions

Classes

data_engine.helpers.polars

2614

37

2

data_engine.ui.gui.rendering.artifacts

2563

45

8

data_engine.hosts.daemon.client

2227

65

4

data_engine.runtime.shared_state

2085

75

9

data_engine.platform.processes

1567

56

11

data_engine.runtime.runtime_cache_store

1179

0

8

data_engine.ui.gui.theme

1145

3

0

data_engine.services.runtime_state

987

4

12

data_engine.ui.gui.controllers.flows

829

1

3

data_engine.ui.gui.controllers.runtime

821

0

1

Internal Stitching Points

Modules with higher internal import fan-out tend to be composition or aggregation points.

Module

Internal Imports

Lines

data_engine.domain

70

99

data_engine.helpers

60

65

data_engine.hosts.daemon.app

57

427

data_engine.views

54

92

data_engine.ui.gui.presenters

45

80

data_engine.ui.gui.render_support

43

240

data_engine.ui.gui.bootstrap

42

472

data_engine.hosts.daemon.client

39

2227

data_engine.ui.gui.support

34

371

data_engine.platform.workspace_policy

33

332

Practical Mental Model

  • Start in data_engine.authoring when changing how flows are expressed.

  • Start in data_engine.runtime when changing how flows are executed.

  • Start in data_engine.helpers when improving operator-friendly flow utilities.

  • Start in data_engine.runtime and data_engine.hosts for daemon behavior, state publication, logging, leasing, or checkpoints.

  • Start in data_engine.application for host-agnostic use-case behavior.

  • Start in data_engine.ui for interaction, rendering, presentation, or operator workflow.

  • Start in data_engine.platform for workspace discovery, path resolution, or platform compatibility.