code: 
  '''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
  
  
  _UpperCAmelCase   :      Dict 						=  get_logger(__name__)
  
  
  
  
  
  
  
  def 						snake_case__	(      UpperCamelCase	) ->      str:
  		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				(					a_ ):
  
  
  
  
  
  		"""simple docstring"""
  
  
  
  
  
  		A__  :   Union[str, Any]          =    False  # to tell pytest it's not a test class
  		@staticmethod
  		def _lowercase  (    _snake_case     )				->    Optional[int]:
  				_UpperCamelCase       : Dict    =      parser.add_parser('''test'''  ,					help='''Test dataset implementation.'''     )
  				test_parser.add_argument('''--name'''  ,					type=_snake_case  ,					default=_snake_case  ,					help='''Dataset processing name'''     )
  				test_parser.add_argument(
  				    '''--cache_dir'''  ,					type=_snake_case  ,					default=_snake_case  ,					help='''Cache directory where the datasets are stored.'''  ,					)
  				test_parser.add_argument(
  				    '''--data_dir'''  ,					type=_snake_case  ,					default=_snake_case  ,					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=_snake_case  ,					help='''Name of the dataset to download'''     )
  				test_parser.set_defaults(func=_test_command_factory     )
  		def __init__(    self  ,					_snake_case  ,					_snake_case  ,					_snake_case  ,					_snake_case  ,					_snake_case  ,					_snake_case  ,					_snake_case  ,					_snake_case  ,					_snake_case  ,					)				->    Tuple:
  				_UpperCamelCase       : Tuple    =      dataset
  				_UpperCamelCase       : List[Any]    =      name
  				_UpperCamelCase       : Optional[Any]    =      cache_dir
  				_UpperCamelCase       : str    =      data_dir
  				_UpperCamelCase       : int    =      all_configs
  				_UpperCamelCase       : int    =      save_infos
  				_UpperCamelCase       : str    =      ignore_verifications
  				_UpperCamelCase       : str    =      force_redownload
  				_UpperCamelCase       : 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:
  						_UpperCamelCase       : Optional[Any]    =      True
  
  
  
  
  		def _lowercase  (    self     )				->    Optional[Any]:
  				fl_logger().setLevel(_snake_case     )
  				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     )
  				_UpperCamelCase,							_UpperCamelCase       : List[Any]    =      self._dataset, self._name
  				_UpperCamelCase       : Tuple    =      dataset_module_factory(_snake_case     )
  				_UpperCamelCase       : Optional[int]    =      import_main_class(module.module_path     )
  				_UpperCamelCase       : int    =      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=_snake_case  ,					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})'''     )
  						_UpperCamelCase       : Any    =      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=_snake_case  ,					)
  						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:
  								_UpperCamelCase       : Union[str, Any]    =      os.path.join(builder_cls.get_imported_module_dir()  ,					'''README.md'''     )
  								_UpperCamelCase       : Tuple    =      Path(_snake_case     ).name + '''.py'''
  								_UpperCamelCase       : Any    =      os.path.join(_snake_case  ,					_snake_case     )
  								if os.path.isfile(_snake_case     ):
  										_UpperCamelCase       : List[Any]    =      os.path.dirname(_snake_case     )
  								elif os.path.isfile(_snake_case     ):
  										_UpperCamelCase       : Tuple    =      path
  								elif os.path.isdir(_snake_case     ):  # for local directories containing only data files
  										_UpperCamelCase       : Dict    =      path
  								else:  # in case of a remote dataset
  										_UpperCamelCase       : List[str]    =      None
  										print(F'''Dataset card saved at {dataset_readme_path}'''     )
  
  								# Move dataset_info back to the user
  								if dataset_dir is not None:
  										_UpperCamelCase       : Union[str, Any]    =      os.path.join(_snake_case  ,					'''README.md'''     )
  										copyfile(_snake_case  ,					_snake_case     )
  										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     )
  								_UpperCamelCase       : Optional[Any]    =      os.path.join(self._cache_dir  ,					datasets.config.DOWNLOADED_DATASETS_DIR     )
  								if os.path.isdir(_snake_case     ):
  										logger.warning(F'''Clearing cache at {download_dir}'''     )
  										rmtree(_snake_case     )
  
  				print('''Test successful.'''     )
  
  
  
  
  
  
