liddlZddlmZmZmZmZ ddlmZddl m Z ddl m Z ddl mZmZGdd eZGd d ZGd d Zy#e$r ddlmZYAwxYw)N)AnyDictList TypedDict) NotRequired)Optional) fire_event)BehaviorChangeEvent)CompilationErrorDbtInternalErrorcVeZdZUdZeed<eed<eeed<eeed<eeed<y) BehaviorFlaga 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 description: an additional message to send when the flag evaluates to False docs_url: the url to the relevant docs on docs.getdbt.com *Note*: While `description` and `docs_url` are both listed as `NotRequired`, at least one of them is required. This is validated when the flag is rendered in `BehaviorFlagRendered` below. The goal of this restriction is to provide the end user with context so they can make an informed decision about if, and when, to enable the behavior flag. namedefaultsource descriptiondocs_urlN)__name__ __module__ __qualname____doc__str__annotations__boolr^/var/www/html/strategist-ai/venv_dbt/lib/python3.12/site-packages/dbt_common/behavior_flags.pyrrs4 I M  S!!#rrceZdZUdZdZeed<dedee e fddfdZ e deddfd Z edefd Zej d eddfd Zedefd Ze de fdZdefdZy)BehaviorFlagRenderedz 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 Ffiredflaguser_overridesreturnNc 4|j||d|_|j|d|d|_d|dd}d}t |d|jd|j |jd||jd| |_y) NrrzThe behavior controlled by `z` is currently turned off. zAhttps://docs.getdbt.com/reference/global-configs/behavior-changesrrr) flag_name flag_sourcerr) _validatergetsettingr _default_source_behavior_change_event)selfr!r"default_descriptiondefault_docs_urls r__init__zBehaviorFlagRendered.__init__3s tL %))$v,YH -T&\N:V Y _&96l4+?+?+AB0CDXXj*:; ' #rc`|jd|jd tdyy)NrrzKBehavior change flags require at least one of `description` and `docs_url`.)r(r )r!s rr'zBehaviorFlagRendered._validateDs8 88M " *txx /C/K"] 0L *rc|jdur(|jst|jd|_|jS)NFT)_settingr r r+r,s rr)zBehaviorFlagRendered.settingKs3 ==E !$** t22 3DJ}}rvaluec||_yNr2)r,r4s rr)zBehaviorFlagRendered.settingRs  rc|jSr6r7r3s rno_warnzBehaviorFlagRendered.no_warnVs }}rctjD]>}tj|dx}s|jtk7s2|jcSy)z If the maintainer did not provide a source, default to the module that called this class. For adapters, this will likely be `dbt.adapters..impl` for `dbt-foo`. rUnknown)inspectstack getmoduler)framemodules rr*z$BehaviorFlagRendered._default_sourceZsN ]]_ +E **5844v4??h.!??* +rc|jSr6)r)r3s r__bool__zBehaviorFlagRendered.__bool__fs ||r)rrrrr rrrrrrr/ staticmethodr'propertyr)setterr9r*rBrrrrr(sE4 \ 4S> d "    ^^Td S  $rrcVeZdZUdZeeed<deedee e fddfdZ de defd Z y) Behaviora 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 behavior change event ... ``` ```jinja {% if adapter.behavior.my_flag %} ... {% endif %} {% if adapter.behavior.my_flag.no_warn %} {# this will not fire the behavior change 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 _flagsflagsr"r#NcL|Dcgc]}t||c}|_ycc}wr6)rrH)r,rIr"r!s rr/zBehavior.__init__sNSTd+D.AT Ts!rch|jD]}|j|k(s|cStd|d)Nz The flag z has not been registered.)rHrr )r,rr!s r __getattr__zBehavior.__getattr__s=KK DyyD   4&0IJKKr) rrrrrrrrrrrr/rLrrrrGrGjsX4 % &&Ud<0U$sCx.UUYULL(<LrrG)r<typingrrrrr ImportErrorrdbt_common.events.functionsr dbt_common.events.typesr dbt_common.exceptionsr r rrrGrrrrRs[--/" 37D90??D$L$LI///sA AA