




import asyncio
import os
import re
import sys
import tempfile
import unittest
from contextlib import contextmanager
from copy import deepcopy
from distutils.util import strtobool
from enum import Enum
from importlib.util import find_spec
from pathlib import Path
from unittest.mock import patch

import pyarrow as pa
import pytest
import requests
from packaging import version

from datasets import config


if config.PY_VERSION < version.parse('''3.8'''):
						import importlib_metadata
else:
						import importlib.metadata as importlib_metadata





def __UpperCamelCase			(       _A ,  _A=False  ):
						try:
												lowerCAmelCase_      			=  os.environ[key]
						except KeyError:
												# KEY isn't set, default to `default`.
												lowerCAmelCase_      			=  default
						else:
												# KEY is set, convert it to True or False.
												try:
																		lowerCAmelCase_      			=  strtobool(_A  )
												except ValueError:
																		# More values are supported, but let's keep the message simple.
																		raise ValueError(f"If set, {key} must be yes or no."  )
						return _value


_A     =			parse_flag_from_env('''RUN_SLOW''', default=False)
_A     =			parse_flag_from_env('''RUN_REMOTE''', default=False)
_A     =			parse_flag_from_env('''RUN_LOCAL''', default=True)
_A     =			parse_flag_from_env('''RUN_PACKAGED''', default=True)

# Compression
_A     =			pytest.mark.skipif(not config.LZ4_AVAILABLE, reason='''test requires lz4''')
_A     =			pytest.mark.skipif(not config.PY7ZR_AVAILABLE, reason='''test requires py7zr''')
_A     =			pytest.mark.skipif(not config.ZSTANDARD_AVAILABLE, reason='''test requires zstandard''')

# Audio
_A     =			pytest.mark.skipif(
    # On Windows and OS X, soundfile installs sndfile
    find_spec('''soundfile''') is None or version.parse(importlib_metadata.version('''soundfile''')) < version.parse('''0.12.0'''),
    reason='''test requires sndfile>=0.12.1: \'pip install \"soundfile>=0.12.1\"\'; ''',
)

# Beam
_A     =			pytest.mark.skipif(
    not config.BEAM_AVAILABLE or config.DILL_VERSION >= version.parse('''0.3.2'''),
    reason='''test requires apache-beam and a compatible dill version''',
)

# Dill-cloudpickle compatibility
_A     =			pytest.mark.skipif(
    config.DILL_VERSION <= version.parse('''0.3.2'''),
    reason='''test requires dill>0.3.2 for cloudpickle compatibility''',
)

# Windows
_A     =			pytest.mark.skipif(
    sys.platform == '''win32''',
    reason='''test should not be run on Windows''',
)





def __UpperCamelCase			(       _A  ):
						try:
												import faiss  # noqa
						except ImportError:
												lowerCAmelCase_      			=  unittest.skip('''test requires faiss'''  )(_A  )
						return test_case





def __UpperCamelCase			(       _A  ):
						try:
												import regex  # noqa
						except ImportError:
												lowerCAmelCase_      			=  unittest.skip('''test requires regex'''  )(_A  )
						return test_case





def __UpperCamelCase			(       _A  ):
						try:
												import elasticsearch  # noqa
						except ImportError:
												lowerCAmelCase_      			=  unittest.skip('''test requires elasticsearch'''  )(_A  )
						return test_case





def __UpperCamelCase			(       _A  ):
						try:
												import sqlalchemy  # noqa
						except ImportError:
												lowerCAmelCase_      			=  unittest.skip('''test requires sqlalchemy'''  )(_A  )
						return test_case





def __UpperCamelCase			(       _A  ):
						if not config.TORCH_AVAILABLE:
												lowerCAmelCase_      			=  unittest.skip('''test requires PyTorch'''  )(_A  )
						return test_case





def __UpperCamelCase			(       _A  ):
						if not config.TF_AVAILABLE:
												lowerCAmelCase_      			=  unittest.skip('''test requires TensorFlow'''  )(_A  )
						return test_case





def __UpperCamelCase			(       _A  ):
						if not config.JAX_AVAILABLE:
												lowerCAmelCase_      			=  unittest.skip('''test requires JAX'''  )(_A  )
						return test_case





def __UpperCamelCase			(       _A  ):
						if not config.PIL_AVAILABLE:
												lowerCAmelCase_      			=  unittest.skip('''test requires Pillow'''  )(_A  )
						return test_case





