doc/log

rwx/log/__init__.py

@@ -5,7 +5,12 @@ import sys
 
 
 def get_file_logger(name: str) -> logging.Logger:
-    """Return a file logger."""
+    """Return a file logger.
+
+    :param name: arbitrary name
+    :type name: str
+    :rtype: logging.Logger
+    """
     # formatter
     items = [
         "%(name)s: %(asctime)s",
@@ -27,7 +32,12 @@ def get_file_logger(name: str) -> logging.Logger:
 
 
 def get_stream_logger(level: int) -> logging.Logger:
-    """Return a stream logger."""
+    """Return a stream logger.
+
+    :param level: filtering level
+    :type level: int
+    :rtype: logging.Logger
+    """
     # handler
     out_handler = logging.StreamHandler(stream=sys.stdout)
     out_handler.setLevel(level)