

'''simple docstring'''

import dataclasses
import json
import sys
import types
from argparse import ArgumentDefaultsHelpFormatter, ArgumentParser, ArgumentTypeError
from copy import copy
from enum import Enum
from inspect import isclass
from pathlib import Path
from typing import Any, Callable, Dict, Iterable, List, Literal, NewType, Optional, Tuple, Union, get_type_hints

import yaml


A_       						=							NewType("DataClass", Any)
A_       						=							NewType("DataClassType", Any)





def    A_  ( snake_case ):
  if isinstance(snake_case      ,       snake_case ):
    return v
  if v.lower() in ("yes", "true", "t", "y", "1"):
    return True
  elif v.lower() in ("no", "false", "f", "n", "0"):
    return False
  else:
    raise ArgumentTypeError(
        F'''Truthy value expected: got {v} but expected one of yes/no, true/false, t/f, y/n, 1/0 (case insensitive).''' )





def    A_  ( snake_case ):
  SCREAMING_SNAKE_CASE:Any						      =					{str(snake_case ): choice for choice in choices}
  return lambda snake_case : str_to_choice.get(snake_case      ,       snake_case )





def    A_  ( *,
    snake_case = None      ,       snake_case = None      ,       snake_case = dataclasses.MISSING      ,       snake_case = dataclasses.MISSING      ,       snake_case = None      ,       **snake_case      ,       ):
  if metadata is None:
    # Important, don't use as default param in function signature because dict is mutable and shared across function calls
    SCREAMING_SNAKE_CASE:str						      =					{}
  if aliases is not None:
    SCREAMING_SNAKE_CASE:Optional[int]						      =					aliases
  if help is not None:
    SCREAMING_SNAKE_CASE:Optional[Any]						      =					help

  return dataclasses.field(metadata=snake_case      ,       default=snake_case      ,       default_factory=snake_case      ,       **snake_case )





