Graphinate 0.0.7__tar.gz → 0.0.8__tar.gz

graphinate-0.0.8/PKG-INFO

@@ -0,0 +1,238 @@
+Metadata-Version: 2.1
+Name: Graphinate
+Version: 0.0.8
+Summary: Graphinate. Data to Graphs.
+Project-URL: Homepage, https://github.com/erivlis/graphinate
+Project-URL: Documentation, https://github.com/erivlis/graphinate#README.md
+Project-URL: Bug Tracker, https://github.com/erivlis/graphinate/issues
+Project-URL: Source, https://github.com/erivlis/graphinate
+Author-email: Eran Rivlis <eran@rivlis.info>
+License-File: LICENSE
+Keywords: declarative,graph
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: click>=8
+Requires-Dist: inflect>=7
+Requires-Dist: loguru>=0.7
+Requires-Dist: matplotlib>=3.7
+Requires-Dist: networkx>=3
+Requires-Dist: strawberry-graphql[asgi,opentelemetry]
+Provides-Extra: dev
+Requires-Dist: ruff; extra == 'dev'
+Provides-Extra: plot
+Requires-Dist: matplotlib; extra == 'plot'
+Requires-Dist: scipy; extra == 'plot'
+Provides-Extra: server
+Requires-Dist: starlette-prometheus; extra == 'server'
+Requires-Dist: uvicorn[standard]; extra == 'server'
+Provides-Extra: test
+Requires-Dist: pytest-cov>=4.1.0; extra == 'test'
+Requires-Dist: pytest>=7.3.2; extra == 'test'
+Description-Content-Type: text/markdown
+
+# Graphinate. Data to Graphs.
+
+## ⚠️ **Under Development!** ⚠️
+
+This library is alpha-quality
+
+![PyPI](https://img.shields.io/pypi/v/graphinate)
+![PyPI - Status](https://img.shields.io/pypi/status/graphinate)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/graphinate)
+![GitHub](https://img.shields.io/github/license/erivlis/graphinate)
+![PyPI - Downloads](https://img.shields.io/pypi/dd/graphinate)
+![GitHub repo size](https://img.shields.io/github/repo-size/erivlis/graphinate)
+[![Contributors](https://img.shields.io/github/contributors/erivlis/graphinate.svg)](https://github.com/erivlis/graphinate/graphs/contributors)
+![GitHub last commit (by committer)](https://img.shields.io/github/last-commit/erivlis/graphinate)
+
+[![Tests](https://github.com/erivlis/graphinate/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/erivlis/graphinate/actions/workflows/test.yml)
+[![Publish](https://github.com/erivlis/graphinate/actions/workflows/publish.yml/badge.svg)](https://github.com/erivlis/graphinate/actions/workflows/publish.yml)
+
+## Install
+
+Graphinate is available on PyPI:
+
+```shell
+python -m pip install graphinate 
+```
+
+Graphinate officially supports Python 3.9+.
+
+## Introduction
+
+### What is Graphinate?
+
+Graphinate aims to simplify the generation of Graph data structures from sources of data.
+It utilizes and build upon [NetworkX](https://networkx.org/)
+
+### What is a Graph?
+
+> In a mathematician's terminology, a graph is a collection of points and lines connecting some (possibly empty) subset
+> of them. The points of a graph are most commonly known as graph vertices, but may also be called "nodes" or simply "
+> points." Similarly, the lines connecting the vertices of a graph are most commonly known as graph edges, but may also
+> be
+> called "arcs" or "lines."
+>
+> &mdash; [https://mathworld.wolfram.com/Graph.html](https://mathworld.wolfram.com/Graph.html)
+
+### What is Data?
+
+> ...data is a collection of discrete or continuous values that convey information, describing the quantity, quality,
+> fact, statistics, other basic units of meaning, or simply sequences of symbols that may be further interpreted
+> formally.
+>
+> &mdash; [https://en.wikipedia.org/wiki/Data](https://en.wikipedia.org/wiki/Data)
+
+### Defining a Graph
+
+One can define Graphs in two general ways:
+
+#### Edge first
+
+Generate a Graph by supplying a list of edges. The simplest definition of an edge will be a tuple of 2 values. Each
+value represent a node (or vertex) in the graph. Additional attributes may be also added to the edge definition to
+signify additional meaning.
+
+In this case one defines the **edges explicitly** and the **nodes implicitly**.
+
+Such graph is focused more on the _relationships_ or the _structure_ of the Graph than on the nodes themselves.
+
+#### Node first
+
+Alternatively, one can first add nodes (vertices) to a graph without defining edges. Additional attributes may be added
+to the node definition to signify additional meaning. Later on edge definitions are added to generate the relationships
+between the nodes.
+
+In this case **both nodes and the edges** are defines **explicitly**.
+
+Such a graph has focus first on the nodes and later on the relationship between them.
+
+## Gallery
+
+![d3_graph_ast](https://github.com/erivlis/graphinate/assets/9897520/9e7e1ed2-3a5c-41fe-8c5f-999da4b741ff)
+![repo_graph](https://github.com/erivlis/graphinate/assets/9897520/9c044bbe-1f21-41b8-b879-95b8362ad48d)
+![AST 3D Force animation](https://github.com/erivlis/graphinate/assets/9897520/2e9a53b1-5686-4683-a0e4-fbffa850a27b)
+
+## Examples
+
+- [ ] Code
+  - [ ] Call Graph
+  - [x] Python AST
+- [x] GitHub
+  - [x] Repository
+  - [x] Followers
+- [ ] Ethernet
+  - [ ] Traceroute
+- [ ] Math
+  - [x] Graph Atlas
+  - [ ] Hailstone
+- [ ] Text
+  - [ ] NLP
+- [ ] Web
+  - [ ] Web Graph
+
+## Guide
+
+### By Convention
+
+https://github.com/erivlis/graphinate/blob/f5b363a360907aecf52cf11249b78666eb470d20/examples/github/followers.py#L1
+
+### By Configuration
+
+https://github.com/erivlis/graphinate/blob/f5b363a360907aecf52cf11249b78666eb470d20/examples/github/repositories.py#L1
+
+## CLI
+
+### Commands
+
+```
+Usage: python -m graphinate [OPTIONS] COMMAND [ARGS]...
+
+Options:
+  --help  Show this message and exit.
+
+Commands:
+  save
+  server
+```
+
+#### Save
+
+```
+Usage: python -m graphinate save [OPTIONS] MODEL
+
+Options:
+  --help  Show this message and exit.
+```
+
+#### Server
+
+```
+Usage: python -m graphinate server [OPTIONS] MODEL
+
+Options:
+  -p, --port INTEGER
+  --help              Show this message and exit.
+```
+
+## Development
+
+### Lint
+
+```shell
+ruff check src
+```
+
+### Docs
+
+```shell
+python -m mkdocs build
+```
+
+### Build
+
+```shell
+python -m build
+```
+
+### Test
+
+```shell
+ python -m pytest ./tests --cov=./src --cov-branch --cov-report=xml --junitxml=test_results.xml
+```
+
+## Acknowledgements
+
+### Dependencies
+
+<a href="https://vasturiano.github.io/3d-force-graph/"><img height="50" style="padding: 5px; 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://palletsprojects.com/p/click/"><img height="50" 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://github.com/Delgan/loguru"><img height="50" 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="50" 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="50" style="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 height="50" 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>
+
+### Dev Tools
+
+<a href="https://hatch.pypa.io/"><img height="50" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://hatch.pypa.io/latest/assets/images/logo.svg" alt="Hatch logo."></a>
+<a href="https://pytest.org"><img height="50" 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="50" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://astralcms.wpengine.com/wp-content/uploads/2023/03/Ruff-Logo.svg" alt="Ruff logo."></a>
+
+### IDE
+
+<a href="https://www.jetbrains.com/pycharm/"><img height="50" style="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.0.8/README.md

@@ -0,0 +1,191 @@
+# Graphinate. Data to Graphs.
+
+## ⚠️ **Under Development!** ⚠️
+
+This library is alpha-quality
+
+![PyPI](https://img.shields.io/pypi/v/graphinate)
+![PyPI - Status](https://img.shields.io/pypi/status/graphinate)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/graphinate)
+![GitHub](https://img.shields.io/github/license/erivlis/graphinate)
+![PyPI - Downloads](https://img.shields.io/pypi/dd/graphinate)
+![GitHub repo size](https://img.shields.io/github/repo-size/erivlis/graphinate)
+[![Contributors](https://img.shields.io/github/contributors/erivlis/graphinate.svg)](https://github.com/erivlis/graphinate/graphs/contributors)
+![GitHub last commit (by committer)](https://img.shields.io/github/last-commit/erivlis/graphinate)
+
+[![Tests](https://github.com/erivlis/graphinate/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/erivlis/graphinate/actions/workflows/test.yml)
+[![Publish](https://github.com/erivlis/graphinate/actions/workflows/publish.yml/badge.svg)](https://github.com/erivlis/graphinate/actions/workflows/publish.yml)
+
+## Install
+
+Graphinate is available on PyPI:
+
+```shell
+python -m pip install graphinate 
+```
+
+Graphinate officially supports Python 3.9+.
+
+## Introduction
+
+### What is Graphinate?
+
+Graphinate aims to simplify the generation of Graph data structures from sources of data.
+It utilizes and build upon [NetworkX](https://networkx.org/)
+
+### What is a Graph?
+
+> In a mathematician's terminology, a graph is a collection of points and lines connecting some (possibly empty) subset
+> of them. The points of a graph are most commonly known as graph vertices, but may also be called "nodes" or simply "
+> points." Similarly, the lines connecting the vertices of a graph are most commonly known as graph edges, but may also
+> be
+> called "arcs" or "lines."
+>
+> — [https://mathworld.wolfram.com/Graph.html](https://mathworld.wolfram.com/Graph.html)
+
+### What is Data?
+
+> ...data is a collection of discrete or continuous values that convey information, describing the quantity, quality,
+> fact, statistics, other basic units of meaning, or simply sequences of symbols that may be further interpreted
+> formally.
+>
+> — [https://en.wikipedia.org/wiki/Data](https://en.wikipedia.org/wiki/Data)
+
+### Defining a Graph
+
+One can define Graphs in two general ways:
+
+#### Edge first
+
+Generate a Graph by supplying a list of edges. The simplest definition of an edge will be a tuple of 2 values. Each
+value represent a node (or vertex) in the graph. Additional attributes may be also added to the edge definition to
+signify additional meaning.
+
+In this case one defines the **edges explicitly** and the **nodes implicitly**.
+
+Such graph is focused more on the _relationships_ or the _structure_ of the Graph than on the nodes themselves.
+
+#### Node first
+
+Alternatively, one can first add nodes (vertices) to a graph without defining edges. Additional attributes may be added
+to the node definition to signify additional meaning. Later on edge definitions are added to generate the relationships
+between the nodes.
+
+In this case **both nodes and the edges** are defines **explicitly**.
+
+Such a graph has focus first on the nodes and later on the relationship between them.
+
+## Gallery
+
+![d3_graph_ast](https://github.com/erivlis/graphinate/assets/9897520/9e7e1ed2-3a5c-41fe-8c5f-999da4b741ff)
+![repo_graph](https://github.com/erivlis/graphinate/assets/9897520/9c044bbe-1f21-41b8-b879-95b8362ad48d)
+![AST 3D Force animation](https://github.com/erivlis/graphinate/assets/9897520/2e9a53b1-5686-4683-a0e4-fbffa850a27b)
+
+## Examples
+
+- [ ] Code
+  - [ ] Call Graph
+  - [x] Python AST
+- [x] GitHub
+  - [x] Repository
+  - [x] Followers
+- [ ] Ethernet
+  - [ ] Traceroute
+- [ ] Math
+  - [x] Graph Atlas
+  - [ ] Hailstone
+- [ ] Text
+  - [ ] NLP
+- [ ] Web
+  - [ ] Web Graph
+
+## Guide
+
+### By Convention
+
+https://github.com/erivlis/graphinate/blob/f5b363a360907aecf52cf11249b78666eb470d20/examples/github/followers.py#L1
+
+### By Configuration
+
+https://github.com/erivlis/graphinate/blob/f5b363a360907aecf52cf11249b78666eb470d20/examples/github/repositories.py#L1
+
+## CLI
+
+### Commands
+
+```
+Usage: python -m graphinate [OPTIONS] COMMAND [ARGS]...
+
+Options:
+  --help  Show this message and exit.
+
+Commands:
+  save
+  server
+```
+
+#### Save
+
+```
+Usage: python -m graphinate save [OPTIONS] MODEL
+
+Options:
+  --help  Show this message and exit.
+```
+
+#### Server
+
+```
+Usage: python -m graphinate server [OPTIONS] MODEL
+
+Options:
+  -p, --port INTEGER
+  --help              Show this message and exit.
+```
+
+## Development
+
+### Lint
+
+```shell
+ruff check src
+```
+
+### Docs
+
+```shell
+python -m mkdocs build
+```
+
+### Build
+
+```shell
+python -m build
+```
+
+### Test
+
+```shell
+ python -m pytest ./tests --cov=./src --cov-branch --cov-report=xml --junitxml=test_results.xml
+```
+
+## Acknowledgements
+
+### Dependencies
+
+<a href="https://vasturiano.github.io/3d-force-graph/"><img height="50" style="padding: 5px; 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://palletsprojects.com/p/click/"><img height="50" 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://github.com/Delgan/loguru"><img height="50" 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="50" 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="50" style="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 height="50" 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>
+
+### Dev Tools
+
+<a href="https://hatch.pypa.io/"><img height="50" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://hatch.pypa.io/latest/assets/images/logo.svg" alt="Hatch logo."></a>
+<a href="https://pytest.org"><img height="50" 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="50" style="background: linear-gradient(-45deg, #FFFFFF, #CCCCCC);" src="https://astralcms.wpengine.com/wp-content/uploads/2023/03/Ruff-Logo.svg" alt="Ruff logo."></a>
+
+### IDE
+
+<a href="https://www.jetbrains.com/pycharm/"><img height="50" style="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.0.7 → graphinate-0.0.8}/examples/code/python_ast.py

@@ -2,7 +2,7 @@ import ast
 import inspect
 import operator
 from _ast import AST
-from typing import Iterable
+from collections.abc import Iterable
 
 import graphinate
 import graphinate.builders

graphinate-0.0.8/examples/code/requirements.txt

@@ -0,0 +1 @@
+PyGithub

{graphinate-0.0.7 → graphinate-0.0.8}/examples/math/graph_atlas.py

@@ -776,7 +776,7 @@ def models(iterable):
     yield graph_model
 
 
-model = next(models(atlas()))
+model = next(models(atlas().items()))
 
 if __name__ == '__main__':
     choices = graphinate.tools.gui.modal_listbox_chooser('Choose Graph', atlas())

{graphinate-0.0.7 → graphinate-0.0.8}/examples/web/requirements.txt

@@ -1,4 +1,3 @@
-
 beautifulsoup4
 lxml
 requests

{graphinate-0.0.7 → graphinate-0.0.8}/examples/web/web_graph.py

@@ -1,15 +1,9 @@
-"""
-pip install beautifulsoup4
-pip install lxml
-pip install requests
-"""
-from urllib.parse import urlparse, urljoin
+from urllib.parse import urljoin, urlparse
 
+import graphinate.builders
 import networkx as nx
 import requests
 from bs4 import BeautifulSoup
-
-import graphinate.builders
 from graphinate.materialize.matplotlib import show
 
 DEPTH = 0

{graphinate-0.0.7 → graphinate-0.0.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "Graphinate"
-version = "0.0.7"
+version = "0.0.8"
 authors = [
     { name = "Eran Rivlis", email = "eran@rivlis.info" },
 ]
@@ -32,7 +32,7 @@ dependencies = [
     "loguru>=0.7",
     "matplotlib>=3.7",
     "networkx>=3",
-    "strawberry-graphql[asgi,opentelemetry]",
+    "strawberry-graphql[asgi,opentelemetry]"
 ]
 
 [project.urls]
@@ -43,18 +43,16 @@ dependencies = [
 
 [project.optional-dependencies]
 dev = [
-    "pip-tools",
-    "pipdeptree"
+    "ruff",
+    # "pip-tools",
+    # "pipdeptree"
 ]
-testing = [
+test = [
     "pytest >= 7.3.2",
     "pytest-cov >= 4.1.0",
-    "pytest-asyncio"
-    #  "pytest-rerunfailures",
-    #  "pytest-xdist",
-    # build deps for tests
-    #  "flit_core >=2,<4",
-    #  "poetry_core>=1.0.0",
+    # "pytest-asyncio"
+    # "pytest-rerunfailures",
+    # "pytest-xdist",
 ]
 plot = [
     "matplotlib",
@@ -66,8 +64,6 @@ server = [
 ]
 
 [build-system]
-#requires = ["setuptools>=61.0"]
-#build-backend = "setuptools.build_meta"
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
@@ -78,6 +74,10 @@ allow-direct-references = true
 pythonpath = ["src"]
 testpaths = ["tests"]
 
+[tool.black]
+line-length = 120
+#extend-exclude = ''
+
 [tool.ruff]
 select = [
     "E",
@@ -133,4 +133,4 @@ multiline-quotes = "single"
 
 [tool.ruff.mccabe]
 # Unlike Flake8, default to a complexity level of 10.
-max-complexity = 15
+max-complexity = 15

{graphinate-0.0.7 → graphinate-0.0.8}/src/graphinate/builders.py

@@ -100,11 +100,12 @@ class Builder(ABC):
     })
 
     def __init__(self, model: GraphModel, graph_type: GraphType = GraphType.Graph):
+        self._cached_build_kwargs = {}
         self.model = model
         self.graph_type = graph_type
 
     def build(self, **kwargs):
-        raise NotImplementedError()
+        self._cached_build_kwargs = kwargs
 
 
 class NetworkxBuilder(Builder):
@@ -257,7 +258,8 @@ class NetworkxBuilder(Builder):
 
         self._graph.graph['created'] = datetime.utcnow()
 
-    def build(self, **kwargs) -> nx.Graph:
+    def build(self, **kwargs):
+        super().build(**kwargs)
         default_node_attributes = dict(**self.default_node_attributes)
         if 'default_node_attributes' in kwargs:
             default_node_attributes.update(kwargs.pop('default_node_attributes') or {})
@@ -278,8 +280,8 @@ class D3Builder(NetworkxBuilder):
         super().__init__(model, graph_type)
 
     def build(self, **kwargs) -> dict:
-        nx_graph: nx.Graph = super().build(**kwargs)
-        return self.from_networkx(nx_graph)
+        super().build(**kwargs)
+        return self.from_networkx(self._graph)
 
     @staticmethod
     def from_networkx(nx_graph: nx.Graph):
@@ -507,12 +509,14 @@ class GraphQLBuilder(NetworkxBuilder):
 
         return {k: GraphQLBuilder._graphql_type(k, v) for k, v in graphql_types.items()}
 
-    def _graphql_query(self):
+    def _graphql_query(self):  # noqa: C901
         # inflect engine to generate Plurals when needed
         inflection = inflect.engine()
 
-        # local references to instance fields in order to "inject" into dynamically generated class methods
-        graph: nx.Graph = self._graph
+        # local reference to instance fields in order to "inject" into dynamically generated class methods
+        def get_graph():
+            return self._graph
+
         graphql_types = self._graphql_types
 
         # region - Defining GraphQL Query Class dict
@@ -520,6 +524,7 @@ class GraphQLBuilder(NetworkxBuilder):
 
         # region - Defining GraphQL Query Class dict - graph field
         def graphql_graph(self) -> GraphQLBuilder.Graph:
+            graph = get_graph()
             return GraphQLBuilder.Graph(
                 graph=graph,
                 name=graph.graph['name'],
@@ -549,6 +554,9 @@ class GraphQLBuilder(NetworkxBuilder):
 
             def graph_nodes(self,
                             node_id: Optional[strawberry.ID] = strawberry.UNSET) -> list[GraphQLBuilder.GraphNode]:
+
+                graph = get_graph()
+
                 if graphql_type:
                     nodes = (GraphQLBuilder._graph_node(graphql_type, n, d) for n, d in graph.nodes(data=True))
                 else:
@@ -580,6 +588,8 @@ class GraphQLBuilder(NetworkxBuilder):
 
             def graph_edges(self,
                             edge_id: Optional[strawberry.ID] = strawberry.UNSET) -> list[GraphQLBuilder.GraphEdge]:
+                graph = get_graph()
+
                 edges = (graph_edge((source, target), data) for source, target, data in graph.edges(data=True))
 
                 def filter_edge(edge):
@@ -607,6 +617,9 @@ class GraphQLBuilder(NetworkxBuilder):
         #  region  - Defining GraphQL Query Class dict - field measure for 'GraphMeasure' GraphQL type
 
         def graph_measure(self, measure: GraphQLBuilder.GraphMeasure) -> GraphQLBuilder.Measure:
+
+            graph = get_graph()
+
             if isinstance(measure.value, str):
                 method = measure.value
                 module = nx
@@ -632,17 +645,29 @@ class GraphQLBuilder(NetworkxBuilder):
 
         return query_graphql_type
 
-    def schema(self) -> strawberry.Schema:
-        query_graphql_type = self._graphql_query()
-        graphql_types = self._graphql_types
+    def _graphql_mutation(self):
 
+        refresh_graph = functools.partial(super().build, **self._cached_build_kwargs)
+
+        @strawberry.type
+        class Mutation:
+
+            @strawberry.mutation
+            def refresh(self) -> bool:
+                refresh_graph()
+                return True
+
+        return Mutation
+
+    def schema(self) -> strawberry.Schema:
         # define and return Schema
-        return strawberry.Schema(query=query_graphql_type, types=graphql_types.values())
+        return strawberry.Schema(query=self._graphql_query(),
+                                 mutation=self._graphql_mutation(),
+                                 types=self._graphql_types.values())
 
     def build(self, **kwargs) -> strawberry.Schema:
         super().build(**kwargs)
-        schema: strawberry.Schema = self.schema()
-        return schema
+        return self.schema()
 
 
 class D3GraphQLBuilder(D3Builder):

{graphinate-0.0.7 → graphinate-0.0.8}/src/graphinate/cli.py

@@ -6,7 +6,7 @@ import click
 from . import builders
 from .materialize import materialize
 from .modeling import GraphModel
-from .server import run_graphql
+from .server import DEFAULT_PORT, run_graphql
 from .tools.importer import import_from_string
 
 
@@ -28,7 +28,7 @@ def save(model, *args, **kwargs):
 
 @cli.command()
 @click.argument('model')
-@click.option('-p', '--port', type=int, default=8072)
+@click.option('-p', '--port', type=int, default=DEFAULT_PORT)
 def server(model, port, *args, **kwargs):
     graph_model: GraphModel = import_from_string(model) if isinstance(model, str) else model
     materialize(title=graph_model.name,

{graphinate-0.0.7 → graphinate-0.0.8}/src/graphinate/server/__init__.py

@@ -6,8 +6,10 @@ from strawberry.asgi import GraphQL
 
 from .starlette import routes
 
+DEFAULT_PORT: int = 8072
 
-def run_graphql(graphql_schema: strawberry.Schema, port: int = 8072):
+
+def run_graphql(graphql_schema: strawberry.Schema, port: int = DEFAULT_PORT):
     def open_url():
         for app_name in ('voyager', 'graphiql', 'viewer'):
             webbrowser.open(f'http://localhost:{port}/{app_name}')

graphinate-0.0.7/PKG-INFO

@@ -1,132 +0,0 @@
-Metadata-Version: 2.1
-Name: Graphinate
-Version: 0.0.7
-Summary: Graphinate. Data to Graphs.
-Project-URL: Homepage, https://github.com/erivlis/graphinate
-Project-URL: Documentation, https://github.com/erivlis/graphinate#README.md
-Project-URL: Bug Tracker, https://github.com/erivlis/graphinate/issues
-Project-URL: Source, https://github.com/erivlis/graphinate
-Author-email: Eran Rivlis <eran@rivlis.info>
-License-File: LICENSE
-Keywords: declarative,graph
-Classifier: Development Status :: 2 - Pre-Alpha
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Information Technology
-Classifier: Intended Audience :: Science/Research
-Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
-Classifier: Natural Language :: English
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: Topic :: Scientific/Engineering
-Classifier: Topic :: Software Development :: Libraries
-Classifier: Typing :: Typed
-Requires-Python: >=3.9
-Requires-Dist: click>=8
-Requires-Dist: inflect>=7
-Requires-Dist: loguru>=0.7
-Requires-Dist: matplotlib>=3.7
-Requires-Dist: networkx>=3
-Requires-Dist: strawberry-graphql[asgi,opentelemetry]
-Provides-Extra: dev
-Requires-Dist: pip-tools; extra == 'dev'
-Requires-Dist: pipdeptree; extra == 'dev'
-Provides-Extra: plot
-Requires-Dist: matplotlib; extra == 'plot'
-Requires-Dist: scipy; extra == 'plot'
-Provides-Extra: server
-Requires-Dist: starlette-prometheus; extra == 'server'
-Requires-Dist: uvicorn[standard]; extra == 'server'
-Provides-Extra: testing
-Requires-Dist: pytest-asyncio; extra == 'testing'
-Requires-Dist: pytest-cov>=4.1.0; extra == 'testing'
-Requires-Dist: pytest>=7.3.2; extra == 'testing'
-Description-Content-Type: text/markdown
-
-# Graphinate. Data to Graphs.
-
-## ⚠️ **Under Development!** ⚠️
-
-This library is alpha-quality
-
-![PyPI](https://img.shields.io/pypi/v/graphinate)
-![PyPI - Status](https://img.shields.io/pypi/status/graphinate)
-![PyPI - Python Version](https://img.shields.io/pypi/pyversions/graphinate)
-![GitHub](https://img.shields.io/github/license/erivlis/graphinate)
-![PyPI - Downloads](https://img.shields.io/pypi/dd/graphinate)
-![GitHub repo size](https://img.shields.io/github/repo-size/erivlis/graphinate)
-[![Contributors](https://img.shields.io/github/contributors/erivlis/graphinate.svg)](https://github.com/erivlis/graphinate/graphs/contributors)
-![GitHub last commit (by committer)](https://img.shields.io/github/last-commit/erivlis/graphinate)
-
-[![Tests](https://github.com/erivlis/graphinate/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/erivlis/graphinate/actions/workflows/test.yml)
-[![Publish](https://github.com/erivlis/graphinate/actions/workflows/publish.yml/badge.svg)](https://github.com/erivlis/graphinate/actions/workflows/publish.yml)
-
-## Gallery
-
-![d3_graph_ast](https://github.com/erivlis/graphinate/assets/9897520/9e7e1ed2-3a5c-41fe-8c5f-999da4b741ff)
-![repo_graph](https://github.com/erivlis/graphinate/assets/9897520/9c044bbe-1f21-41b8-b879-95b8362ad48d)
-![AST 3D Force animation](https://github.com/erivlis/graphinate/assets/9897520/2e9a53b1-5686-4683-a0e4-fbffa850a27b)
-
-## Install
-
-Graphinate is available on PyPI:
-
-```console
-python -m pip install graphinate 
-```
-
-Graphinate officially supports Python 3.9+.
-
-## Examples
-
-- [ ] Code
-  - [ ] Call Graph
-  - [x] Python AST
-- [x] GitHub
-  - [x] Repository
-  - [x] Followers
-- [ ] Ethernet
-  - [ ] Traceroute
-- [ ] Math
-  - [x] Graph Atlas
-  - [ ] Hailstone
-- [ ] Text
-  - [ ] NLP
-- [ ] Web
-  - [ ] Web Graph
-
-## API
-
-### By Convention
-
-### By Configuration
-
-## Development
-
-### Lint
-
-```shell
-ruff check src
-```
-
-### Docs
-
-```shell
-python -m mkdocs build
-```
-
-### Build
-
-```shell
-python -m build
-```
-
-### Test
-
-```shell
- python -m pytest ./tests --cov=./src --cov-branch --cov-report=xml --junitxml=test_results.xml
-```

graphinate-0.0.7/README.md

@@ -1,83 +0,0 @@
-# Graphinate. Data to Graphs.
-
-## ⚠️ **Under Development!** ⚠️
-
-This library is alpha-quality
-
-![PyPI](https://img.shields.io/pypi/v/graphinate)
-![PyPI - Status](https://img.shields.io/pypi/status/graphinate)
-![PyPI - Python Version](https://img.shields.io/pypi/pyversions/graphinate)
-![GitHub](https://img.shields.io/github/license/erivlis/graphinate)
-![PyPI - Downloads](https://img.shields.io/pypi/dd/graphinate)
-![GitHub repo size](https://img.shields.io/github/repo-size/erivlis/graphinate)
-[![Contributors](https://img.shields.io/github/contributors/erivlis/graphinate.svg)](https://github.com/erivlis/graphinate/graphs/contributors)
-![GitHub last commit (by committer)](https://img.shields.io/github/last-commit/erivlis/graphinate)
-
-[![Tests](https://github.com/erivlis/graphinate/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/erivlis/graphinate/actions/workflows/test.yml)
-[![Publish](https://github.com/erivlis/graphinate/actions/workflows/publish.yml/badge.svg)](https://github.com/erivlis/graphinate/actions/workflows/publish.yml)
-
-## Gallery
-
-![d3_graph_ast](https://github.com/erivlis/graphinate/assets/9897520/9e7e1ed2-3a5c-41fe-8c5f-999da4b741ff)
-![repo_graph](https://github.com/erivlis/graphinate/assets/9897520/9c044bbe-1f21-41b8-b879-95b8362ad48d)
-![AST 3D Force animation](https://github.com/erivlis/graphinate/assets/9897520/2e9a53b1-5686-4683-a0e4-fbffa850a27b)
-
-## Install
-
-Graphinate is available on PyPI:
-
-```console
-python -m pip install graphinate 
-```
-
-Graphinate officially supports Python 3.9+.
-
-## Examples
-
-- [ ] Code
-  - [ ] Call Graph
-  - [x] Python AST
-- [x] GitHub
-  - [x] Repository
-  - [x] Followers
-- [ ] Ethernet
-  - [ ] Traceroute
-- [ ] Math
-  - [x] Graph Atlas
-  - [ ] Hailstone
-- [ ] Text
-  - [ ] NLP
-- [ ] Web
-  - [ ] Web Graph
-
-## API
-
-### By Convention
-
-### By Configuration
-
-## Development
-
-### Lint
-
-```shell
-ruff check src
-```
-
-### Docs
-
-```shell
-python -m mkdocs build
-```
-
-### Build
-
-```shell
-python -m build
-```
-
-### Test
-
-```shell
- python -m pytest ./tests --cov=./src --cov-branch --cov-report=xml --junitxml=test_results.xml
-```

graphinate-0.0.7/examples/code/requirements.txt

@@ -1 +0,0 @@
-PyGithub