Graphinate 0.15.0__tar.gz → 0.15.2__tar.gz

graphinate-0.15.2/.github/workflows/codspeed.yml

@@ -0,0 +1,35 @@
+# This workflow runs the benchmark suite and reports the results to CodSpeed.
+# For more information see: https://codspeed.io/docs/integrations/ci/github-actions
+
+name: CodSpeed
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+  # `workflow_dispatch` allows CodSpeed to trigger backtest
+  # performance analysis in order to generate initial data.
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write # for OpenID Connect authentication with CodSpeed
+
+jobs:
+  benchmarks:
+    name: Run benchmarks
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - name: Set up UV and Python
+        uses: astral-sh/setup-uv@v9.0.0
+        with:
+          python-version: "3.14"
+      - name: Install dependencies
+        run: uv sync --all-extras --group test
+      - name: Run benchmarks
+        uses: CodSpeedHQ/action@v5
+        with:
+          mode: simulation
+          run: uv run pytest benchmarks --codspeed

graphinate-0.15.2/.github/workflows/publish.yml

@@ -0,0 +1,31 @@
+# This workflow will build and publish the Python package to PyPI using uv
+# For more information see: https://docs.astral.sh/uv/
+
+name: Publish
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  deploy:
+    name: Deploy to PyPI
+    environment: pypi
+    permissions:
+      # Required for Trusted Publishing / OIDC authentication
+      id-token: write
+      contents: read
+
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - name: Install uv
+        uses: astral-sh/setup-uv@v9.0.0
+        with:
+          python-version: "3.14"
+      - name: Build package
+        run: uv build
+      - name: Publish package
+        run: uv publish

{graphinate-0.15.0 → graphinate-0.15.2}/CHANGELOG.md

@@ -1,3 +1,15 @@
+## v0.15.2 (2026-08-21)
+
+### Fix
+
+- correct debug mode support to CLI and GraphQL server configuration
+
+## v0.15.1 (2026-08-09)
+
+### Fix
+
+- GraphQL builder robustly populates enums and handles empty models.
+
 ## v0.15.0 (2026-08-07)
 
 ### Feat

{graphinate-0.15.0 → graphinate-0.15.2}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: Graphinate
-Version: 0.15.0
+Version: 0.15.2
 Summary: Graphinate. Data to Graphs.
 Project-URL: Homepage, https://erivlis.github.io/graphinate
 Project-URL: Documentation, https://erivlis.github.io/graphinate
@@ -88,6 +88,7 @@ Description-Content-Type: text/markdown
     <td>
       <a href="https://github.com/erivlis/graphinate/actions/workflows/test.yml"><img alt="Test" src="https://github.com/erivlis/graphinate/actions/workflows/test.yml/badge.svg"></a>
       <a href="https://github.com/erivlis/graphinate/actions/workflows/test-beta.yml"><img alt="Test (Beta)" src="https://github.com/erivlis/graphinate/actions/workflows/test-beta.yml/badge.svg"></a>
+      <a href="https://github.com/erivlis/graphinate/actions/workflows/codspeed.yml"><img alt="CodSpeed" src="https://github.com/erivlis/graphinate/actions/workflows/codspeed.yml/badge.svg"></a>
       <a href="https://github.com/erivlis/graphinate/actions/workflows/publish.yml"><img alt="Publish" src="https://github.com/erivlis/graphinate/actions/workflows/publish.yml/badge.svg"></a>
       <a href="https://github.com/erivlis/graphinate/actions/workflows/publish-docs.yaml"><img alt="Publish Docs" src="https://github.com/erivlis/graphinate/actions/workflows/publish-docs.yaml/badge.svg"></a>
     </td>
@@ -109,13 +110,15 @@ Description-Content-Type: text/markdown
       <a href="https://app.deepsource.com/gh/erivlis/graphinate/" target="_blank"><img alt="DeepSource" title="DeepSource" src="https://app.deepsource.com/gh/erivlis/graphinate.svg/?label=active+issues&show_trend=true&token=5n11jDEmcZB-6eyGR34rQaxF"/></a>
       <a href="https://app.deepsource.com/gh/erivlis/graphinate/" target="_blank"><img alt="DeepSource" title="DeepSource" src="https://app.deepsource.com/gh/erivlis/graphinate.svg/?label=resolved+issues&show_trend=true&token=5n11jDEmcZB-6eyGR34rQaxF"/></a>
       <a href="https://snyk.io/test/github/erivlis/graphinate"><img alt="Snyk" src="https://snyk.io/test/github/erivlis/Graphinate/badge.svg"></a>
