DROP(plot): -splines=ortho crashes with some shapes ...

See https://gitlab.com/graphviz/graphviz/issues/1408

+ doc: explain in docs how to re-enables (x2 ways).

Author: ankostis

graphtik/base.py

@@ -491,7 +491,9 @@ def plot(
               - ``_no_plot``: nodes and/or edges skipped from plotting
                 (see *"Examples:"* section, below)
 
-            - "public" attributes: reaching `Graphviz`_ as-is.
+            - "public" attributes: reaching `Graphviz`_ as-is, e.g.
+              to set ``spline -> ortho`` on the graph attributes
+              (this can also be achieved by modified :term:`plot styles`).
 
               .. Note::
 
@@ -579,9 +581,9 @@ def plot(
         green-dotted arrows
             execution steps labeled in succession
 
-
         To generate the **legend**, see :func:`.legend()`.
 
+
         **Examples:**
 
         >>> from graphtik import compose, operation
@@ -604,10 +606,11 @@ def plot(
         digraph netop {
         fontname=italic;
         label=<netop>;
-        splines=ortho;
         <a> [fillcolor=wheat, shape=invhouse, style=filled, tooltip="(int) 1"];
         ...
 
+        .. TODO: move advanced plot examples from API --> tutorial page
+
         You may use the :attr:`PlotArgs.graph` overlay to skip certain nodes (or edges)
         from the plots:
 

graphtik/plot.py

@@ -360,9 +360,11 @@ class Style:
     kw_graph = {
         "graph_type": "digraph",
         "fontname": "italic",
-        # Whether to plot `curved/polyline edges
-        # <https://graphviz.gitlab.io/_pages/doc/info/attrs.html#d:splines>`_
-        "splines": "ortho",
+        ## Whether to plot `curved/polyline edges
+        #  <https://graphviz.gitlab.io/_pages/doc/info/attrs.html#d:splines>`_
+        #  BUT disabled due to crashes:
+        #  https://gitlab.com/graphviz/graphviz/issues/1408
+        #"splines": "ortho",
     }
     #: styles per plot-type
     kw_pottable_type = {

test/test_plot.py

@@ -433,7 +433,6 @@ def test_node_dot_str0(dot_str_pipeline):
         digraph graph_ {
         fontname=italic;
         label=<graph>;
-        splines=ortho;
         <edge> [shape=invhouse];
         <digraph&#58; strict> [shape=invhouse];
         <node> [label=<<TABLE CELLBORDER="0" CELLSPACING="0" STYLE="rounded">
@@ -482,6 +481,7 @@ def test_node_dot_str1(dot_str_pipeline, monkeypatch):
     overlay = nx.DiGraph()
     hidden_op = dot_str_pipeline.net.find_op_by_name("node")
     overlay.add_node(hidden_op, _no_plot=True)
+    overlay.graph["splines"] = "ortho"
 
     sol = dot_str_pipeline.compute({"edge": 1, "digraph: strict": 2})
     dot_str = str(sol.plot(graph=overlay))