wai.logging 0.0.1__tar.gz

wai.logging-0.0.1/CHANGES.rst

@@ -0,0 +1,8 @@
+Changelog
+=========
+
+0.0.1 (????-??-??)
+------------------
+
+- initial release
+

wai.logging-0.0.1/DESCRIPTION.rst

@@ -0,0 +1 @@
+Python library with helper methods for logging.

wai.logging-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 University of Waikato - Data Mining
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

wai.logging-0.0.1/MANIFEST.in

@@ -0,0 +1,3 @@
+include DESCRIPTION.rst
+include CHANGES.rst
+include LICENSE

wai.logging-0.0.1/PKG-INFO

@@ -0,0 +1,24 @@
+Metadata-Version: 2.1
+Name: wai.logging
+Version: 0.0.1
+Summary: Python library with helper methods for logging.
+Home-page: https://github.com/waikato-datamining/wai-logging
+Author: Peter Reutemann
+Author-email: fracpete@waikato.ac.nz
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Programming Language :: Python :: 3
+License-File: LICENSE
+
+Python library with helper methods for logging.
+
+Changelog
+=========
+
+0.0.1 (????-??-??)
+------------------
+
+- initial release
+

wai.logging-0.0.1/README.md

@@ -0,0 +1,10 @@
+# wai-logging
+Simple helper library for logging.
+
+## Methods
+
+* `init_logging` - initializes the logging with a default level, which can be overridden with an environment variable
+* `set_logging_level` - sets the logging level of a `logging.Logger` instance
+* `str_to_logging_level` - turns a string logging level into a `logging` module one, used by `init_logging` and `set_logging_level`
+* `add_logging_level` - adds an option for the logging level to an `argparse.ArgumentParser` instance
+* `add_logger_name` - adds an option for a custom name for a logger to an `argparse.ArgumentParser` instance

wai.logging-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

wai.logging-0.0.1/setup.py

@@ -0,0 +1,38 @@
+from setuptools import setup
+
+
+def _read(f) -> bytes:
+    """
+    Reads in the content of the file.
+    :param f: the file to read
+    :type f: str
+    :return: the content
+    :rtype: str
+    """
+    return open(f, 'rb').read()
+
+
+setup(
+    name="wai.logging",
+    description="Python library with helper methods for logging.",
+    long_description=(
+        _read('DESCRIPTION.rst') + b'\n' +
+        _read('CHANGES.rst')).decode('utf-8'),
+    url="https://github.com/waikato-datamining/wai-logging",
+    classifiers=[
+        'Development Status :: 4 - Beta',
+        'License :: OSI Approved :: MIT License',
+        'Topic :: Scientific/Engineering :: Mathematics',
+        'Programming Language :: Python :: 3',
+    ],
+    license='MIT',
+    package_dir={
+        '': 'src'
+    },
+    packages=[
+        "wai.logging",
+    ],
+    version="0.0.1",
+    author='Peter Reutemann',
+    author_email='fracpete@waikato.ac.nz',
+)

wai.logging-0.0.1/src/wai/logging/__init__.py

@@ -0,0 +1,3 @@
+from ._core import LOGGING_LEVELS, LOGGING_DEBUG, LOGGING_INFO, LOGGING_WARN, LOGGING_WARNING, LOGGING_ERROR, LOGGING_CRITICAL
+from ._core import init_logging, set_logging_level, str_to_logging_level
+from ._argparse import add_logging_level, add_logger_name

wai.logging-0.0.1/src/wai/logging/_argparse.py

@@ -0,0 +1,41 @@
+import argparse
+
+from ._core import LOGGING_LEVELS, LOGGING_WARN
+
+
+def add_logging_level(parser: argparse.ArgumentParser, short_opt: str = "-l", long_opt: str = "--logging_level",
+                      help_str: str = None):
+    """
+    Adds an option for the logging level to the parser.
+
+    :param parser: the parser to append.
+    :type parser: argparse.ArgumentParser
+    :param short_opt: the short option flag to use (eg -l)
+    :type short_opt: str
+    :param long_opt: the long option flag to use (eg --logging_level)
+    :type long_opt: str
+    :param help_str: the help string to use
+    :type help_str: str
+    """
+    if help_str is None:
+        help_str = "The logging level to use."
+    parser.add_argument(short_opt, long_opt, choices=LOGGING_LEVELS, default=LOGGING_WARN, help=help_str)
+
+
+def add_logger_name(parser: argparse.ArgumentParser, short_opt: str = "-N", long_opt: str = "--logger_name",
+                    help_str: str = None):
+    """
+    Adds an option for the logger name to the parser.
+
+    :param parser: the parser to append.
+    :type parser: argparse.ArgumentParser
+    :param short_opt: the short option flag to use (eg -N)
+    :type short_opt: str
+    :param long_opt: the long option flag to use (eg --logger_name)
+    :type long_opt: str
+    :param help_str: the help string to use
+    :type help_str: str
+    """
+    if help_str is None:
+        help_str = "The custom name to use for the logger"
+    parser.add_argument(short_opt, long_opt, type=str, default=None, help=help_str, required=False)