+      <a href="https://app.codspeed.io/erivlis/graphinate?utm_source=badge"><img src="https://img.shields.io/endpoint?url=https://codspeed.io/badge.json" alt="CodSpeed"/></a>
     </td>
   </tr>
   <tr>
     <td>Mentions</td>
     <td>
       <a href="https://www.youtube.com/live/k01G0b0Y0Jg?si=030OT8sK3BqPyy8r&t=1028"><img alt="PythonBytes Podcast" src="https://img.shields.io/badge/Python_Bytes-Ep. 361-D7F9FF?logo=applepodcasts&labelColor=blue"></a>
-      <a href="https://pythonhub.dev/digest/2024-03-10/"><img alt="Static Badge" src="https://img.shields.io/badge/PythonHub-2024.03.10-gold?labelColor=blue"></a>
+      <!-- a href="https://pythonhub.dev/digest/2024-03-10/"><img alt="Static Badge" src="https://img.shields.io/badge/PythonHub-2024.03.10-gold?labelColor=blue"></a -->
+      <a href="https://pythonhub.dev/digest/2024-03-10/"><img alt="Python Hub" src="https://custom-icon-badges.demolab.com/badge/Python%20Hub-2024.03.10-gold?logo=pythonhub&labelColor=grey"></a>
     </td>
   </tr>
   <tr>

{graphinate-0.15.0 → graphinate-0.15.2}/README.md

@@ -41,6 +41,7 @@
     <td>
       <a href="https://github.com/erivlis/graphinate/actions/workflows/test.yml"><img alt="Test" src="https://github.com/erivlis/graphinate/actions/workflows/test.yml/badge.svg"></a>
       <a href="https://github.com/erivlis/graphinate/actions/workflows/test-beta.yml"><img alt="Test (Beta)" src="https://github.com/erivlis/graphinate/actions/workflows/test-beta.yml/badge.svg"></a>
+      <a href="https://github.com/erivlis/graphinate/actions/workflows/codspeed.yml"><img alt="CodSpeed" src="https://github.com/erivlis/graphinate/actions/workflows/codspeed.yml/badge.svg"></a>
       <a href="https://github.com/erivlis/graphinate/actions/workflows/publish.yml"><img alt="Publish" src="https://github.com/erivlis/graphinate/actions/workflows/publish.yml/badge.svg"></a>
       <a href="https://github.com/erivlis/graphinate/actions/workflows/publish-docs.yaml"><img alt="Publish Docs" src="https://github.com/erivlis/graphinate/actions/workflows/publish-docs.yaml/badge.svg"></a>
     </td>
@@ -62,13 +63,15 @@
       <a href="https://app.deepsource.com/gh/erivlis/graphinate/" target="_blank"><img alt="DeepSource" title="DeepSource" src="https://app.deepsource.com/gh/erivlis/graphinate.svg/?label=active+issues&show_trend=true&token=5n11jDEmcZB-6eyGR34rQaxF"/></a>
       <a href="https://app.deepsource.com/gh/erivlis/graphinate/" target="_blank"><img alt="DeepSource" title="DeepSource" src="https://app.deepsource.com/gh/erivlis/graphinate.svg/?label=resolved+issues&show_trend=true&token=5n11jDEmcZB-6eyGR34rQaxF"/></a>
       <a href="https://snyk.io/test/github/erivlis/graphinate"><img alt="Snyk" src="https://snyk.io/test/github/erivlis/Graphinate/badge.svg"></a>
+      <a href="https://app.codspeed.io/erivlis/graphinate?utm_source=badge"><img src="https://img.shields.io/endpoint?url=https://codspeed.io/badge.json" alt="CodSpeed"/></a>
     </td>
   </tr>
   <tr>
     <td>Mentions</td>
     <td>
       <a href="https://www.youtube.com/live/k01G0b0Y0Jg?si=030OT8sK3BqPyy8r&t=1028"><img alt="PythonBytes Podcast" src="https://img.shields.io/badge/Python_Bytes-Ep. 361-D7F9FF?logo=applepodcasts&labelColor=blue"></a>