class 							_snake_case (       _a						):
   _A       :     Iterable[DataClassType]
   def __init__( self			:      Any     ,SCREAMING_SNAKE_CASE__			:      Union[DataClassType, Iterable[DataClassType]]     ,**SCREAMING_SNAKE_CASE__			:      Dict							):
     # To make the default appear when using --help
     if "formatter_class" not in kwargs:
       SCREAMING_SNAKE_CASE:List[Any]						      =					ArgumentDefaultsHelpFormatter
     super().__init__(**SCREAMING_SNAKE_CASE__							)
     if dataclasses.is_dataclass(SCREAMING_SNAKE_CASE__							):
       SCREAMING_SNAKE_CASE:Union[str, Any]						      =					[dataclass_types]
     SCREAMING_SNAKE_CASE:Optional[int]						      =					list(SCREAMING_SNAKE_CASE__							)
     for dtype in self.dataclass_types:
       self._add_dataclass_arguments(SCREAMING_SNAKE_CASE__							)
   @staticmethod
   def     __UpperCamelCase						( SCREAMING_SNAKE_CASE__			:      ArgumentParser     ,SCREAMING_SNAKE_CASE__			:      dataclasses.Field							):
     SCREAMING_SNAKE_CASE:Dict						      =					F'''--{field.name}'''
     SCREAMING_SNAKE_CASE:Any						      =					field.metadata.copy()
     # field.metadata is not used at all by Data Classes,
     # it is provided as a third-party extension mechanism.
     if isinstance(field.type     ,SCREAMING_SNAKE_CASE__							):
       raise RuntimeError(
           "Unresolved type detected, which should have been done with the help of "
           "`typing.get_type_hints` method by default"							)

     SCREAMING_SNAKE_CASE:Any						      =					kwargs.pop("aliases"     ,[]							)
     if isinstance(SCREAMING_SNAKE_CASE__     ,SCREAMING_SNAKE_CASE__							):
       SCREAMING_SNAKE_CASE:Union[str, Any]						      =					[aliases]

     SCREAMING_SNAKE_CASE:Dict						      =					getattr(field.type     ,"__origin__"     ,field.type							)
     if origin_type is Union or (hasattr(SCREAMING_SNAKE_CASE__     ,"UnionType"							) and isinstance(SCREAMING_SNAKE_CASE__     ,types.UnionType							)):
       if str not in field.type.__args__ and (
           len(field.type.__args__							) != 2 or type(SCREAMING_SNAKE_CASE__							) not in field.type.__args__
       ):
         raise ValueError(
             "Only `Union[X, NoneType]` (i.e., `Optional[X]`) is allowed for `Union` because"
             " the argument parser only supports one type per argument."
             F''' Problem encountered in field \'{field.name}\'.'''							)
       if type(SCREAMING_SNAKE_CASE__							) not in field.type.__args__:
         # filter `str` in Union
         SCREAMING_SNAKE_CASE:Tuple						      =					field.type.__args__[0] if field.type.__args__[1] == str else field.type.__args__[1]
         SCREAMING_SNAKE_CASE:Tuple						      =					getattr(field.type     ,"__origin__"     ,field.type							)
       elif bool not in field.type.__args__:
         # filter `NoneType` in Union (except for `Union[bool, NoneType]`)
         SCREAMING_SNAKE_CASE:int						      =					(
             field.type.__args__[0] if isinstance(SCREAMING_SNAKE_CASE__     ,field.type.__args__[1]							) else field.type.__args__[1]
         )
         SCREAMING_SNAKE_CASE:Tuple						      =					getattr(field.type     ,"__origin__"     ,field.type							)

        # A variable to store kwargs for a boolean field, if needed
        # so that we can init a `no_*` complement argument (see below)
     SCREAMING_SNAKE_CASE:Optional[int]						      =					{}
     if origin_type is Literal or (isinstance(field.type     ,SCREAMING_SNAKE_CASE__							) and issubclass(field.type     ,SCREAMING_SNAKE_CASE__							)):
       if origin_type is Literal:
         SCREAMING_SNAKE_CASE:Tuple						      =					field.type.__args__
       else:
         SCREAMING_SNAKE_CASE:int						      =					[x.value for x in field.type]

       SCREAMING_SNAKE_CASE:Optional[int]						      =					make_choice_type_function(kwargs["choices"]							)

       if field.default is not dataclasses.MISSING:
         SCREAMING_SNAKE_CASE:Optional[int]						      =					field.default
       else:
         SCREAMING_SNAKE_CASE:List[str]						      =					True
     elif field.type is bool or field.type == Optional[bool]:
       # Copy the currect kwargs to use to instantiate a `no_*` complement argument below.
       # We do not initialize it here because the `no_*` alternative must be instantiated after the real argument
       SCREAMING_SNAKE_CASE:Tuple						      =					copy(SCREAMING_SNAKE_CASE__							)

       # Hack because type=bool in argparse does not behave as we want.
       SCREAMING_SNAKE_CASE:str						      =					string_to_bool
       if field.type is bool or (field.default is not None and field.default is not dataclasses.MISSING):
         # Default value is False if we have no default when of type bool.
         SCREAMING_SNAKE_CASE:Tuple						      =					False if field.default is dataclasses.MISSING else field.default
         # This is the value that will get picked if we don't include --field_name in any way
         SCREAMING_SNAKE_CASE:Union[str, Any]						      =					default
         # This tells argparse we accept 0 or 1 value after --field_name
         SCREAMING_SNAKE_CASE:Dict						      =					"?"
         # This is the value that will get picked if we do --field_name (without value)
         SCREAMING_SNAKE_CASE:List[Any]						      =					True
     elif isclass(SCREAMING_SNAKE_CASE__							) and issubclass(SCREAMING_SNAKE_CASE__     ,SCREAMING_SNAKE_CASE__							):
       SCREAMING_SNAKE_CASE:Any						      =					field.type.__args__[0]
       SCREAMING_SNAKE_CASE:Optional[int]						      =					"+"
       if field.default_factory is not dataclasses.MISSING:
         SCREAMING_SNAKE_CASE:List[str]						      =					field.default_factory()
       elif field.default is dataclasses.MISSING:
         SCREAMING_SNAKE_CASE:int						      =					True
     else:
       SCREAMING_SNAKE_CASE:Tuple						      =					field.type
       if field.default is not dataclasses.MISSING:
         SCREAMING_SNAKE_CASE:Any						      =					field.default
       elif field.default_factory is not dataclasses.MISSING:
         SCREAMING_SNAKE_CASE:Tuple						      =					field.default_factory()
       else:
         SCREAMING_SNAKE_CASE:int						      =					True
     parser.add_argument(SCREAMING_SNAKE_CASE__     ,*SCREAMING_SNAKE_CASE__     ,**SCREAMING_SNAKE_CASE__							)

     # Add a complement `no_*` argument for a boolean field AFTER the initial field has already been added.
     # Order is important for arguments with the same destination!
     # We use a copy of earlier kwargs because the original kwargs have changed a lot before reaching down
     # here and we do not need those changes/additional keys.
     if field.default is True and (field.type is bool or field.type == Optional[bool]):
       SCREAMING_SNAKE_CASE:Tuple						      =					False
       parser.add_argument(F'''--no_{field.name}'''     ,action="store_false"     ,dest=field.name     ,**SCREAMING_SNAKE_CASE__							)
   def     __UpperCamelCase						( self			:      int     ,SCREAMING_SNAKE_CASE__			:      DataClassType							):
     if hasattr(SCREAMING_SNAKE_CASE__     ,"_argument_group_name"							):
       SCREAMING_SNAKE_CASE:Any						      =					self.add_argument_group(dtype._argument_group_name							)
     else:
       SCREAMING_SNAKE_CASE:Union[str, Any]						      =					self

     try:
       SCREAMING_SNAKE_CASE:Dict[str, type]						      =					get_type_hints(SCREAMING_SNAKE_CASE__							)
     except NameError:
       raise RuntimeError(
           F'''Type resolution failed for {dtype}. Try declaring the class in global scope or '''
           "removing line of `from __future__ import annotations` which opts in Postponed "
           "Evaluation of Annotations (PEP 563)"							)
     except TypeError as ex:
       # Remove this block when we drop Python 3.9 support
       if sys.version_info[:2] < (3, 10) and "unsupported operand type(s) for |" in str(SCREAMING_SNAKE_CASE__							):
         SCREAMING_SNAKE_CASE:Dict						      =					".".join(map(SCREAMING_SNAKE_CASE__     ,sys.version_info[:3]							)							)
         raise RuntimeError(
             F'''Type resolution failed for {dtype} on Python {python_version}. Try removing '''
             "line of `from __future__ import annotations` which opts in union types as "
             "`X | Y` (PEP 604) via Postponed Evaluation of Annotations (PEP 563). To "
             "support Python versions that lower than 3.10, you need to use "
             "`typing.Union[X, Y]` instead of `X | Y` and `typing.Optional[X]` instead of "
             "`X | None`."							) from ex
       raise

     for field in dataclasses.fields(SCREAMING_SNAKE_CASE__							):
       if not field.init:
         continue
       SCREAMING_SNAKE_CASE:Union[str, Any]						      =					type_hints[field.name]
       self._parse_dataclass_field(SCREAMING_SNAKE_CASE__     ,SCREAMING_SNAKE_CASE__							)
   def     __UpperCamelCase						( self			:      str     ,SCREAMING_SNAKE_CASE__			:      str=None     ,SCREAMING_SNAKE_CASE__			:      Tuple=False     ,SCREAMING_SNAKE_CASE__			:      List[Any]=True     ,SCREAMING_SNAKE_CASE__			:      Optional[Any]=None     ,SCREAMING_SNAKE_CASE__			:      Tuple=None     ,):

     if args_file_flag or args_filename or (look_for_args_file and len(sys.argv							)):
       SCREAMING_SNAKE_CASE:Optional[int]						      =					[]

       if args_filename:
         args_files.append(Path(SCREAMING_SNAKE_CASE__							)							)
       elif look_for_args_file and len(sys.argv							):
         args_files.append(Path(sys.argv[0]							).with_suffix(".args"							)							)

       # args files specified via command line flag should overwrite default args files so we add them last
       if args_file_flag:
         # Create special parser just to extract the args_file_flag values
         SCREAMING_SNAKE_CASE:Optional[Any]						      =					ArgumentParser()
         args_file_parser.add_argument(SCREAMING_SNAKE_CASE__     ,type=SCREAMING_SNAKE_CASE__     ,action="append"							)

         # Use only remaining args for further parsing (remove the args_file_flag)
         SCREAMING_SNAKE_CASE      ,    SCREAMING_SNAKE_CASE:Optional[int]						      =					args_file_parser.parse_known_args(args=SCREAMING_SNAKE_CASE__							)
         SCREAMING_SNAKE_CASE:List[str]						      =					vars(SCREAMING_SNAKE_CASE__							).get(args_file_flag.lstrip("-"							)     ,SCREAMING_SNAKE_CASE__							)

         if cmd_args_file_paths:
           args_files.extend([Path(SCREAMING_SNAKE_CASE__							) for p in cmd_args_file_paths]							)

       SCREAMING_SNAKE_CASE:List[Any]						      =					[]
       for args_file in args_files:
         if args_file.exists():
           file_args += args_file.read_text().split()

            # in case of duplicate arguments the last one has precedence
            # args specified via the command line should overwrite args from files, so we add them last
       SCREAMING_SNAKE_CASE:Optional[int]						      =					file_args + args if args is not None else file_args + sys.argv[1:]
     SCREAMING_SNAKE_CASE      ,    SCREAMING_SNAKE_CASE:List[str]						      =					self.parse_known_args(args=SCREAMING_SNAKE_CASE__							)
     SCREAMING_SNAKE_CASE:int						      =					[]
     for dtype in self.dataclass_types:
       SCREAMING_SNAKE_CASE:Union[str, Any]						      =					{f.name for f in dataclasses.fields(SCREAMING_SNAKE_CASE__							) if f.init}
       SCREAMING_SNAKE_CASE:Optional[int]						      =					{k: v for k, v in vars(SCREAMING_SNAKE_CASE__							).items() if k in keys}
       for k in keys:
         delattr(SCREAMING_SNAKE_CASE__     ,SCREAMING_SNAKE_CASE__							)
       SCREAMING_SNAKE_CASE:Optional[Any]						      =					dtype(**SCREAMING_SNAKE_CASE__							)
       outputs.append(SCREAMING_SNAKE_CASE__							)
     if len(namespace.__dict__							) > 0:
       # additional namespace.
       outputs.append(SCREAMING_SNAKE_CASE__							)
     if return_remaining_strings:
       return (*outputs, remaining_args)
     else:
       if remaining_args:
         raise ValueError(F'''Some specified arguments are not used by the HfArgumentParser: {remaining_args}'''							)

       return (*outputs,)
   def     __UpperCamelCase						( self			:      Optional[int]     ,SCREAMING_SNAKE_CASE__			:      Dict[str, Any]     ,SCREAMING_SNAKE_CASE__			:      bool = False							):
     SCREAMING_SNAKE_CASE:Optional[Any]						      =					set(args.keys()							)
     SCREAMING_SNAKE_CASE:Optional[int]						      =					[]
     for dtype in self.dataclass_types:
       SCREAMING_SNAKE_CASE:Any						      =					{f.name for f in dataclasses.fields(SCREAMING_SNAKE_CASE__							) if f.init}
       SCREAMING_SNAKE_CASE:Union[str, Any]						      =					{k: v for k, v in args.items() if k in keys}
       unused_keys.difference_update(inputs.keys()							)
       SCREAMING_SNAKE_CASE:str						      =					dtype(**SCREAMING_SNAKE_CASE__							)
       outputs.append(SCREAMING_SNAKE_CASE__							)
     if not allow_extra_keys and unused_keys:
       raise ValueError(F'''Some keys are not used by the HfArgumentParser: {sorted(SCREAMING_SNAKE_CASE__							)}'''							)
     return tuple(SCREAMING_SNAKE_CASE__							)
   def     __UpperCamelCase						( self			:      Optional[int]     ,SCREAMING_SNAKE_CASE__			:      str     ,SCREAMING_SNAKE_CASE__			:      bool = False							):
     with open(Path(SCREAMING_SNAKE_CASE__							)     ,encoding="utf-8"							) as open_json_file:
       SCREAMING_SNAKE_CASE:List[Any]						      =					json.loads(open_json_file.read()							)
     SCREAMING_SNAKE_CASE:Dict						      =					self.parse_dict(SCREAMING_SNAKE_CASE__     ,allow_extra_keys=SCREAMING_SNAKE_CASE__							)
     return tuple(SCREAMING_SNAKE_CASE__							)







   def     __UpperCamelCase						( self			:      Optional[int]     ,SCREAMING_SNAKE_CASE__			:      str     ,SCREAMING_SNAKE_CASE__			:      bool = False							):
     SCREAMING_SNAKE_CASE:Any						      =					self.parse_dict(yaml.safe_load(Path(SCREAMING_SNAKE_CASE__							).read_text()							)     ,allow_extra_keys=SCREAMING_SNAKE_CASE__							)
     return tuple(SCREAMING_SNAKE_CASE__							)









