neo4j-viz 0.6.0__py3-none-any.whl → 1.0.0__py3-none-any.whl

neo4j_viz/resources/nvl_entrypoint/styles.css

@@ -49,5 +49,17 @@ button.icon:active {
   filter: drop-shadow(0 4px 8px rgba(26,27,29,0.12));
   font-family: 'Public Sans', sans-serif;
   color: var(--neutral-text-default);
-  font-size: 14px
+  font-size: 14px;
+  overflow-y: auto;
+  overflow-x: hidden;
+  word-wrap: break-word;
+  overflow-wrap: break-word;
+}
+
+.tooltip-value {
+  display: inline-block;
+  max-width: 100%;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
 }

neo4j_viz/snowflake.py

@@ -341,9 +341,9 @@ def from_snowflake(
     VG = from_dfs(node_dfs, rel_dfs)
 
     for node in VG.nodes:
-        node.caption = node.properties.get("table")
+        node.caption = node.properties.pop("table")
     for rel in VG.relationships:
-        rel.caption = rel.properties.get("table")
+        rel.caption = rel.properties.pop("table")
 
     number_of_colors = node_df["table"].drop_duplicates().count()
     if number_of_colors <= len(NEO4J_COLORS_DISCRETE):

neo4j_viz/visualization_graph.py

@@ -194,6 +194,75 @@ class VisualizationGraph:
 
             node.pinned = node_pinned
 
+    def set_node_captions(
+        self,
+        *,
+        field: Optional[str] = None,
+        property: Optional[str] = None,
+        override: bool = True,
+    ) -> None:
+        """
+        Set the caption for nodes in the graph based on either a node field or a node property.
+
+        Parameters
+        ----------
+        field:
+            The field of the nodes to use as the caption. Must be None if `property` is provided.
+        property:
+            The property of the nodes to use as the caption. Must be None if `field` is provided.
+        override:
+            Whether to override existing captions of the nodes, if they have any.
+
+        Examples
+        --------
+        Given a VisualizationGraph `VG`:
+
+        >>> nodes = [
+        ...    Node(id="0", properties={"name": "Alice", "age": 30}),
+        ...    Node(id="1", properties={"name": "Bob", "age": 25}),
+        ... ]
+        >>> VG = VisualizationGraph(nodes=nodes)
+
+        Set node captions from a property:
+
+        >>> VG.set_node_captions(property="name")
+
+        Set node captions from a field, only if not already set:
+
+        >>> VG.set_node_captions(field="id", override=False)
+
+        Set captions from multiple properties with fallback:
+
+        >>> for node in VG.nodes:
+        ...     caption = node.properties.get("name") or node.properties.get("title") or node.id
+        ...     if override or node.caption is None:
+        ...         node.caption = str(caption)
+        """
+        if not ((field is None) ^ (property is None)):
+            raise ValueError(
+                f"Exactly one of the arguments `field` (received '{field}') and `property` (received '{property}') must be provided"
+            )
+
+        if property:
+            # Use property
+            for node in self.nodes:
+                if not override and node.caption is not None:
+                    continue
+
+                value = node.properties.get(property, "")
+                node.caption = str(value)
+        else:
+            # Use field
+            assert field is not None
+            attribute = to_snake(field)
+
+            for node in self.nodes:
+                if not override and node.caption is not None:
+                    continue
+
+                value = getattr(node, attribute, "")
+                node.caption = str(value)
+
     def resize_nodes(
         self,
         sizes: Optional[dict[NodeIdType, RealNumber]] = None,
@@ -294,7 +363,7 @@ class VisualizationGraph:
         property: Optional[str] = None,
         colors: Optional[ColorsType] = None,
         color_space: ColorSpace = ColorSpace.DISCRETE,
-        override: bool = False,
+        override: bool = True,
     ) -> None:
         """
         Color the nodes in the graph based on either a node field, or a node property.

{neo4j_viz-0.6.0.dist-info → neo4j_viz-1.0.0.dist-info}/METADATA

@@ -1,15 +1,15 @@
 Metadata-Version: 2.4
 Name: neo4j-viz
-Version: 0.6.0
+Version: 1.0.0
 Summary: A simple graph visualization tool
 Author-email: Neo4j <team-gds@neo4j.org>
 License-Expression: GPL-3.0-only
 Project-URL: Homepage, https://neo4j.com/
 Project-URL: Repository, https://github.com/neo4j/python-graph-visualization
 Project-URL: Issues, https://github.com/neo4j/python-graph-visualization/issues
-Project-URL: Documentation, https://neo4j.com/docs/nvl-python/preview
+Project-URL: Documentation, https://neo4j.com/docs/python-graph-visualization/
 Keywords: graph,visualization,neo4j
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
 Classifier: Operating System :: OS Independent
@@ -34,7 +34,7 @@ Requires-Dist: pydantic-extra-types<3,>=2
 Requires-Dist: enum-tools==0.13.0
 Provides-Extra: dev
 Requires-Dist: ruff==0.14.1; extra == "dev"
-Requires-Dist: mypy==1.17.1; extra == "dev"
+Requires-Dist: mypy==1.18.2; extra == "dev"
 Requires-Dist: pytest==8.4.2; extra == "dev"
 Requires-Dist: selenium==4.32.0; extra == "dev"
 Requires-Dist: ipykernel==6.30.1; extra == "dev"

{neo4j_viz-0.6.0.dist-info → neo4j_viz-1.0.0.dist-info}/RECORD

@@ -10,18 +10,18 @@ neo4j_viz/options.py,sha256=oai-yI03WxWyl6-9cFWEbQkqpXAcI8oG4G6rSVF1Bt0,6495
 neo4j_viz/pandas.py,sha256=gFQW9SlWxiSrVCi2kHGUKpDXDhYtlFkk2AR2DzxYTWE,4759
 neo4j_viz/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 neo4j_viz/relationship.py,sha256=aVj8_6umHSm1rg53CU-oci21W845J91AFKv1AJudmD8,4112
-neo4j_viz/snowflake.py,sha256=GoiFfpzE5fuAorh_PNZCK7QSIv52pIMn_QS2LLsUxCM,12683
-neo4j_viz/visualization_graph.py,sha256=v2OmfGM8t9UDmSDCFLe5uWa6MnPmppby20VK_NjThT4,17161
+neo4j_viz/snowflake.py,sha256=Md3bW6qaBVnq8A_2fx8POkdbpKQuPc1qNaNzwDvQ8CE,12683
+neo4j_viz/visualization_graph.py,sha256=G4MHAQ_sgVMDqf3gI76l4m8tnFzfW0hM_lrxWFWojVc,19490
 neo4j_viz/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 neo4j_viz/resources/icons/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 neo4j_viz/resources/icons/screenshot.svg,sha256=Ns9Yi2Iq4lIaiFvzc0pXBmjxt4fcmBO-I4cI8Xiu1HE,311
 neo4j_viz/resources/icons/zoom-in.svg,sha256=PsO5yFkA1JnGM2QV_qxHKG13qmoR-RrlWARpaXNp5qU,415
 neo4j_viz/resources/icons/zoom-out.svg,sha256=OQRADAoe2bxbCeFufg6W22nR41q5NlI8QspT9l5pXUw,400
 neo4j_viz/resources/nvl_entrypoint/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-neo4j_viz/resources/nvl_entrypoint/base.js,sha256=tICNjZLV8sUen2qvosUZuUlovpHcZIqXpdNzSo4phE4,1820159
-neo4j_viz/resources/nvl_entrypoint/styles.css,sha256=JjeTSB9OJT2KMfb8yFUUMLMG7Rzrf3o60hSCD547zTk,1123
-neo4j_viz-0.6.0.dist-info/licenses/LICENSE,sha256=tWSeLI0mRp2u8Pnumaxq51JltfXLVSXl2w_D6kxhRMI,36006
-neo4j_viz-0.6.0.dist-info/METADATA,sha256=A06tmKgiAI93yfZRX-ofAapiQeJldwSCKkCegzf_LG0,7120
-neo4j_viz-0.6.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-neo4j_viz-0.6.0.dist-info/top_level.txt,sha256=jPUM3z8MOtxqDanc2VzqkxG4HJn8aaq4S7rnCFNk_Vs,10
-neo4j_viz-0.6.0.dist-info/RECORD,,
+neo4j_viz/resources/nvl_entrypoint/base.js,sha256=2Z_ofAXO1TFONMqYXjBjPd6l4U3an-h8ZNwgoMiKuPI,1820251
+neo4j_viz/resources/nvl_entrypoint/styles.css,sha256=sRA-0i4Bc-P2S3FHg8FjTBiChr0ikC8f0UOYduXAXT0,1354
+neo4j_viz-1.0.0.dist-info/licenses/LICENSE,sha256=tWSeLI0mRp2u8Pnumaxq51JltfXLVSXl2w_D6kxhRMI,36006
+neo4j_viz-1.0.0.dist-info/METADATA,sha256=vDiI0KP0eUawlpabsGfhDVGea5mZwSSwOYvEmrpHlao,7141
+neo4j_viz-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+neo4j_viz-1.0.0.dist-info/top_level.txt,sha256=jPUM3z8MOtxqDanc2VzqkxG4HJn8aaq4S7rnCFNk_Vs,10
+neo4j_viz-1.0.0.dist-info/RECORD,,