dbt-common 1.17.0__tar.gz → 1.19__tar.gz

{dbt_common-1.17.0 → dbt_common-1.19}/CHANGELOG.md

@@ -5,6 +5,28 @@
 - "Breaking changes" listed under a version may require action from end users or external maintainers when upgrading to that version.
 - Do not edit this file directly. This file is auto-generated using [changie](https://github.com/miniscruff/changie). For details on how to document a change, see [the contributing guide](https://github.com/dbt-labs/dbt-common/blob/main/CONTRIBUTING.md#adding-changelog-entry)
 
+## dbt-common 1.19 - April 16, 2025
+
+
+
+## dbt-common 1.18 - April 14, 2025
+
+### Features
+
+- Ability to specify 'Deprecations' in `WarnErrorOptions` ([#265](https://github.com/dbt-labs/dbt-common/issues/265))
+
+### Fixes
+
+- Replace depricated datetime.datetime.utcnow() for datetime.datetime.now(timezone.utc) to reduce stdout spam. ([#238](https://github.com/dbt-labs/dbt-common/issues/238), [#99](https://github.com/dbt-labs/dbt-common/issues/99))
+
+### Under the Hood
+
+- Add support for Python 3.13 ([#263](https://github.com/dbt-labs/dbt-common/issues/263))
+- Add new event to signal issues during record/replay ([#268](https://github.com/dbt-labs/dbt-common/issues/268))
+
+### Contributors
+- [@cfernhout](https://github.com/cfernhout) ([#238](https://github.com/dbt-labs/dbt-common/issues/238), [#99](https://github.com/dbt-labs/dbt-common/issues/99))
+
 ## dbt-common 1.17.0 - March 31, 2025
 
 ### Breaking Changes
@@ -15,8 +37,6 @@
 
 - Stream recorded events to disk rather than storing them in memory. ([#260](https://github.com/dbt-labs/dbt-common/issues/260))
 
-
-
 ## dbt-common 1.16.0 - March 18, 2025
 
 ### Features

{dbt_common-1.17.0 → dbt_common-1.19}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dbt-common
-Version: 1.17.0
+Version: 1.19
 Summary: The shared common utilities that dbt-core and adapter implementations use
 Project-URL: Homepage, https://github.com/dbt-labs/dbt-common
 Project-URL: Repository, https://github.com/dbt-labs/dbt-common.git
@@ -20,6 +20,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Requires-Python: >=3.9

dbt_common-1.19/dbt_common/__about__.py

@@ -0,0 +1 @@
+version = "1.19"

{dbt_common-1.17.0 → dbt_common-1.19}/dbt_common/clients/_jinja_blocks.py

@@ -1,7 +1,7 @@
 import dataclasses
 import re
 from collections import namedtuple
-from typing import Dict, Iterator, List, Optional, Set, Union
+from typing import Callable, Dict, Iterator, List, Optional, Set, Union
 
 from dbt_common.exceptions import (
     BlockDefinitionNotAtTopError,
@@ -115,6 +115,12 @@ class PositionedMatch:
     match: Optional[re.Match]
 
 
+@dataclasses.dataclass
+class ExtractWarning:
+    warning_type: str
+    msg: str
+
+
 class TagIterator:
     def __init__(self, text: str) -> None:
         self.text: str = text
@@ -326,8 +332,13 @@ _CONTROL_FLOW_END_TAGS = {v: k for k, v in _CONTROL_FLOW_TAGS.items()}
 
 
 class BlockIterator:
-    def __init__(self, tag_iterator: TagIterator) -> None:
+    def __init__(
+        self,
+        tag_iterator: TagIterator,
+        warning_callback: Optional[Callable[[ExtractWarning], None]] = None,
+    ) -> None:
         self.tag_parser = tag_iterator
+        self.warning_callback = warning_callback
         self.current: Optional[Tag] = None
         self.stack: List[str] = []
         self.last_position: int = 0
@@ -393,6 +404,12 @@ class BlockIterator:
                     full_block=self.data[self.current.start : tag.end],
                 )
                 self.current = None
+            elif self.warning_callback:
+                self.warning_callback(
+                    ExtractWarning(
+                        "unexpected_block", f"Found unexpected '{tag.block_type_name}' block tag."
+                    )
+                )
 
         if self.current:
             linecount = self.data[: self.current.end].count("\n") + 1

{dbt_common-1.17.0 → dbt_common-1.19}/dbt_common/clients/jinja.py

@@ -38,7 +38,13 @@ from dbt_common.utils.jinja import (
     get_materialization_macro_name,
     get_test_macro_name,
 )
-from dbt_common.clients._jinja_blocks import BlockIterator, BlockData, BlockTag, TagIterator
+from dbt_common.clients._jinja_blocks import (
+    BlockIterator,
+    BlockData,
+    BlockTag,
+    TagIterator,
+    ExtractWarning,
+)
 
 from dbt_common.exceptions import (
     CompilationError,
@@ -659,6 +665,7 @@ def extract_toplevel_blocks(
     text: str,
     allowed_blocks: Optional[Set[str]] = None,
     collect_raw_data: bool = True,
+    warning_callback: Optional[Callable[[ExtractWarning], None]] = None,
 ) -> List[Union[BlockData, BlockTag]]:
     """Extract the top-level blocks with matching block types from a jinja file.
 
@@ -672,6 +679,8 @@ def extract_toplevel_blocks(
         be part of the results, as `BlockData` objects. They have a
         `block_type_name` field of `'__dbt_data'` and will never have a
         `block_name`.
+    :param warning_callback: An optional callback that will be called if there
+        are recoverable issues detected in the template.
     :return: A list of `BlockTag`s matching the allowed block types and (if
         `collect_raw_data` is `True`) `BlockData` objects.
     """
@@ -682,7 +691,7 @@ def extract_toplevel_blocks(
             return _TESTING_BLOCKS_CACHE[hash]
 
     tag_iterator = TagIterator(text)
-    blocks = BlockIterator(tag_iterator).lex_for_blocks(
+    blocks = BlockIterator(tag_iterator, warning_callback).lex_for_blocks(
         allowed_blocks=allowed_blocks, collect_raw_data=collect_raw_data
     )
 

{dbt_common-1.17.0 → dbt_common-1.19}/dbt_common/events/event_manager_client.py

@@ -8,17 +8,14 @@ _EVENT_MANAGER: IEventManager = EventManager()
 
 
 def get_event_manager() -> IEventManager:
-    global _EVENT_MANAGER
     return _EVENT_MANAGER
 
 
 def add_logger_to_manager(logger) -> None:
-    global _EVENT_MANAGER
     _EVENT_MANAGER.add_logger(logger)
 
 
 def add_callback_to_manager(callback: TCallback) -> None:
-    global _EVENT_MANAGER
     _EVENT_MANAGER.add_callback(callback)
 
 

{dbt_common-1.17.0 → dbt_common-1.19}/dbt_common/events/helpers.py

@@ -1,4 +1,4 @@
-from datetime import datetime
+from datetime import datetime, timezone
 
 
 # This converts a datetime to a json format datetime string which
@@ -9,6 +9,6 @@ def datetime_to_json_string(dt: datetime) -> str:
 
 # preformatted time stamp
 def get_json_string_utcnow() -> str:
-    ts = datetime.utcnow()
+    ts = datetime.now(timezone.utc).replace(tzinfo=None)
     ts_rfc3339 = datetime_to_json_string(ts)
     return ts_rfc3339

{dbt_common-1.17.0 → dbt_common-1.19}/dbt_common/events/logger.py

@@ -2,7 +2,7 @@ import json
 import logging
 import threading
 from dataclasses import dataclass
-from datetime import datetime
+from datetime import datetime, timezone
 from enum import Enum
 from logging.handlers import RotatingFileHandler
 from typing import Optional, TextIO, Any, Callable
@@ -156,7 +156,7 @@ class _TextLogger(_Logger):
         if _is_print_event(msg):
             # PrintEvent is a special case, we don't want to add a timestamp
             return scrubbed_msg
-        ts: str = datetime.utcnow().strftime("%H:%M:%S")
+        ts: str = datetime.now(timezone.utc).replace(tzinfo=None).strftime("%H:%M:%S")
         return f"{self._get_color_tag()}{ts}  {scrubbed_msg}"
 
     def create_debug_line(self, msg: EventMsg) -> str:

{dbt_common-1.17.0 → dbt_common-1.19}/dbt_common/events/types.proto

@@ -144,3 +144,13 @@ message PrintEventMsg {
     EventInfo info = 1;
     PrintEvent data = 2;
 }
+
+// Z053
+message RecordReplayIssue {
+    string msg = 1;
+}
+
+message RecordReplayIssueMsg {
+    EventInfo info = 1;
+    RecordReplayIssue data = 2;
+}

{dbt_common-1.17.0 → dbt_common-1.19}/dbt_common/events/types.py

@@ -118,7 +118,7 @@ class SystemReportReturnCode(DebugLevel):
 
 
 # We use events to create console output, but also think of them as a sequence of important and
-# meaningful occurrences to be used for debugging and monitoring. The Formatting event helps eases
+# meaningful occurrences to be used for debugging and monitoring. The Formatting event eases
 # the tension between these two goals by allowing empty lines, heading separators, and other
 # formatting to be written to the console, while they can be ignored for other purposes. For
 # general information that isn't simple formatting, the Note event should be used instead.
@@ -156,3 +156,13 @@ class PrintEvent(InfoLevel):
 
     def message(self) -> str:
         return self.msg
+
+
+class RecordReplayIssue(InfoLevel):
+    """General event for reporting record/replay issues at runtime."""
+
+    def code(self) -> str:
+        return "Z053"
+
+    def message(self) -> str:
+        return self.msg

{dbt_common-1.17.0 → dbt_common-1.19}/dbt_common/events/types_pb2.py

@@ -25,7 +25,7 @@ _sym_db = _symbol_database.Default()
 from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x0btypes.proto\x12\x0bproto_types\x1a\x1fgoogle/protobuf/timestamp.proto\"\x91\x02\n\tEventInfo\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0c\n\x04\x63ode\x18\x02 \x01(\t\x12\x0b\n\x03msg\x18\x03 \x01(\t\x12\r\n\x05level\x18\x04 \x01(\t\x12\x15\n\rinvocation_id\x18\x05 \x01(\t\x12\x0b\n\x03pid\x18\x06 \x01(\x05\x12\x0e\n\x06thread\x18\x07 \x01(\t\x12&\n\x02ts\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x30\n\x05\x65xtra\x18\t \x03(\x0b\x32!.proto_types.EventInfo.ExtraEntry\x12\x10\n\x08\x63\x61tegory\x18\n \x01(\t\x1a,\n\nExtraEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"6\n\x0eGenericMessage\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\"d\n\x13\x42\x65haviorChangeEvent\x12\x11\n\tflag_name\x18\x01 \x01(\t\x12\x13\n\x0b\x66lag_source\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12\x10\n\x08\x64ocs_url\x18\x04 \x01(\t\"n\n\x16\x42\x65haviorChangeEventMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12.\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32 .proto_types.BehaviorChangeEvent\"1\n\x11RetryExternalCall\x12\x0f\n\x07\x61ttempt\x18\x01 \x01(\x05\x12\x0b\n\x03max\x18\x02 \x01(\x05\"j\n\x14RetryExternalCallMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12,\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32\x1e.proto_types.RetryExternalCall\"#\n\x14RecordRetryException\x12\x0b\n\x03\x65xc\x18\x01 \x01(\t\"p\n\x17RecordRetryExceptionMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12/\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32!.proto_types.RecordRetryException\"@\n\x13SystemCouldNotWrite\x12\x0c\n\x04path\x18\x01 \x01(\t\x12\x0e\n\x06reason\x18\x02 \x01(\t\x12\x0b\n\x03\x65xc\x18\x03 \x01(\t\"n\n\x16SystemCouldNotWriteMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12.\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32 .proto_types.SystemCouldNotWrite\"!\n\x12SystemExecutingCmd\x12\x0b\n\x03\x63md\x18\x01 \x03(\t\"l\n\x15SystemExecutingCmdMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12-\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32\x1f.proto_types.SystemExecutingCmd\"\x1c\n\x0cSystemStdOut\x12\x0c\n\x04\x62msg\x18\x01 \x01(\t\"`\n\x0fSystemStdOutMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12\'\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32\x19.proto_types.SystemStdOut\"\x1c\n\x0cSystemStdErr\x12\x0c\n\x04\x62msg\x18\x01 \x01(\t\"`\n\x0fSystemStdErrMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12\'\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32\x19.proto_types.SystemStdErr\",\n\x16SystemReportReturnCode\x12\x12\n\nreturncode\x18\x01 \x01(\x05\"t\n\x19SystemReportReturnCodeMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12\x31\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32#.proto_types.SystemReportReturnCode\"\x19\n\nFormatting\x12\x0b\n\x03msg\x18\x01 \x01(\t\"\\\n\rFormattingMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12%\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32\x17.proto_types.Formatting\"\x13\n\x04Note\x12\x0b\n\x03msg\x18\x01 \x01(\t\"P\n\x07NoteMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12\x1f\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32\x11.proto_types.Note\"\x19\n\nPrintEvent\x12\x0b\n\x03msg\x18\x01 \x01(\t\"\\\n\rPrintEventMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12%\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32\x17.proto_types.PrintEventb\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x0btypes.proto\x12\x0bproto_types\x1a\x1fgoogle/protobuf/timestamp.proto\"\x91\x02\n\tEventInfo\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0c\n\x04\x63ode\x18\x02 \x01(\t\x12\x0b\n\x03msg\x18\x03 \x01(\t\x12\r\n\x05level\x18\x04 \x01(\t\x12\x15\n\rinvocation_id\x18\x05 \x01(\t\x12\x0b\n\x03pid\x18\x06 \x01(\x05\x12\x0e\n\x06thread\x18\x07 \x01(\t\x12&\n\x02ts\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x30\n\x05\x65xtra\x18\t \x03(\x0b\x32!.proto_types.EventInfo.ExtraEntry\x12\x10\n\x08\x63\x61tegory\x18\n \x01(\t\x1a,\n\nExtraEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"6\n\x0eGenericMessage\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\"d\n\x13\x42\x65haviorChangeEvent\x12\x11\n\tflag_name\x18\x01 \x01(\t\x12\x13\n\x0b\x66lag_source\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12\x10\n\x08\x64ocs_url\x18\x04 \x01(\t\"n\n\x16\x42\x65haviorChangeEventMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12.\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32 .proto_types.BehaviorChangeEvent\"1\n\x11RetryExternalCall\x12\x0f\n\x07\x61ttempt\x18\x01 \x01(\x05\x12\x0b\n\x03max\x18\x02 \x01(\x05\"j\n\x14RetryExternalCallMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12,\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32\x1e.proto_types.RetryExternalCall\"#\n\x14RecordRetryException\x12\x0b\n\x03\x65xc\x18\x01 \x01(\t\"p\n\x17RecordRetryExceptionMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12/\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32!.proto_types.RecordRetryException\"@\n\x13SystemCouldNotWrite\x12\x0c\n\x04path\x18\x01 \x01(\t\x12\x0e\n\x06reason\x18\x02 \x01(\t\x12\x0b\n\x03\x65xc\x18\x03 \x01(\t\"n\n\x16SystemCouldNotWriteMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12.\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32 .proto_types.SystemCouldNotWrite\"!\n\x12SystemExecutingCmd\x12\x0b\n\x03\x63md\x18\x01 \x03(\t\"l\n\x15SystemExecutingCmdMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12-\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32\x1f.proto_types.SystemExecutingCmd\"\x1c\n\x0cSystemStdOut\x12\x0c\n\x04\x62msg\x18\x01 \x01(\t\"`\n\x0fSystemStdOutMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12\'\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32\x19.proto_types.SystemStdOut\"\x1c\n\x0cSystemStdErr\x12\x0c\n\x04\x62msg\x18\x01 \x01(\t\"`\n\x0fSystemStdErrMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12\'\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32\x19.proto_types.SystemStdErr\",\n\x16SystemReportReturnCode\x12\x12\n\nreturncode\x18\x01 \x01(\x05\"t\n\x19SystemReportReturnCodeMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12\x31\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32#.proto_types.SystemReportReturnCode\"\x19\n\nFormatting\x12\x0b\n\x03msg\x18\x01 \x01(\t\"\\\n\rFormattingMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12%\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32\x17.proto_types.Formatting\"\x13\n\x04Note\x12\x0b\n\x03msg\x18\x01 \x01(\t\"P\n\x07NoteMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12\x1f\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32\x11.proto_types.Note\"\x19\n\nPrintEvent\x12\x0b\n\x03msg\x18\x01 \x01(\t\"\\\n\rPrintEventMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12%\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32\x17.proto_types.PrintEvent\" \n\x11RecordReplayIssue\x12\x0b\n\x03msg\x18\x01 \x01(\t\"j\n\x14RecordReplayIssueMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12,\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32\x1e.proto_types.RecordReplayIssueb\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -84,4 +84,8 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['_PRINTEVENT']._serialized_end=1909
   _globals['_PRINTEVENTMSG']._serialized_start=1911
   _globals['_PRINTEVENTMSG']._serialized_end=2003
+  _globals['_RECORDREPLAYISSUE']._serialized_start=2005
+  _globals['_RECORDREPLAYISSUE']._serialized_end=2037
+  _globals['_RECORDREPLAYISSUEMSG']._serialized_start=2039
+  _globals['_RECORDREPLAYISSUEMSG']._serialized_end=2145
 # @@protoc_insertion_point(module_scope)

dbt_common-1.19/dbt_common/helper_types.py

@@ -0,0 +1,270 @@
+# never name this package "types", or mypy will crash in ugly ways
+
+# necessary for annotating constructors
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import Tuple, AbstractSet, Union
+from typing import Callable, cast, Generic, Optional, TypeVar, List, NewType, Set
+
+from dbt_common.dataclass_schema import (
+    dbtClassMixin,
+    ValidationError,
+    StrEnum,
+)
+from dbt_common.events.base_types import BaseEvent
+
+Port = NewType("Port", int)
+
+
+class NVEnum(StrEnum):
+    novalue = "novalue"
+
+    def __eq__(self, other) -> bool:
+        return isinstance(other, NVEnum)
+
+
+@dataclass
+class NoValue(dbtClassMixin):
+    """Sometimes, you want a way to say none that isn't None!"""
+
+    novalue: NVEnum = field(default_factory=lambda: NVEnum.novalue)
+
+
+@dataclass
+class IncludeExclude(dbtClassMixin):
+    INCLUDE_ALL = ("all", "*")
+
+    include: Union[str, List[str]]
+    exclude: List[str] = field(default_factory=list)
+
+    def __post_init__(self):
+        if isinstance(self.include, str) and self.include not in self.INCLUDE_ALL:
+            raise ValidationError(
+                f"include must be one of {self.INCLUDE_ALL} or a list of strings"
+            )
+
+        if self.exclude and self.include not in self.INCLUDE_ALL:
+            raise ValidationError(
+                f"exclude can only be specified if include is one of {self.INCLUDE_ALL}"
+            )
+
+        if isinstance(self.include, list):
+            self._validate_items(self.include)
+
+        if isinstance(self.exclude, list):
+            self._validate_items(self.exclude)
+
+    def includes(self, item_name: str) -> bool:
+        return (
+            item_name in self.include or self.include in self.INCLUDE_ALL
+        ) and item_name not in self.exclude
+
+    def _validate_items(self, items: List[str]) -> None:
+        pass
+
+
+class WarnErrorOptions(IncludeExclude):
+    """
+    This class is used to configure the behavior of the warn_error feature (now part of fire_event).
+
+    include: "all", "*", or a list of event names.
+    exclude: a list of event names.
+    silence: a list of event names.
+    valid_error_names: a set of event names that can be named in include, exclude, and silence.
+
+    In a hierarchy of configuration, the following rules apply:
+    1. named > Deprecations > "all"/"*"
+    2. silence > exclude > include
+    3. (1) > (2)
+    """
+
+    DEPRECATIONS = "Deprecations"
+
+    def __init__(
+        self,
+        include: Union[str, List[str]],
+        exclude: Optional[List[str]] = None,
+        valid_error_names: Optional[Set[str]] = None,
+        silence: Optional[List[str]] = None,
+    ):
+        self.silence = silence or []
+        self._valid_error_names: Set[str] = valid_error_names or set()
+        self._valid_error_names.add(self.DEPRECATIONS)
+        super().__init__(include=include, exclude=(exclude or []))
+
+    def __post_init__(self):
+        if isinstance(self.include, str) and self.include not in self.INCLUDE_ALL:
+            raise ValidationError(
+                f"include must be one of {self.INCLUDE_ALL} or a list of strings"
+            )
+
+        # To specify exclude, either `include` must be "all" or "deprecations" must be
+        # in `include` or `silence`.
+        if self.exclude and not (
+            self.include in self.INCLUDE_ALL
+            or self.DEPRECATIONS in self.include
+            or self.DEPRECATIONS in self.silence
+        ):
+            raise ValidationError(
+                f"exclude can only be specified if include is one of {self.INCLUDE_ALL} or "
+                f"{self.DEPRECATIONS} is in include or silence."
+            )
+
+        if isinstance(self.include, list):
+            self._validate_items(self.include)
+
+        if isinstance(self.exclude, list):
+            self._validate_items(self.exclude)
+
+        if isinstance(self.silence, list):
+            self._validate_items(self.silence)
+
+    def _includes_all(self) -> bool:
+        """Is `*` or `all` set as include?"""
+        return self.include in self.INCLUDE_ALL
+
+    def _named_inclusion(self, item_name: str) -> bool:
+        """Is the item_name named in the include list?"""
+        return item_name in self.include
+
+    def _named_exclusion(self, item_name: str) -> bool:
+        """Is the item_name named in the exclude list?"""
+        return item_name in self.exclude
+
+    def _named_silence(self, item_name: str) -> bool:
+        """Is the item_name named in the silence list?"""
+        return item_name in self.silence
+
+    def _include_as_deprecation(self, event: Optional[BaseEvent]) -> bool:
+        """Is event included as a deprecation?"""
+        return (
+            event is not None
+            and event.code().startswith("D")
+            and self.DEPRECATIONS in self.include
+        )
+
+    def _exclude_as_deprecation(self, event: Optional[BaseEvent]) -> bool:
+        """Is event excluded as a deprecation?"""
+        return (
+            event is not None
+            and event.code().startswith("D")
+            and self.DEPRECATIONS in self.exclude
+        )
+
+    def _silence_as_deprecation(self, event: Optional[BaseEvent]) -> bool:
+        """Is event silenced as a deprecation?"""
+        return (
+            event is not None
+            and event.code().startswith("D")
+            and self.DEPRECATIONS in self.silence
+        )
+
+    def includes(self, item_name: Union[str, BaseEvent]) -> bool:
+        """Is the event included?
+
+        An event included if any of the following are true:
+        - The event is named in `include` and not named in `exclude` or `silence`
+        - "*" or "all" is specified for `include`, and the event is not named in `exclude` or `silence`
+        - The event is a deprecation, "deprecations" is in `include`, and the event is not named in `exclude` or `silence`
+          nor is "deprecations" in `exclude` or `silence`
+        """
+        # Setup based on item_name type
+        if isinstance(item_name, str):
+            event_name = item_name
+            event = None
+        else:
+            event_name = type(item_name).__name__
+            event = item_name
+
+        # Pre-compute checks that will be used multiple times
+        named_elsewhere = self._named_exclusion(event_name) or self._named_silence(event_name)
+        deprecation_elsewhere = self._exclude_as_deprecation(
+            event
+        ) or self._silence_as_deprecation(event)
+
+        # Calculate result
+        if self._named_inclusion(event_name) and not named_elsewhere:
+            return True
+        elif self._include_as_deprecation(event) and not (
+            named_elsewhere or deprecation_elsewhere
+        ):
+            return True
+        elif self._includes_all() and not (named_elsewhere or deprecation_elsewhere):
+            return True
+        else:
+            return False
+
+    def silenced(self, item_name: Union[str, BaseEvent]) -> bool:
+        """Is the event silenced?
+
+        An event silenced if any of the following are true:
+        - The event is named in `silence`
+        - "Deprecations" is in `silence` and the event is not named in `include` or `exclude`
+        """
+        # Setup based on item_name type
+        if isinstance(item_name, str):
+            event_name = item_name
+            event = None
+        else:
+            event_name = type(item_name).__name__
+            event = item_name
+
+        # Pre-compute checks that will be used multiple times
+        named_elsewhere = self._named_inclusion(event_name) or self._named_exclusion(event_name)
+
+        # Calculate result
+        if self._named_silence(event_name):
+            return True
+        elif self._silence_as_deprecation(event) and not named_elsewhere:
+            return True
+        else:
+            return False
+
+    def _validate_items(self, items: List[str]):
+        for item in items:
+            if item not in self._valid_error_names:
+                raise ValidationError(f"{item} is not a valid dbt error name.")
+
+
+FQNPath = Tuple[str, ...]
+PathSet = AbstractSet[FQNPath]
+
+T = TypeVar("T")
+
+
+# A data type for representing lazily evaluated values.
+#
+# usage:
+# x = Lazy.defer(lambda: expensive_fn())
+# y = x.force()
+#
+# inspired by the purescript data type
+# https://pursuit.purescript.org/packages/purescript-lazy/5.0.0/docs/Data.Lazy
+@dataclass
+class Lazy(Generic[T]):
+    _f: Callable[[], T]
+    memo: Optional[T] = None
+
+    # constructor for lazy values
+    @classmethod
+    def defer(cls, f: Callable[[], T]) -> Lazy[T]:
+        return Lazy(f)
+
+    # workaround for open mypy issue:
+    # https://github.com/python/mypy/issues/6910
+    def _typed_eval_f(self) -> T:
+        return cast(Callable[[], T], getattr(self, "_f"))()
+
+    # evaluates the function if the value has not been memoized already
+    def force(self) -> T:
+        if self.memo is None:
+            self.memo = self._typed_eval_f()
+        return self.memo
+
+
+# This class is used in to_target_dict, so that accesses to missing keys
+# will return an empty string instead of Undefined
+class DictDefaultEmptyStr(dict):
+    def __getitem__(self, key):
+        return dict.get(self, key, "")

{dbt_common-1.17.0 → dbt_common-1.19}/dbt_common/record.py

@@ -457,6 +457,13 @@ def _record_function_inner(
     index_on_thread_id,
     func_to_record,
 ):
+    recorded_types = get_record_types_from_env()
+    if recorded_types is not None and not (
+        getattr(record_type, "__name__", record_type) in recorded_types
+        or getattr(record_type, "group", group) in recorded_types
+    ):
+        return func_to_record
+
     if isinstance(record_type, str):
         return_type = inspect.signature(func_to_record).return_annotation
         fields = _get_arg_fields(inspect.getfullargspec(func_to_record), method)

{dbt_common-1.17.0 → dbt_common-1.19}/pyproject.toml

@@ -23,6 +23,7 @@ classifiers = [
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
   "Programming Language :: Python :: Implementation :: CPython",
   "Programming Language :: Python :: Implementation :: PyPy",
 ]

dbt_common-1.17.0/dbt_common/__about__.py

@@ -1 +0,0 @@
-version = "1.17.0"

dbt_common-1.17.0/dbt_common/helper_types.py

@@ -1,134 +0,0 @@
-# never name this package "types", or mypy will crash in ugly ways
-
-# necessary for annotating constructors
-from __future__ import annotations
-
-from dataclasses import dataclass, field
-from typing import Tuple, AbstractSet, Union
-from typing import Callable, cast, Generic, Optional, TypeVar, List, NewType, Set
-
-from dbt_common.dataclass_schema import (
-    dbtClassMixin,
-    ValidationError,
-    StrEnum,
-)
-
-Port = NewType("Port", int)
-
-
-class NVEnum(StrEnum):
-    novalue = "novalue"
-
-    def __eq__(self, other) -> bool:
-        return isinstance(other, NVEnum)
-
-
-@dataclass
-class NoValue(dbtClassMixin):
-    """Sometimes, you want a way to say none that isn't None!"""
-
-    novalue: NVEnum = field(default_factory=lambda: NVEnum.novalue)
-
-
-@dataclass
-class IncludeExclude(dbtClassMixin):
-    INCLUDE_ALL = ("all", "*")
-
-    include: Union[str, List[str]]
-    exclude: List[str] = field(default_factory=list)
-
-    def __post_init__(self):
-        if isinstance(self.include, str) and self.include not in self.INCLUDE_ALL:
-            raise ValidationError(
-                f"include must be one of {self.INCLUDE_ALL} or a list of strings"
-            )
-
-        if self.exclude and self.include not in self.INCLUDE_ALL:
-            raise ValidationError(
-                f"exclude can only be specified if include is one of {self.INCLUDE_ALL}"
-            )
-
-        if isinstance(self.include, list):
-            self._validate_items(self.include)
-
-        if isinstance(self.exclude, list):
-            self._validate_items(self.exclude)
-
-    def includes(self, item_name: str) -> bool:
-        return (
-            item_name in self.include or self.include in self.INCLUDE_ALL
-        ) and item_name not in self.exclude
-
-    def _validate_items(self, items: List[str]) -> None:
-        pass
-
-
-class WarnErrorOptions(IncludeExclude):
-    def __init__(
-        self,
-        include: Union[str, List[str]],
-        exclude: Optional[List[str]] = None,
-        valid_error_names: Optional[Set[str]] = None,
-        silence: Optional[List[str]] = None,
-    ):
-        self.silence = silence or []
-        self._valid_error_names: Set[str] = valid_error_names or set()
-        super().__init__(include=include, exclude=(exclude or []))
-
-    def __post_init__(self):
-        super().__post_init__()
-        self._validate_items(self.silence)
-
-    def includes(self, item_name: str) -> bool:
-        return super().includes(item_name) and not self.silenced(item_name)
-
-    def silenced(self, item_name: str) -> bool:
-        return item_name in self.silence
-
-    def _validate_items(self, items: List[str]):
-        for item in items:
-            if item not in self._valid_error_names:
-                raise ValidationError(f"{item} is not a valid dbt error name.")
-
-
-FQNPath = Tuple[str, ...]
-PathSet = AbstractSet[FQNPath]
-
-T = TypeVar("T")
-
-
-# A data type for representing lazily evaluated values.
-#
-# usage:
-# x = Lazy.defer(lambda: expensive_fn())
-# y = x.force()
-#
-# inspired by the purescript data type
-# https://pursuit.purescript.org/packages/purescript-lazy/5.0.0/docs/Data.Lazy
-@dataclass
-class Lazy(Generic[T]):
-    _f: Callable[[], T]
-    memo: Optional[T] = None
-
-    # constructor for lazy values
-    @classmethod
-    def defer(cls, f: Callable[[], T]) -> Lazy[T]:
-        return Lazy(f)
-
-    # workaround for open mypy issue:
-    # https://github.com/python/mypy/issues/6910
-    def _typed_eval_f(self) -> T:
-        return cast(Callable[[], T], getattr(self, "_f"))()
-
-    # evaluates the function if the value has not been memoized already
-    def force(self) -> T:
-        if self.memo is None:
-            self.memo = self._typed_eval_f()
-        return self.memo
-
-
-# This class is used in to_target_dict, so that accesses to missing keys
-# will return an empty string instead of Undefined
-class DictDefaultEmptyStr(dict):
-    def __getitem__(self, key):
-        return dict.get(self, key, "")