'''simple docstring'''

from importlib import import_module

from .logging import get_logger


A_       						=							get_logger(__name__)





class 							_snake_case :
   def __init__( self			:      Dict     ,SCREAMING_SNAKE_CASE__			:      Any     ,SCREAMING_SNAKE_CASE__			:      Dict=None							):
     SCREAMING_SNAKE_CASE:Any						      =					attrs or []
     if module is not None:
       for key in module.__dict__:
         if key in attrs or not key.startswith("__"							):
           setattr(self     ,SCREAMING_SNAKE_CASE__     ,getattr(SCREAMING_SNAKE_CASE__     ,SCREAMING_SNAKE_CASE__							)							)
     SCREAMING_SNAKE_CASE:Any						      =					module._original_module if isinstance(SCREAMING_SNAKE_CASE__     ,_PatchedModuleObj							) else module





class 							_snake_case :
   _A       :     Any       =					[]
   def __init__( self			:      Any     ,SCREAMING_SNAKE_CASE__			:      List[str]     ,SCREAMING_SNAKE_CASE__			:      str     ,SCREAMING_SNAKE_CASE__			:      str     ,SCREAMING_SNAKE_CASE__			:      Optional[Any]=None							):
     SCREAMING_SNAKE_CASE:Any						      =					obj
     SCREAMING_SNAKE_CASE:Any						      =					target
     SCREAMING_SNAKE_CASE:Union[str, Any]						      =					new
     SCREAMING_SNAKE_CASE:Any						      =					target.split("."							)[0]
     SCREAMING_SNAKE_CASE:str						      =					{}
     SCREAMING_SNAKE_CASE:List[Any]						      =					attrs or []
   def __enter__( self			:      Tuple							):
     *SCREAMING_SNAKE_CASE      ,    SCREAMING_SNAKE_CASE:int						      =					self.target.split("."							)

     # Patch modules:
     # it's used to patch attributes of submodules like "os.path.join";
     # in this case we need to patch "os" and "os.path"

     for i in range(len(SCREAMING_SNAKE_CASE__							)							):
       try:
         SCREAMING_SNAKE_CASE:int						      =					import_module(".".join(submodules[: i + 1]							)							)
       except ModuleNotFoundError:
         continue
       # We iterate over all the globals in self.obj in case we find "os" or "os.path"
       for attr in self.obj.__dir__():
         SCREAMING_SNAKE_CASE:str						      =					getattr(self.obj     ,SCREAMING_SNAKE_CASE__							)
         # We don't check for the name of the global, but rather if its value *is* "os" or "os.path".
         # This allows to patch renamed modules like "from os import path as ospath".
         if obj_attr is submodule or (
             (isinstance(SCREAMING_SNAKE_CASE__     ,_PatchedModuleObj							) and obj_attr._original_module is submodule)
         ):
           SCREAMING_SNAKE_CASE:Union[str, Any]						      =					obj_attr
           # patch at top level
           setattr(self.obj     ,SCREAMING_SNAKE_CASE__     ,_PatchedModuleObj(SCREAMING_SNAKE_CASE__     ,attrs=self.attrs							)							)
           SCREAMING_SNAKE_CASE:int						      =					getattr(self.obj     ,SCREAMING_SNAKE_CASE__							)
           # construct lower levels patches
           for key in submodules[i + 1 :]:
             setattr(SCREAMING_SNAKE_CASE__     ,SCREAMING_SNAKE_CASE__     ,_PatchedModuleObj(getattr(SCREAMING_SNAKE_CASE__     ,SCREAMING_SNAKE_CASE__     ,SCREAMING_SNAKE_CASE__							)     ,attrs=self.attrs							)							)
             SCREAMING_SNAKE_CASE:Dict						      =					getattr(SCREAMING_SNAKE_CASE__     ,SCREAMING_SNAKE_CASE__							)
           # finally set the target attribute
           setattr(SCREAMING_SNAKE_CASE__     ,SCREAMING_SNAKE_CASE__     ,self.new							)

        # Patch attribute itself:
        # it's used for builtins like "open",
        # and also to patch "os.path.join" we may also need to patch "join"
        # itself if it was imported as "from os.path import join".

     if submodules:  # if it's an attribute of a submodule like "os.path.join"
       try:
         SCREAMING_SNAKE_CASE:Any						      =					getattr(import_module(".".join(SCREAMING_SNAKE_CASE__							)							)     ,SCREAMING_SNAKE_CASE__							)
       except (AttributeError, ModuleNotFoundError):
         return
       # We iterate over all the globals in self.obj in case we find "os.path.join"
       for attr in self.obj.__dir__():
         # We don't check for the name of the global, but rather if its value *is* "os.path.join".
         # This allows to patch renamed attributes like "from os.path import join as pjoin".
         if getattr(self.obj     ,SCREAMING_SNAKE_CASE__							) is attr_value:
           SCREAMING_SNAKE_CASE:Union[str, Any]						      =					getattr(self.obj     ,SCREAMING_SNAKE_CASE__							)
           setattr(self.obj     ,SCREAMING_SNAKE_CASE__     ,self.new							)
     elif target_attr in globals()["__builtins__"]:  # if it'a s builtin like "open"
       SCREAMING_SNAKE_CASE:int						      =					globals()["__builtins__"][target_attr]
       setattr(self.obj     ,SCREAMING_SNAKE_CASE__     ,self.new							)
     else:
       raise RuntimeError(F'''Tried to patch attribute {target_attr} instead of a submodule.'''							)
   def __exit__( self			:      List[Any]     ,*SCREAMING_SNAKE_CASE__			:      Union[str, Any]							):
     for attr in list(self.original							):
       setattr(self.obj     ,SCREAMING_SNAKE_CASE__     ,self.original.pop(SCREAMING_SNAKE_CASE__							)							)
   def     __UpperCamelCase						( self			:      Optional[int]							):
     self.__enter__()
     self._active_patches.append(self							)







   def     __UpperCamelCase						( self			:      Dict							):
     try:
       self._active_patches.remove(self							)
     except ValueError:
       # If the patch hasn't been started this will fail
       return None

     return self.__exit__()






