


"""simple docstring"""
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 						_a				(      _SCREAMING_SNAKE_CASE				, _SCREAMING_SNAKE_CASE=False				)    ->				Tuple:







							try:
														snake_case_           =		os.environ[key]
							except KeyError:
														# KEY isn't set, default to `default`.
														snake_case_           =		default
							else:
														# KEY is set, convert it to True or False.
														try:
																					snake_case_           =		strtobool(__UpperCamelCase				)
														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


__SCREAMING_SNAKE_CASE							:    Optional[Any]		=    parse_flag_from_env('RUN_SLOW', default=False)
__SCREAMING_SNAKE_CASE							:    Tuple		=    parse_flag_from_env('RUN_REMOTE', default=False)
__SCREAMING_SNAKE_CASE							:    List[Any]		=    parse_flag_from_env('RUN_LOCAL', default=True)
__SCREAMING_SNAKE_CASE							:    Union[str, Any]		=    parse_flag_from_env('RUN_PACKAGED', default=True)

# Compression
__SCREAMING_SNAKE_CASE							:    Dict		=    pytest.mark.skipif(not config.LZ4_AVAILABLE, reason='test requires lz4')
__SCREAMING_SNAKE_CASE							:    str		=    pytest.mark.skipif(not config.PY7ZR_AVAILABLE, reason='test requires py7zr')
__SCREAMING_SNAKE_CASE							:    Optional[int]		=    pytest.mark.skipif(not config.ZSTANDARD_AVAILABLE, reason='test requires zstandard')

# Audio
__SCREAMING_SNAKE_CASE							:    Optional[Any]		=    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
__SCREAMING_SNAKE_CASE							:    Any		=    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
__SCREAMING_SNAKE_CASE							:    str		=    pytest.mark.skipif(
    config.DILL_VERSION <= version.parse('0.3.2'),
    reason='test requires dill>0.3.2 for cloudpickle compatibility',
)

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







def 						_a				(      _SCREAMING_SNAKE_CASE				)    ->				Dict:







							try:
														import faiss  # noqa
							except ImportError:
														snake_case_           =		unittest.skip("""test requires faiss"""				)(__UpperCamelCase				)
							return test_case







def 						_a				(      _SCREAMING_SNAKE_CASE				)    ->				Tuple:







							try:
														import regex  # noqa
							except ImportError:
														snake_case_           =		unittest.skip("""test requires regex"""				)(__UpperCamelCase				)
							return test_case







def 						_a				(      _SCREAMING_SNAKE_CASE				)    ->				int:







							try:
														import elasticsearch  # noqa
							except ImportError:
														snake_case_           =		unittest.skip("""test requires elasticsearch"""				)(__UpperCamelCase				)
							return test_case







def 						_a				(      _SCREAMING_SNAKE_CASE				)    ->				int:







							try:
														import sqlalchemy  # noqa
							except ImportError:
														snake_case_           =		unittest.skip("""test requires sqlalchemy"""				)(__UpperCamelCase				)
							return test_case







def 						_a				(      _SCREAMING_SNAKE_CASE				)    ->				Dict:







							if not config.TORCH_AVAILABLE:
														snake_case_           =		unittest.skip("""test requires PyTorch"""				)(__UpperCamelCase				)
							return test_case







def 						_a				(      _SCREAMING_SNAKE_CASE				)    ->				Tuple:







							if not config.TF_AVAILABLE:
														snake_case_           =		unittest.skip("""test requires TensorFlow"""				)(__UpperCamelCase				)
							return test_case







def 						_a				(      _SCREAMING_SNAKE_CASE				)    ->				str:







							if not config.JAX_AVAILABLE:
														snake_case_           =		unittest.skip("""test requires JAX"""				)(__UpperCamelCase				)
							return test_case







def 						_a				(      _SCREAMING_SNAKE_CASE				)    ->				int:







							if not config.PIL_AVAILABLE:
														snake_case_           =		unittest.skip("""test requires Pillow"""				)(__UpperCamelCase				)
							return test_case







def 						_a				(      _SCREAMING_SNAKE_CASE				)    ->				Optional[Any]:







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







def 						_a				(      _SCREAMING_SNAKE_CASE				)    ->				Any:







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