-      <a href="https://pythonhub.dev/digest/2024-03-10/"><img alt="Static Badge" src="https://img.shields.io/badge/PythonHub-2024.03.10-gold?labelColor=blue"></a>
+      <!-- a href="https://pythonhub.dev/digest/2024-03-10/"><img alt="Static Badge" src="https://img.shields.io/badge/PythonHub-2024.03.10-gold?labelColor=blue"></a -->
+      <a href="https://pythonhub.dev/digest/2024-03-10/"><img alt="Python Hub" src="https://custom-icon-badges.demolab.com/badge/Python%20Hub-2024.03.10-gold?logo=pythonhub&labelColor=grey"></a>
     </td>
   </tr>
   <tr>

graphinate-0.15.2/benchmarks/conftest.py

@@ -0,0 +1,72 @@
+"""Shared fixtures for the Graphinate benchmark suite.
+
+The models defined here are deterministic (no randomness, no I/O) so that
+measurements stay comparable from one run to the next.
+"""
+
+import networkx as nx
+import pytest
+
+import graphinate
+from graphinate.builders import NetworkxBuilder
+
+COUNTRY_COUNT = 10
+CITY_COUNT = 200
+MESH_NODE_COUNT = 400
+MESH_DEGREE = 3
+
+
+def hierarchical_model(country_count: int = COUNTRY_COUNT, city_count: int = CITY_COUNT) -> graphinate.GraphModel:
+    """A two level parent/child model, exercising nested node generation."""
+    countries = tuple(f'country-{i}' for i in range(country_count))
+    cities = {f'city-{i}': countries[i % country_count] for i in range(city_count)}
+
+    graph_model = graphinate.model(name='Map')
+
+    @graph_model.node(unique=False)
+    def country(country_id=None, **kwargs):
+        if country_id is not None and country_id in countries:
+            yield country_id
+        else:
+            yield from countries
+
+    @graph_model.node(parent_type='country', unique=False)
+    def city(country_id=None, city_id=None, **kwargs):
+        if city_id is not None:
+            if cities.get(city_id) == country_id or country_id is None:
+                yield city_id
+        elif country_id is None:
+            yield from cities
+        else:
+            yield from (k for k, v in cities.items() if v == country_id)
+
+    return graph_model
+
+
+def mesh_model(node_count: int = MESH_NODE_COUNT, degree: int = MESH_DEGREE) -> graphinate.GraphModel:
+    """An edge only model producing a circulant graph, exercising edge population."""
+    graph_model = graphinate.model(name='Mesh')
+
+    @graph_model.edge()
+    def edge():
+        for i in range(node_count):
+            for offset in range(1, degree + 1):
+                yield {'source': i, 'target': (i + offset) % node_count}
+
+    return graph_model
+
+
+@pytest.fixture
+def hierarchical_graph_model() -> graphinate.GraphModel:
+    return hierarchical_model()
+
+
+@pytest.fixture
+def mesh_graph_model() -> graphinate.GraphModel:
+    return mesh_model()
+
+
+@pytest.fixture
+def mesh_graph() -> nx.Graph:
+    """A materialized NetworkX graph, used to benchmark post-processing steps."""
+    return NetworkxBuilder(mesh_model()).build()

graphinate-0.15.2/benchmarks/test_builders_benchmark.py

