Support for metrical logger for hier hold state. Hold Log, Hog.

ref/hier.md

@@ -55,7 +55,7 @@ These properties are mutually supporting. Together they provide a powerful found
 for solving the hard problem of automation systems, that is, the coordination
 problem. The coordination problem poses the following question; how best to
 coordinate the various components of an automation system especially
-a coordiantion system that is dynamically adaptive (in-stride) to both a
+a coordination system that is dynamically adaptive (in-stride) to both a
 changing environment and changing goals and objectives for mission success?
 
 
@@ -107,6 +107,7 @@ A boxwork consists of a graph of connected boxes. Each box belongs to a pile of
 stacked boxes. A given pile constitues a hierarchical state. State changes by
 transitioning from one pile to a different pile as determined by a transition
 from one box to another box in the boxwork.
+
 ### Box Piles
 
 Each box may have an over box and zero or more under boxes. A box at the top

src/hio/base/filing.py

@@ -40,9 +40,7 @@ class Filer(hioing.Mixin):
         Mode (str): open mode such as "r+"
         Fext (str): default file extension such as "text" for "fname.text"
 
-
     Attributes:
-        name (str): unique path component used in directory or file path name
         base (str): another unique path component inserted before name
         temp (bool): True means use TempHeadDir in /tmp directory
         headDirPath (str): head directory path
@@ -59,6 +57,12 @@ class Filer(hioing.Mixin):
         opened (bool): True means directory created and if filed then file
                 is opened. False otherwise
 
+    Properties:
+        name (str): unique path component used in directory or file path name
+
+    Hidden:
+        _name (str): unique name for .name property
+
 
     File/Directory Creation Mode Notes:
         .Perm provides default restricted access permissions to directory and/or files
@@ -126,15 +130,17 @@ def __init__(self, *, name='main', base="", temp=False, headDirPath=None,
             fext (str): File extension when filed or extensioned
 
         """
-        super(Filer, self).__init__(**kwa)  # Mixin for Mult-inheritance MRO
+        if not hasattr(self, "_name") or name != self.name:  # avoid collision subclass
+            self.name = name
+
+        super(Filer, self).__init__(name=self.name, **kwa)  # Mixin for Mult-inheritance MRO
 
         # ensure relative path parts are relative because of odd path.join behavior
-        if os.path.isabs(name):
-            raise hioing.FilerError(f"Not relative {name=} path.")
+        if os.path.isabs(self.name):
+            raise hioing.FilerError(f"Not relative name={self.name} path.")
         if os.path.isabs(base):
             raise hioing.FilerError(f"Not relative {base=} path.")
 
-        self.name = name
         self.base = base
         self.temp = True if temp else False
         self.headDirPath = headDirPath if headDirPath is not None else self.HeadDirPath
@@ -150,6 +156,29 @@ def __init__(self, *, name='main', base="", temp=False, headDirPath=None,
         if reopen:
             self.reopen(clear=clear, reuse=reuse, clean=clean, **kwa)
 
+    @property
+    def name(self):
+        """Property getter for ._name
+
+        Returns:
+            name (str): unique identifier of instance used as unique path
+                        component in directory or file path name
+        """
+        return self._name
+
+
+    @name.setter
+    def name(self, name):
+        """Property setter for ._name
+
+        Parameters:
+            name (str): unique identifier of instance
+        """
+        #if not Renam.match(name):
+            #raise HierError(f"Invalid {name=}.")
+        self._name = name
+
+
 
     def reopen(self, temp=None, headDirPath=None, perm=None, clear=False,
                reuse=False, clean=False, mode=None, fext=None, **kwa):
@@ -197,7 +226,7 @@ def reopen(self, temp=None, headDirPath=None, perm=None, clear=False,
                                                mode=self.mode,
                                                fext=self.fext,
                                                **kwa)
-        elif self.filed:  # assumes dir in self.path exists
+        elif self.filed:  # would not be here unless self.path already exists
             self.file = ocfn(self.path, mode=self.mode)
 
         self.opened = True if not self.filed else self.file and not self.file.closed
@@ -450,13 +479,23 @@ def exists(self, name="", base="", headDirPath=None, clean=False,
         return os.path.exists(path)
 
 
+    def flush(self):
+        """
+        flush self.file if not closed
+        """
+        if self.file and not self.file.closed:
+            self.file.flush()
+            os.fsync(self.file.fileno())
+
+
     def close(self, clear=False):
         """Close .file if any and if clear rm directory or file at .path
 
         Parameters:
            clear (bool): True means remove dir or file at .path
         """
         if self.file:
+            self.flush() # since file.close does not guarantee file sync
             self.file.close()
         self.opened = False
 

src/hio/base/hier/__init__.py

@@ -8,11 +8,13 @@
                      Act, Goact, EndAct, Beact, Mark, LapseMark, RelapseMark,
                      Count, Discount,
                      BagMark, UpdateMark, ReupdateMark,
-                     ChangeMark, RechangeMark)
+                     ChangeMark, RechangeMark,
+                     CloseAct)
 from .needing import Need
 from .bagging import Bag, IceBag
 from .canning import CanDom, Can
 from .holding import Hold
 from .durqing import Durq
 from .dusqing import Dusq
+from .hogging import Rules, Hog, openHog, HogDoer