python-coloured-logger 1.0.1__tar.gz → 1.0.3__tar.gz

{python_coloured_logger-1.0.1 → python_coloured_logger-1.0.3}/PKG-INFO

@@ -1,9 +1,12 @@
 Metadata-Version: 2.4
 Name: python-coloured-logger
-Version: 1.0.1
+Version: 1.0.3
 Summary: Simple coloured logging for Flask and FastAPI apps
 Author: Skulldorom
 License-Expression: MIT
+Project-URL: Homepage, https://github.com/Skulldorom/python-coloured-logger
+Project-URL: Repository, https://github.com/Skulldorom/python-coloured-logger
+Project-URL: Issues, https://github.com/Skulldorom/python-coloured-logger/issues
 Keywords: logging,flask,fastapi,color
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
@@ -60,10 +63,10 @@ logger.critical("System crash")
 Example output:
 
 ```text
-[2026-05-27 12:00:00] INFO     Server started
-[2026-05-27 12:00:01] SUCCESS  Database connected
-[2026-05-27 12:00:02] WARNING  High memory usage
-[2026-05-27 12:00:03] ERROR    Request failed
+[20/06/2026] [INFO] Server started
+[20/06/2026] [SUCCESS] Database connected
+[20/06/2026] [WARNING] High memory usage
+[20/06/2026] [ERROR] Request failed
 ```
 
 ---
@@ -172,7 +175,7 @@ FLASK_LOG_DATE_FORMAT=%H:%M:%S
 
 ## Requirements
 
-- Python 3.9+
+- Python 3.8+
 - Flask (optional)
 - FastAPI / Uvicorn (optional)
 

{python_coloured_logger-1.0.1 → python_coloured_logger-1.0.3}/README.md

@@ -45,10 +45,10 @@ logger.critical("System crash")
 Example output:
 
 ```text
-[2026-05-27 12:00:00] INFO     Server started
-[2026-05-27 12:00:01] SUCCESS  Database connected
-[2026-05-27 12:00:02] WARNING  High memory usage
-[2026-05-27 12:00:03] ERROR    Request failed
+[20/06/2026] [INFO] Server started
+[20/06/2026] [SUCCESS] Database connected
+[20/06/2026] [WARNING] High memory usage
+[20/06/2026] [ERROR] Request failed
 ```
 
 ---
@@ -157,7 +157,7 @@ FLASK_LOG_DATE_FORMAT=%H:%M:%S
 
 ## Requirements
 
-- Python 3.9+
+- Python 3.8+
 - Flask (optional)
 - FastAPI / Uvicorn (optional)
 

