dbt-common 1.7.0__py3-none-any.whl → 1.8.0__py3-none-any.whl

dbt_common/__about__.py

@@ -1 +1 @@
-version = "1.7.0"
+version = "1.8.0"

dbt_common/behavior_flags.py

@@ -0,0 +1,125 @@
+import inspect
+from typing import Any, Dict, List, TypedDict
+
+try:
+    from typing import NotRequired
+except ImportError:
+    # NotRequired was introduced in Python 3.11
+    # This is the suggested way to implement a TypedDict with optional arguments
+    from typing import Optional as NotRequired
+
+from dbt_common.events.functions import fire_event
+from dbt_common.events.types import BehaviorDeprecationEvent
+from dbt_common.exceptions import CompilationError
+
+
+class BehaviorFlag(TypedDict):
+    """
+    Configuration used to create a BehaviorFlagRendered instance
+
+    Args:
+        name: the name of the behavior flag
+        default: default setting, starts as False, becomes True after a bake-in period
+        deprecation_version: the version when the default will change to True
+        deprecation_message: an additional message to send when the flag evaluates to False
+        docs_url: the url to the relevant docs on docs.getdbt.com
+    """
+
+    name: str
+    default: bool
+    source: NotRequired[str]
+    deprecation_version: NotRequired[str]
+    deprecation_message: NotRequired[str]
+    docs_url: NotRequired[str]
+
+
+class BehaviorFlagRendered:
+    """
+    A rendered behavior flag that gets used throughout dbt packages
+
+    Args:
+        flag: the configuration for the behavior flag
+        user_overrides: a set of user settings, one of which may be an override on this behavior flag
+    """
+
+    def __init__(self, flag: BehaviorFlag, user_overrides: Dict[str, Any]) -> None:
+        self.name = flag["name"]
+        self.setting = user_overrides.get(flag["name"], flag["default"])
+        self.deprecation_event = self._deprecation_event(flag)
+
+    @property
+    def setting(self) -> bool:
+        if self._setting is False:
+            fire_event(self.deprecation_event)
+        return self._setting
+
+    @setting.setter
+    def setting(self, value: bool) -> None:
+        self._setting = value
+
+    @property
+    def no_warn(self) -> bool:
+        return self._setting
+
+    def _deprecation_event(self, flag: BehaviorFlag) -> BehaviorDeprecationEvent:
+        return BehaviorDeprecationEvent(
+            flag_name=flag["name"],
+            flag_source=flag.get("source", self._default_source()),
+            deprecation_version=flag.get("deprecation_version"),
+            deprecation_message=flag.get("deprecation_message"),
+            docs_url=flag.get("docs_url"),
+        )
+
+    @staticmethod
+    def _default_source() -> str:
+        """
+        If the maintainer did not provide a source, default to the module that called this class.
+        For adapters, this will likely be `dbt.adapters.<foo>.impl` for `dbt-foo`.
+        """
+        for frame in inspect.stack():
+            if module := inspect.getmodule(frame[0]):
+                if module.__name__ != __name__:
+                    return module.__name__
+        return "Unknown"
+
+    def __bool__(self) -> bool:
+        return self.setting
+
+
+class Behavior:
+    """
+    A collection of behavior flags
+
+    This is effectively a dictionary that supports dot notation for easy reference, e.g.:
+        ```python
+        if adapter.behavior.my_flag:
+            ...
+
+        if adapter.behavior.my_flag.no_warn:  # this will not fire the deprecation event
+            ...
+        ```
+        ```jinja
+        {% if adapter.behavior.my_flag %}
+            ...
+        {% endif %}
+
+        {% if adapter.behavior.my_flag.no_warn %}  {# this will not fire the deprecation event #}
+            ...
+        {% endif %}
+        ```
+
+    Args:
+        flags: a list of configurations, one for each behavior flag
+        user_overrides: a set of user settings, which may include overrides on one or more of the behavior flags
+    """
+
+    _flags: List[BehaviorFlagRendered]
+
+    def __init__(self, flags: List[BehaviorFlag], user_overrides: Dict[str, Any]) -> None:
+        self._flags = [BehaviorFlagRendered(flag, user_overrides) for flag in flags]
+
+    def __getattr__(self, name: str) -> BehaviorFlagRendered:
+        for flag in self._flags:
+            if flag.name == name:
+                return flag
+        raise CompilationError(f"The flag {name} has not be registered.")

dbt_common/clients/agate_helper.py

@@ -1,6 +1,6 @@
 from codecs import BOM_UTF8
 
-import agate  # type: ignore
+import agate
 import datetime
 import isodate
 import json
@@ -149,7 +149,7 @@ def as_matrix(table):
     return [r.values() for r in table.rows.values()]
 
 
-def from_csv(abspath, text_columns, delimiter=","):
+def from_csv(abspath, text_columns, delimiter=",") -> agate.Table:
     type_tester = build_type_tester(text_columns=text_columns)
     with open(abspath, encoding="utf-8") as fp:
         if fp.read(1) != BOM:

dbt_common/clients/jinja.py

@@ -9,12 +9,12 @@ from itertools import chain, islice
 from typing import Any, Callable, Dict, Iterator, List, Mapping, Optional, Union, Set, Type
 from typing_extensions import Protocol
 
-import jinja2  # type: ignore
-import jinja2.ext  # type: ignore
-import jinja2.nativetypes  # type: ignore
-import jinja2.nodes  # type: ignore
-import jinja2.parser  # type: ignore
-import jinja2.sandbox  # type: ignore
+import jinja2
+import jinja2.ext
+import jinja2.nativetypes
+import jinja2.nodes
+import jinja2.parser
+import jinja2.sandbox
 
 from dbt_common.tests import test_caching_enabled
 from dbt_common.utils.jinja import (
@@ -124,6 +124,7 @@ class MacroFuzzTemplate(jinja2.nativetypes.NativeTemplate):
                 "shared or locals parameters."
             )
 
+        vars = {} if vars is None else vars
         parent = ChainMap(vars, self.globals) if self.globals else vars
 
         return self.environment.context_class(self.environment, parent, self.name, self.blocks)
@@ -544,6 +545,7 @@ _TESTING_BLOCKS_CACHE: Dict[int, List[Union[BlockData, BlockTag]]] = {}
 
 def _get_blocks_hash(text: str, allowed_blocks: Optional[Set[str]], collect_raw_data: bool) -> int:
     """Provides a hash function over the arguments to extract_toplevel_blocks, in order to support caching."""