def __UpperCamelCase			(       _A  ):
						try:
												import transformers  # noqa F401
						except ImportError:
												return unittest.skip('''test requires transformers'''  )(_A  )
						else:
												return test_case





def __UpperCamelCase			(       _A  ):
						try:
												import tiktoken  # noqa F401
						except ImportError:
												return unittest.skip('''test requires tiktoken'''  )(_A  )
						else:
												return test_case





def __UpperCamelCase			(       _A  ):
						try:
												import spacy  # noqa F401
						except ImportError:
												return unittest.skip('''test requires spacy'''  )(_A  )
						else:
												return test_case





def __UpperCamelCase			(       _A  ):

						def _require_spacy_model(_A  ):
												try:
																		import spacy  # noqa F401

																		spacy.load(_A  )
												except ImportError:
																		return unittest.skip('''test requires spacy'''  )(_A  )
												except OSError:
																		return unittest.skip('''test requires spacy model \'{}\''''.format(_A  )  )(_A  )
												else:
																		return test_case

						return _require_spacy_model





def __UpperCamelCase			(       _A  ):
						try:
												import pyspark  # noqa F401
						except ImportError:
												return unittest.skip('''test requires pyspark'''  )(_A  )
						else:
												return test_case





def __UpperCamelCase			(       _A  ):
						try:
												import joblibspark  # noqa F401
						except ImportError:
												return unittest.skip('''test requires joblibspark'''  )(_A  )
						else:
												return test_case





def __UpperCamelCase			(       _A  ):
						if not _run_slow_tests or _run_slow_tests == 0:
												lowerCAmelCase_      			=  unittest.skip('''test is slow'''  )(_A  )
						return test_case





def __UpperCamelCase			(       _A  ):
						if not _run_local_tests or _run_local_tests == 0:
												lowerCAmelCase_      			=  unittest.skip('''test is local'''  )(_A  )
						return test_case





def __UpperCamelCase			(       _A  ):
						if not _run_packaged_tests or _run_packaged_tests == 0:
												lowerCAmelCase_      			=  unittest.skip('''test is packaged'''  )(_A  )
						return test_case





def __UpperCamelCase			(       _A  ):
						if not _run_remote_tests or _run_remote_tests == 0:
												lowerCAmelCase_      			=  unittest.skip('''test requires remote'''  )(_A  )
						return test_case





def __UpperCamelCase			(       *_A  ):
						def decorate(cls  ):
												for name, fn in cls.__dict__.items():
																		if callable(_A  ) and name.startswith('''test'''  ):
																								for decorator in decorators:
																														lowerCAmelCase_      			=  decorator(_A  )
																								setattr(cls ,  _A ,  _A  )
												return cls

						return decorate


class  A		(  __UpperCAmelCase     ):
		pass







class  A		(  __UpperCAmelCase     ):
		__snake_case									=   0
		__snake_case									=   1
		__snake_case									=   2







@contextmanager
def __UpperCamelCase			(       _A=OfflineSimulationMode.CONNECTION_FAILS ,  _A=1E-1_6  ):
						lowerCAmelCase_      			=  requests.Session().request

						def timeout_request(_A ,  _A ,  _A ,  **_A  ):
												# Change the url to an invalid url so that the connection hangs
												lowerCAmelCase_      			=  '''https://10.255.255.1'''
												if kwargs.get('''timeout'''  ) is None:
																		raise RequestWouldHangIndefinitelyError(
																		    f"Tried a call to {url} in offline mode with no timeout set. Please set a timeout."  )
												lowerCAmelCase_      			=  timeout
												try:
																		return online_request(_A ,  _A ,  **_A  )
												except Exception as e:
																		# The following changes in the error are just here to make the offline timeout error prettier
																		lowerCAmelCase_      			=  url
																		lowerCAmelCase_      			=  e.args[0]
																		lowerCAmelCase_      			=  (max_retry_error.args[0].replace('''10.255.255.1''' ,  f"OfflineMock[{url}]"  ),)
																		lowerCAmelCase_      			=  (max_retry_error,)
																		raise

						def raise_connection_error(_A ,  _A ,  **_A  ):
												raise requests.ConnectionError('''Offline mode is enabled.''' ,  request=_A  )

						if mode is OfflineSimulationMode.CONNECTION_FAILS:
												with patch('''requests.Session.send''' ,  _A  ):
																		yield
						elif mode is OfflineSimulationMode.CONNECTION_TIMES_OUT:
												# inspired from https://stackoverflow.com/a/904609
												with patch('''requests.Session.request''' ,  _A  ):
																		yield
						elif mode is OfflineSimulationMode.HF_DATASETS_OFFLINE_SET_TO_1:
												with patch('''datasets.config.HF_DATASETS_OFFLINE''' ,  _A  ):
																		yield
						else:
												raise ValueError('''Please use a value from the OfflineSimulationMode enum.'''  )





