






"""simple docstring"""


from scipy.constants import g


def 					UpperCAmelCase			(				a__    ,			a__   ):





						'''simple docstring'''






						if mass < 0:
												# handling of negative values of mass
												raise ValueError('The mass of a body cannot be negative'   )
						if height < 0:
												# handling of negative values of height
												raise ValueError('The height above the ground cannot be negative'   )
						return mass * g * height


if __name__ == "__main__":
		from doctest import testmod

		testmod(name='potential_energy')







"""simple docstring"""


import os
from argparse import ArgumentParser
from pathlib import Path
from shutil import copyfile, rmtree
from typing import Generator

import datasets.config
from datasets.builder import DatasetBuilder
from datasets.commands import BaseDatasetsCLICommand
from datasets.download.download_manager import DownloadMode
from datasets.load import dataset_module_factory, import_main_class
from datasets.utils.filelock import logger as fl_logger
from datasets.utils.info_utils import VerificationMode
from datasets.utils.logging import ERROR, get_logger


__SCREAMING_SNAKE_CASE      =      get_logger(__name__)


def 					UpperCAmelCase			(				a__   ):





						'''simple docstring'''






						return TestCommand(
						    args.dataset    ,			args.name    ,			args.cache_dir    ,			args.data_dir    ,			args.all_configs    ,			args.save_info or args.save_infos    ,			args.ignore_verifications    ,			args.force_redownload    ,			args.clear_cache    ,			)