style_context: 
  '''simple docstring'''
  
  from __future__ import annotations
  
  from collections.abc import Iterable
  from dataclasses import dataclass
  from typing import Any
  
  class 			UpperCAmelCase				:
  
  
  
  
  
  		"""simple docstring"""
  
  
  
  
  
  		A__  :   List[str]          =    ('_front', '_back', '_len')
  
  		@dataclass
  		class 			UpperCAmelCase				:
  
  
  
  
  
  				"""simple docstring"""
  
  
  
  
  
  				A__  :   Any          =    None
  				A__  :   Deque._Node | None          =    None
  				A__  :   Deque._Node | None          =    None
  
  
  
  
  
  
  
  		class 			UpperCAmelCase				:
  
  
  
  
  
  				"""simple docstring"""
  
  
  
  
  
  				A__  :   Any          =    ('_cur',)
  				def __init__(    self  ,					_snake_case     )				->    None:
  						_UpperCamelCase       : Any    =      cur
  				def __iter__(    self     )				->    Deque._Iterator:
  						return self
  
  
  
  
  				def _lowercase  (    self     )				->    Any:
  						if self._cur is None:
  								# finished iterating
  								raise StopIteration
  						_UpperCamelCase       : List[Any]    =      self._cur.val
  						_UpperCamelCase       : List[Any]    =      self._cur.next_node
  
  						return val
  
  
  
  
  
  
  
  		def __init__(    self  ,					_snake_case = None     )				->    None:
  				_UpperCamelCase       : Any    =      None
  				_UpperCamelCase       : Any    =      None
  				_UpperCamelCase       : int    =      0
  
  				if iterable is not None:
  						# append every value to the deque
  						for val in iterable:
  								self.append(_snake_case     )
  		def _lowercase  (    self  ,					_snake_case     )				->    None:
  				_UpperCamelCase       : List[str]    =      self._Node(_snake_case  ,					_snake_case  ,					_snake_case     )
  				if self.is_empty():
  						# front = back
  						_UpperCamelCase       : Union[str, Any]    =      node
  						_UpperCamelCase       : Tuple    =      1
  				else:
  						# connect nodes
  						_UpperCamelCase       : Union[str, Any]    =      node
  						_UpperCamelCase       : int    =      self._back
  						_UpperCamelCase       : List[Any]    =      node  # assign new back to the new node
  
  						self._len += 1
  
  						# make sure there were no errors
  						assert not self.is_empty(), "Error on appending value."
  		def _lowercase  (    self  ,					_snake_case     )				->    None:
  				_UpperCamelCase       : Optional[Any]    =      self._Node(_snake_case  ,					_snake_case  ,					_snake_case     )
  				if self.is_empty():
  						# front = back
  						_UpperCamelCase       : Union[str, Any]    =      node
  						_UpperCamelCase       : Optional[int]    =      1
  				else:
  						# connect nodes
  						_UpperCamelCase       : Tuple    =      self._front
  						_UpperCamelCase       : Optional[int]    =      node
  						_UpperCamelCase       : List[str]    =      node  # assign new front to the new node
  
  						self._len += 1
  
  						# make sure there were no errors
  						assert not self.is_empty(), "Error on appending value."
  		def _lowercase  (    self  ,					_snake_case     )				->    None:
  				for val in iterable:
  						self.append(_snake_case     )
  		def _lowercase  (    self  ,					_snake_case     )				->    None:
  				for val in iterable:
  						self.appendleft(_snake_case     )
  		def _lowercase  (    self     )				->    Any:
  				assert not self.is_empty(), "Deque is empty."
  
  				_UpperCamelCase       : int    =      self._back
  				_UpperCamelCase       : List[Any]    =      self._back.prev_node  # set new back
  				# drop the last node - python will deallocate memory automatically
  				_UpperCamelCase       : Union[str, Any]    =      None
  
  				self._len -= 1
  
  				return topop.val
  		def _lowercase  (    self     )				->    Any:
  				assert not self.is_empty(), "Deque is empty."
  
  				_UpperCamelCase       : List[Any]    =      self._front
  				_UpperCamelCase       : str    =      self._front.next_node  # set new front and drop the first node
  				_UpperCamelCase       : Union[str, Any]    =      None
  
  				self._len -= 1
  
  				return topop.val
  		def _lowercase  (    self     )				->    bool:
  				return self._front is None
  		def __len__(    self     )				->    int:
  				return self._len
  		def __eq__(    self  ,					_snake_case     )				->    bool:
  
  				if not isinstance(_snake_case  ,					_snake_case     ):
  						return NotImplemented
  
  				_UpperCamelCase       : Optional[int]    =      self._front
  				_UpperCamelCase       : List[Any]    =      other._front
  
  				# if the length of the dequeues are not the same, they are not equal
  				if len(self     ) != len(_snake_case     ):
  						return False
  
  				while me is not None and oth is not None:
  						# compare every value
  						if me.val != oth.val:
  								return False
  						_UpperCamelCase       : str    =      me.next_node
  						_UpperCamelCase       : List[str]    =      oth.next_node
  
  				return True
  		def __iter__(    self     )				->    Deque._Iterator:
  				return Deque._Iterator(self._front     )
  
  
  
  
  		def __repr__(    self     )				->    str:
  				_UpperCamelCase       : str    =      []
  				_UpperCamelCase       : Tuple    =      self._front
  				while aux is not None:
  						# append the values in a list to display
  						values_list.append(aux.val     )
  						_UpperCamelCase       : List[str]    =      aux.next_node
  
  				return F'''[{', '.join(repr(_snake_case     ) for val in values_list     )}]'''
  
  
  if __name__ == "__main__":
  	import doctest
  
  	doctest.testmod()
  
  
  
  
  
  