@contextmanager
def __UpperCamelCase			(       *_A ,  **_A  ):
						lowerCAmelCase_      			=  str(Path().resolve()  )
						with tempfile.TemporaryDirectory(*_A ,  **_A  ) as tmp_dir:
												try:
																		os.chdir(_A  )
																		yield
												finally:
																		os.chdir(_A  )





@contextmanager
def __UpperCamelCase			(       ):
						import gc

						gc.collect()
						lowerCAmelCase_      			=  pa.total_allocated_bytes()
						yield
						assert pa.total_allocated_bytes() - previous_allocated_memory > 0, "Arrow memory didn't increase."





@contextmanager
def __UpperCamelCase			(       ):
						import gc

						gc.collect()
						lowerCAmelCase_      			=  pa.total_allocated_bytes()
						yield
						assert pa.total_allocated_bytes() - previous_allocated_memory <= 0, "Arrow memory wasn't expected to increase."





def __UpperCamelCase			(       _A ,  _A  ):
						return deepcopy(_A  ).integers(0 ,  100 ,  10  ).tolist() == deepcopy(_A  ).integers(0 ,  100 ,  10  ).tolist()





def __UpperCamelCase			(       _A  ):
						import decorator
						from requests.exceptions import HTTPError

						def _wrapper(_A ,  *_A ,  **_A  ):
												try:
																		return func(*_A ,  **_A  )
												except HTTPError as err:
																		if str(_A  ).startswith('''500'''  ) or str(_A  ).startswith('''502'''  ):
																								pytest.xfail(str(_A  )  )
																		raise err

						return decorator.decorator(_wrapper ,  _A  )


class  A		:



		def __init__(     self,	UpperCamelCase__,	UpperCamelCase__,	UpperCamelCase__   ):







								"""simple docstring"""



								lowerCAmelCase_      			=  returncode
								lowerCAmelCase_      			=  stdout
								lowerCAmelCase_      			=  stderr







async def __UpperCamelCase			(       _A ,  _A  ):
						while True:
												lowerCAmelCase_      			=  await stream.readline()
												if line:
																		callback(_A  )
												else:
																		break





async def __UpperCamelCase			(       _A ,  _A=None ,  _A=None ,  _A=None ,  _A=False ,  _A=False  ):
						if echo:
												print('''\nRunning: ''' ,  ''' '''.join(_A  )  )

						lowerCAmelCase_      			=  await asyncio.create_subprocess_exec(
						    cmd[0] ,  *cmd[1:] ,  stdin=_A ,  stdout=asyncio.subprocess.PIPE ,  stderr=asyncio.subprocess.PIPE ,  env=_A ,  )

						# note: there is a warning for a possible deadlock when using `wait` with huge amounts of data in the pipe
						# https://docs.python.org/3/library/asyncio-subprocess.html#asyncio.asyncio.subprocess.Process.wait
						#
						# If it starts hanging, will need to switch to the following code. The problem is that no data
						# will be seen until it's done and if it hangs for example there will be no debug info.
						# out, err = await p.communicate()
						# return _RunOutput(p.returncode, out, err)

						lowerCAmelCase_      			=  []
						lowerCAmelCase_      			=  []

						def tee(_A ,  _A ,  _A ,  _A=""  ):
												lowerCAmelCase_      			=  line.decode('''utf-8'''  ).rstrip()
												sink.append(_A  )
												if not quiet:
																		print(_A ,  _A ,  file=_A  )

    # XXX: the timeout doesn't seem to make any difference here
						await asyncio.wait(
						    [
						        _read_stream(p.stdout ,  lambda _A  : tee(_A ,  _A ,  sys.stdout ,  label='''stdout:'''  )  ),
						        _read_stream(p.stderr ,  lambda _A  : tee(_A ,  _A ,  sys.stderr ,  label='''stderr:'''  )  ),
						    ] ,  timeout=_A ,  )
						return _RunOutput(await p.wait() ,  _A ,  _A  )





