REFACT: modifierS.py-->modifer.py

Author: ankostis

docs/source/arch.rst

@@ -351,11 +351,11 @@ Architecture
         function arguments, `provides` and *needs* can be annotated as "ghost" `sideffects`
         or assigned an `accessor` to work with `hierarchical data`.
 
-        .. include:: ../../graphtik/modifiers.py
+        .. include:: ../../graphtik/modifier.py
             :start-after: .. diacritics-start
             :end-before: .. diacritics-end
 
-        See :mod:`graphtik.modifiers` module.
+        See :mod:`graphtik.modifier` module.
 
     optionals
         A `needs` only `modifier` for a `inputs` that do not hinder `operation` execution
@@ -378,7 +378,7 @@ Architecture
         - the :func:`.varargs` annotates *iterable* values and all its items are appended
           in the ``*args`` one-by-one.
 
-        .. include:: ../../graphtik/modifiers.py
+        .. include:: ../../graphtik/modifier.py
             :start-after: .. varargs-mistake-start
             :end-before: .. varargs-mistake-end
 

docs/source/operations.rst

@@ -156,19 +156,19 @@ Declarations of *needs* and *provides* is affected by :term:`modifier`\s like
 
 Map inputs to different function arguments
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-.. autofunction:: graphtik.modifiers.keyword
+.. autofunction:: graphtik.modifier.keyword
    :noindex:
 
 Operations may execute with missing inputs
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-.. autofunction:: graphtik.modifiers.optional
+.. autofunction:: graphtik.modifier.optional
    :noindex:
 
 Calling functions with varargs (``*args``)
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-.. autofunction:: graphtik.modifiers.vararg
+.. autofunction:: graphtik.modifier.vararg
    :noindex:
-.. autofunction:: graphtik.modifiers.varargs
+.. autofunction:: graphtik.modifier.varargs
    :noindex:
 
 
@@ -179,7 +179,7 @@ Aliased `provides`
 Sometimes, you need to interface functions & operations where they name a
 :term:`dependency` differently.
 This is doable without introducing "pipe-through" interface operation, either
-by annotating certain `needs` with :func:`.keyword` `modifiers` (above), or
+by annotating certain `needs` with :func:`.keyword` *modifier* (above), or
 by :term:`alias`\sing certain `provides` to different names:
 
    >>> op = operation(str,

docs/source/pipelines.rst

@@ -244,12 +244,12 @@ Advanced pipelines
 
 Depending on sideffects
 ^^^^^^^^^^^^^^^^^^^^^^^
-.. autofunction:: graphtik.modifiers.sfx
+.. autofunction:: graphtik.modifier.sfx
    :noindex:
 
 Modifying existing values in solutions
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-.. autofunction:: graphtik.modifiers.sfxed
+.. autofunction:: graphtik.modifier.sfxed
    :noindex:
 
 Resilience when operations fail (*endurance*)
@@ -398,7 +398,7 @@ First, let's build the single day's workflow, without any nesting:
     >>> from graphtik import NO_RESULT, sfxed
     >>> from graphtik.base import RenArgs  # type hints for autocompletion.
     >>> from graphtik.execution import task_context
-    >>> from graphtik.modifiers import dep_renamed
+    >>> from graphtik.modifier import dep_renamed
 
     >>> todos = sfxed("backlog", "todos")
     >>> @operation(name="wake up",

docs/source/reference.rst

@@ -7,7 +7,7 @@ API Reference
      graphtik
      graphtik.op
      graphtik.pipeline
-     graphtik.modifiers
+     graphtik.modifier
      graphtik.network
      graphtik.execution
      graphtik.plot
@@ -36,10 +36,10 @@ Module: `pipeline`
      :private-members:
      :special-members:
 
-Module: `modifiers`
+Module: `modifier`
 ====================
 
-.. automodule:: graphtik.modifiers
+.. automodule:: graphtik.modifier
      :members:
      :private-members:
      :special-members:

graphtik/__init__.py

@@ -12,7 +12,7 @@
 
 
 from .base import AbortedException, IncompleteExecutionError, MultiValueError
-from .modifiers import (
+from .modifier import (
     accessor,
     jsonp,
     keyword,

graphtik/base.py

@@ -682,7 +682,7 @@ def plot(
         **Examples:**
 
             >>> from graphtik import compose, operation
-            >>> from graphtik.modifiers import optional
+            >>> from graphtik.modifier import optional
             >>> from operator import add
 
             >>> pipeline = compose("pipeline",
@@ -902,7 +902,7 @@ def _rename_graph_names(
             - if a `renamer` was neither dict nor callable
             - if a `renamer` dict contained a non-string value,
         """
-        from .modifiers import dep_renamed
+        from .modifier import dep_renamed
 
         def with_errors_logged(fn, ren_args: RenArgs) -> str:
             """Wrap `fn` to log its errors without touching ex, for debug aid."""

graphtik/execution.py

@@ -37,7 +37,7 @@
     is_reschedule_operations,
     is_skip_evictions,
 )
-from .modifiers import (
+from .modifier import (
     acc_contains,
     acc_delitem,
     acc_getitem,

graphtik/modifiers.py renamed to graphtik/modifier.py

@@ -26,7 +26,7 @@
 
 from .base import Items, Operation, PlotArgs, Plottable, astuple, jetsam
 from .config import is_debug, is_skip_evictions
-from .modifiers import (
+from .modifier import (
     modifier_withset,
     dep_renamed,
     dep_stripped,

graphtik/network.py

@@ -4,7 +4,7 @@
 Define :term:`operation` & :term:`dependency` and match/zip inputs/outputs during :term:`execution`.
 
 .. note::
-    This module (along with :mod:`.modifiers` & :mod:`.pipeline`) is what client code needs
+    This module (along with :mod:`.modifier` & :mod:`.pipeline`) is what client code needs
     to define pipelines *on import time* without incurring a heavy price
     (<5ms on a 2019 fast PC)
 """
@@ -41,7 +41,7 @@
     func_name,
     jetsam,
 )
-from .modifiers import (
+from .modifier import (
     dep_renamed,
     dep_singularized,
     dep_stripped,