



"""simple docstring"""







import importlib.metadata
import subprocess
import sys


def  __SCREAMING_SNAKE_CASE (  __UpperCAmelCase = False      ):
		_lowercase				: int     =   False
		if "IPython" in sys.modules:
				_lowercase				: Union[str, Any]     =   """google.colab""" in str(sys.modules["""IPython"""].get_ipython()      )

		if in_colab:
				if upgrade:
						_lowercase				: Any     =   ["""pip""", """install""", """-U""", """torch"""]
						subprocess.run(__UpperCAmelCase   ,				check=__UpperCAmelCase      )
				# get the current version of torch
				_lowercase				: Union[str, Any]     =   importlib.metadata.version("""torch"""      )
				_lowercase				: List[Any]     =   torch_version[: torch_version.rindex("""."""      )]
				_lowercase				: Any     =   F"""https://storage.googleapis.com/tpu-pytorch/wheels/colab/torch_xla-{torch_version_trunc}-cp37-cp37m-linux_x86_64.whl"""
				_lowercase				: Tuple     =   ["""pip""", """install""", xla_wheel]
				subprocess.run(__UpperCAmelCase   ,				check=__UpperCAmelCase      )
		else:
				raise RuntimeError("""`install_xla` utility works only on google colab."""      )











# Copyright 2022 The HuggingFace Team. All rights reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

from pathlib import Path

from .config_args import default_config_file, load_config_from_file
from .config_utils import SubcommandHelpFormatter


UpperCAmelCase_					:		int           = '''Update an existing config file with the latest defaults while maintaining the old configuration.'''

def   SCREAMING_SNAKE_CASE_				(				__magic_name__   :    str   )						->     Dict:






	"""simple docstring"""



	UpperCamelCase	:Optional[int]		=      args.config_file
	if config_file is None and Path(__magic_name__   ).exists():
		UpperCamelCase	:int		=      default_config_file
	elif not Path(__magic_name__   ).exists():
		raise ValueError(f"""The passed config file located at {config_file} doesn't exist."""   )
	UpperCamelCase	:Dict		=      load_config_from_file(__magic_name__   )

	if config_file.endswith(""".json"""   ):
		config.to_json_file(__magic_name__   )
	else:
		config.to_yaml_file(__magic_name__   )
	return config_file

def   SCREAMING_SNAKE_CASE_				(				__magic_name__   :    int      ,     __magic_name__   :    Optional[Any]   )						->     List[str]:






	"""simple docstring"""



	UpperCamelCase	:Union[str, Any]		=      parser.add_parser("""update"""      ,     parents=__magic_name__      ,     help=__magic_name__      ,     formatter_class=__magic_name__   )
	parser.add_argument(
	    """--config_file"""      ,     default=__magic_name__      ,     help=(
	        """The path to the config file to update. Will default to a file named default_config.yaml in the cache """
	        """location, which is the content of the environment `HF_HOME` suffixed with 'accelerate', or if you don't have """
	        """such an environment variable, your cache directory ('~/.cache' or the content of `XDG_CACHE_HOME`) suffixed """
	        """with 'huggingface'."""
	    )      ,     )

	parser.set_defaults(func=__magic_name__   )
	return parser

def   SCREAMING_SNAKE_CASE_				(				__magic_name__   :    Union[str, Any]   )						->     Union[str, Any]:






	"""simple docstring"""



	UpperCamelCase	:Tuple		=      update_config(__magic_name__   )
	print(f"""Sucessfully updated the configuration file at {config_file}."""   )
