chore: import upstream snapshot with attribution

python/paddle/base/log_helper.py

@@ -0,0 +1,62 @@
+#   Copyright (c) 2019 PaddlePaddle Authors. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import logging
+
+__all__ = []
+
+
+def get_logger(name, level, fmt=None):
+    """
+    Get logger from logging with given name, level and format without
+    setting logging basicConfig. For setting basicConfig in paddle
+    will disable basicConfig setting after import paddle.
+
+    Args:
+        name (str): The logger name.
+        level (logging.LEVEL): The base level of the logger
+        fmt (str): Format of logger output
+
+    Returns:
+        logging.Logger: logging logger with given settings
+
+    Examples:
+
+        .. code-block:: pycon
+
+            >>> import paddle
+            >>> import logging
+            >>> from paddle.base import log_helper
+
+            >>> logger = log_helper.get_logger(
+            ...     __name__,
+            ...     logging.INFO,
+            ...     fmt='%(asctime)s-%(levelname)s: %(message)s',
+            ... )
+    """
+
+    logger = logging.getLogger(name)
+    logger.setLevel(level)
+    handler = logging.StreamHandler()
+
+    if fmt:
+        formatter = logging.Formatter(fmt=fmt, datefmt='%a %b %d %H:%M:%S')
+        handler.setFormatter(formatter)
+
+    logger.addHandler(handler)
+
+    # stop propagate for propagating may print
+    # log multiple times
+    logger.propagate = False
+    return logger