REFACT: Unify Op+Netop modules

Author: ankostis

CHANGES.rst

@@ -92,7 +92,7 @@ v8.0.0 (7 May 2020, @ankostis): re-MODULE; sideffect --> sfx; all DIACRITIC Modi
 
   + :mod:`.network` module was splitted into :mod:`.execution` which now
     contains plan+solution;
-  + renamed module ``netop`` --> :mod:`.pipeline`.
+  + renamed module ``netop`` --> ``.pipeline``.
   + DOC: module dependencies diagram in :doc:`reference`.
 
 + BREAK: sideffect modifier functions *shortened* to :func:`.sfx` & :func:`.sfxed`.
@@ -579,7 +579,7 @@ Details
   or else they will fail.
 
 + FEAT(OP, netop): specify :term:`endurance`/`reschedule` on a per operation basis,
-  or collectively for all operations grouped under some :term:`netop`.
+  or collectively for all operations grouped under some :term:`pipeline`.
 
 + REFACT(NETOP):
 
@@ -630,7 +630,7 @@ v4.3.0 (16 Dec 2019, @ankostis): Aliases
 v4.2.0 (16 Dec 2019, @ankostis): ENDURED Execution
 ==================================================
 + FEAT(NET): when :func:`.set_endure_operations` configuration is set to true,
-  a :term:`netop` will keep on calculating solution, skipping any operations
+  a :term:`pipeline` will keep on calculating solution, skipping any operations
   downstream from failed ones.  The :term:`solution` eventually collects all failures
   in ``Solution.failures`` attribute.
 

docs/source/arch.rst

@@ -37,7 +37,7 @@ Architecture
         .. autosummary::
 
             graphtik.op.FunctionalOperation
-            graphtik.pipeline.NetworkOperation
+            graphtik.op.NetworkOperation
             graphtik.network.Network
             graphtik.execution.ExecutionPlan
             graphtik.execution.Solution

docs/source/plotting.rst

@@ -40,7 +40,7 @@ The same :meth:`.Plottable.plot()` method applies also for:
 
 each one capable to producing diagrams with increasing complexity.
 Whenever possible, the top-level ``plot()`` methods will delegate to the ones below;
-specifically, the :term:`netop` keeps a transient reference to the last `plan`.
+specifically, the :term:`pipeline` keeps a transient reference to the last `plan`.
 BUT the `plan` does not hold such a reference, you have to plot the `solution`.
 
 For instance, when a net-operation has just been composed, plotting it will
@@ -307,7 +307,7 @@ Directives
    .. rst:directive:option:: alt
       :type: `str`
 
-      If not given, derived from string representation of the :term:`netop`.
+      If not given, derived from string representation of the :term:`pipeline`.
 
 .. rst:directive::  graphtik-output
 

docs/source/reference.rst

@@ -7,7 +7,6 @@ API Reference
      graphtik
      graphtik.op
      graphtik.modifiers
-     graphtik.pipeline
      graphtik.network
      graphtik.execution
      graphtik.plot
@@ -34,13 +33,6 @@ Module: `modifiers`
      :members:
      :private-members:
 
-Module: `pipeline`
-====================
-
-.. automodule:: graphtik.pipeline
-     :members:
-     :undoc-members:
-
 Module: `network`
 =================
 

graphtik/__init__.py

@@ -48,8 +48,7 @@
     vararg,
     varargs,
 )
-from .pipeline import compose
-from .op import NULL_OP, operation
+from .op import NULL_OP, operation, compose
 
 ## SEE ALSO: `.plot.active_plotter_plugged()`, `.plot.set_active_plotter()` &
 #  `.plot.get_active_plotter()` configs, not imported, unless plot is needed..

graphtik/config.py

@@ -79,6 +79,8 @@ def _tristate_armed(context_var: ContextVar, enabled):
 
 :param enabled:
     - ``None, False, string(0, false, off, no)``: Disabled
+    - ``1``: Enable ALL ``DEBUG_XXX``
+    - integers: Enable respective ``DEBUG_XXX`` bit-field constants
     - anything else: Enable ALL ``DEBUG_XXX``
 
 Affected behavior:
@@ -260,6 +262,6 @@ def get_execution_pool() -> "Optional[Pool]":
 ."""
 
 
-def first_solid(*tristates, default=False):
+def first_solid(*tristates, default=None):
     """Utility combining multiple tri-state booleans."""
     return first(tristates, default=default, key=lambda i: i is not None)

graphtik/network.py

@@ -639,8 +639,7 @@ def build_network(
         see same-named param in :func:`.compose`
     """
     from boltons.setutils import IndexedSet as iset
-    from .op import NULL_OP
-    from .pipeline import NetworkOperation
+    from .op import NULL_OP, NetworkOperation
 
     def proc_op(op, parent=None):
         """clone FuncOperation with certain props changed"""