class 	__UpperCamelCase    (    UpperCamelCase	):
					lowercase_						:							str			=     False  # to tell pytest it's not a test class
					@staticmethod
					def 					UpperCAmelCase__   (       UpperCAmelCase       :  ArgumentParser      )  ->					Optional[int]:
											lowerCAmelCase      :Union[str, Any]				  = parser.add_parser('test'    ,   help='Test dataset implementation.'      )
											test_parser.add_argument('--name'    ,   type=UpperCAmelCase    ,   default=UpperCAmelCase    ,   help='Dataset processing name'      )
											test_parser.add_argument(
											    '--cache_dir'    ,   type=UpperCAmelCase    ,   default=UpperCAmelCase    ,   help='Cache directory where the datasets are stored.'    ,   )
											test_parser.add_argument(
											    '--data_dir'    ,   type=UpperCAmelCase    ,   default=UpperCAmelCase    ,   help='Can be used to specify a manual directory to get the files from.'    ,   )
											test_parser.add_argument('--all_configs'    ,   action='store_true'    ,   help='Test all dataset configurations'      )
											test_parser.add_argument(
											    '--save_info'    ,   action='store_true'    ,   help='Save the dataset infos in the dataset card (README.md)'      )
											test_parser.add_argument(
											    '--ignore_verifications'    ,   action='store_true'    ,   help='Run the test without checksums and splits checks.'    ,   )
											test_parser.add_argument('--force_redownload'    ,   action='store_true'    ,   help='Force dataset redownload'      )
											test_parser.add_argument(
											    '--clear_cache'    ,   action='store_true'    ,   help='Remove downloaded files and cached datasets after each config test'    ,   )
											# aliases
											test_parser.add_argument('--save_infos'    ,   action='store_true'    ,   help='alias to save_info'      )
											test_parser.add_argument('dataset'    ,   type=UpperCAmelCase    ,   help='Name of the dataset to download'      )
											test_parser.set_defaults(func=_test_command_factory      )
					def __init__(       self       :  List[Any]    ,   UpperCAmelCase       :  str    ,   UpperCAmelCase       :  str    ,   UpperCAmelCase       :  str    ,   UpperCAmelCase       :  str    ,   UpperCAmelCase       :  bool    ,   UpperCAmelCase       :  bool    ,   UpperCAmelCase       :  bool    ,   UpperCAmelCase       :  bool    ,   UpperCAmelCase       :  bool    ,   )  ->					Any:
											lowerCAmelCase      :int				  = dataset
											lowerCAmelCase      :Tuple				  = name
											lowerCAmelCase      :Tuple				  = cache_dir
											lowerCAmelCase      :List[Any]				  = data_dir
											lowerCAmelCase      :int				  = all_configs
											lowerCAmelCase      :Dict				  = save_infos
											lowerCAmelCase      :Union[str, Any]				  = ignore_verifications
											lowerCAmelCase      :int				  = force_redownload
											lowerCAmelCase      :Union[str, Any]				  = clear_cache
											if clear_cache and not cache_dir:
																	print(
																	    'When --clear_cache is used, specifying a cache directory is mandatory.\n'
																	    'The \'download\' folder of the cache directory and the dataset builder cache will be deleted after each configuration test.\n'
																	    'Please provide a --cache_dir that will be used to test the dataset script.'      )
																	exit(1      )
											if save_infos:
																	lowerCAmelCase      :List[str]				  = True
					def 					UpperCAmelCase__   (       self       :  Optional[Any]      )  ->					int:
											fl_logger().setLevel(UpperCAmelCase      )
											if self._name is not None and self._all_configs:
																	print('Both parameters `config` and `all_configs` can\'t be used at once.'      )
																	exit(1      )
											lowerCAmelCase  ,   lowerCAmelCase      :Dict				  = self._dataset, self._name
											lowerCAmelCase      :int				  = dataset_module_factory(UpperCAmelCase      )
											lowerCAmelCase      :int				  = import_main_class(module.module_path      )
											lowerCAmelCase      :Dict				  = len(builder_cls.BUILDER_CONFIGS      ) if self._all_configs and builder_cls.BUILDER_CONFIGS else 1

											def get_builders() -> Generator[DatasetBuilder, None, None]:
																	if self._all_configs and builder_cls.BUILDER_CONFIGS:
																							for i, config in enumerate(builder_cls.BUILDER_CONFIGS      ):
																													if "config_name" in module.builder_kwargs:
																																			yield builder_cls(
																																			    cache_dir=self._cache_dir    ,   data_dir=self._data_dir    ,   **module.builder_kwargs    ,   )
																													else:
																																			yield builder_cls(
																																			    config_name=config.name    ,   cache_dir=self._cache_dir    ,   data_dir=self._data_dir    ,   **module.builder_kwargs    ,   )
																	else:
																							if "config_name" in module.builder_kwargs:
																													yield builder_cls(cache_dir=self._cache_dir    ,   data_dir=self._data_dir    ,   **module.builder_kwargs      )
																							else:
																													yield builder_cls(
																													    config_name=UpperCAmelCase    ,   cache_dir=self._cache_dir    ,   data_dir=self._data_dir    ,   **module.builder_kwargs    ,   )

											for j, builder in enumerate(get_builders()      ):
																	print(f"""Testing builder '{builder.config.name}' ({j + 1}/{n_builders})"""      )
																	lowerCAmelCase      :int				  = os.path.exists(
																	    os.path.join(builder.get_imported_module_dir()    ,   datasets.config.DATASETDICT_INFOS_FILENAME      )      )  # record checksums only if we need to update a (deprecated) dataset_infos.json
																	builder.download_and_prepare(
																	    download_mode=DownloadMode.REUSE_CACHE_IF_EXISTS
																	    if not self._force_redownload
																	    else DownloadMode.FORCE_REDOWNLOAD    ,   verification_mode=VerificationMode.NO_CHECKS
																	    if self._ignore_verifications
																	    else VerificationMode.ALL_CHECKS    ,   try_from_hf_gcs=UpperCAmelCase    ,   )
																	builder.as_dataset()
																	if self._save_infos:
																							builder._save_infos()

																	# If save_infos=True, the dataset card (README.md) is created next to the loaded module file.
																	# The dataset_infos are saved in the YAML part of the README.md

																	# Let's move it to the original directory of the dataset script, to allow the user to
																	# upload them on S3 at the same time afterwards.
																	if self._save_infos:
																							lowerCAmelCase      :Optional[Any]				  = os.path.join(builder_cls.get_imported_module_dir()    ,   'README.md'      )
																							lowerCAmelCase      :List[str]				  = Path(UpperCAmelCase      ).name + '.py'
																							lowerCAmelCase      :Dict				  = os.path.join(UpperCAmelCase    ,   UpperCAmelCase      )
																							if os.path.isfile(UpperCAmelCase      ):
																													lowerCAmelCase      :Any				  = os.path.dirname(UpperCAmelCase      )
																							elif os.path.isfile(UpperCAmelCase      ):
																													lowerCAmelCase      :Any				  = path
																							elif os.path.isdir(UpperCAmelCase      ):  # for local directories containing only data files
																													lowerCAmelCase      :Dict				  = path
																							else:  # in case of a remote dataset
																													lowerCAmelCase      :int				  = None
																													print(f"""Dataset card saved at {dataset_readme_path}"""      )

																							# Move dataset_info back to the user
																							if dataset_dir is not None:
																													lowerCAmelCase      :Any				  = os.path.join(UpperCAmelCase    ,   'README.md'      )
																													copyfile(UpperCAmelCase    ,   UpperCAmelCase      )
																													print(f"""Dataset card saved at {user_dataset_readme_path}"""      )

            # If clear_cache=True, the download folder and the dataset builder cache directory are deleted
																	if self._clear_cache:
																							if os.path.isdir(builder._cache_dir      ):
																													logger.warning(f"""Clearing cache at {builder._cache_dir}"""      )
																													rmtree(builder._cache_dir      )
																							lowerCAmelCase      :str				  = os.path.join(self._cache_dir    ,   datasets.config.DOWNLOADED_DATASETS_DIR      )
																							if os.path.isdir(UpperCAmelCase      ):
																													logger.warning(f"""Clearing cache at {download_dir}"""      )
																													rmtree(UpperCAmelCase      )

											print('Test successful.'      )