ruff format / docstring

Author: d-w-moore

irods/meta.py

@@ -132,15 +132,32 @@ def __init__(self, operation, avu, **kw):
 
 class iRODSMetaCollection:
     def __getattr__(self, name):
+        """Here we intervene for the purpose of casting such settable flags such
+        as 'admin', 'timestamps', etc. as readable attributes of the object.
+
+        If the attribute name exists as a key in _MetadataManager_opts_initializer 
+        (for the "_opts" lookup in the manager object), then the current value from
+        _opts is returned.  Otherwise we throw an exception to revert to the default
+        __getattr__ behavior.
+
+        For more specific coverage of such attributes and how they are used, please
+        consult the test module irods/test/meta_test.py and read the test for
+        issue #709, named:
+
+            test_cascading_changes_of_metadata_manager_options__issue_709
+        """
+
         from irods.manager.metadata_manager import _MetadataManager_opts_initializer
+
         # Separating _MetadataManager_opts_initializer from the MetadataManager class
         # prevents the possibility of arbitrary access by copy.copy() to parts of
         # our object's state before they have been initialized, as it is known to do
         # by calling hasattr on the "__setstate__" attribute. The result of such
         # unfettered access is infinite recursion.  See:
         # https://nedbatchelder.com/blog/201010/surprising_getattr_recursion
+
         if name in _MetadataManager_opts_initializer:
-            return self._manager._opts[name]
+            return self._manager._opts[name]  # noqa: SLF001
         raise AttributeError
 
     def __call__(self, **opts):