@@ -0,0 +1,88 @@
+"""Benchmarks for the builders, the core of Graphinate's data pipeline."""
+
+import networkx as nx
+import pytest
+import strawberry
+
+import graphinate
+from graphinate import GraphType
+from graphinate.builders import D3Builder, GraphQLBuilder, MermaidBuilder, NetworkxBuilder
+
+GRAPHQL_QUERY = """
+query Graph {
+  graph {
+    name
+    nodeTypeCounts { name value }
+    edgeTypeCounts { name value }
+    nodeCount
+    edgeCount
+    order
+    size
+  }
+  nodes { id type label color }
+  edges { source { id } target { id } type label weight }
+}
+"""
+
+
+@pytest.mark.benchmark
+def test_networkx_builder__mesh(mesh_graph_model):
+    graph = NetworkxBuilder(mesh_graph_model).build()
+    assert graph.number_of_nodes() > 0
+
+
+@pytest.mark.benchmark
+def test_networkx_builder__hierarchical(hierarchical_graph_model):
+    graph = NetworkxBuilder(hierarchical_graph_model).build()
+    assert graph.number_of_nodes() > 0
+
+
+@pytest.mark.benchmark
+def test_networkx_builder__digraph(mesh_graph_model):
+    graph = NetworkxBuilder(mesh_graph_model, graph_type=GraphType.DiGraph).build()
+    assert isinstance(graph, nx.DiGraph)
+
+
+@pytest.mark.benchmark
+def test_d3_builder__python(mesh_graph_model):
+    d3_graph = D3Builder(mesh_graph_model).build()
+    assert d3_graph['nodes']
+
+
+@pytest.mark.benchmark
+def test_d3_builder__json(mesh_graph_model):
+    d3_graph = D3Builder(mesh_graph_model).build(values_format='json')
+    assert d3_graph['nodes']
+
+
+@pytest.mark.benchmark
+def test_d3_builder__from_networkx(mesh_graph):
+    d3_graph = D3Builder.from_networkx(mesh_graph)
+    assert d3_graph['nodes']
+
+
+@pytest.mark.benchmark
+def test_mermaid_builder(mesh_graph_model):
+    diagram = MermaidBuilder(mesh_graph_model).build()
+    assert diagram
+
+
+@pytest.mark.benchmark
+def test_graphql_builder__schema(hierarchical_graph_model):
+    schema = GraphQLBuilder(hierarchical_graph_model).build()
+    assert isinstance(schema, strawberry.Schema)
+
+
+def test_graphql_builder__query(benchmark, hierarchical_graph_model):
+    schema: strawberry.Schema = GraphQLBuilder(hierarchical_graph_model).build()
+
+    result = benchmark(schema.execute_sync, GRAPHQL_QUERY)
+
+    assert result.errors is None
+    assert result.data['nodes']
+
+
+@pytest.mark.benchmark
+def test_build_facade(mesh_graph_model):
+    graph = graphinate.build(NetworkxBuilder, mesh_graph_model)
+    assert graph.number_of_nodes() > 0

graphinate-0.15.2/benchmarks/test_color_benchmark.py

@@ -0,0 +1,28 @@
+"""Benchmarks for the color helpers used when finalizing every graph."""
+
+import pytest
+
+from graphinate.color import color_hex, convert_colors_to_hex, node_color_mapping
+
+# node_color_mapping is lru_cached on the graph instance, bypass the cache so that
+# the mapping logic is actually measured on every iteration.
+_node_color_mapping = node_color_mapping.__wrapped__
+
+
+def test_node_color_mapping(benchmark, mesh_graph):
+    mapping = benchmark(_node_color_mapping, mesh_graph)
+
+    assert len(mapping) == mesh_graph.number_of_nodes()
+
+
+def test_convert_colors_to_hex(benchmark, mesh_graph):
+    benchmark(convert_colors_to_hex, mesh_graph)
+
+    assert all(isinstance(data['color'], str) for _, data in mesh_graph.nodes(data=True))
+
+
+@pytest.mark.benchmark
+def test_color_hex():
+    for i in range(1000):
+        value = (i % 256) / 255
+        color_hex((value, 1 - value, value / 2, 1.0))

graphinate-0.15.2/benchmarks/test_converters_benchmark.py