def 						_a				(      _SCREAMING_SNAKE_CASE				)    ->				List[Any]:







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







def 						_a				(      _SCREAMING_SNAKE_CASE				)    ->				Tuple:







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

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

							return _require_spacy_model







def 						_a				(      _SCREAMING_SNAKE_CASE				)    ->				List[str]:







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







def 						_a				(      _SCREAMING_SNAKE_CASE				)    ->				int:







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







def 						_a				(      _SCREAMING_SNAKE_CASE				)    ->				Tuple:







							if not _run_slow_tests or _run_slow_tests == 0:
														snake_case_           =		unittest.skip("""test is slow"""				)(__UpperCamelCase				)
							return test_case







def 						_a				(      _SCREAMING_SNAKE_CASE				)    ->				Optional[Any]:







							if not _run_local_tests or _run_local_tests == 0:
														snake_case_           =		unittest.skip("""test is local"""				)(__UpperCamelCase				)
							return test_case







def 						_a				(      _SCREAMING_SNAKE_CASE				)    ->				Optional[Any]:







							if not _run_packaged_tests or _run_packaged_tests == 0:
														snake_case_           =		unittest.skip("""test is packaged"""				)(__UpperCamelCase				)
							return test_case







def 						_a				(      _SCREAMING_SNAKE_CASE				)    ->				Optional[int]:







							if not _run_remote_tests or _run_remote_tests == 0:
														snake_case_           =		unittest.skip("""test requires remote"""				)(__UpperCamelCase				)
							return test_case







def 						_a				(      *_SCREAMING_SNAKE_CASE				)    ->				Optional[int]:







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

							return decorate





class      __A     (SCREAMING_SNAKE_CASE_):





							'''simple docstring'''

							pass





class      __A     (SCREAMING_SNAKE_CASE_):





							'''simple docstring'''

							__lowercase:		List[str]							      =    0
							__lowercase:		Union[str, Any]							      =    1
							__lowercase:		Tuple							      =    2







