python-json-logger 4.2.0__py3-none-any.whl → 4.3.0.dev2__py3-none-any.whl

{python_json_logger-4.2.0.dist-info → python_json_logger-4.3.0.dev2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-json-logger
-Version: 4.2.0
+Version: 4.3.0.dev2
 Summary: JSON Log Formatter for the Python Logging Package
 Author-email: Zakaria Zajac <zak@madzak.com>, Nicholas Hairs <info+python-json-logger@nicholashairs.com>
 Maintainer-email: Nicholas Hairs <info+python-json-logger@nicholashairs.com>
@@ -16,6 +16,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Topic :: System :: Logging
 Classifier: Typing :: Typed
 Requires-Python: >=3.10

{python_json_logger-4.2.0.dist-info → python_json_logger-4.3.0.dev2.dist-info}/RECORD

@@ -1,7 +1,7 @@
-python_json_logger-4.2.0.dist-info/licenses/LICENSE,sha256=GOqVF546Xg4k62zhbED7--IxM8JQKTOi91-KPhoFW1Q,1329
+python_json_logger-4.3.0.dev2.dist-info/licenses/LICENSE,sha256=GOqVF546Xg4k62zhbED7--IxM8JQKTOi91-KPhoFW1Q,1329
 pythonjsonlogger/__init__.py,sha256=2QcveuId10CyXff_BtJ_6kXIarHT5oq66XHHMFiaE8s,419
-pythonjsonlogger/core.py,sha256=L41AmWK0t5n-QHazXeOlggNX7uzri750i7SFSpeXZ5Q,16268
-pythonjsonlogger/defaults.py,sha256=muj4QzHgUMJH0UwRvgroHKSRfQgHcF9E-EJXhVzAi98,6461
+pythonjsonlogger/core.py,sha256=T02iURAubnMTk0PO0HUOckS93eMfAFapSZcFPXJqB64,17102
+pythonjsonlogger/defaults.py,sha256=VR_Wl092yRjwS0mREjuNn_W4H4sAjtcZAIYFBMYNHe0,6770
 pythonjsonlogger/exception.py,sha256=r3DXDk7TThscnMVNPpVRaRSFHTnY-ygea6nn-FgjwsI,804
 pythonjsonlogger/json.py,sha256=6aJSqd2BeysAHkQkxb7dPgFpqsFRf4rvWYgaWF2MEC0,4064
 pythonjsonlogger/jsonlogger.py,sha256=sfltkYGwRhRvqcpT-kxlPfcMuOc4ngEa4W4NVTiBpMI,417
@@ -9,7 +9,7 @@ pythonjsonlogger/msgspec.py,sha256=tdFes9rLrdns9I_C5ascK9a265iNc4UccLPzc8JbFDI,2
 pythonjsonlogger/orjson.py,sha256=XWM-jyl6g_40Em8kt188EOspD872xHvYy8aS_CLlssw,2354
 pythonjsonlogger/py.typed,sha256=4RLptUHQuSqzK6CDbigff8uvWQjwPPQMxikWPkV4OtA,80
 pythonjsonlogger/utils.py,sha256=qr04nb61TkVw7cJTXAtLBfyH_NBvyYUlR_mehH76-RM,1126
-python_json_logger-4.2.0.dist-info/METADATA,sha256=kgcfdHSWOBb_eR3Xg4Or8GzyuDw9HbClYz9cTx4y5GU,2866
-python_json_logger-4.2.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-python_json_logger-4.2.0.dist-info/top_level.txt,sha256=9G-OsTkbwPgM8t-bXKPmWDBRZv9cbzLIiEDE5EnGk2I,17
-python_json_logger-4.2.0.dist-info/RECORD,,
+python_json_logger-4.3.0.dev2.dist-info/METADATA,sha256=q4IajnR8q8pXVltRYOx5V3-7FPkoGkECHgo9XbSb9AI,2922
+python_json_logger-4.3.0.dev2.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+python_json_logger-4.3.0.dev2.dist-info/top_level.txt,sha256=9G-OsTkbwPgM8t-bXKPmWDBRZv9cbzLIiEDE5EnGk2I,17
+python_json_logger-4.3.0.dev2.dist-info/RECORD,,

{python_json_logger-4.2.0.dist-info → python_json_logger-4.3.0.dev2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (84.0.0)
+Generator: setuptools (84.2.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

pythonjsonlogger/core.py

@@ -9,6 +9,7 @@ from __future__ import annotations
 from datetime import datetime, timezone
 import logging
 import re
+import string
 import sys
 from typing import TypeAlias, Any
 from collections.abc import Container, Sequence
@@ -64,8 +65,7 @@ if sys.version_info >= (3, 12):
 STYLE_STRING_TEMPLATE_REGEX = re.compile(
     r"\$(?:\$|\{(?P<braced>.+?)\}|(?P<named>[_a-z][_a-z0-9]*))", re.IGNORECASE
 )  # $ style
-STYLE_STRING_FORMAT_REGEX = re.compile(r"\{(.+?)\}", re.IGNORECASE)  # { style
-STYLE_PERCENT_REGEX = re.compile(r"%\((.+?)\)", re.IGNORECASE)  # % style
+STYLE_PERCENT_REGEX = re.compile(r"%(?:%|\((?P<named>.+?)\))", re.IGNORECASE)  # % style
 
 ## Type Aliases
 ## -----------------------------------------------------------------------------
@@ -153,12 +153,14 @@ class BaseJsonFormatter(logging.Formatter):
             rename_fields_keep_missing: When renaming fields, include missing fields in the output.
             static_fields: an optional dict, used to add fields with static values to all logs
             reserved_attrs: an optional list of fields that will be skipped when
-                outputting json log record. Defaults to [all log record attributes][pythonjsonlogger.core.RESERVED_ATTRS].
+                outputting json log record. Pass a list or tuple, not a string.
+                Defaults to [all log record attributes][pythonjsonlogger.core.RESERVED_ATTRS].
             timestamp: an optional string/boolean field to add a timestamp when
                 outputting the json log record. If string is passed, timestamp will be added
                 to log record using string as key. If True boolean is passed, timestamp key
                 will be "timestamp". Defaults to False/off.
-            exc_info_as_array: break the exc_info into a list of lines based on line breaks.
+            exc_info_as_array: break the exc_info into a list of lines based on line breaks,
+                including cached exception text in records received over a transport.
             stack_info_as_array: break the stack_info into a list of lines based on line breaks.
 
         *Changed in 3.1*:
@@ -213,8 +215,9 @@ class BaseJsonFormatter(logging.Formatter):
         ## ---------------------------------------------------------------------
         self.prefix = prefix
 
-        # We recreate the dict in rename_fields and static_fields to support internal/external
-        # references which require getting the item to do the conversion.
+        # Recreate these dicts so DictConfigurator `ext://` / `cfg://` prefixes
+        # are converted (ConvertingDict only converts on `__getitem__`) and so
+        # later mutation of the caller's dict cannot change formatter state.
         # For more details see: https://github.com/nhairs/python-json-logger/pull/45
         self.rename_fields = (
             {key: rename_fields[key] for key in rename_fields} if rename_fields is not None else {}
@@ -222,18 +225,26 @@ class BaseJsonFormatter(logging.Formatter):
         self.static_fields = (
             {key: static_fields[key] for key in static_fields} if static_fields is not None else {}
         )
+        self.defaults = {key: defaults[key] for key in defaults} if defaults is not None else {}
 
         self.rename_fields_keep_missing = rename_fields_keep_missing
-        self.reserved_attrs = set(reserved_attrs if reserved_attrs is not None else RESERVED_ATTRS)
+        if reserved_attrs is None:
+            reserved_attrs = RESERVED_ATTRS
+        elif isinstance(reserved_attrs, str):
+            raise TypeError("reserved_attrs must be a sequence of field names, not a string")
+        self.reserved_attrs = set(reserved_attrs)
         self.timestamp = timestamp
 
         self._skip_fields = set(self._required_fields)
         self._skip_fields.update(self.reserved_attrs)
-        self.defaults = defaults if defaults is not None else {}
         self.exc_info_as_array = exc_info_as_array
         self.stack_info_as_array = stack_info_as_array
         return
 
+    def usesTime(self) -> bool:
+        """Return whether the parsed format fields include `asctime`."""
+        return "asctime" in self._required_fields
+
     def format(self, record: logging.LogRecord) -> str:
         """Formats a log record and serializes to json
 
@@ -264,7 +275,9 @@ class BaseJsonFormatter(logging.Formatter):
         if record.exc_info and not message_dict.get("exc_info"):
             message_dict["exc_info"] = self.formatException(record.exc_info)
         if not message_dict.get("exc_info") and record.exc_text:
-            message_dict["exc_info"] = record.exc_text
+            message_dict["exc_info"] = (
+                record.exc_text.splitlines() if self.exc_info_as_array else record.exc_text
+            )
 
         # Display formatted record of stack frames
         # default format is a string returned from :func:`traceback.print_stack`
@@ -311,12 +324,20 @@ class BaseJsonFormatter(logging.Formatter):
             ]
 
         if isinstance(self._style, logging.StrFormatStyle):
-            return STYLE_STRING_FORMAT_REGEX.findall(self._fmt)
+            return [
+                field_name
+                for _, field_name, _, _ in string.Formatter().parse(self._fmt)
+                if field_name
+            ]
 
         if isinstance(self._style, logging.PercentStyle):
             # PercentStyle is parent class of StringTemplateStyle and StrFormatStyle
             # so it must be checked last.
-            return STYLE_PERCENT_REGEX.findall(self._fmt)
+            return [
+                match.group("named")
+                for match in STYLE_PERCENT_REGEX.finditer(self._fmt)
+                if match.group("named")
+            ]
 
         raise ValueError(f"Style {self._style!r} is not supported")
 

pythonjsonlogger/defaults.py

@@ -152,10 +152,18 @@ def use_exception_default(obj: Any) -> TypeGuard[BaseException]:
 def exception_default(obj: BaseException) -> str:
     """Default function for exception instances
 
+    Includes the exception's own notes, if present. Exception groups retain
+    their summary without recursively formatting their children.
+
     Args:
         obj: object to handle
+
+    *Changed in 4.3*: Includes exception notes if available.
     """
-    return f"{obj.__class__.__name__}: {obj}"
+    result = f"{obj.__class__.__name__}: {obj}"
+    if hasattr(obj, "__notes__"):
+        return "\n".join([result, *obj.__notes__])
+    return result
 
 
 def use_traceback_default(obj: Any) -> TypeGuard[TracebackType]: