Graphinate 0.8.4__tar.gz → 0.8.6__tar.gz

graphinate-0.8.6/.coveragerc

@@ -0,0 +1,9 @@
+[run]
+branch = True
+relative_files = True
+omit =
+    .venv/*
+    docs/*
+    examples/*
+    playground/*
+    tests/*

graphinate-0.8.6/.deepsource.toml

@@ -0,0 +1,28 @@
+version = 1
+
+test_patterns = [
+    "tests/**",
+    "test_*.py"
+]
+
+exclude_patterns = [
+    "docs/**",
+    "examples/**",
+    "playground/**"
+]
+
+[[analyzers]]
+name = "javascript"
+
+    [analyzers.meta]
+    environment = ["browser"]
+
+[[analyzers]]
+name = "test-coverage"
+
+[[analyzers]]
+name = "python"
+
+    [analyzers.meta]
+    runtime_version = "3.x.x"
+

{graphinate-0.8.4 → graphinate-0.8.6}/.github/workflows/codeql.yml

@@ -46,7 +46,7 @@ jobs:
 
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
 
     # Initializes the CodeQL tools for scanning.
     - name: Initialize CodeQL

{graphinate-0.8.4 → graphinate-0.8.6}/.github/workflows/publish-docs.yaml

@@ -9,7 +9,7 @@ jobs:
   deploy:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: actions/setup-python@v5
         with:
           python-version: 3.x

{graphinate-0.8.4 → graphinate-0.8.6}/.github/workflows/publish.yml

@@ -16,7 +16,7 @@ jobs:
   deploy:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
     - name: Set up Python
       uses: actions/setup-python@v5
       with:

{graphinate-0.8.4 → graphinate-0.8.6}/.github/workflows/test-beta.yml

@@ -16,9 +16,9 @@ jobs:
       fail-fast: false
       matrix:
         # https://github.com/actions/python-versions/blob/main/versions-manifest.json
-        python-version: [ "3.14.0-alpha.6" ]
+        python-version: [ "3.14.0-rc.2" ]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v5
         with:
@@ -38,5 +38,5 @@ jobs:
           flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
       - name: Test with pytest
         run: |
-          python -m pip install faker pytest pytest-asyncio pytest-cov pytest-randomly pytest-xdist starlette-prometheus uvicorn[standard]
+          python -m pip install faker pytest pytest-asyncio pytest-cov pytest-mock pytest-randomly pytest-xdist starlette-prometheus uvicorn[standard]
           pytest tests --cov=src --cov-branch --cov-report=xml --junitxml=test_results.xml -n auto

{graphinate-0.8.4 → graphinate-0.8.6}/.github/workflows/test.yml

@@ -17,7 +17,7 @@ jobs:
       matrix:
         python-version: [ "3.10", "3.11", "3.12", "3.13"]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v5
         with:
@@ -37,7 +37,7 @@ jobs:
           flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
       - name: Test with pytest
         run: |
-          python -m pip install faker pytest pytest-asyncio pytest-cov pytest-randomly pytest-xdist starlette-prometheus uvicorn[standard]
+          python -m pip install faker pytest pytest-asyncio pytest-cov pytest-mock pytest-randomly pytest-xdist starlette-prometheus uvicorn[standard]
           pytest tests --cov=src --cov-branch --cov-report=xml --junitxml=junit.xml -o junit_family=legacy -n auto
       - name: Upload coverage reports to Codecov
         uses: codecov/codecov-action@v5

{graphinate-0.8.4 → graphinate-0.8.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Graphinate
-Version: 0.8.4
+Version: 0.8.6
 Summary: Graphinate. Data to Graphs.
 Project-URL: Homepage, https://erivlis.github.io/graphinate
 Project-URL: Documentation, https://erivlis.github.io/graphinate
@@ -33,7 +33,8 @@ Requires-Dist: loguru
 Requires-Dist: mappingtools
 Requires-Dist: matplotlib
 Requires-Dist: networkx
-Requires-Dist: networkx-mermaid>=0.1.0
+Requires-Dist: networkx-mermaid
+Requires-Dist: networkx-query>=2.1.3
 Requires-Dist: strawberry-graphql[asgi,opentelemetry]
 Provides-Extra: plot
 Requires-Dist: scipy; extra == 'plot'
@@ -74,6 +75,7 @@ Description-Content-Type: text/markdown
       <a href="https://github.com/astral-sh/ruff"><img alt="ruff" src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" style="max-width:100%;"></a>
       <a href="https://github.com/tox-dev/pipdeptree"><img alt="pipdeptree" src="https://img.shields.io/badge/pipdeptree-526CFE.svg?labelColor=gray&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAADFElEQVR4nFxTW2tcVRRe39773E/mliZjwKRmhBaKt4BWRKmGgihCH3xUKNWC/Q/ii76IP8AHpSIiRfqmD5YKCinalhgiCMZLSVtMM0mTdDLTuZyZc9l7yTlp7WXBgXPW+fa31rfWtxU9FLMN79Crr028e+iJsZfb7fJMp23xRlOvbTR3L/y5cuOL3Vbv7/vxuPviecI/eWr6k/mj4+8AkM11y+zs2MKwMJvNgIgYINZX/rlx+tIvf72fZXr4P0EQyOCjjw98P9vwn8+/+z3Bq6sek7AJkNhsOjQcyjvFmHd2upd+PP/zsSxNI5mnPvjw8U9fPFJ9XVkgNuDVayEbcgVEfgikNfFg4JAmh1LyyfGq06QqE9vN6+fEs4fHnjv25vjbAOA4AsL2MVZ1hRcI4QXIH7ilMqQXkiYXRBJRbFNQnTsRlqfmxFvH66ccFyAQMxP3I5cqNZBSxIWcKORMO9g3yeSHzFkGbnVCIkDUZ+beEy+8VJ4XguC6TMPYokwrCAHUJsBxYptoFBYSMi0oLIlcAkuFYhal8Zl5VanZU0zErgfurufMFjEkWZ7iRFY4SlgYfW9bUIJKFQNjiNPYf1QZOZn/hTaStPQKTI4eDCxSjsL4I6BeJzOjgcnT0HqPqwBJCdHZjW/miWjkkG3hzqKIe5FVlM3llGuWqOxTDMBkWlJ/6PB2p0Sb21gXixdvLeTtDGOHLFvQHpkiYyTuNU5kuxJercTdpEK3Bz4yLdFrXVsQ33x1/bModjhvyrKKVXB/YD9gb8PgKAlolAZipmFTOIYcxq21Xz8XS5dbi+e+2zqbA3MjxYninH3PpkyZljwYjZE2FoxBIWm6YVHaW/k66qwtF05curz509OHHzvqBqWp232fE+2AoCjOXNMfhcRcjAxxoijNFNpbG0vL588cNzpLC4I00cnCD1fPBuVqffbA5DMGNjR5MOSBpC+UYxGE5G5PmNXff/vy4rdnTmRJHD1wG+9G42D9qVfeePLk/oONI8qv7+/2fbq11f53ZfnqhStLi6d3b67/cT/+vwAAAP//Xo5dwOtdLi4AAAAASUVORK5CYII="></a>
       <a href="https://squidfunk.github.io/mkdocs-material/"><img alt="mkdocs-material" src="https://img.shields.io/badge/Material_for_MkDocs-526CFE?&logo=MaterialForMkDocs&logoColor=white&labelColor=grey"></a>
+      <a href="https://github.com/hukkin/mdformat"><img alt="mdformat" src="https://img.shields.io/badge/mdformat-526CFE?&logo=markdown&logoColor=white&labelColor=grey"></a>
       <a href="https://hatch.pypa.io"><img alt="Hatch project" class="off-glb" loading="lazy" src="https://img.shields.io/badge/%F0%9F%A5%9A-Hatch-4051b5.svg"></a>
     </td>
   </tr>
@@ -99,8 +101,9 @@ Description-Content-Type: text/markdown
       <a href="https://sonarcloud.io/summary/new_code?id=erivlis_graphinate"><img alt="Bugs" src="https://sonarcloud.io/api/project_badges/measure?project=erivlis_graphinate&metric=bugs"></a>
       <a href="https://app.codacy.com/gh/erivlis/graphinate/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade"><img alt="Codacy Badge" src="https://app.codacy.com/project/badge/Grade/54b33c3f7313448f9471d01e2a06f037"></a>
       <a href="https://app.codacy.com/gh/erivlis/graphinate/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_coverage"><img alt="Codacy Coverage" src="https://app.codacy.com/project/badge/Coverage/54b33c3f7313448f9471d01e2a06f037"/></a>
-      <a href="https://scrutinizer-ci.com/g/erivlis/graphinate"><img alt="Scrutinizer" src="https://scrutinizer-ci.com/g/erivlis/graphinate/badges/quality-score.png?b=main"></a>
       <a href="https://www.codefactor.io/repository/github/erivlis/graphinate"><img src="https://www.codefactor.io/repository/github/erivlis/graphinate/badge" alt="CodeFactor" /></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=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>
     </td>
   </tr>
@@ -137,10 +140,13 @@ Description-Content-Type: text/markdown
   - [Python AST - 3D Force-Directed Animation](#python-ast---3d-force-directed-animation)
   - [Web Page Links](#web-page-links)
 - [Development](#development)
+  - [Install dependencies](#install-dependencies)
+  - [Update dependencies](#update-dependencies)
   - [Ruff](#ruff)
   - [Test](#test)
     - [Standard (cobertura) XML Coverage Report](#standard-cobertura-xml-coverage-report)
     - [HTML Coverage Report](#html-coverage-report)
+    - [Terminal Coverage Report](#terminal-coverage-report)
   - [Docs](#docs)
     - [test](#test-1)
     - [build](#build)
@@ -199,6 +205,7 @@ N: int = 8
 # It will be used to hold the graph definitions
 graph_model: graphinate.GraphModel = graphinate.model(name="Octagonal Graph")
 
+
 # Register in the Graph Model the edges' supplier generator function
 @graph_model.edge()
 def edge():
@@ -236,6 +243,7 @@ schema = builder.build()
 # and serve it using Uvicorn web server
 graphinate.graphql.server(schema)
 ```
+
 ## CLI
 
 ### Commands
@@ -298,7 +306,6 @@ Options:
 
 ![repo_graph](https://github.com/erivlis/graphinate/assets/9897520/9c044bbe-1f21-41b8-b879-95b8362ad48d)
 
-
 ### Web Links
 
 ![Web Page Links](https://github.com/erivlis/graphinate/assets/9897520/ea5b00a2-75d1-4d0e-86af-272f20973149)
@@ -320,6 +327,7 @@ uv lock --upgrade
 uv sync --all-extras --all-groups
 ```
 
+
 ### Ruff
 
 #### Report issues
@@ -374,35 +382,39 @@ python -m mkdocs build
 
 #### Python
 
-<a href="https://palletsprojects.com/p/click/"><img height="60" style="padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://click.palletsprojects.com/en/7.x/_images/click-logo.png" alt="Click Logo"></a>
+<a href="https://palletsprojects.com/projects/click/"><img height="60" style="padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://palletsprojects.com/static/content/projects/click-name.svg" alt="Click Logo"></a>
 <a href="https://github.com/Delgan/loguru"><img height="60" style="padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://raw.githubusercontent.com/Delgan/loguru/master/docs/_static/img/logo.png" alt="Loguru Logo"></a>
-<a href="https://matplotlib.org/"><img height="60" style="padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://matplotlib.org/_static/logo_dark.svg" alt="matplotlib Logo."></a>
-<a href="https://networkx.org/"><img height="60" style="padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://networkx.org/_static/networkx_logo.svg" alt="NetworkX Logo."></a>
+<a href="https://matplotlib.org/"><img height="60" style="padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://matplotlib.org/_static/logo_dark.svg" alt="matplotlib Logo"></a>
+<a href="https://networkx.org/"><img height="60" style="padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://networkx.org/_static/networkx_logo.svg" alt="NetworkX Logo"></a>
+<a href="https://www.starlette.io/"><img height="60" style="padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://www.starlette.io/img/starlette.svg#only-light" alt="Starlette Logo"></a>
 <a href="https://strawberry.rocks/"><img height="60" style="padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://github.com/strawberry-graphql/strawberry/raw/main/.github/logo.png" alt="Strawberry GraphQL Logo"></a>
 
 #### Javascript and HTML
 
-<a href="https://vasturiano.github.io/3d-force-graph/"><img height="60" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="http://gist.github.com/vasturiano/02affe306ce445e423f992faeea13521/raw/preview.png" alt="3D Force-Directed Graph Logo"></a>
+<a href="https://vasturiano.github.io/3d-force-graph/"><img height="60" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="http://gist.github.com/vasturiano/02affe306ce445e423f992faeea13521/raw/preview.png" alt="3D Force-Directed Graph"></a>
 <a href="https://github.com/graphql-kit/graphql-voyager"><img height="60" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://github.com/graphql-kit/graphql-voyager/raw/main/docs/cover.png" alt="Graphql Voyager Logo"></a>
-<a href="https://github.com/cocopon/tweakpane"><img height="60" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://user-images.githubusercontent.com/602961/184479032-38f50be3-e235-4914-85c0-dce316b33ed2.png" alt="Tweakpane Logo"></a>
+<a href="https://github.com/cocopon/tweakpane"><img height="60" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://user-images.githubusercontent.com/602961/184479032-38f50be3-e235-4914-85c0-dce316b33ed2.png" alt="Tweakpane"></a>
 
 ### Dev Tools
 
-<a href="https://hatch.pypa.io/"><img height="60" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://hatch.pypa.io/latest/assets/images/logo.svg" alt="Hatch logo."></a>
+<a href="https://astral.sh/uv"><img height="60" style="padding: 16px; background: #261230;" src="https://docs.astral.sh/uv/assets/logo-letter.svg" alt="uv logo"></a>
+<a href="https://astral.sh/ruff"><img height="60" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://astralcms.wpengine.com/wp-content/uploads/2023/03/Ruff-Logo.svg" alt="Ruff logo"></a>
+<a href="https://mdformat.readthedocs.io"><img height="60" width="60" style="aspect-ratio: auto; padding: 4px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://mdformat.readthedocs.io/en/stable/_static/logo-150px.png" alt="mdformat"></a>
 <a href="https://squidfunk.github.io/mkdocs-material/"><img height="60" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/logo.svg" alt="Material for MkDocs"></a>
 <a href="https://pytest.org"><img height="60" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://docs.pytest.org/en/7.4.x/_static/pytest_logo_curves.svg" alt="pytest logo"></a>
-<a href="https://astral.sh/ruff"><img height="60" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://astralcms.wpengine.com/wp-content/uploads/2023/03/Ruff-Logo.svg" alt="Ruff logo"></a>
-<a href="https://astral.sh/uv"><img height="60" style="padding: 16px; background: #261230;" src="https://docs.astral.sh/uv/assets/logo-letter.svg" alt="uv logo"></a>
+<a href="https://hatch.pypa.io/"><img height="60" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://hatch.pypa.io/latest/assets/images/logo.svg" alt="Hatch logo."></a>
+
+
 
 ### IDE
 
 <a href="https://www.jetbrains.com/pycharm/"><img height="60" style="padding: 5px; background: linear-gradient(-45deg, #FCF84A, #3DEA62, #21D789);" src="https://resources.jetbrains.com/storage/products/company/brand/logos/PyCharm.png" alt="PyCharm logo"></a>
 
---------------------------------
+______________________________________________________________________
 
 ![Alt](https://repobeats.axiom.co/api/embed/683f50f1d2de0e13e468c34a692612c2de4d56bd.svg "Repobeats analytics image")
 
---------------------------------
+______________________________________________________________________
 
 <img alt="Work on my Machine" src="https://forthebadge.com/images/badges/works-on-my-machine.svg">
 

{graphinate-0.8.4 → graphinate-0.8.6}/README.md

@@ -30,6 +30,7 @@
       <a href="https://github.com/astral-sh/ruff"><img alt="ruff" src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" style="max-width:100%;"></a>
       <a href="https://github.com/tox-dev/pipdeptree"><img alt="pipdeptree" src="https://img.shields.io/badge/pipdeptree-526CFE.svg?labelColor=gray&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAADFElEQVR4nFxTW2tcVRRe39773E/mliZjwKRmhBaKt4BWRKmGgihCH3xUKNWC/Q/ii76IP8AHpSIiRfqmD5YKCinalhgiCMZLSVtMM0mTdDLTuZyZc9l7yTlp7WXBgXPW+fa31rfWtxU9FLMN79Crr028e+iJsZfb7fJMp23xRlOvbTR3L/y5cuOL3Vbv7/vxuPviecI/eWr6k/mj4+8AkM11y+zs2MKwMJvNgIgYINZX/rlx+tIvf72fZXr4P0EQyOCjjw98P9vwn8+/+z3Bq6sek7AJkNhsOjQcyjvFmHd2upd+PP/zsSxNI5mnPvjw8U9fPFJ9XVkgNuDVayEbcgVEfgikNfFg4JAmh1LyyfGq06QqE9vN6+fEs4fHnjv25vjbAOA4AsL2MVZ1hRcI4QXIH7ilMqQXkiYXRBJRbFNQnTsRlqfmxFvH66ccFyAQMxP3I5cqNZBSxIWcKORMO9g3yeSHzFkGbnVCIkDUZ+beEy+8VJ4XguC6TMPYokwrCAHUJsBxYptoFBYSMi0oLIlcAkuFYhal8Zl5VanZU0zErgfurufMFjEkWZ7iRFY4SlgYfW9bUIJKFQNjiNPYf1QZOZn/hTaStPQKTI4eDCxSjsL4I6BeJzOjgcnT0HqPqwBJCdHZjW/miWjkkG3hzqKIe5FVlM3llGuWqOxTDMBkWlJ/6PB2p0Sb21gXixdvLeTtDGOHLFvQHpkiYyTuNU5kuxJercTdpEK3Bz4yLdFrXVsQ33x1/bModjhvyrKKVXB/YD9gb8PgKAlolAZipmFTOIYcxq21Xz8XS5dbi+e+2zqbA3MjxYninH3PpkyZljwYjZE2FoxBIWm6YVHaW/k66qwtF05curz509OHHzvqBqWp232fE+2AoCjOXNMfhcRcjAxxoijNFNpbG0vL588cNzpLC4I00cnCD1fPBuVqffbA5DMGNjR5MOSBpC+UYxGE5G5PmNXff/vy4rdnTmRJHD1wG+9G42D9qVfeePLk/oONI8qv7+/2fbq11f53ZfnqhStLi6d3b67/cT/+vwAAAP//Xo5dwOtdLi4AAAAASUVORK5CYII="></a>
       <a href="https://squidfunk.github.io/mkdocs-material/"><img alt="mkdocs-material" src="https://img.shields.io/badge/Material_for_MkDocs-526CFE?&logo=MaterialForMkDocs&logoColor=white&labelColor=grey"></a>
+      <a href="https://github.com/hukkin/mdformat"><img alt="mdformat" src="https://img.shields.io/badge/mdformat-526CFE?&logo=markdown&logoColor=white&labelColor=grey"></a>
       <a href="https://hatch.pypa.io"><img alt="Hatch project" class="off-glb" loading="lazy" src="https://img.shields.io/badge/%F0%9F%A5%9A-Hatch-4051b5.svg"></a>
     </td>
   </tr>
@@ -55,8 +56,9 @@
       <a href="https://sonarcloud.io/summary/new_code?id=erivlis_graphinate"><img alt="Bugs" src="https://sonarcloud.io/api/project_badges/measure?project=erivlis_graphinate&metric=bugs"></a>
       <a href="https://app.codacy.com/gh/erivlis/graphinate/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade"><img alt="Codacy Badge" src="https://app.codacy.com/project/badge/Grade/54b33c3f7313448f9471d01e2a06f037"></a>
       <a href="https://app.codacy.com/gh/erivlis/graphinate/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_coverage"><img alt="Codacy Coverage" src="https://app.codacy.com/project/badge/Coverage/54b33c3f7313448f9471d01e2a06f037"/></a>
-      <a href="https://scrutinizer-ci.com/g/erivlis/graphinate"><img alt="Scrutinizer" src="https://scrutinizer-ci.com/g/erivlis/graphinate/badges/quality-score.png?b=main"></a>
       <a href="https://www.codefactor.io/repository/github/erivlis/graphinate"><img src="https://www.codefactor.io/repository/github/erivlis/graphinate/badge" alt="CodeFactor" /></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=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>
     </td>
   </tr>
@@ -93,10 +95,13 @@
   - [Python AST - 3D Force-Directed Animation](#python-ast---3d-force-directed-animation)
   - [Web Page Links](#web-page-links)
 - [Development](#development)
+  - [Install dependencies](#install-dependencies)
+  - [Update dependencies](#update-dependencies)
   - [Ruff](#ruff)
   - [Test](#test)
     - [Standard (cobertura) XML Coverage Report](#standard-cobertura-xml-coverage-report)
     - [HTML Coverage Report](#html-coverage-report)
+    - [Terminal Coverage Report](#terminal-coverage-report)
   - [Docs](#docs)
     - [test](#test-1)
     - [build](#build)
@@ -155,6 +160,7 @@ N: int = 8
 # It will be used to hold the graph definitions
 graph_model: graphinate.GraphModel = graphinate.model(name="Octagonal Graph")
 
+
 # Register in the Graph Model the edges' supplier generator function
 @graph_model.edge()
 def edge():
@@ -192,6 +198,7 @@ schema = builder.build()
 # and serve it using Uvicorn web server
 graphinate.graphql.server(schema)
 ```
+
 ## CLI
 
 ### Commands
@@ -254,7 +261,6 @@ Options:
 
 ![repo_graph](https://github.com/erivlis/graphinate/assets/9897520/9c044bbe-1f21-41b8-b879-95b8362ad48d)
 
-
 ### Web Links
 
 ![Web Page Links](https://github.com/erivlis/graphinate/assets/9897520/ea5b00a2-75d1-4d0e-86af-272f20973149)
@@ -276,6 +282,7 @@ uv lock --upgrade
 uv sync --all-extras --all-groups
 ```
 
+
 ### Ruff
 
 #### Report issues
@@ -330,35 +337,39 @@ python -m mkdocs build
 
 #### Python
 
-<a href="https://palletsprojects.com/p/click/"><img height="60" style="padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://click.palletsprojects.com/en/7.x/_images/click-logo.png" alt="Click Logo"></a>
+<a href="https://palletsprojects.com/projects/click/"><img height="60" style="padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://palletsprojects.com/static/content/projects/click-name.svg" alt="Click Logo"></a>
 <a href="https://github.com/Delgan/loguru"><img height="60" style="padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://raw.githubusercontent.com/Delgan/loguru/master/docs/_static/img/logo.png" alt="Loguru Logo"></a>
-<a href="https://matplotlib.org/"><img height="60" style="padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://matplotlib.org/_static/logo_dark.svg" alt="matplotlib Logo."></a>
-<a href="https://networkx.org/"><img height="60" style="padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://networkx.org/_static/networkx_logo.svg" alt="NetworkX Logo."></a>
+<a href="https://matplotlib.org/"><img height="60" style="padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://matplotlib.org/_static/logo_dark.svg" alt="matplotlib Logo"></a>
+<a href="https://networkx.org/"><img height="60" style="padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://networkx.org/_static/networkx_logo.svg" alt="NetworkX Logo"></a>
+<a href="https://www.starlette.io/"><img height="60" style="padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://www.starlette.io/img/starlette.svg#only-light" alt="Starlette Logo"></a>
 <a href="https://strawberry.rocks/"><img height="60" style="padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://github.com/strawberry-graphql/strawberry/raw/main/.github/logo.png" alt="Strawberry GraphQL Logo"></a>
 
 #### Javascript and HTML
 
-<a href="https://vasturiano.github.io/3d-force-graph/"><img height="60" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="http://gist.github.com/vasturiano/02affe306ce445e423f992faeea13521/raw/preview.png" alt="3D Force-Directed Graph Logo"></a>
+<a href="https://vasturiano.github.io/3d-force-graph/"><img height="60" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="http://gist.github.com/vasturiano/02affe306ce445e423f992faeea13521/raw/preview.png" alt="3D Force-Directed Graph"></a>
 <a href="https://github.com/graphql-kit/graphql-voyager"><img height="60" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://github.com/graphql-kit/graphql-voyager/raw/main/docs/cover.png" alt="Graphql Voyager Logo"></a>
-<a href="https://github.com/cocopon/tweakpane"><img height="60" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://user-images.githubusercontent.com/602961/184479032-38f50be3-e235-4914-85c0-dce316b33ed2.png" alt="Tweakpane Logo"></a>
+<a href="https://github.com/cocopon/tweakpane"><img height="60" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://user-images.githubusercontent.com/602961/184479032-38f50be3-e235-4914-85c0-dce316b33ed2.png" alt="Tweakpane"></a>
 
 ### Dev Tools
 
-<a href="https://hatch.pypa.io/"><img height="60" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://hatch.pypa.io/latest/assets/images/logo.svg" alt="Hatch logo."></a>
+<a href="https://astral.sh/uv"><img height="60" style="padding: 16px; background: #261230;" src="https://docs.astral.sh/uv/assets/logo-letter.svg" alt="uv logo"></a>
+<a href="https://astral.sh/ruff"><img height="60" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://astralcms.wpengine.com/wp-content/uploads/2023/03/Ruff-Logo.svg" alt="Ruff logo"></a>
+<a href="https://mdformat.readthedocs.io"><img height="60" width="60" style="aspect-ratio: auto; padding: 4px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://mdformat.readthedocs.io/en/stable/_static/logo-150px.png" alt="mdformat"></a>
 <a href="https://squidfunk.github.io/mkdocs-material/"><img height="60" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/logo.svg" alt="Material for MkDocs"></a>
 <a href="https://pytest.org"><img height="60" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://docs.pytest.org/en/7.4.x/_static/pytest_logo_curves.svg" alt="pytest logo"></a>
-<a href="https://astral.sh/ruff"><img height="60" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://astralcms.wpengine.com/wp-content/uploads/2023/03/Ruff-Logo.svg" alt="Ruff logo"></a>
-<a href="https://astral.sh/uv"><img height="60" style="padding: 16px; background: #261230;" src="https://docs.astral.sh/uv/assets/logo-letter.svg" alt="uv logo"></a>
+<a href="https://hatch.pypa.io/"><img height="60" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://hatch.pypa.io/latest/assets/images/logo.svg" alt="Hatch logo."></a>
+
+
 
 ### IDE
 
 <a href="https://www.jetbrains.com/pycharm/"><img height="60" style="padding: 5px; background: linear-gradient(-45deg, #FCF84A, #3DEA62, #21D789);" src="https://resources.jetbrains.com/storage/products/company/brand/logos/PyCharm.png" alt="PyCharm logo"></a>
 
---------------------------------
+______________________________________________________________________
 
 ![Alt](https://repobeats.axiom.co/api/embed/683f50f1d2de0e13e468c34a692612c2de4d56bd.svg "Repobeats analytics image")
 
---------------------------------
+______________________________________________________________________
 
 <img alt="Work on my Machine" src="https://forthebadge.com/images/badges/works-on-my-machine.svg">
 

{graphinate-0.8.4 → graphinate-0.8.6}/docs/.dates_cache.json

@@ -1,15 +1,15 @@
 {
-  "acknowledge.md": {
+  "acknowledgements.md": {
     "created": "2023-08-20T00:21:55.621436",
-    "modified": "2025-03-12T00:39:57.859235"
+    "modified": "2025-08-22T22:30:50.704535"
   },
   "index.md": {
     "created": "2023-08-15T00:05:21.586874",
     "modified": "2025-03-12T00:40:46.459147"
   },
-  "intro.md": {
+  "introduction.md": {
     "created": "2023-08-19T23:54:18.668094",
-    "modified": "2025-03-11T23:24:02.836144"
+    "modified": "2025-08-22T22:30:50.705536"
   },
   "start.md": {
     "created": "2023-08-20T00:07:42.683716",

graphinate-0.8.4/docs/acknowledge.md → graphinate-0.8.6/docs/acknowledgements.md

@@ -4,11 +4,12 @@
 
 ### Python
 
-<a href="https://palletsprojects.com/p/click/"><img style="height: 50px; padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://click.palletsprojects.com/en/7.x/_images/click-logo.png" alt="Click Logo."></a>
-<a href="https://github.com/Delgan/loguru"><img style="height: 50px; padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://raw.githubusercontent.com/Delgan/loguru/master/docs/_static/img/logo.png" alt="Loguru Logo."></a>
-<a href="https://matplotlib.org/"><img style="height: 50px; padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://matplotlib.org/_static/logo_dark.svg" alt="matplotlib Logo."></a>
-<a href="https://networkx.org/"><img style="height: 50px; padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://networkx.org/_static/networkx_logo.svg" alt="NetworkX Logo."></a>
-<a href="https://strawberry.rocks/"><img style="height: 50px; padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://github.com/strawberry-graphql/strawberry/raw/main/.github/logo.png" alt="Strawberry GraphQL Logo."></a>
+<a href="https://palletsprojects.com/projects/click/"><img style="height: 50px; padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://palletsprojects.com/static/content/projects/click-name.svg" alt="Click Logo"></a>
+<a href="https://github.com/Delgan/loguru"><img style="height: 50px; padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://raw.githubusercontent.com/Delgan/loguru/master/docs/_static/img/logo.png" alt="Loguru Logo"></a>
+<a href="https://matplotlib.org/"><img style="height: 50px; padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://matplotlib.org/_static/logo_dark.svg" alt="matplotlib Logo"></a>
+<a href="https://networkx.org/"><img style="height: 50px; padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://networkx.org/_static/networkx_logo.svg" alt="NetworkX Logo"></a>
+<a href="https://www.starlette.io/"><img style="height: 50px; padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://www.starlette.io/img/starlette.svg" alt="Starlette Logo"></a>
+<a href="https://strawberry.rocks/"><img style="height: 50px; padding: 5px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://github.com/strawberry-graphql/strawberry/raw/main/.github/logo.png" alt="Strawberry GraphQL Logo"></a>
 
 ### Javascript and HTML
 
@@ -20,12 +21,11 @@
 
 <a href="https://astral.sh/uv"><img style="height: 50px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://avatars.githubusercontent.com/u/115962839" alt="uv logo."></a>
 <a href="https://astral.sh/ruff"><img style="height: 50px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://astralcms.wpengine.com/wp-content/uploads/2023/03/Ruff-Logo.svg" alt="Ruff logo."></a>
+<a href="https://mdformat.readthedocs.io"><img style="height: 50px; width: 50px; aspect-ratio: auto; padding: 4px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://mdformat.readthedocs.io/en/stable/_static/logo-150px.png" alt="mdformat"></a>
 <a href="https://squidfunk.github.io/mkdocs-material/"><img style="height: 50px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/logo.svg" alt="Material for MkDocs"></a>
 <a href="https://pytest.org"><img style="height: 50px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://docs.pytest.org/en/7.4.x/_static/pytest_logo_curves.svg" alt="pytest logo."></a>
 <a href="https://hatch.pypa.io/"><img style="height: 50px; background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://hatch.pypa.io/latest/assets/images/logo.svg" alt="Hatch logo."></a>
 
-
-
 ## IDE
 
 <a href="https://www.jetbrains.com/pycharm/"><img style="height: 50px; padding: 5px; background: linear-gradient(-45deg, #FCF84A, #3DEA62, #21D789);" src="https://resources.jetbrains.com/storage/products/company/brand/logos/PyCharm.png" alt="PyCharm logo."></a>

{graphinate-0.8.4 → graphinate-0.8.6}/examples/code/python_ast.py

@@ -51,7 +51,9 @@ def ast_graph_model():
         GraphModel: A graph model representing the AST nodes and their relationships.
     """
 
-    graph_model = graphinate.model(name='AST Graph')
+    code_object = graphinate.builders.D3Builder
+
+    graph_model = graphinate.model(name=f'AST Graph - {code_object.__qualname__}',)
 
     root_ast_node = ast.parse(inspect.getsource(graphinate.builders.D3Builder))
 

{graphinate-0.8.4 → graphinate-0.8.6}/examples/github/_client.py

@@ -1,7 +1,7 @@
 import functools
 import os
 from collections.abc import Iterable
-from typing import Optional, Union
+from typing import Union
 
 # see requirements.txt
 from github import Auth, Github
@@ -26,11 +26,11 @@ client = Github(auth=auth)
 
 
 @functools.lru_cache
-def github_user(user_id: Optional[str] = None) -> Union[NamedUser, AuthenticatedUser]:
+def github_user(user_id: str | None = None) -> Union[NamedUser, AuthenticatedUser]:
     """
     Get the GitHub user object for the specified user ID or the authenticated user.
 
-    Parameters:
+    Args:
         user_id (Optional[str]): The ID of the user to retrieve.
                                  If not provided, retrieve the authenticated user.
 
@@ -46,12 +46,12 @@ def github_user(user_id: Optional[str] = None) -> Union[NamedUser, Authenticated
 
 @functools.lru_cache
 def github_repositories(
-        user_id: Optional[str] = None,
-        repo_id: Optional[str] = None) -> Iterable[Repository]:
+        user_id: str | None = None,
+        repo_id: str | None = None) -> Iterable[Repository]:
     """
     Get the GitHub repositories for the specified user ID or the authenticated user.
 
-    Parameters:
+    Args:
         user_id (Optional[str]): The ID of the user whose repositories to retrieve.
                                  If not provided, retrieve repositories of the authenticated user.
         repo_id (Optional[str]): The ID of the repository to retrieve.
@@ -74,11 +74,11 @@ def github_repositories(
 
 def github_commits(
         repo: Repository,
-        commit_id: Optional[str] = None) -> Iterable[Commit]:
+        commit_id: str | None = None) -> Iterable[Commit]:
     """
     Retrieve commits from a GitHub repository.
 
-    Parameters:
+    Args:
         repo (Repository): The GitHub repository object from which to retrieve commits.
         commit_id (str, optional): The ID of the commit to retrieve.
                                    If provided, only that commit will be returned.
@@ -111,11 +111,11 @@ def github_commits(
 
 def github_files(
         commit: Commit,
-        file_id: Optional[str] = None) -> Iterable[File]:
+        file_id: str | None = None) -> Iterable[File]:
     """
     Retrieves Files from a GitHub Commit
 
-    Parameters:
+    Args:
         commit (Commit): A Commit object from the GitHub API.
         file_id (Optional[str]): An optional parameter specifying the filename to filter the files. Default is None.
 

{graphinate-0.8.4 → graphinate-0.8.6}/examples/github/followers.py

@@ -4,7 +4,6 @@ It recursively fetches followers of a given user up to a specified maximum depth
 The function yields edges between users in the graph.
 """
 
-from typing import Optional
 
 from _client import github_user  # see _client.py
 
@@ -26,7 +25,7 @@ def followers_graph_model(max_depth: int = DEPTH):
 
     graph_model = graphinate.model(name='Github Followers Graph')
 
-    def _followers(user_id: Optional[str] = None, depth: int = 0, **kwargs):
+    def _followers(user_id: str | None = None, depth: int = 0, **kwargs):
         user = github_user(user_id)
         for follower in user.get_followers():
             yield {'source': user.login, 'target': follower.login}
@@ -34,7 +33,7 @@ def followers_graph_model(max_depth: int = DEPTH):
                 yield from _followers(follower.login, depth=depth + 1, **kwargs)
 
     @graph_model.edge()
-    def followed_by(user_id: Optional[str] = None, **kwargs):
+    def followed_by(user_id: str | None = None, **kwargs):
         yield from _followers(user_id, **kwargs)
 
     return graph_model

{graphinate-0.8.4 → graphinate-0.8.6}/examples/github/repositories.py

@@ -1,7 +1,6 @@
 import itertools
 import operator
 import pathlib
-from typing import Optional
 
 from _client import github_commits, github_files, github_repositories, github_user  # see _client.py
 
@@ -19,10 +18,10 @@ def repo_graph_model():  # noqa: C901
     graph_model = graphinate.model(name='GitHub Repository Graph')
 
     @graph_model.edge()
-    def github(user_id: Optional[str] = None,
-               repository_id: Optional[str] = None,
-               commit_id: Optional[str] = None,
-               file_id: Optional[str] = None,
+    def github(user_id: str | None = None,
+               repository_id: str | None = None,
+               commit_id: str | None = None,
+               file_id: str | None = None,
                **kwargs):
         user = github_user(user_id)
         for repo in github_repositories(user_id, repository_id):
@@ -62,28 +61,28 @@ def repo_graph_model():  # noqa: C901
                                  label=operator.itemgetter('filename'))
 
     @user_node
-    def user(user_id: Optional[str] = None, **kwargs):
+    def user(user_id: str | None = None, **kwargs):
         yield github_user(user_id)
 
     @repository_node
-    def repository(user_id: Optional[str] = None,
-                   repository_id: Optional[str] = None,
+    def repository(user_id: str | None = None,
+                   repository_id: str | None = None,
                    **kwargs):
         repos = github_repositories(user_id, repository_id)
         yield from repos
 
     @commit_node
-    def commit(user_id: Optional[str] = None,
-               repository_id: Optional[str] = None,
-               commit_id: Optional[str] = None,
+    def commit(user_id: str | None = None,
+               repository_id: str | None = None,
+               commit_id: str | None = None,
                **kwargs):
         for repo in github_repositories(user_id, repository_id):
             yield from github_commits(repo, commit_id)
 
-    def file_type(user_id: Optional[str] = None,
-                  repository_id: Optional[str] = None,
-                  commit_id: Optional[str] = None,
-                  file_type_id: Optional[str] = None,
+    def file_type(user_id: str | None = None,
+                  repository_id: str | None = None,
+                  commit_id: str | None = None,
+                  file_type_id: str | None = None,
                   **kwargs):
         def group_key(file):
             return pathlib.PurePath(file).suffix
@@ -97,10 +96,10 @@ def repo_graph_model():  # noqa: C901
                             ))
 
     @file_node
-    def file(user_id: Optional[str] = None,
-             repository_id: Optional[str] = None,
-             commit_id: Optional[str] = None,
-             file_id: Optional[str] = None,
+    def file(user_id: str | None = None,
+             repository_id: str | None = None,
+             commit_id: str | None = None,
+             file_id: str | None = None,
              **kwargs):
         for repo in github_repositories(user_id, repository_id):
             for commit in github_commits(repo, commit_id):