@@ -0,0 +1,52 @@
+"""Benchmarks for the converters used on every GraphQL node and edge identifier."""
+
+import itertools
+
+import pytest
+
+from graphinate.converters import (
+    decode_edge_id,
+    decode_node_id,
+    edge_label_converter,
+    encode_edge_id,
+    encode_node_id,
+    node_label_converter,
+)
+
+NODE_IDS = [(f'country-{i % 10}', f'city-{i}') for i in range(500)]
+EDGE_IDS = [((source,), (target,)) for source, target in itertools.pairwise(NODE_IDS)]
+ENCODED_NODE_IDS = [encode_node_id(node_id) for node_id in NODE_IDS]
+ENCODED_EDGE_IDS = [encode_edge_id(edge_id) for edge_id in EDGE_IDS]
+
+
+@pytest.mark.benchmark
+def test_encode_node_id():
+    for node_id in NODE_IDS:
+        encode_node_id(node_id)
+
+
+@pytest.mark.benchmark
+def test_decode_node_id():
+    for encoded in ENCODED_NODE_IDS:
+        decode_node_id(encoded)
+
+
+@pytest.mark.benchmark
+def test_encode_edge_id():
+    for edge_id in EDGE_IDS:
+        encode_edge_id(edge_id)
+
+
+@pytest.mark.benchmark
+def test_decode_edge_id():
+    for encoded in ENCODED_EDGE_IDS:
+        decode_edge_id(encoded)
+
+
+@pytest.mark.benchmark
+def test_label_converters():
+    for node_id in NODE_IDS:
+        node_label_converter(node_id)
+
+    for edge_id in EDGE_IDS:
+        edge_label_converter(edge_id)

graphinate-0.15.2/benchmarks/test_modeling_benchmark.py

@@ -0,0 +1,53 @@
+"""Benchmarks for the modeling layer: element creation and model registration."""
+
+import operator
+
+import pytest
+
+from graphinate.modeling import GraphModel, elements, extractor
+
+PAYLOADS = [{'id': i, 'name': f'item-{i}', 'kind': 'even' if i % 2 == 0 else 'odd'} for i in range(2000)]
+
+
+@pytest.mark.benchmark
+def test_elements__static_type():
+    generated = elements(PAYLOADS, 'item', key=operator.itemgetter('id'), label=operator.itemgetter('name'))
+    assert sum(1 for _ in generated) == len(PAYLOADS)
+
+
+@pytest.mark.benchmark
+def test_elements__dynamic_type():
+    generated = elements(
+        PAYLOADS,
+        operator.itemgetter('kind'),
+        key=operator.itemgetter('id'),
+        label=operator.itemgetter('name'),
+    )
+    assert sum(1 for _ in generated) == len(PAYLOADS)
+
+
+@pytest.mark.benchmark
+def test_extractor():
+    for payload in PAYLOADS:
+        extractor(payload, 'name')
+        extractor(payload, operator.itemgetter('id'))
+        extractor(payload)
+
+
+@pytest.mark.benchmark
+def test_model_registration():
+    graph_model = GraphModel(name='Registration')
+
+    @graph_model.node()
+    def country(**kwargs):
+        yield from ()
+
+    @graph_model.node(parent_type='country')
+    def city(country_id=None, **kwargs):
+        yield from ()
+
+    @graph_model.edge()
+    def edge(**kwargs):
+        yield from ()
+
+    assert graph_model.node_types == {'country', 'city'}

