+ oiCRt^RIt^RIt^RIt^RIt]P !]4tRtRt Rt ] !]] ] .4t ]t RtRtRtRtR tR tR tR#) z-Helper functions for commonly used utilities.NWARNING EXCEPTIONIGNOREzFile: {0}: Is a symbolic link.z{0}: Is a directoryz,Cannot access {0}: No such file or directorycaV3Rlp\S\4'dV#\P!S4wpr4p\ \ V4\ V4, 4!S4#)aA decorator to declare that only the first N arguments may be positional. This decorator makes it easy to support Python 3 style keyword-only parameters. For example, in Python 3 it is possible to write:: def fn(pos1, *, kwonly1=None, kwonly2=None): ... All named parameters after ``*`` must be a keyword:: fn(10, 'kw1', 'kw2') # Raises exception. fn(10, kwonly1='kw1') # Ok. Example ^^^^^^^ To define a function like above, do:: @positional(1) def fn(pos1, kwonly1=None, kwonly2=None): ... If no default value is provided to a keyword argument, it becomes a required keyword argument:: @positional(0) def fn(required_kw): ... This must be called with the keyword parameter:: fn() # Raises exception. fn(10) # Raises exception. fn(required_kw=10) # Ok. When defining instance or class methods always remember to account for ``self`` and ``cls``:: class MyClass(object): @positional(2) def my_method(self, pos1, kwonly1=None): ... @classmethod @positional(2) def my_method(cls, pos1, kwonly1=None): ... The positional decorator behavior is controlled by ``_helpers.positional_parameters_enforcement``, which may be set to ``POSITIONAL_EXCEPTION``, ``POSITIONAL_WARNING`` or ``POSITIONAL_IGNORE`` to raise an exception, log a warning, or do nothing, respectively, if a declaration is violated. Args: max_positional_arguments: Maximum number of positional arguments. All parameters after this index must be keyword only. Returns: A decorator that prevents using arguments after max_positional_args from being used as positional parameters. Raises: TypeError: if a keyword-only argument is provided as a positional parameter, but only if _helpers.positional_parameters_enforcement is set to POSITIONAL_EXCEPTION. cJ<a\P!S4VV3Rl4pV#)c<\V4S8drRpS^8wdRpRPSPS\V4VR7p\\8Xd \ V4h\\ 8Xd\PV4S!V/VB#)szV{function}() takes at most {args_max} positional argument{plural} ({args_given} given))functionargs_max args_givenplural) lenformat__name__!positional_parameters_enforcementPOSITIONAL_EXCEPTION TypeErrorPOSITIONAL_WARNINGloggerwarning)argskwargsplural_smessagemax_positional_argswrappeds*, {/Users/tonyclaw/.openclaw/workspace/scripts/youtube-playlists/venv/lib/python3.14/site-packages/googleapiclient/_helpers.pypositional_wrapperDpositional..positional_decorator..positional_wrapperos4y..&!+"H<.positional_decoratorns&  ! , " ,("!r ) isinstanceintinspectgetfullargspec positionalr)rr#r_defaultssf rr)r)&s[P"0%s++##(/(>(>?R(S%aaA#d)c(m345HIIr c\PPV4p/pVP4FDwr4\ V4^8wd%RV: RRP V4: 2p\ V4hV^,W#&KF V#)zParses unique key-value parameters from urlencoded content. Args: content: string, URL-encoded key-value pairs. Returns: dict, The key-value pairs from ``content``. Raises: ValueError: if one of the keys is repeated. z.URL-encoded content contains a repeated value:z -> z, )urllibparseparse_qsitemsrjoin ValueError)contenturlencoded_paramsparamskeyvaluemsgs& rparse_unique_urlencodedr9sr --g6 F'--/  u:? % CS/ !Ah 0 Mr c,\PPV4p\VP4pVP V4\PP V4pVPVR7p\PPV4#)aUpdates a URI with new query parameters. If a given key from ``params`` is repeated in the ``uri``, then the URI will be considered invalid and an error will occur. If the URI is valid, then each value from ``params`` will replace the corresponding value in the query parameters (if it exists). Args: uri: string, A valid URI, with potential existing query parameters. params: dict, A dictionary of query parameters. Returns: The same URI but with the new query parameters added. )query) r-r.urlparser9r;update urlencode_replace urlunparse)urir5parts query_params new_query new_partss&& rupdate_query_paramsrFsm" LL ! !# &E*5;;7L &&|4IY/I << " "9 --r c(VfV#\WV/4#)a<Adds a query parameter to a url. Replaces the current value if it already exists in the URL. Args: url: string, url to add the query parameter to. name: string, query parameter name. value: string, query parameter value. Returns: Updated query parameter. Does not update the url if value is None. )rF)urlnamer7s&&&r_add_query_parameterrJs } "3u 66r )__doc__r!r'loggingr- getLoggerrrrrPOSITIONAL_IGNORE frozensetPOSITIONAL_SETr_SYM_LINK_MESSAGE_IS_DIR_MESSAGE_MISSING_FILE_MESSAGEr)r9rFrJr rrUs~4   8 $"-/@A%7!4'FdJN2.27r