{python_coloured_logger-1.0.1 → python_coloured_logger-1.0.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-coloured-logger"
-version = "1.0.1"
+version = "1.0.3"
 description = "Simple coloured logging for Flask and FastAPI apps"
 readme = "README.md"
 requires-python = ">=3.8"
@@ -18,8 +18,23 @@ classifiers = [
   "Operating System :: OS Independent",
 ]
 
+[project.urls]
+Homepage = "https://github.com/Skulldorom/python-coloured-logger"
+Repository = "https://github.com/Skulldorom/python-coloured-logger"
+Issues = "https://github.com/Skulldorom/python-coloured-logger/issues"
+
 [tool.setuptools]
 package-dir = { "" = "src" }
 
+[tool.setuptools.package-data]
+"coloured_logger" = ["py.typed"]
+
 [tool.setuptools.packages.find]
 where = ["src"]
+
+[tool.mypy]
+strict = true
+python_version = "3.8"
+files = ["src"]
+warn_unused_ignores = true
+warn_redundant_casts = true

python_coloured_logger-1.0.3/src/coloured_logger/__init__.py

@@ -0,0 +1,10 @@
+from importlib.metadata import PackageNotFoundError, version
+
+from .formatter import ColouredFormatter, SUCCESS_LEVEL, get_logger, log, setup_logging
+
+try:
+    __version__ = version("python-coloured-logger")
+except PackageNotFoundError:
+    __version__ = "unknown"
+
+__all__ = ["ColouredFormatter", "SUCCESS_LEVEL", "get_logger", "log", "setup_logging", "__version__"]

{python_coloured_logger-1.0.1 → python_coloured_logger-1.0.3}/src/coloured_logger/formatter.py

@@ -4,6 +4,8 @@ from typing import Optional, TextIO
 
 SUCCESS_LEVEL = 25
 
+_success_level_registered: bool = False
+
 
 def _env_bool(name: str, default: bool) -> bool:
     value = os.getenv(name)
@@ -23,7 +25,7 @@ def _resolve_use_color(use_color: Optional[bool]) -> bool:
 def _resolve_datefmt(datefmt: Optional[str]) -> str:
     if datefmt:
         return datefmt
-    return os.getenv("FLASK_LOG_DATE_FORMAT") or os.getenv("COLOURED_LOGGER_DATE_FORMAT") or "%d/%b/%Y %H:%M:%S"
+    return os.getenv("FLASK_LOG_DATE_FORMAT") or os.getenv("COLOURED_LOGGER_DATE_FORMAT") or "%d/%m/%Y"
 
 
 class ColouredFormatter(logging.Formatter):
@@ -60,6 +62,10 @@ class ColouredFormatter(logging.Formatter):
 
 
 def _ensure_success_level() -> None:
+    global _success_level_registered
+    if _success_level_registered:
+        return
+
     if logging.getLevelName(SUCCESS_LEVEL) != "SUCCESS":
         logging.addLevelName(SUCCESS_LEVEL, "SUCCESS")
 
@@ -71,11 +77,12 @@ def _ensure_success_level() -> None:
             self._log(SUCCESS_LEVEL, msg, args, **kwargs)
 
     setattr(logging.Logger, "success", success)
+    _success_level_registered = True
 
 
 def setup_logging(
     logger_name: Optional[str] = None,
-    level: int = logging.DEBUG,
+    level: int = logging.NOTSET,
     stream: Optional[TextIO] = None,
     use_color: Optional[bool] = None,
     datefmt: Optional[str] = None,
@@ -83,7 +90,8 @@ def setup_logging(
 ) -> logging.Logger:
     _ensure_success_level()
     logger = logging.getLogger(logger_name)
-    logger.setLevel(level)
+    if level != logging.NOTSET or logger.level == logging.NOTSET:
+        logger.setLevel(level)
 
     managed_handler_exists = any(
         isinstance(handler, logging.StreamHandler) and isinstance(handler.formatter, ColouredFormatter)

{python_coloured_logger-1.0.1 → python_coloured_logger-1.0.3}/src/python_coloured_logger.egg-info/PKG-INFO

@@ -1,9 +1,12 @@
 Metadata-Version: 2.4
 Name: python-coloured-logger
-Version: 1.0.1
+Version: 1.0.3
 Summary: Simple coloured logging for Flask and FastAPI apps
 Author: Skulldorom
 License-Expression: MIT
+Project-URL: Homepage, https://github.com/Skulldorom/python-coloured-logger
+Project-URL: Repository, https://github.com/Skulldorom/python-coloured-logger
+Project-URL: Issues, https://github.com/Skulldorom/python-coloured-logger/issues
 Keywords: logging,flask,fastapi,color
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
@@ -60,10 +63,10 @@ logger.critical("System crash")
 Example output:
 
 ```text
-[2026-05-27 12:00:00] INFO     Server started
-[2026-05-27 12:00:01] SUCCESS  Database connected
-[2026-05-27 12:00:02] WARNING  High memory usage
-[2026-05-27 12:00:03] ERROR    Request failed
+[20/06/2026] [INFO] Server started
+[20/06/2026] [SUCCESS] Database connected
+[20/06/2026] [WARNING] High memory usage
+[20/06/2026] [ERROR] Request failed
 ```
 
 ---
@@ -172,7 +175,7 @@ FLASK_LOG_DATE_FORMAT=%H:%M:%S
 
 ## Requirements
 
-- Python 3.9+
+- Python 3.8+
 - Flask (optional)
 - FastAPI / Uvicorn (optional)
 

{python_coloured_logger-1.0.1 → python_coloured_logger-1.0.3}/src/python_coloured_logger.egg-info/SOURCES.txt

@@ -3,6 +3,7 @@ README.md
 pyproject.toml
 src/coloured_logger/__init__.py
 src/coloured_logger/formatter.py
+src/coloured_logger/py.typed
 src/python_coloured_logger.egg-info/PKG-INFO
 src/python_coloured_logger.egg-info/SOURCES.txt
 src/python_coloured_logger.egg-info/dependency_links.txt

python_coloured_logger-1.0.3/tests/test_formatter.py

@@ -0,0 +1,217 @@
+import io
+import logging
+import os
+import unittest
+
+from coloured_logger import ColouredFormatter, SUCCESS_LEVEL, get_logger, setup_logging
+
+
+class ColouredFormatterTests(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        # Register the SUCCESS level name so direct formatter usage sees "SUCCESS"
+        if logging.getLevelName(SUCCESS_LEVEL) != "SUCCESS":
+            logging.addLevelName(SUCCESS_LEVEL, "SUCCESS")
+
+    def test_format_without_color(self):
+        formatter = ColouredFormatter(use_color=False, datefmt="%Y")
+        record = logging.LogRecord("test", logging.INFO, __file__, 1, "hello", (), None)
+        output = formatter.format(record)
+        self.assertIn("[INFO] hello", output)
+        self.assertNotIn("\033[", output)
+
+    def test_format_with_color(self):
+        formatter = ColouredFormatter(use_color=True, datefmt="%Y")
+        record = logging.LogRecord("test", logging.INFO, __file__, 1, "hello", (), None)
+        output = formatter.format(record)
+        self.assertIn("[INFO] hello", output)
+        self.assertIn("\033[", output)
+
+    def test_all_log_levels_have_colors(self):
+        levels = {
+            logging.DEBUG: "DEBUG",
+            logging.INFO: "INFO",
+            SUCCESS_LEVEL: "SUCCESS",
+            logging.WARNING: "WARNING",
+            logging.ERROR: "ERROR",
+            logging.CRITICAL: "CRITICAL",
+        }
+        for levelno, levelname in levels.items():
+            formatter = ColouredFormatter(use_color=True)
+            record = logging.LogRecord("test", levelno, __file__, 1, "msg", (), None)
+            output = formatter.format(record)
+            self.assertIn(f"[{levelname}] msg", output)
+            self.assertIn("\033[", output)
+
+    def test_unknown_level_returns_uncolored(self):
+        formatter = ColouredFormatter(use_color=True)
+        record = logging.LogRecord("test", 99, __file__, 1, "msg", (), None)
+        output = formatter.format(record)
+        self.assertIn("[Level 99] msg", output)
+        self.assertNotIn("\033[", output)
+
+    def test_default_date_format(self):
+        formatter = ColouredFormatter(use_color=False)
+        self.assertEqual(formatter.datefmt, "%d/%m/%Y")
+
+    def test_custom_date_format(self):
+        formatter = ColouredFormatter(datefmt="%H:%M", use_color=False)
+        self.assertEqual(formatter.datefmt, "%H:%M")
+
+    def test_default_message_format(self):
+        formatter = ColouredFormatter(use_color=False)
+        record = logging.LogRecord("test", logging.INFO, __file__, 1, "hello world", (), None)
+        output = formatter.format(record)
+        self.assertIn("[INFO] hello world", output)
+        self.assertNotIn("\033[", output)
+
+    def test_custom_message_format(self):
+        formatter = ColouredFormatter(fmt="%(levelname)s: %(message)s", use_color=False)
+        record = logging.LogRecord("test", logging.ERROR, __file__, 1, "oops", (), None)
+        output = formatter.format(record)
+        self.assertEqual(output, "ERROR: oops")
+
+
+class SetupLoggingTests(unittest.TestCase):
+    def _make_stream_logger(self, **kwargs):
+        stream = io.StringIO()
+        logger = setup_logging(stream=stream, use_color=False, datefmt="%Y", **kwargs)
+        return logger, stream
+
+    def test_default_level_is_notset(self):
+        logger, _ = self._make_stream_logger(logger_name="test_notset")
+        self.assertEqual(logger.level, logging.NOTSET)
+
+    def test_custom_level(self):
+        logger, _ = self._make_stream_logger(logger_name="test_level_warn", level=logging.WARNING)
+        self.assertEqual(logger.level, logging.WARNING)
+
+    def test_default_level_does_not_override_existing_logger_level(self):
+        logger_name = "test_preserve_level"
+        original = logging.getLogger(logger_name)
+        original.setLevel(logging.ERROR)
+
+        logger, _ = self._make_stream_logger(logger_name=logger_name)
+        self.assertEqual(logger.level, logging.ERROR)
+
+    def test_handler_deduplication(self):
+        logger1 = setup_logging(logger_name="test_dedup", use_color=False)
+        count1 = len(logger1.handlers)
+        logger2 = setup_logging(logger_name="test_dedup", use_color=False)
+        count2 = len(logger2.handlers)
+        self.assertEqual(count1, count2)
+        self.assertGreaterEqual(count1, 1)
+
+    def test_success_level_output(self):
+        logger, stream = self._make_stream_logger(
+            logger_name="test_success", level=logging.DEBUG
+        )
+        logger.success("done")
+        value = stream.getvalue()
+        self.assertIn("[SUCCESS] done", value)
+
+    def test_debug_output(self):
+        logger, stream = self._make_stream_logger(
+            logger_name="test_debug", level=logging.DEBUG
+        )
+        logger.debug("trace")
+        self.assertIn("[DEBUG] trace", stream.getvalue())
+
+    def test_info_output(self):
+        logger, stream = self._make_stream_logger(
+            logger_name="test_info", level=logging.DEBUG
+        )
+        logger.info("running")
+        self.assertIn("[INFO] running", stream.getvalue())
+
+    def test_warning_output(self):
+        logger, stream = self._make_stream_logger(
+            logger_name="test_warn", level=logging.DEBUG
+        )
+        logger.warning("caution")
+        self.assertIn("[WARNING] caution", stream.getvalue())
+
+    def test_error_output(self):
+        logger, stream = self._make_stream_logger(
+            logger_name="test_err", level=logging.DEBUG
+        )
+        logger.error("fail")
+        self.assertIn("[ERROR] fail", stream.getvalue())
+
+    def test_critical_output(self):
+        logger, stream = self._make_stream_logger(
+            logger_name="test_crit", level=logging.DEBUG
+        )
+        logger.critical("boom")
+        self.assertIn("[CRITICAL] boom", stream.getvalue())
+
+    def test_respects_level_filtering(self):
+        logger, stream = self._make_stream_logger(
+            logger_name="test_filter", level=logging.WARNING
+        )
+        logger.info("should not appear")
+        logger.warning("should appear")
+        value = stream.getvalue()
+        self.assertNotIn("should not appear", value)
+        self.assertIn("should appear", value)
+
+
+class GetLoggerTests(unittest.TestCase):
+    def test_get_logger_returns_logger(self):
+        logger = get_logger("test_gl", use_color=False)
+        self.assertIsInstance(logger, logging.Logger)
+        self.assertEqual(logger.name, "test_gl")
+
+    def test_get_logger_default_level(self):
+        logger = get_logger("test_gl_default", use_color=False)
+        self.assertEqual(logger.level, logging.NOTSET)
+
+
+class EnvironmentVariableTests(unittest.TestCase):
+    def setUp(self):
+        self._saved = {}
+        for var in (
+            "COLOURED_LOGGER_COLOR",
+            "FLASK_LOG_COLOR",
+            "COLOURED_LOGGER_DATE_FORMAT",
+            "FLASK_LOG_DATE_FORMAT",
+        ):
+            self._saved[var] = os.environ.pop(var, None)
+
+    def tearDown(self):
+        for var, value in self._saved.items():
+            if value is not None:
+                os.environ[var] = value
+            elif var in os.environ:
+                del os.environ[var]
+
+    def test_colour_env_var_true(self):
+        os.environ["COLOURED_LOGGER_COLOR"] = "true"
+        formatter = ColouredFormatter()
+        self.assertTrue(formatter.use_color)
+
+    def test_colour_env_var_false(self):
+        os.environ["COLOURED_LOGGER_COLOR"] = "false"
+        formatter = ColouredFormatter()
+        self.assertFalse(formatter.use_color)
+
+    def test_flask_color_overrides_coloured_logger_color(self):
+        os.environ["COLOURED_LOGGER_COLOR"] = "true"
+        os.environ["FLASK_LOG_COLOR"] = "false"
+        formatter = ColouredFormatter()
+        self.assertFalse(formatter.use_color)
+
+    def test_date_format_env_var(self):
+        os.environ["COLOURED_LOGGER_DATE_FORMAT"] = "%H:%M"
+        formatter = ColouredFormatter(use_color=False)
+        self.assertEqual(formatter.datefmt, "%H:%M")
+
+    def test_flask_date_format_overrides_coloured_date_format(self):
+        os.environ["COLOURED_LOGGER_DATE_FORMAT"] = "%H:%M"
+        os.environ["FLASK_LOG_DATE_FORMAT"] = "%Y"
+        formatter = ColouredFormatter(use_color=False)
+        self.assertEqual(formatter.datefmt, "%Y")
+
+
+if __name__ == "__main__":
+    unittest.main()

python_coloured_logger-1.0.1/src/coloured_logger/__init__.py

@@ -1,3 +0,0 @@
-from .formatter import ColouredFormatter, SUCCESS_LEVEL, get_logger, log, setup_logging
-
-__all__ = ["ColouredFormatter", "SUCCESS_LEVEL", "get_logger", "log", "setup_logging"]

python_coloured_logger-1.0.1/tests/test_formatter.py

@@ -1,31 +0,0 @@
-import io
-import logging
-import unittest
-
-from coloured_logger import ColouredFormatter, setup_logging
-
-
-class FormatterTests(unittest.TestCase):
-    def test_formatter_without_color(self):
-        formatter = ColouredFormatter(use_color=False, datefmt="%Y")
-        record = logging.LogRecord("test", logging.INFO, __file__, 1, "hello", (), None)
-        output = formatter.format(record)
-        self.assertIn("[INFO] hello", output)
-        self.assertNotIn("\033[", output)
-
-    def test_logger_adds_success_level_output(self):
-        stream = io.StringIO()
-        logger = setup_logging(
-            logger_name="coloured_logger_test",
-            level=logging.DEBUG,
-            stream=stream,
-            use_color=False,
-            datefmt="%Y",
-        )
-        logger.success("done")
-        value = stream.getvalue()
-        self.assertIn("[SUCCESS] done", value)
-
-
-if __name__ == "__main__":
-    unittest.main()