community_5_readmenator_diagrams

readmenator: _diagrams

Community 5 | 15 files | cohesion 0.39

Definition

This community groups 15 file(s) rooted at readmenator with dominant language py (cohesion 0.39). Central symbols: BundleGraphRenderer, BundleLayout, DocsSitePublisher, ForceAtlas2Settings, ForceGraphRenderer, InteractiveMapRenderer, MapDelta, MapDiagnostic. Core file: readmenator/_diagrams.py (97 symbols). Documented purpose: Edge bundle explorer: circle and sphere hierarchical edge bundling pages. Turns the force-graph payload (file nodes with community, layer, language, PageRank, .

Files

File	Language	Layer	Symbols	Doc
readmenator/_bundlegraph.py	py	utility	8	yes
readmenator/_bundlegraph_page.py	py	presentation	0	yes
readmenator/_diagrams.py	py	utility	97	yes
readmenator/_forcegraph.py	py	utility	23	yes
readmenator/_forcegraph_page.py	py	presentation	0	yes
readmenator/_graphlayout.py	py	utility	26	yes
readmenator/_htmlpack.py	py	utility	5	yes
readmenator/_project_config.py	py	infrastructure	18	yes
readmenator/_sourceview.py	py	utility	8	yes
readmenator/_viewer_ui.py	py	presentation	7	yes
tests/test_bundlegraph.py	py	testing	27	yes
tests/test_graphlayout.py	py	testing	33	yes
tests/test_layout_quality.py	py	testing	16	yes
tests/test_project_config.py	py	testing	33	yes
tests/test_sourceview.py	py	testing	23	yes

Key Symbols

• _json_script (function, readmenator/_bundlegraph.py:39) def _json_script(value) - Serialize a value for an inline script, escaping angle brackets.
• BundleGraphRenderer (class, readmenator/_bundlegraph.py:51) class BundleGraphRenderer - Builds the bundle payload and renders the edge bundle explorer page.
• __init__ (method, readmenator/_bundlegraph.py:54) def __init__(self, config) - Initialise with application configuration.
• build_payload (method, readmenator/_bundlegraph.py:63) def build_payload(self, force_payload) - Derive the bundle payload from a force-graph payload.
• page_settings (method, readmenator/_bundlegraph.py:184) def page_settings(self, force_payload, explorer_href, live_api) - Collect the page settings serialized into the HTML.
• render (method, readmenator/_bundlegraph.py:228) def render(self, force_payload, title, home_href, explorer_href, live_api) - Render the standalone edge bundle explorer HTML document.
• write (method, readmenator/_bundlegraph.py:273) def write(self, output_path, force_payload, title, home_href, explorer_href) - Write the edge bundle explorer HTML document.
• thumbnail_svg (method, readmenator/_bundlegraph.py:299) def thumbnail_svg(self, force_payload) - Render a small circular bundle preview as inline SVG.
• _escape_markup (function, readmenator/_diagrams.py:33) def _escape_markup(value) - Escape text for HTML and tooltip embedding.
• _json_payload (function, readmenator/_diagrams.py:45) def _json_payload(payload) - Serialize a payload for safe inline script embedding.
• _fill_template (function, readmenator/_diagrams.py:57) def _fill_template(template, values) - Substitute KEY placeholders in a single pass.
• _role_color (function, readmenator/_diagrams.py:76) def _role_color(role, config) - Return the stroke color for a semantic role.
• MapNode (class, readmenator/_diagrams.py:90) class MapNode - Single authored node in a system map.
• MapEdge (class, readmenator/_diagrams.py:123) class MapEdge - Single authored directed relationship in a system map.
• MapView (class, readmenator/_diagrams.py:140) class MapView - Single guided chapter over authored topology.
• SystemMap (class, readmenator/_diagrams.py:157) class SystemMap - Typed intermediate representation of one diagram.
• MapDiagnostic (class, readmenator/_diagrams.py:178) class MapDiagnostic - Single machine-readable validation diagnostic.
• MapReceipt (class, readmenator/_diagrams.py:195) class MapReceipt - Deterministic validation receipt for a system map.
• MapDelta (class, readmenator/_diagrams.py:212) class MapDelta - Before and after comparison between two maps of the same kind.
• SystemMapValidator (class, readmenator/_diagrams.py:232) class SystemMapValidator - Deterministic validator for system map intermediate representations.
• __init__ (method, readmenator/_diagrams.py:235) def __init__(self, config) - Initialise the validator with application configuration.
• _effective_canvas (method, readmenator/_diagrams.py:243) def _effective_canvas(self, system_map) - Return the canvas bounds applying per-map full-mode growth.
• validate (method, readmenator/_diagrams.py:264) def validate(self, system_map) - Validate a system map and return a deterministic receipt.
• SystemMapBuilder (class, readmenator/_diagrams.py:456) class SystemMapBuilder - Builds deterministic system maps from the scanned knowledge graph.
• __init__ (method, readmenator/_diagrams.py:485) def __init__(self, config) - Initialise the builder with application configuration.
• supported_kinds (method, readmenator/_diagrams.py:494) def supported_kinds(self) - Return the supported diagram kind identifiers.
• _is_full (method, readmenator/_diagrams.py:502) def _is_full(self, full) - Return whether full-map scope applies for this build.
• build (method, readmenator/_diagrams.py:515) def build(self, nodes, edges, resolved_edges, layers, findings, analysis, kind, - Build one deterministic system map of the requested kind.
• _annotate_communities (method, readmenator/_diagrams.py:557) def _annotate_communities(system_map, analysis) - Tag map nodes with their code community so renderers can color clusters.
• build_all (method, readmenator/_diagrams.py:574) def build_all(self, nodes, edges, resolved_edges, layers, findings, analysis, fu - Build all five diagram kinds deterministically.

Internal vs External Edges

• Internal resolved imports (EXTRACTED): 45
• Cross-boundary resolved imports (EXTRACTED): 64

Connections

• [EXTRACTED] depends_on community 3 <-> 5 (strength 0.9): Extracted import edge crosses communities: readmenator/init.py imports readmenator/_project_config.py.
• [EXTRACTED] depends_on community 0 <-> 5 (strength 0.9): Extracted import edge crosses communities: readmenator/main.py imports readmenator/_project_config.py.
• [EXTRACTED] depends_on community 6 <-> 5 (strength 0.9): Extracted import edge crosses communities: readmenator/_apidocs_page.py imports readmenator/_htmlpack.py.
• [EXTRACTED] depends_on community 5 <-> 2 (strength 0.9): Extracted import edge crosses communities: readmenator/_diagrams.py imports readmenator/_folder_readme.py.
• [EXTRACTED] depends_on community 5 <-> 1 (strength 0.9): Extracted import edge crosses communities: readmenator/_diagrams.py imports readmenator/_models.py.
• [EXTRACTED] depends_on community 4 <-> 5 (strength 0.9): Extracted import edge crosses communities: readmenator/_documentation.py imports readmenator/_forcegraph.py.

Risks

• [taint high] readmenator/_diagrams.py -> readmenator/_diagrams.py via subprocess (0 hops)
• [taint high] readmenator/_diagrams.py -> readmenator/_models.py via subprocess (1 hops)
• [taint high] readmenator/_diagrams.py -> readmenator/_htmlpack.py via subprocess (1 hops)
• [taint high] readmenator/_diagrams.py -> readmenator/_viewer_ui.py via subprocess (1 hops)
• [taint high] readmenator/_diagrams.py -> readmenator/_folder_readme.py via subprocess (1 hops)
• [taint high] readmenator/_diagrams.py -> readmenator/_config.py via subprocess (1 hops)
• [taint high] readmenator/_diagrams.py -> readmenator/_project_config.py via subprocess (1 hops)
• [taint high] readmenator/_diagrams.py -> readmenator/_category.py via subprocess (2 hops)
• [taint high] readmenator/_documentation.py -> readmenator/_forcegraph.py via subprocess (1 hops)
• [layer strict] tests/test_layout_quality.py (testing) -> readmenator/_forcegraph_page.py (presentation)
• [layer strict] tests/test_project_config.py (testing) -> readmenator/_viewer_ui.py (presentation)
• [layer strict] tests/test_project_config.py (testing) -> readmenator/_viewer_ui.py (presentation)
• [layer strict] tests/test_project_config.py (testing) -> readmenator/_viewer_ui.py (presentation)
• [layer strict] tests/test_project_config.py (testing) -> readmenator/_forcegraph_page.py (presentation)
• [layer strict] tests/test_project_config.py (testing) -> readmenator/_bundlegraph_page.py (presentation)

Open Questions

• Is the dangerous import subprocess in readmenator/_diagrams.py still required, or can it be isolated?
• What would break if the most connected file in readmenator: _diagrams changed?
• Should readmenator: _diagrams be split, given cohesion 0.39?

Sources

• readmenator/_bundlegraph.py
• readmenator/_bundlegraph_page.py
• readmenator/_diagrams.py
• readmenator/_forcegraph.py
• readmenator/_forcegraph_page.py
• readmenator/_graphlayout.py
• readmenator/_htmlpack.py
• readmenator/_project_config.py
• readmenator/_sourceview.py
• readmenator/_viewer_ui.py
• tests/test_bundlegraph.py
• tests/test_graphlayout.py
• tests/test_layout_quality.py
• tests/test_project_config.py
• tests/test_sourceview.py