+    allowed_blocks = allowed_blocks or set()
     allowed_tuple = tuple(sorted(allowed_blocks) or [])
     return text.__hash__() + allowed_tuple.__hash__() + collect_raw_data.__hash__()
 

dbt_common/clients/system.py

@@ -52,6 +52,7 @@ class FindMatchingParams:
     root_path: str
     relative_paths_to_search: List[str]
     file_pattern: str
+
     # ignore_spec: Optional[PathSpec] = None
 
     def __init__(
@@ -608,11 +609,36 @@ def rename(from_path: str, to_path: str, force: bool = False) -> None:
     shutil.move(from_path, to_path)
 
 
+def safe_extract(tarball: tarfile.TarFile, path: str = ".") -> None:
+    """
+    Fix for CWE-22: Improper Limitation of a Pathname to a Restricted Directory ('Path Traversal')
+    Solution copied from https://github.com/mindsdb/mindsdb/blob/main/mindsdb/utilities/fs.py
+    """
+
+    def _is_within_directory(directory, target):
+        abs_directory = os.path.abspath(directory)
+        abs_target = os.path.abspath(target)
+        prefix = os.path.commonprefix([abs_directory, abs_target])
+        return prefix == abs_directory
+
+    # for py >= 3.12
+    if hasattr(tarball, "data_filter"):
+        tarball.extractall(path, filter="data")
+    else:
+        members = tarball.getmembers()
+        for member in members:
+            member_path = os.path.join(path, member.name)
+            if not _is_within_directory(path, member_path):
+                raise tarfile.OutsideDestinationError(member, path)
+
+        tarball.extractall(path, members=members)
+
+
 def untar_package(tar_path: str, dest_dir: str, rename_to: Optional[str] = None) -> None:
     tar_path = convert_path(tar_path)
     tar_dir_name = None
     with tarfile.open(tar_path, "r:gz") as tarball:
-        tarball.extractall(dest_dir)
+        safe_extract(tarball, dest_dir)
         tar_dir_name = os.path.commonprefix(tarball.getnames())
     if rename_to:
         downloaded_path = os.path.join(dest_dir, tar_dir_name)

dbt_common/context.py

@@ -6,7 +6,7 @@ from dbt_common.constants import PRIVATE_ENV_PREFIX, SECRET_ENV_PREFIX
 from dbt_common.record import Recorder
 
 
-class CaseInsensitiveMapping(Mapping):
+class CaseInsensitiveMapping(Mapping[str, str]):
     def __init__(self, env: Mapping[str, str]):
         self._env = {k.casefold(): (k, v) for k, v in env.items()}
 
@@ -65,7 +65,7 @@ _INVOCATION_CONTEXT_VAR: ContextVar[InvocationContext] = ContextVar("DBT_INVOCAT
 
 
 def reliably_get_invocation_var() -> ContextVar[InvocationContext]:
-    invocation_var: Optional[ContextVar] = next(
+    invocation_var: Optional[ContextVar[InvocationContext]] = next(
         (cv for cv in copy_context() if cv.name == _INVOCATION_CONTEXT_VAR.name), None
     )
 

dbt_common/contracts/config/base.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 from dataclasses import dataclass, Field
 
 from itertools import chain
-from typing import Callable, Dict, Any, List, TypeVar, Type
+from typing import Any, Callable, Dict, Iterator, List, Type, TypeVar
 
 from dbt_common.contracts.config.metadata import Metadata
 from dbt_common.exceptions import CompilationError, DbtInternalError
@@ -17,11 +17,11 @@ T = TypeVar("T", bound="BaseConfig")
 @dataclass
 class BaseConfig(AdditionalPropertiesAllowed, Replaceable):
     # enable syntax like: config['key']
-    def __getitem__(self, key):
+    def __getitem__(self, key: str) -> Any:
         return self.get(key)
 
     # like doing 'get' on a dictionary
-    def get(self, key, default=None):
+    def get(self, key: str, default: Any = None) -> Any:
         if hasattr(self, key):
             return getattr(self, key)
         elif key in self._extra:
@@ -30,13 +30,13 @@ class BaseConfig(AdditionalPropertiesAllowed, Replaceable):
             return default
 
     # enable syntax like: config['key'] = value
-    def __setitem__(self, key, value):
+    def __setitem__(self, key: str, value) -> None:
         if hasattr(self, key):
             setattr(self, key, value)
         else:
             self._extra[key] = value
 
-    def __delitem__(self, key):
+    def __delitem__(self, key: str) -> None:
         if hasattr(self, key):
             msg = (
                 'Error, tried to delete config key "{}": Cannot delete ' "built-in keys"
@@ -45,7 +45,7 @@ class BaseConfig(AdditionalPropertiesAllowed, Replaceable):
         else:
             del self._extra[key]
 
-    def _content_iterator(self, include_condition: Callable[[Field], bool]):
+    def _content_iterator(self, include_condition: Callable[[Field[Any]], bool]) -> Iterator[str]:
         seen = set()
         for fld, _ in self._get_fields():
             seen.add(fld.name)
@@ -57,10 +57,10 @@ class BaseConfig(AdditionalPropertiesAllowed, Replaceable):
                 seen.add(key)
                 yield key
 
-    def __iter__(self):
+    def __iter__(self) -> Iterator[str]:
         yield from self._content_iterator(include_condition=lambda f: True)
 
-    def __len__(self):
+    def __len__(self) -> int:
         return len(self._get_fields()) + len(self._extra)
 
     @staticmethod
@@ -76,7 +76,7 @@ class BaseConfig(AdditionalPropertiesAllowed, Replaceable):
         elif key in unrendered and key not in other:
             return False
         else:
-            return unrendered[key] == other[key]
+            return bool(unrendered[key] == other[key])
 
     @classmethod
     def same_contents(cls, unrendered: Dict[str, Any], other: Dict[str, Any]) -> bool:
@@ -203,11 +203,11 @@ class CompareBehavior(Metadata):
         return "compare"
 
     @classmethod
-    def should_include(cls, fld: Field) -> bool:
+    def should_include(cls, fld: Field[Any]) -> bool:
         return cls.from_field(fld) == cls.Include
 
 
-def _listify(value: Any) -> List:
+def _listify(value: Any) -> List[Any]:
     if isinstance(value, list):
         return value[:]
     else:
@@ -221,7 +221,7 @@ def _merge_field_value(
     merge_behavior: MergeBehavior,
     self_value: Any,
     other_value: Any,
-):
+) -> Any:
     if merge_behavior == MergeBehavior.Clobber:
         return other_value
     elif merge_behavior == MergeBehavior.Append:

dbt_common/contracts/util.py

@@ -1,21 +1,27 @@
 import dataclasses
+from typing import Any, TypeVar
+
+_R = TypeVar("_R", bound="Replaceable")
 
 
 # TODO: remove from dbt_common.contracts.util:: Replaceable + references
 class Replaceable:
-    def replace(self, **kwargs):
-        return dataclasses.replace(self, **kwargs)
+    def replace(self: _R, **kwargs: Any) -> _R:
+        return dataclasses.replace(self, **kwargs)  # type: ignore
+
+
+_M = TypeVar("_M", bound="Mergeable")
 
 
 class Mergeable(Replaceable):
-    def merged(self, *args):
+    def merged(self: _M, *args: Any) -> _M:
         """Perform a shallow merge, where the last non-None write wins. This is
         intended to merge dataclasses that are a collection of optional values.
         """
         replacements = {}
         cls = type(self)
         for arg in args:
-            for field in dataclasses.fields(cls):
+            for field in dataclasses.fields(cls):  # type: ignore
                 value = getattr(arg, field.name)
                 if value is not None:
                     replacements[field.name] = value

dbt_common/dataclass_schema.py

@@ -1,4 +1,4 @@
-from typing import Any, cast, ClassVar, Dict, get_type_hints, List, Optional, Tuple
+from typing import Any, ClassVar, Dict, get_type_hints, List, Optional, Tuple, Union
 import re
 import jsonschema
 from dataclasses import fields, Field
@@ -6,7 +6,6 @@ from enum import Enum
 from datetime import datetime
 from dateutil.parser import parse
 
-# type: ignore
 from mashumaro.config import (
     TO_DICT_ADD_OMIT_NONE_FLAG,
     ADD_SERIALIZATION_CONTEXT,
@@ -33,8 +32,8 @@ class DateTimeSerialization(SerializationStrategy):
             out += "Z"
         return out
 
-    def deserialize(self, value) -> datetime:
-        return value if isinstance(value, datetime) else parse(cast(str, value))
+    def deserialize(self, value: Union[datetime, str]) -> datetime:
+        return value if isinstance(value, datetime) else parse(value)
 
 
 class dbtMashConfig(MashBaseConfig):
@@ -92,7 +91,7 @@ class dbtClassMixin(DataClassMessagePackMixin):
         return json_schema
 
     @classmethod
-    def validate(cls, data):
+    def validate(cls, data: Any) -> None:
         json_schema = cls.json_schema()
         validator = jsonschema.Draft7Validator(json_schema)
         error = next(iter(validator.iter_errors(data)), None)

dbt_common/events/contextvars.py

@@ -22,7 +22,7 @@ def get_contextvars(prefix: str) -> Dict[str, Any]:
     return rv
 
 
-def get_node_info():
+def get_node_info() -> Dict[str, Any]:
     cvars = get_contextvars(LOG_PREFIX)
     if "node_info" in cvars:
         return cvars["node_info"]

dbt_common/events/types.proto

@@ -23,6 +23,22 @@ message GenericMessage {
     EventInfo info = 1;
 }
 
+// D - Deprecations
+
+// D018
+message BehaviorDeprecationEvent {
+    string flag_name = 1;
+    string flag_source = 2;
+    string deprecation_version = 3;
+    string deprecation_message = 4;
+    string docs_url = 5;
+}
+
+message BehaviorDeprecationEventMsg {
+    EventInfo info = 1;
+    BehaviorDeprecationEvent data = 2;
+}
+
 // M - Deps generation
 
 // M020

dbt_common/events/types.py

@@ -1,7 +1,11 @@
+from typing import Optional
+
 from dbt_common.events.base_types import (
     DebugLevel,
     InfoLevel,
+    WarnLevel,
 )
+from dbt_common.ui import warning_tag
 
 
 # The classes in this file represent the data necessary to describe a
@@ -28,6 +32,41 @@ from dbt_common.events.base_types import (
 #
 # The basic idea is that event codes roughly translate to the natural order of running a dbt task
 
+
+# =======================================================
+# D - Deprecations
+# =======================================================
+
+
+class BehaviorDeprecationEvent(WarnLevel):
+    flag_name: str
+    flag_source: str
+    deprecation_version: Optional[str]
+    deprecation_message: Optional[str]
+    docs_url: Optional[str]
+
+    def code(self) -> str:
+        return "D018"
+
+    def message(self) -> str:
+        msg = f"The legacy behavior controlled by `{self.flag_name}` is deprecated.\n"
+
+        if self.deprecation_version:
+            msg = (
+                f"The legacy behavior is expected to be retired in `{self.deprecation_version}`.\n"
+            )
+
+        msg += f"The new behavior can be turned on by setting `flags.{self.flag_name}` to `True` in `dbt_project.yml`.\n"
+
+        if self.deprecation_message:
+            msg += f"{self.deprecation_message}.\n"
+
+        docs_url = self.docs_url or f"https://docs.getdbt.com/search?q={self.flag_name}"
+        msg += f"Visit {docs_url} for more information."
+
+        return warning_tag(msg)
+
+
 # =======================================================
 # M - Deps generation
 # =======================================================

dbt_common/events/types_pb2.py

@@ -1,7 +1,7 @@
 # -*- coding: utf-8 -*-
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: types.proto
-# Protobuf Python Version: 5.26.1
+# Protobuf Python Version: 4.25.2
 """Generated protocol buffer code."""
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import descriptor_pool as _descriptor_pool
@@ -15,14 +15,14 @@ _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\"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\"\x8e\x01\n\x18\x42\x65haviorDeprecationEvent\x12\x11\n\tflag_name\x18\x01 \x01(\t\x12\x13\n\x0b\x66lag_source\x18\x02 \x01(\t\x12\x1b\n\x13\x64\x65precation_version\x18\x03 \x01(\t\x12\x1b\n\x13\x64\x65precation_message\x18\x04 \x01(\t\x12\x10\n\x08\x64ocs_url\x18\x05 \x01(\t\"x\n\x1b\x42\x65haviorDeprecationEventMsg\x12$\n\x04info\x18\x01 \x01(\x0b\x32\x16.proto_types.EventInfo\x12\x33\n\x04\x64\x61ta\x18\x02 \x01(\x0b\x32%.proto_types.BehaviorDeprecationEvent\"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')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
 _builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'types_pb2', _globals)
-if not _descriptor._USE_C_DESCRIPTORS:
-  DESCRIPTOR._loaded_options = None
-  _globals['_EVENTINFO_EXTRAENTRY']._loaded_options = None
+if _descriptor._USE_C_DESCRIPTORS == False:
+  DESCRIPTOR._options = None
+  _globals['_EVENTINFO_EXTRAENTRY']._options = None
   _globals['_EVENTINFO_EXTRAENTRY']._serialized_options = b'8\001'
   _globals['_EVENTINFO']._serialized_start=62
   _globals['_EVENTINFO']._serialized_end=335
@@ -30,44 +30,48 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['_EVENTINFO_EXTRAENTRY']._serialized_end=335
   _globals['_GENERICMESSAGE']._serialized_start=337
   _globals['_GENERICMESSAGE']._serialized_end=391
-  _globals['_RETRYEXTERNALCALL']._serialized_start=393
-  _globals['_RETRYEXTERNALCALL']._serialized_end=442
-  _globals['_RETRYEXTERNALCALLMSG']._serialized_start=444
-  _globals['_RETRYEXTERNALCALLMSG']._serialized_end=550
-  _globals['_RECORDRETRYEXCEPTION']._serialized_start=552
-  _globals['_RECORDRETRYEXCEPTION']._serialized_end=587
-  _globals['_RECORDRETRYEXCEPTIONMSG']._serialized_start=589
-  _globals['_RECORDRETRYEXCEPTIONMSG']._serialized_end=701
-  _globals['_SYSTEMCOULDNOTWRITE']._serialized_start=703
-  _globals['_SYSTEMCOULDNOTWRITE']._serialized_end=767
-  _globals['_SYSTEMCOULDNOTWRITEMSG']._serialized_start=769
-  _globals['_SYSTEMCOULDNOTWRITEMSG']._serialized_end=879
-  _globals['_SYSTEMEXECUTINGCMD']._serialized_start=881
-  _globals['_SYSTEMEXECUTINGCMD']._serialized_end=914
-  _globals['_SYSTEMEXECUTINGCMDMSG']._serialized_start=916
-  _globals['_SYSTEMEXECUTINGCMDMSG']._serialized_end=1024
-  _globals['_SYSTEMSTDOUT']._serialized_start=1026
-  _globals['_SYSTEMSTDOUT']._serialized_end=1054
-  _globals['_SYSTEMSTDOUTMSG']._serialized_start=1056
-  _globals['_SYSTEMSTDOUTMSG']._serialized_end=1152
-  _globals['_SYSTEMSTDERR']._serialized_start=1154
-  _globals['_SYSTEMSTDERR']._serialized_end=1182
-  _globals['_SYSTEMSTDERRMSG']._serialized_start=1184
-  _globals['_SYSTEMSTDERRMSG']._serialized_end=1280
-  _globals['_SYSTEMREPORTRETURNCODE']._serialized_start=1282
-  _globals['_SYSTEMREPORTRETURNCODE']._serialized_end=1326
-  _globals['_SYSTEMREPORTRETURNCODEMSG']._serialized_start=1328
-  _globals['_SYSTEMREPORTRETURNCODEMSG']._serialized_end=1444
-  _globals['_FORMATTING']._serialized_start=1446
-  _globals['_FORMATTING']._serialized_end=1471
-  _globals['_FORMATTINGMSG']._serialized_start=1473
-  _globals['_FORMATTINGMSG']._serialized_end=1565
-  _globals['_NOTE']._serialized_start=1567
-  _globals['_NOTE']._serialized_end=1586
-  _globals['_NOTEMSG']._serialized_start=1588
-  _globals['_NOTEMSG']._serialized_end=1668
-  _globals['_PRINTEVENT']._serialized_start=1670
-  _globals['_PRINTEVENT']._serialized_end=1695
-  _globals['_PRINTEVENTMSG']._serialized_start=1697
-  _globals['_PRINTEVENTMSG']._serialized_end=1789
+  _globals['_BEHAVIORDEPRECATIONEVENT']._serialized_start=394
+  _globals['_BEHAVIORDEPRECATIONEVENT']._serialized_end=536
+  _globals['_BEHAVIORDEPRECATIONEVENTMSG']._serialized_start=538
+  _globals['_BEHAVIORDEPRECATIONEVENTMSG']._serialized_end=658
+  _globals['_RETRYEXTERNALCALL']._serialized_start=660
+  _globals['_RETRYEXTERNALCALL']._serialized_end=709
+  _globals['_RETRYEXTERNALCALLMSG']._serialized_start=711
+  _globals['_RETRYEXTERNALCALLMSG']._serialized_end=817
+  _globals['_RECORDRETRYEXCEPTION']._serialized_start=819
+  _globals['_RECORDRETRYEXCEPTION']._serialized_end=854
+  _globals['_RECORDRETRYEXCEPTIONMSG']._serialized_start=856
+  _globals['_RECORDRETRYEXCEPTIONMSG']._serialized_end=968
+  _globals['_SYSTEMCOULDNOTWRITE']._serialized_start=970
+  _globals['_SYSTEMCOULDNOTWRITE']._serialized_end=1034
+  _globals['_SYSTEMCOULDNOTWRITEMSG']._serialized_start=1036
+  _globals['_SYSTEMCOULDNOTWRITEMSG']._serialized_end=1146
+  _globals['_SYSTEMEXECUTINGCMD']._serialized_start=1148
+  _globals['_SYSTEMEXECUTINGCMD']._serialized_end=1181
+  _globals['_SYSTEMEXECUTINGCMDMSG']._serialized_start=1183
+  _globals['_SYSTEMEXECUTINGCMDMSG']._serialized_end=1291
+  _globals['_SYSTEMSTDOUT']._serialized_start=1293
+  _globals['_SYSTEMSTDOUT']._serialized_end=1321
+  _globals['_SYSTEMSTDOUTMSG']._serialized_start=1323
+  _globals['_SYSTEMSTDOUTMSG']._serialized_end=1419
+  _globals['_SYSTEMSTDERR']._serialized_start=1421
+  _globals['_SYSTEMSTDERR']._serialized_end=1449
+  _globals['_SYSTEMSTDERRMSG']._serialized_start=1451
+  _globals['_SYSTEMSTDERRMSG']._serialized_end=1547
+  _globals['_SYSTEMREPORTRETURNCODE']._serialized_start=1549
+  _globals['_SYSTEMREPORTRETURNCODE']._serialized_end=1593
+  _globals['_SYSTEMREPORTRETURNCODEMSG']._serialized_start=1595
+  _globals['_SYSTEMREPORTRETURNCODEMSG']._serialized_end=1711
+  _globals['_FORMATTING']._serialized_start=1713
+  _globals['_FORMATTING']._serialized_end=1738
+  _globals['_FORMATTINGMSG']._serialized_start=1740
+  _globals['_FORMATTINGMSG']._serialized_end=1832
+  _globals['_NOTE']._serialized_start=1834
+  _globals['_NOTE']._serialized_end=1853
+  _globals['_NOTEMSG']._serialized_start=1855
+  _globals['_NOTEMSG']._serialized_end=1935
+  _globals['_PRINTEVENT']._serialized_start=1937
+  _globals['_PRINTEVENT']._serialized_end=1962
+  _globals['_PRINTEVENTMSG']._serialized_start=1964
+  _globals['_PRINTEVENTMSG']._serialized_end=2056
 # @@protoc_insertion_point(module_scope)

dbt_common/exceptions/base.py

@@ -1,5 +1,5 @@
 import builtins
-from typing import Any, List, Optional
+from typing import Any, Dict, List, Optional
 import os
 
 from dbt_common.constants import SECRET_ENV_PREFIX
@@ -23,7 +23,7 @@ class DbtBaseException(Exception):
     CODE = -32000
     MESSAGE = "Server Error"
 
-    def data(self):
+    def data(self) -> Dict[str, Any]:
         # if overriding, make sure the result is json-serializable.
         return {
             "type": self.__class__.__name__,
@@ -32,7 +32,7 @@ class DbtBaseException(Exception):
 
 
 class DbtInternalError(DbtBaseException):
-    def __init__(self, msg: str):
+    def __init__(self, msg: str) -> None:
         self.stack: List = []
         self.msg = scrub_secrets(msg, env_secrets())
 
@@ -40,7 +40,7 @@ class DbtInternalError(DbtBaseException):
     def type(self) -> str:
         return "Internal"
 
-    def process_stack(self):
+    def process_stack(self) -> List[str]:
         lines = []
         stack = self.stack
         first = True
@@ -81,7 +81,7 @@ class DbtRuntimeError(RuntimeError, DbtBaseException):
         self.node = node
         self.msg = scrub_secrets(msg, env_secrets())
 
-    def add_node(self, node=None):
+    def add_node(self, node=None) -> None:
         if node is not None and node is not self.node:
             if self.node is not None:
                 self.stack.append(self.node)
@@ -91,7 +91,7 @@ class DbtRuntimeError(RuntimeError, DbtBaseException):
     def type(self):
         return "Runtime"
 
-    def node_to_string(self, node: Any):
+    def node_to_string(self, node: Any) -> str:
         """Given a node-like object we attempt to create the best identifier we can."""
         result = ""
         if hasattr(node, "resource_type"):
@@ -103,7 +103,7 @@ class DbtRuntimeError(RuntimeError, DbtBaseException):
 
         return result.strip() if result != "" else "<Unknown>"
 
-    def process_stack(self):
+    def process_stack(self) -> List[str]:
         lines = []
         stack = self.stack + [self.node]
         first = True
@@ -122,7 +122,7 @@ class DbtRuntimeError(RuntimeError, DbtBaseException):
 
         return lines
 
-    def validator_error_message(self, exc: builtins.Exception):
+    def validator_error_message(self, exc: builtins.Exception) -> str:
         """Given a dbt.dataclass_schema.ValidationError return the relevant parts as a string.
 
         dbt.dataclass_schema.ValidationError is basically a jsonschema.ValidationError)
@@ -132,7 +132,7 @@ class DbtRuntimeError(RuntimeError, DbtBaseException):
         path = "[%s]" % "][".join(map(repr, exc.relative_path))
         return f"at path {path}: {exc.message}"
 
-    def __str__(self, prefix: str = "! "):
+    def __str__(self, prefix: str = "! ") -> str:
         node_string = ""
 
         if self.node is not None:
@@ -149,7 +149,7 @@ class DbtRuntimeError(RuntimeError, DbtBaseException):
 
         return lines[0] + "\n" + "\n".join(["  " + line for line in lines[1:]])
 
-    def data(self):
+    def data(self) -> Dict[str, Any]:
         result = DbtBaseException.data(self)
         if self.node is None:
             return result
@@ -236,7 +236,7 @@ class DbtDatabaseError(DbtRuntimeError):
     CODE = 10003
     MESSAGE = "Database Error"
 
-    def process_stack(self):
+    def process_stack(self) -> List[str]:
         lines = []
 
         if hasattr(self.node, "build_path") and self.node.build_path:
@@ -250,7 +250,7 @@ class DbtDatabaseError(DbtRuntimeError):
 
 
 class UnexpectedNullError(DbtDatabaseError):
-    def __init__(self, field_name: str, source):
+    def __init__(self, field_name: str, source) -> None:
         self.field_name = field_name
         self.source = source
         msg = (
@@ -268,7 +268,7 @@ class CommandError(DbtRuntimeError):
         self.cmd = cmd_scrubbed
         self.args = (cwd, cmd_scrubbed, msg)
 
-    def __str__(self):
+    def __str__(self, prefix: str = "! ") -> str:
         if len(self.cmd) == 0:
             return f"{self.msg}: No arguments given"
         return f'{self.msg}: "{self.cmd[0]}"'

dbt_common/exceptions/system.py

@@ -26,7 +26,7 @@ class WorkingDirectoryError(CommandError):
     def __init__(self, cwd: str, cmd: List[str], msg: str) -> None:
         super().__init__(cwd, cmd, msg)
 
-    def __str__(self):
+    def __str__(self, prefix: str = "! ") -> str:
         return f'{self.msg}: "{self.cwd}"'
 
 
@@ -46,5 +46,5 @@ class CommandResultError(CommandError):
         self.stderr = scrub_secrets(stderr.decode("utf-8"), env_secrets())
         self.args = (cwd, self.cmd, returncode, self.stdout, self.stderr, msg)
 
-    def __str__(self):
+    def __str__(self, prefix: str = "! ") -> str:
         return f"{self.msg} running: {self.cmd}"

dbt_common/invocation.py

@@ -7,6 +7,6 @@ def get_invocation_id() -> str:
     return _INVOCATION_ID
 
 
-def reset_invocation_id():
+def reset_invocation_id() -> None:
     global _INVOCATION_ID
     _INVOCATION_ID = str(uuid.uuid4())

dbt_common/semver.py

@@ -1,6 +1,6 @@
 from dataclasses import dataclass
 import re
-from typing import List, Iterable
+from typing import Iterable, List, Union
 
 import dbt_common.exceptions.base
 from dbt_common.exceptions import VersionsNotCompatibleError
@@ -67,7 +67,7 @@ $
 _VERSION_REGEX = re.compile(_VERSION_REGEX_PAT_STR, re.VERBOSE)
 
 
-def _cmp(a, b):
+def _cmp(a, b) -> int:
     """Return negative if a<b, zero if a==b, positive if a>b."""
     return (a > b) - (a < b)
 
@@ -123,7 +123,7 @@ class VersionSpecifier(VersionSpecification):
 
         return VersionRange(start=range_start, end=range_end)
 
-    def compare(self, other):
+    def compare(self, other: "VersionSpecifier") -> int:
         if self.is_unbounded or other.is_unbounded:
             return 0
 
@@ -192,16 +192,16 @@ class VersionSpecifier(VersionSpecification):
 
         return 0
 
-    def __lt__(self, other) -> bool:
+    def __lt__(self, other: "VersionSpecifier") -> bool:
         return self.compare(other) == -1
 
-    def __gt__(self, other) -> bool:
+    def __gt__(self, other: "VersionSpecifier") -> bool:
         return self.compare(other) == 1
 
-    def __eq___(self, other) -> bool:
+    def __eq___(self, other: "VersionSpecifier") -> bool:
         return self.compare(other) == 0
 
-    def __cmp___(self, other):
+    def __cmp___(self, other: "VersionSpecifier") -> int:
         return self.compare(other)
 
     @property
@@ -221,7 +221,7 @@ class VersionSpecifier(VersionSpecification):
         return self.matcher == Matchers.EXACT
 
     @classmethod
-    def _nat_cmp(cls, a, b):
+    def _nat_cmp(cls, a, b) -> int:
         def cmp_prerelease_tag(a, b):
             if isinstance(a, int) and isinstance(b, int):
                 return _cmp(a, b)
@@ -358,27 +358,27 @@ class UnboundedVersionSpecifier(VersionSpecifier):
             matcher=Matchers.EXACT, major=None, minor=None, patch=None, prerelease=None, build=None
         )
 
-    def __str__(self):
+    def __str__(self) -> str:
         return "*"
 
     @property
-    def is_unbounded(self):
+    def is_unbounded(self) -> bool:
         return True
 
     @property
-    def is_lower_bound(self):
+    def is_lower_bound(self) -> bool:
         return False
 
     @property
-    def is_upper_bound(self):
+    def is_upper_bound(self) -> bool:
         return False
 
     @property
-    def is_exact(self):
+    def is_exact(self) -> bool:
         return False
 
 
-def reduce_versions(*args):
+def reduce_versions(*args: Union[VersionSpecifier, VersionRange, str]) -> VersionRange:
     version_specifiers = []
 
     for version in args:

dbt_common/utils/casting.py

@@ -1,7 +1,7 @@
 # This is useful for proto generated classes in particular, since
 # the default for protobuf for strings is the empty string, so
 # Optional[str] types don't work for generated Python classes.
-from typing import Any, Dict, Optional
+from typing import Any, Dict, Mapping, Optional
 
 
 def cast_to_str(string: Optional[str]) -> str:
@@ -18,8 +18,9 @@ def cast_to_int(integer: Optional[int]) -> int:
         return integer
 
 
-def cast_dict_to_dict_of_strings(dct: Dict[Any, Any]) -> Dict[str, str]:
+def cast_dict_to_dict_of_strings(dct: Mapping[Any, Any]) -> Dict[str, str]:
     new_dct: Dict[str, str] = {}
+
     for k, v in dct.items():
         new_dct[str(k)] = str(v)
     return new_dct

dbt_common/utils/connection.py

@@ -1,4 +1,5 @@
 import time
+from typing import Callable
 
 from dbt_common.events.types import RecordRetryException, RetryExternalCall
 from dbt_common.exceptions import ConnectionError
@@ -7,7 +8,7 @@ from tarfile import ReadError
 import requests
 
 
-def connection_exception_retry(fn, max_attempts: int, attempt: int = 0):
+def connection_exception_retry(fn: Callable, max_attempts: int, attempt: int = 0):
     """Handle connection retries gracefully.
 
     Attempts to run a function that makes an external call, if the call fails

dbt_common/utils/jinja.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from dbt_common.exceptions import DbtInternalError
 
 
@@ -5,20 +7,20 @@ MACRO_PREFIX = "dbt_macro__"
 DOCS_PREFIX = "dbt_docs__"
 
 
-def get_dbt_macro_name(name) -> str:
+def get_dbt_macro_name(name: str) -> str:
     if name is None:
         raise DbtInternalError("Got None for a macro name!")
     return f"{MACRO_PREFIX}{name}"
 
 
-def get_dbt_docs_name(name) -> str:
+def get_dbt_docs_name(name: str) -> str:
     if name is None:
         raise DbtInternalError("Got None for a doc name!")
     return f"{DOCS_PREFIX}{name}"
 
 
 def get_materialization_macro_name(
-    materialization_name, adapter_type=None, with_prefix=True
+    materialization_name: str, adapter_type: Optional[str] = None, with_prefix: bool = True
 ) -> str:
     if adapter_type is None:
         adapter_type = "default"
@@ -26,10 +28,10 @@ def get_materialization_macro_name(
     return get_dbt_macro_name(name) if with_prefix else name
 
 
-def get_docs_macro_name(docs_name, with_prefix=True):
+def get_docs_macro_name(docs_name: str, with_prefix: bool = True) -> str:
     return get_dbt_docs_name(docs_name) if with_prefix else docs_name
 
 
-def get_test_macro_name(test_name, with_prefix=True):
+def get_test_macro_name(test_name: str, with_prefix: bool = True) -> str:
     name = f"test_{test_name}"
     return get_dbt_macro_name(name) if with_prefix else name

{dbt_common-1.7.0.dist-info → dbt_common-1.8.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: dbt-common
-Version: 1.7.0
+Version: 1.8.0
 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

{dbt_common-1.7.0.dist-info → dbt_common-1.8.0.dist-info}/RECORD

@@ -1,33 +1,34 @@
-dbt_common/__about__.py,sha256=9UsQLZYw3LX7NO0PsCa8nGInSg0LC4sQ67EJUs50ljU,18
+dbt_common/__about__.py,sha256=J9Md0egz2m3v0DHzraSTc3Ep1dKM1wRt2RZSVicTmqM,18
 dbt_common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dbt_common/behavior_flags.py,sha256=fkk9snLsKH4mM4PklQSjjk9heuP7NvB4zFndgQNWM6E,4163
 dbt_common/constants.py,sha256=-Y5DIL1SDPQWtlCNizXRYxFgbx1D7LaLs1ysamvGMRk,278
-dbt_common/context.py,sha256=mNYvTF5hWGM-x19CgOT5L35s_GcPoGIAbrzxbmz9DX4,2520
-dbt_common/dataclass_schema.py,sha256=yFq1P5qkEwOJylSKe69Edirubpzgdcbvj6ThbPUH8dA,5553
+dbt_common/context.py,sha256=rk4EYBU4SpDXRhqbSvDTJwojilxPSoaiEdOxkXow_BU,2549
+dbt_common/dataclass_schema.py,sha256=u2S0dxwxIghv8RMqC91HlWZJVxmsC_844yZQaGyOwdY,5563
 dbt_common/helper_types.py,sha256=FWJGPmp7Qp2iToHyI4uvhkBbu_d1tl2_oF-obi98_N4,3917
-dbt_common/invocation.py,sha256=Zw8jRPn75oi2VrUD6qGvaCDtSyIfqm5pJlPpRjs3s1E,202
+dbt_common/invocation.py,sha256=2ZchIr4Wq7NwtAjjB-mxHP9ITD6-r45jEq4Zooso0gc,210
 dbt_common/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 dbt_common/record.py,sha256=og-9SZhRINqW6jnqLdf3CTVKvUPdKldi52oFaa2-QRE,12658
-dbt_common/semver.py,sha256=M6J5IHi04yn8R6FTwdOweD6gFFrl7KxVMc-x5WOYV9E,14130
+dbt_common/semver.py,sha256=NNG0CVJosfwSVQ8WKKGtK_qzinbEy-OEn_jih36Y0Co,14364
 dbt_common/tests.py,sha256=6lC_JuRtoYO6cbAF8-R5aTM4HtQiM_EH8X5m_97duGY,315
 dbt_common/ui.py,sha256=rc2TEM29raBFc_LXcg901pMDD07C2ohwp9qzkE-7pBY,2567
 dbt_common/clients/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 dbt_common/clients/_jinja_blocks.py,sha256=xoJK9Y0F93U2PKfT_3SJbBopCGYCtl7LiwKuylXnrEE,12947
-dbt_common/clients/agate_helper.py,sha256=n5Q0_gJPbBhFvjd286NGYGlcTtdEExYmIT3968lppyg,9124
-dbt_common/clients/jinja.py,sha256=i6VQ94FU4F6ZCQLHTxNSeGHmvyYSIe34nDhNkH6wO08,18502
-dbt_common/clients/system.py,sha256=ICFy-s-IQCbXNCmL0LTplyRvnNK8YTn7BL1_vDMffrI,22969
+dbt_common/clients/agate_helper.py,sha256=anKKgKV5PSnFRuFeBwRMdHK3JCaQoUqB2ZXHD0su0Wo,9123
+dbt_common/clients/jinja.py,sha256=yB7fv_Y5LKnj-3BKl3KCFDQYSFEEvn5YCyyu0vBsFR8,18495
+dbt_common/clients/system.py,sha256=aoUBtOuXVmkOyj6IhhJ3Y4a7JFzPO2F_zKyOtz3xy44,23932
 dbt_common/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 dbt_common/contracts/constraints.py,sha256=_f1q3Rkcg2UwA7zI5XBbUMXnPUg6pw17UC7l1HyhyQM,1352
 dbt_common/contracts/metadata.py,sha256=K_M06Rue0wmrQhFP_mq3uvQszq10CIt93oGiAVgbRfE,1293
-dbt_common/contracts/util.py,sha256=RZpeEExSKdyFwTq7MM3rd1ZkAf11C7I-bgppUJ6SXOg,741
+dbt_common/contracts/util.py,sha256=_-vtcI6ZGmYVgrlxOw4M3YuH34Ncx-oKdKg7TV0pV78,916
 dbt_common/contracts/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-dbt_common/contracts/config/base.py,sha256=jWLf6SBUy7wngYs0Z5Zmx1O1v86XRueYaABlZ0W2Bxc,8356
+dbt_common/contracts/config/base.py,sha256=JR9a7FdboXugexqXmab82TabKyRoRW8OPGn2_vVlS6g,8492
 dbt_common/contracts/config/materialization.py,sha256=rahC72qZ0-jB8oPwxyPooZXc5NJ-smg74g2HnGOMj34,256
 dbt_common/contracts/config/metadata.py,sha256=X47-tEA8q2ZfSMcYv0godUwTSVjt8NI77tD4NqdgM0c,1877
 dbt_common/contracts/config/properties.py,sha256=gWt6xsP4rVOqRKhmagiUhWnDynzD9mykfMYMTviwpEU,2281
 dbt_common/events/README.md,sha256=CSwVajoxCAqOug2UCnXldH1EUK7Kjf3rcq7z9ACjrss,3023
 dbt_common/events/__init__.py,sha256=av08vfpxo0ek7PqZNtMxY8FODJ3xwph4ehRxgInx4LA,383
 dbt_common/events/base_types.py,sha256=1l4Yx8zuma7jABB1fcPvL20ltpQ46w0mlYxn48kHykY,5415
-dbt_common/events/contextvars.py,sha256=Jx2J_Nkx0DH8EE1Sno_mbv7PMLBfCzm7byeFlUeflLA,3079
+dbt_common/events/contextvars.py,sha256=EIs1P6NrJzx_IAV17x5cVqOAS4Lqbu6oc0etHtWCJOo,3097
 dbt_common/events/event_handler.py,sha256=jfi0PyqIOGnXCG9HEa0VIVULqNvXs1RYmAg0b50ChQs,1385
 dbt_common/events/event_manager.py,sha256=IIUwSyt_RcBbUI_iE5mnpmZt2uW7lG49RXOWz2VlUv0,2300
 dbt_common/events/event_manager_client.py,sha256=VKlIYJPcexmDKnidkyrs8BIuNZ1_CwDFGz-gBM2SAvo,1193
@@ -36,27 +37,27 @@ dbt_common/events/functions.py,sha256=K-R-FBTeO03U51gtMBu1EUcNsIAsgw_e5spWxLJ44V
 dbt_common/events/helpers.py,sha256=CfsWwNDjsLJkPIgOtAfuLEnZ3rGUKeYsH8aDtCW12OA,410
 dbt_common/events/interfaces.py,sha256=hEDeDoB0FW2RYHVZBG7gebEt_mUVBzkn1yPubpaxs-s,147
 dbt_common/events/logger.py,sha256=mAUNLZlIIOl3T2u7KOe8FF_deTNNe1CRJqmkPw4YH1U,6728
-dbt_common/events/types.proto,sha256=nsOE3XFYBPovT9Th8WMkDWxBXa-adqiL23zCYfOdVk0,2013
-dbt_common/events/types.py,sha256=quE22Kp78J51_8f1Si_K-xg0gA2Sg-fw9XDjNrcy81M,3905
-dbt_common/events/types_pb2.py,sha256=Gn3exMla0FjoA-5OQTjOeKCT_DLxzvcA3YHPfbFjAck,6563
+dbt_common/events/types.proto,sha256=VflTmP9HUsatIi7xC3GXk2eJHsrS5041m5qpA7idU6c,2335
+dbt_common/events/types.py,sha256=aQ9TSsOyVBq2LMdMQQVktGww0qzH4PpR4AHArMQWtT8,5049
+dbt_common/events/types_pb2.py,sha256=0kIhc1xWqhF3DtJhaAdN_8AjxzxkFcVzE53Dd5mdS5Q,7277
 dbt_common/exceptions/__init__.py,sha256=X_Uw7BxOzXev_9JMYfs5Cm-_i_Qf2PJim8_-dDJI7Y8,361
-dbt_common/exceptions/base.py,sha256=9FVfeMn2zSZyevynwuVqKTgHBXyQ1HLZZRsubiU2FiE,7597
+dbt_common/exceptions/base.py,sha256=d6lsA8sLqR6_BERowm91Mrs1ZwrEOeT8WQKWg4nPSPA,7750
 dbt_common/exceptions/cache.py,sha256=0z4fBcdNZMAR41YbPRo2GN0__xAMaYs8Uc-t3hjmVio,2532
 dbt_common/exceptions/connection.py,sha256=rXLJXUdLhyXP3CUUyiqWN2DDO5-0Pn1ChX3OIR7pxKk,176
 dbt_common/exceptions/contracts.py,sha256=i2PKRqda1Pq_Sro9FA22W7FTGklhBAGl6__nimR5_qI,527
 dbt_common/exceptions/events.py,sha256=j83szhbqmK3ITZR_xwA2dYTNaPcGF_lN_kQar6dQgjQ,317
 dbt_common/exceptions/jinja.py,sha256=PzVUB1MFf8x81bQHTwFIGw3PyrGZzWYw04eotI4CqtI,3124
 dbt_common/exceptions/macros.py,sha256=2nujJrtpWHnhBwcyhcOmeVaEzILh3W9gtyP6vVpkA0o,3301
-dbt_common/exceptions/system.py,sha256=w7zCilpKTiKwj0BwqVgJZy6SqiCpH61ZzvOfGnYaeoI,1549
+dbt_common/exceptions/system.py,sha256=scoKnSx2frTFCrfk2cH0g-z3MuzE-SEBXFC9P-jzB2s,1603
 dbt_common/utils/__init__.py,sha256=8PNb_A9zm2YfYMa0GsM-pAyJy3Iu0FUtWKvCs8kFhD0,549
-dbt_common/utils/casting.py,sha256=lcGLvASRRQ4q195wkQoP0BMA_AojK6Zu1yqxxjRktjo,666
-dbt_common/utils/connection.py,sha256=J5zxWFpGHpUbe-F04S9bVLLO3HLvHB6INOkAey0k76c,1373
+dbt_common/utils/casting.py,sha256=xMulzzTrIQvw65UC9wr9oUWw5xp-BcUKtHaE8dldfII,679
+dbt_common/utils/connection.py,sha256=gyEdWPG7NauZqMX9ZzbglaaB8itEpdwtn-0s_Zw79rk,1411
 dbt_common/utils/dict.py,sha256=unI-kJs2yvw7ic2U71-6H8koVRknkb0jCk7W_FCq6_I,4014
 dbt_common/utils/encoding.py,sha256=6_kSY2FvGNYMg7oX7PrbvVioieydih3Kl7Ii802LaHI,1705
 dbt_common/utils/executor.py,sha256=pNY0UbPlwQmTE69Vt_Rj91YGCIOEaqeYU3CjAds0T70,2454
 dbt_common/utils/formatting.py,sha256=JUn5rzJ-uajs9wPCN0-f2iRFY1pOJF5YjTD9dERuLoc,165
-dbt_common/utils/jinja.py,sha256=7s1-LbFBWIXZAeXMny6TpCmyd7uKrdDkCOklJ5W08qs,992
-dbt_common-1.7.0.dist-info/METADATA,sha256=ZjCx7aXFL7b-lRUJ87A06wzS7F9CBQJK2hEfcpZumvA,5298
-dbt_common-1.7.0.dist-info/WHEEL,sha256=1yFddiXMmvYK7QYTqtRNtX66WJ0Mz8PYEiEUoOUUxRY,87
-dbt_common-1.7.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-dbt_common-1.7.0.dist-info/RECORD,,
+dbt_common/utils/jinja.py,sha256=JXgNmJArGGy0h7qkbNLA3zaEQmoF1CxsNBYTlIwFXDw,1101
+dbt_common-1.8.0.dist-info/METADATA,sha256=9YS6_dZQSWe_FuiBUu-lYqVdhptGjdU-na84EExK72g,5298
+dbt_common-1.8.0.dist-info/WHEEL,sha256=1yFddiXMmvYK7QYTqtRNtX66WJ0Mz8PYEiEUoOUUxRY,87
+dbt_common-1.8.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+dbt_common-1.8.0.dist-info/RECORD,,