wai.logging-0.0.1/src/wai/logging/_core.py

@@ -0,0 +1,73 @@
+import logging
+import os
+
+
+LOGGING_DEBUG = "DEBUG"
+LOGGING_INFO = "INFO"
+LOGGING_WARN = "WARN"
+LOGGING_WARNING = "WARNING"
+LOGGING_ERROR = "ERROR"
+LOGGING_CRITICAL = "CRITICAL"
+LOGGING_LEVELS = [
+    LOGGING_DEBUG,
+    LOGGING_INFO,
+    LOGGING_WARNING,
+    LOGGING_ERROR,
+    LOGGING_CRITICAL,
+]
+
+
+def str_to_logging_level(level: str) -> int:
+    """
+    Turns a logging level string into the corresponding integer constant.
+
+    :param level: the level to convert
+    :type level: str
+    :return: the int level
+    :rtype: int
+    """
+    level = level.upper()
+    if level == LOGGING_WARN:
+        level = LOGGING_WARNING
+    if level not in LOGGING_LEVELS:
+        raise Exception("Invalid logging level (%s): %s" % ("|".join(LOGGING_LEVELS), level))
+    if level == LOGGING_CRITICAL:
+        return logging.CRITICAL
+    elif level == LOGGING_ERROR:
+        return logging.ERROR
+    elif level == LOGGING_WARNING:
+        return logging.WARNING
+    elif level == LOGGING_INFO:
+        return logging.INFO
+    elif level == LOGGING_DEBUG:
+        return logging.DEBUG
+    else:
+        raise Exception("Unhandled logging level: %s" % level)
+
+
+def init_logging(default_level: str = LOGGING_WARNING, env_var: str = None):
+    """
+    Initializes the logging.
+
+    :param default_level: the default level to use
+    :type default_level: str
+    :param env_var: the environment variable to check for a level (overrides the default level), ignored if None
+    :type env_var: str
+    """
+    level = str_to_logging_level(default_level)
+    if env_var is not None:
+        if os.getenv(env_var) is not None:
+            level = str_to_logging_level(os.getenv(env_var))
+    logging.basicConfig(level=level)
+
+
+def set_logging_level(logger: logging.Logger, level: str):
+    """
+    Sets the logging level of the logger.
+
+    :param logger: the logger to update
+    :type logger: logging.Logger
+    :param level: the level string, see LOGGING_LEVELS
+    :type level: str
+    """
+    logger.setLevel(str_to_logging_level(level))

wai.logging-0.0.1/src/wai.logging.egg-info/PKG-INFO

@@ -0,0 +1,24 @@
+Metadata-Version: 2.1
+Name: wai.logging
+Version: 0.0.1
+Summary: Python library with helper methods for logging.
+Home-page: https://github.com/waikato-datamining/wai-logging
+Author: Peter Reutemann
+Author-email: fracpete@waikato.ac.nz
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Programming Language :: Python :: 3
+License-File: LICENSE
+
+Python library with helper methods for logging.
+
+Changelog
+=========
+
+0.0.1 (????-??-??)
+------------------
+
+- initial release
+

wai.logging-0.0.1/src/wai.logging.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+CHANGES.rst
+DESCRIPTION.rst
+LICENSE
+MANIFEST.in
+README.md
+setup.py
+src/wai.logging.egg-info/PKG-INFO
+src/wai.logging.egg-info/SOURCES.txt
+src/wai.logging.egg-info/dependency_links.txt
+src/wai.logging.egg-info/top_level.txt
+src/wai/logging/__init__.py
+src/wai/logging/_argparse.py
+src/wai/logging/_core.py

wai.logging-0.0.1/src/wai.logging.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

wai.logging-0.0.1/src/wai.logging.egg-info/top_level.txt

@@ -0,0 +1 @@
+wai