{graphinate-0.15.0 → graphinate-0.15.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "Graphinate"
-version = "0.15.0"
+version = "0.15.2"
 description = "Graphinate. Data to Graphs."
 authors = [
     { name = "Eran Rivlis", email = "eran@rivlis.info" },
@@ -99,6 +99,7 @@ test = [
     "httpx",
     "pytest",
     "pytest-asyncio",
+    "pytest-codspeed",
     "pytest-cov",
     "pytest-mock",
     "pytest-randomly",

{graphinate-0.15.0 → graphinate-0.15.2}/src/graphinate/builders/graphql.py

@@ -266,18 +266,22 @@ class GraphQLBuilder(NetworkxBuilder):
     def _populate_graph_node_type_enum(self, node_types: list[str]):
         from strawberry.types.enum import EnumValue
 
-        for v in node_types:
-            self.GraphNodeType._member_names_.append(v)
-            self.GraphNodeType._member_map_[v] = v
-            self.GraphNodeType._value2member_map_[v] = v
-
-            self.GraphNodeType.__strawberry_definition__.values.append(
-                EnumValue(
-                    name=v,
-                    value=v,
-                    description=f"Graph Node Type: {v}"
+        types_to_populate = node_types if node_types else ['node']
+
+        for v in types_to_populate:
+            if v not in self.GraphNodeType._member_names_:
+                self.GraphNodeType._member_names_.append(v)
+                self.GraphNodeType._member_map_[v] = v
+                self.GraphNodeType._value2member_map_[v] = v
+
+                self.GraphNodeType.__strawberry_definition__.values.append(
+                    EnumValue(
+                        name=v,
+                        value=v,
+                        description=f"Graph Node Type: {v}"
+                    )
                 )
-            )
+
 
     @property
     @functools.lru_cache

{graphinate-0.15.0 → graphinate-0.15.2}/src/graphinate/cli.py

@@ -1,16 +1,24 @@
 import importlib
 import json
+import sys
 from pathlib import Path
 from types import ModuleType
 from typing import Any
 
 import rich_click as click
+from loguru import logger
 from strawberry import Schema
 
 from . import GraphModel, builders, graphql
 from .renderers.graphql import DEFAULT_PORT
 
 
+def _configure_logging(debug: bool = False) -> None:
+    logger.remove()
+    log_level = 'DEBUG' if debug else 'INFO'
+    logger.add(sys.stderr, level=log_level)
+
+
 def _get_kwargs(ctx: click.Context) -> dict:
     return dict([item.strip('--').split('=') for item in ctx.args if item.startswith("--")])  # NOSONAR
 
@@ -79,15 +87,29 @@ model_option = click.option('-m', '--model',
 
 
 @click.group()
+@click.option(
+    '--debug/--no-debug',
+    default=False,
+    envvar='GRAPHINATE_DEBUG',
+    help='Enable or disable debug mode (can also be set via GRAPHINATE_DEBUG env var).'
+)
 @click.pass_context
-def cli(ctx: click.Context) -> None:
+def cli(ctx: click.Context, debug: bool) -> None:
     ctx.ensure_object(dict)
+    ctx.obj['debug'] = debug
+    _configure_logging(debug)
 
 
 @cli.command()
 @model_option
+@click.option('--debug/--no-debug', envvar='GRAPHINATE_DEBUG', default=None,
+              help='Enable or disable debug mode (can also be set via GRAPHINATE_DEBUG env var).')
 @click.pass_context
-def save(ctx: click.Context, model: GraphModel) -> None:
+def save(ctx: click.Context, model: GraphModel, debug: bool | None = None) -> None:
+    if debug is not None:
+        ctx.obj['debug'] = debug
+        _configure_logging(debug)
+
     file_path = Path(f"{model.name}.d3_graph.json")
 
     if file_path.is_absolute():
@@ -109,8 +131,16 @@ def save(ctx: click.Context, model: GraphModel) -> None:
 @model_option
 @click.option('-p', '--port', type=int, default=DEFAULT_PORT, help='Port number.')
 @click.option('-b', '--browse', type=bool, default=False, help='Open server address in browser.')
+@click.option('--debug/--no-debug', envvar='GRAPHINATE_DEBUG', default=None,
+              help='Enable or disable debug mode (can also be set via GRAPHINATE_DEBUG env var).')
 @click.pass_context
-def server(ctx: click.Context, model: GraphModel, port: int, browse: bool) -> None:
+def server(ctx: click.Context, model: GraphModel, port: int, browse: bool, debug: bool | None = None) -> None:
+    if debug is None:
+        debug = ctx.obj.get('debug', False)
+    else:
+        ctx.obj['debug'] = debug
+    _configure_logging(debug)
+
     message = """
      ██████╗ ██████╗  █████╗ ██████╗ ██╗  ██╗██║███╗   ██╗ █████╗ ████████╗███████╗
     ██╔════╝ ██╔══██╗██╔══██╗██╔══██╗██║  ██║██║████╗  ██║██╔══██╗╚══██╔══╝██╔════╝
@@ -120,4 +150,4 @@ def server(ctx: click.Context, model: GraphModel, port: int, browse: bool) -> No
      ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝     ╚═╝  ╚═╝╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝   ╚═╝   ╚══════╝"""
     click.echo(message)
     schema: Schema = builders.GraphQLBuilder(model).build()
-    graphql.server(schema, port=port, browse=browse, **_get_kwargs(ctx))
+    graphql.server(schema, port=port, browse=browse, debug=debug, **_get_kwargs(ctx))

{graphinate-0.15.0 → graphinate-0.15.2}/src/graphinate/renderers/graphql.py

@@ -69,6 +69,7 @@ def _graphql_app(graphql_schema: strawberry.Schema) -> GraphQL:
 
 def _starlette_app(graphql_app: strawberry.asgi.GraphQL | None = None,
                    port: int = DEFAULT_PORT,
+                   debug: bool = False,
                    **kwargs: Any) -> Starlette:
     def open_url(endpoint):
         webbrowser.open(f'http://localhost:{port}/{endpoint}')
@@ -97,6 +98,7 @@ def _starlette_app(graphql_app: strawberry.asgi.GraphQL | None = None,
         ])
 
     app = Starlette(
+        debug=debug,
         lifespan=lifespan,
         routes=app_routes
     )
@@ -108,21 +110,24 @@ def _starlette_app(graphql_app: strawberry.asgi.GraphQL | None = None,
     return app
 
 
-def server(graphql_schema: strawberry.Schema, port: int = DEFAULT_PORT, **kwargs: Any):
+def server(graphql_schema: strawberry.Schema, port: int = DEFAULT_PORT, debug: bool = False, **kwargs: Any):
     """
     Args:
         graphql_schema: The Strawberry GraphQL schema.
         port: The port number to run the server on. Defaults to 8072.
+        debug: Whether to run in debug mode. Defaults to False.
 
     Returns:
     """
 
     graphql_app = _graphql_app(graphql_schema)
 
-    app = _starlette_app(graphql_app, port=port, **kwargs)
+    app = _starlette_app(graphql_app, port=port, debug=debug, **kwargs)
 
     import uvicorn
-    uvicorn.run(app, host='0.0.0.0', port=port)
+    uvicorn_log_level = 'debug' if debug else 'info'
+    uvicorn.run(app, host='0.0.0.0', port=port, log_level=kwargs.get('log_level', uvicorn_log_level))
+
 
 
 __all__ = ['server']

{graphinate-0.15.0 → graphinate-0.15.2}/tests/graphinate/builders/test_graphql.py

@@ -136,3 +136,24 @@ def test_graphql_builder__ast_model__graph_query(ast_graph_model, graphql_query)
     assert actual_graph['graph']['name'] == 'AST Graph'
     node_types_counts = {c['name']: c['value'] for c in actual_graph['graph']['nodeTypeCounts']}
     assert node_types_counts
+
+
+def test_graphql_builder_empty_graph_model():
+    empty_model = graphinate.model('Empty Model')
+    builder = graphinate.builders.GraphQLBuilder(empty_model)
+
+    import strawberry
+    schema: strawberry.Schema = builder.build()
+    assert schema is not None
+
+    result = schema.execute_sync("{ graph { name nodeCount edgeCount } nodes { id } }")
+    assert result.errors is None
+    assert result.data == {
+        "graph": {
+            "name": "Empty Model",
+            "nodeCount": 0,
+            "edgeCount": 0,
+        },
+        "nodes": [],
+    }
+

{graphinate-0.15.0 → graphinate-0.15.2}/tests/graphinate/renderers/test_graphql_server.py

@@ -238,13 +238,18 @@ def test_root_redirect_and_schema_endpoints(client: TestClient):
 def test_server_runs_uvicorn(fake_schema, monkeypatch):
     import uvicorn
     called = []
-    def mock_run(app, host, port):
-        called.append((host, port))
+    def mock_run(app, host, port, log_level='info'):
+        called.append((host, port, log_level, app.debug))
 
     monkeypatch.setattr(uvicorn, "run", mock_run)
     graphql.server(fake_schema, port=9000)
     assert len(called) == 1
-    assert called[0] == ("0.0.0.0", 9000)
+    assert called[0] == ("0.0.0.0", 9000, "info", False)
+
+    called.clear()
+    graphql.server(fake_schema, port=9001, debug=True)
+    assert called[0] == ("0.0.0.0", 9001, "debug", True)
+
 
 
 def test_package_not_found_fallback(monkeypatch):