def __UpperCamelCase			(       _A ,  _A=None ,  _A=None ,  _A=180 ,  _A=False ,  _A=True  ):
						lowerCAmelCase_      			=  asyncio.get_event_loop()
						lowerCAmelCase_      			=  loop.run_until_complete(
						    _stream_subprocess(_A ,  env=_A ,  stdin=_A ,  timeout=_A ,  quiet=_A ,  echo=_A  )  )

						lowerCAmelCase_      			=  ''' '''.join(_A  )
						if result.returncode > 0:
												lowerCAmelCase_      			=  '''\n'''.join(result.stderr  )
												raise RuntimeError(
												    f"'{cmd_str}' failed with returncode {result.returncode}\n\n"
												    f"The combined stderr from workers follows:\n{stderr}"  )

						# check that the subprocess actually did run and produced some output, should the test rely on
						# the remote side to do the testing
						if not result.stdout and not result.stderr:
												raise RuntimeError(f"'{cmd_str}' produced no output."  )

						return result





def __UpperCamelCase			(       ):
						lowerCAmelCase_      			=  os.environ.get('''PYTEST_XDIST_WORKER''' ,  '''gw0'''  )
						lowerCAmelCase_      			=  re.sub(r'''^gw''' ,  '''''' ,  _A ,  0 ,  re.M  )
						return int(_A  )






def __UpperCamelCase			(       ):
						lowerCAmelCase_      			=  29500
						lowerCAmelCase_      			=  pytest_xdist_worker_id()
						return port + uniq_delta










import argparse
from collections import defaultdict

import yaml


_A     =			'''docs/source/en/_toctree.yml'''





def __UpperCamelCase			(       _A  ):
						lowerCAmelCase_      			=  defaultdict(_A  )
						for doc in model_doc:
												counts[doc["local"]] += 1
						lowerCAmelCase_      			=  [key for key, value in counts.items() if value > 1]

						lowerCAmelCase_      			=  []
						for duplicate_key in duplicates:
												lowerCAmelCase_      			=  list({doc['''title'''] for doc in model_doc if doc['''local'''] == duplicate_key}  )
												if len(_A  ) > 1:
																		raise ValueError(
																		    f"{duplicate_key} is present several times in the documentation table of content at "
																		    '''`docs/source/en/_toctree.yml` with different *Title* values. Choose one of those and remove the '''
																		    '''others.'''  )
												# Only add this once
												new_doc.append({'''local''': duplicate_key, '''title''': titles[0]}  )

						# Add none duplicate-keys
						new_doc.extend([doc for doc in model_doc if counts[doc['''local''']] == 1]  )

						# Sort
						return sorted(_A ,  key=lambda _A  : s["title"].lower()  )





def __UpperCamelCase			(       _A=False  ):
						with open(_A ,  encoding='''utf-8'''  ) as f:
												lowerCAmelCase_      			=  yaml.safe_load(f.read()  )

						# Get to the API doc
						lowerCAmelCase_      			=  0
						while content[api_idx]["title"] != "API":
												api_idx += 1
						lowerCAmelCase_      			=  content[api_idx]['''sections''']

						# Then to the model doc
						lowerCAmelCase_      			=  0
						while api_doc[model_idx]["title"] != "Models":
												model_idx += 1

						lowerCAmelCase_      			=  api_doc[model_idx]['''sections''']

						lowerCAmelCase_      			=  [(idx, section) for idx, section in enumerate(_A  ) if '''sections''' in section]
						lowerCAmelCase_      			=  False
						for idx, modality_doc in modalities_docs:
												lowerCAmelCase_      			=  modality_doc['''sections''']
												lowerCAmelCase_      			=  clean_model_doc_toc(_A  )

												if old_modality_doc != new_modality_doc:
																		lowerCAmelCase_      			=  True
																		if overwrite:
																								lowerCAmelCase_      			=  new_modality_doc

						if diff:
												if overwrite:
																		lowerCAmelCase_      			=  model_doc
																		lowerCAmelCase_      			=  api_doc
																		with open(_A ,  '''w''' ,  encoding='''utf-8'''  ) as f:
																								f.write(yaml.dump(_A ,  allow_unicode=_A  )  )
												else:
																		raise ValueError(
																		    '''The model doc part of the table of content is not properly sorted, run `make style` to fix this.'''  )


if __name__ == "__main__":
						_A     =			argparse.ArgumentParser()
						parser.add_argument('''--fix_and_overwrite''', action='''store_true''', help='''Whether to fix inconsistencies.''')
						_A     =			parser.parse_args()

						check_model_doc(args.fix_and_overwrite)