@contextmanager
def 						_a				(      _SCREAMING_SNAKE_CASE=OfflineSimulationMode.CONNECTION_FAILS				, _SCREAMING_SNAKE_CASE=1E-1_6				)    ->				Dict:
							snake_case_           =		requests.Session().request

							def timeout_request(_SCREAMING_SNAKE_CASE				, _SCREAMING_SNAKE_CASE				, _SCREAMING_SNAKE_CASE				, **_SCREAMING_SNAKE_CASE				):
														# Change the url to an invalid url so that the connection hangs
														snake_case_           =		'''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."""				)
														snake_case_           =		timeout
														try:
																					return online_request(__UpperCamelCase				, __UpperCamelCase				, **__UpperCamelCase				)
														except Exception as e:
																					# The following changes in the error are just here to make the offline timeout error prettier
																					snake_case_           =		url
																					snake_case_           =		e.args[0]
																					snake_case_           =		(max_retry_error.args[0].replace("""10.255.255.1"""				, f"""OfflineMock[{url}]"""				),)
																					snake_case_           =		(max_retry_error,)
																					raise

							def raise_connection_error(_SCREAMING_SNAKE_CASE				, _SCREAMING_SNAKE_CASE				, **_SCREAMING_SNAKE_CASE				):
														raise requests.ConnectionError("""Offline mode is enabled."""				, request=__UpperCamelCase				)

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







@contextmanager
def 						_a				(      *_SCREAMING_SNAKE_CASE				, **_SCREAMING_SNAKE_CASE				)    ->				Optional[Any]:
							snake_case_           =		str(Path().resolve()				)
							with tempfile.TemporaryDirectory(*__UpperCamelCase				, **__UpperCamelCase				) as tmp_dir:
														try:
																					os.chdir(__UpperCamelCase				)
																					yield
														finally:
																					os.chdir(__UpperCamelCase				)







@contextmanager
def 						_a				(      )    ->				int:
							import gc

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







@contextmanager
def 						_a				(      )    ->				Optional[int]:
							import gc

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







def 						_a				(      _SCREAMING_SNAKE_CASE				, _SCREAMING_SNAKE_CASE				)    ->				Optional[int]:
							return deepcopy(__UpperCamelCase				).integers(0				, 100				, 10				).tolist() == deepcopy(__UpperCamelCase				).integers(0				, 100				, 10				).tolist()







def 						_a				(      _SCREAMING_SNAKE_CASE				)    ->				Optional[Any]:
							import decorator
							from requests.exceptions import HTTPError

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

							return decorator.decorator(_wrapper				, __UpperCamelCase				)





class      __A     :





							'''simple docstring'''

							def __init__(				self							:      List[str]		,       UpperCAmelCase_							:      Union[str, Any]		,       UpperCAmelCase_							:      List[str]		,       UpperCAmelCase_							:      Union[str, Any]       )					->int:



														"""simple docstring"""



														snake_case_           =		returncode
														snake_case_           =		stdout
														snake_case_           =		stderr







async def 						_a				(      _SCREAMING_SNAKE_CASE				, _SCREAMING_SNAKE_CASE				)    ->				str:







							while True:
														snake_case_           =		await stream.readline()
														if line:
																					callback(__UpperCamelCase				)
														else:
																					break







async def 						_a				(      _SCREAMING_SNAKE_CASE				, _SCREAMING_SNAKE_CASE=None				, _SCREAMING_SNAKE_CASE=None				, _SCREAMING_SNAKE_CASE=None				, _SCREAMING_SNAKE_CASE=False				, _SCREAMING_SNAKE_CASE=False				)    ->				_RunOutput:







							if echo:
														print("""\nRunning: """				, """ """.join(__UpperCamelCase				)				)

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

							# 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)

							snake_case_           =		[]
							snake_case_           =		[]

							def tee(_SCREAMING_SNAKE_CASE				, _SCREAMING_SNAKE_CASE				, _SCREAMING_SNAKE_CASE				, _SCREAMING_SNAKE_CASE=""				):
														snake_case_           =		line.decode("""utf-8"""				).rstrip()
														sink.append(__UpperCamelCase				)
														if not quiet:
																					print(__UpperCamelCase				, __UpperCamelCase				, file=__UpperCamelCase				)

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







def 						_a				(      _SCREAMING_SNAKE_CASE				, _SCREAMING_SNAKE_CASE=None				, _SCREAMING_SNAKE_CASE=None				, _SCREAMING_SNAKE_CASE=180				, _SCREAMING_SNAKE_CASE=False				, _SCREAMING_SNAKE_CASE=True				)    ->				_RunOutput:
							snake_case_           =		asyncio.get_event_loop()
							snake_case_           =		loop.run_until_complete(
							    _stream_subprocess(__UpperCamelCase				, env=__UpperCamelCase				, stdin=__UpperCamelCase				, timeout=__UpperCamelCase				, quiet=__UpperCamelCase				, echo=__UpperCamelCase				)				)

							snake_case_           =		''' '''.join(__UpperCamelCase				)
							if result.returncode > 0:
														snake_case_           =		'''\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 						_a				(      )    ->				Optional[int]:
							snake_case_           =		os.environ.get("""PYTEST_XDIST_WORKER"""				, """gw0"""				)
							snake_case_           =		re.sub(r"""^gw"""				, """"""				, __UpperCamelCase				, 0				, re.M				)
							return int(__UpperCamelCase				)







def 						_a				(      )    ->				List[Any]:
							snake_case_           =		29_500
							snake_case_           =		pytest_xdist_worker_id()
							return port + uniq_delta







"""simple docstring"""
from math import factorial







def 						_a				(      _SCREAMING_SNAKE_CASE = 20				)    ->				int:
							snake_case_           =		2 * n  # middle entry of odd rows starting at row 3 is the solution for n = 1,
							# 2, 3,...
							snake_case_           =		n // 2

							return int(factorial(_SCREAMING_SNAKE_CASE				) / (factorial(_SCREAMING_SNAKE_CASE				) * factorial(n - k				))				)


if __name__ == "__main__":
				import sys

				if len(sys.argv) == 1:
								print(solution(20))
				else:
								try:
												__SCREAMING_SNAKE_CASE							:    Optional[int]		=    int(sys.argv[1])
												print(solution(n))
								except ValueError:
												print('Invalid entry - please enter a number.')



