


'''simple docstring'''



import sacrebleu as scb
from packaging import version
from sacrebleu import CHRF

import datasets


__lowercase     :						List[str]	=     '\\n@inproceedings{popovic-2015-chrf,\n    title = \"chr{F}: character n-gram {F}-score for automatic {MT} evaluation\",\n    author = \"Popovi{\'c}, Maja\",\n    booktitle = \"Proceedings of the Tenth Workshop on Statistical Machine Translation\",\n    month = sep,\n    year = \"2015\",\n    address = \"Lisbon, Portugal\",\n    publisher = \"Association for Computational Linguistics\",\n    url = \"https://aclanthology.org/W15-3049\",\n    doi = \"10.18653/v1/W15-3049\",\n    pages = \"392--395\",\n}\n@inproceedings{popovic-2017-chrf,\n    title = \"chr{F}++: words helping character n-grams\",\n    author = \"Popovi{\'c}, Maja\",\n    booktitle = \"Proceedings of the Second Conference on Machine Translation\",\n    month = sep,\n    year = \"2017\",\n    address = \"Copenhagen, Denmark\",\n    publisher = \"Association for Computational Linguistics\",\n    url = \"https://aclanthology.org/W17-4770\",\n    doi = \"10.18653/v1/W17-4770\",\n    pages = \"612--618\",\n}\n@inproceedings{post-2018-call,\n    title = \"A Call for Clarity in Reporting {BLEU} Scores\",\n    author = \"Post, Matt\",\n    booktitle = \"Proceedings of the Third Conference on Machine Translation: Research Papers\",\n    month = oct,\n    year = \"2018\",\n    address = \"Belgium, Brussels\",\n    publisher = \"Association for Computational Linguistics\",\n    url = \"https://www.aclweb.org/anthology/W18-6319\",\n    pages = \"186--191\",\n}\n'

__lowercase     :						List[Any]	=     '\\nChrF and ChrF++ are two MT evaluation metrics. They both use the F-score statistic for character n-gram matches,\nand ChrF++ adds word n-grams as well which correlates more strongly with direct assessment. We use the implementation\nthat is already present in sacrebleu.\n\nThe implementation here is slightly different from sacrebleu in terms of the required input format. The length of\nthe references and hypotheses lists need to be the same, so you may need to transpose your references compared to\nsacrebleu\'s required input format. See https://github.com/huggingface/datasets/issues/3154#issuecomment-950746534\n\nSee the README.md file at https://github.com/mjpost/sacreBLEU#chrf--chrf for more information.\n'

__lowercase     :						int	=     '\nProduces ChrF(++) scores for hypotheses given reference translations.\n\nArgs:\n    predictions (list of str): The predicted sentences.\n    references (list of list of str): The references. There should be one reference sub-list for each prediction sentence.\n    char_order (int): Character n-gram order. Defaults to `6`.\n    word_order (int): Word n-gram order. If equals to `2`, the metric is referred to as chrF++. Defaults to `0`.\n    beta (int): Determine the importance of recall w.r.t precision. Defaults to `2`.\n    lowercase (bool): if `True`, enables case-insensitivity. Defaults to `False`.\n    whitespace (bool): If `True`, include whitespaces when extracting character n-grams.\n    eps_smoothing (bool): If `True`, applies epsilon smoothing similar\n    to reference chrF++.py, NLTK and Moses implementations. If `False`,\n    it takes into account effective match order similar to sacreBLEU < 2.0.0. Defaults to `False`.\n\nReturns:\n    \'score\' (float): The chrF (chrF++) score,\n    \'char_order\' (int): The character n-gram order,\n    \'word_order\' (int): The word n-gram order. If equals to 2, the metric is referred to as chrF++,\n    \'beta\' (int): Determine the importance of recall w.r.t precision\n\nExamples:\n    Example 1--a simple example of calculating chrF:\n        >>> prediction = [\"The relationship between cats and dogs is not exactly friendly.\", \"a good bookshop is just a genteel black hole that knows how to read.\"]\n        >>> reference = [[\"The relationship between dogs and cats is not exactly friendly.\"], [\"A good bookshop is just a genteel Black Hole that knows how to read.\"]]\n        >>> chrf = datasets.load_metric(\"chrf\")\n        >>> results = chrf.compute(predictions=prediction, references=reference)\n        >>> print(results)\n        {\'score\': 84.64214891738334, \'char_order\': 6, \'word_order\': 0, \'beta\': 2}\n\n    Example 2--the same example, but with the argument word_order=2, to calculate chrF++ instead of chrF:\n        >>> prediction = [\"The relationship between cats and dogs is not exactly friendly.\", \"a good bookshop is just a genteel black hole that knows how to read.\"]\n        >>> reference = [[\"The relationship between dogs and cats is not exactly friendly.\"], [\"A good bookshop is just a genteel Black Hole that knows how to read.\"]]\n        >>> chrf = datasets.load_metric(\"chrf\")\n        >>> results = chrf.compute(predictions=prediction,\n        ...                         references=reference,\n        ...                         word_order=2)\n        >>> print(results)\n        {\'score\': 82.87263732906315, \'char_order\': 6, \'word_order\': 2, \'beta\': 2}\n\n    Example 3--the same chrF++ example as above, but with `lowercase=True` to normalize all case:\n        >>> prediction = [\"The relationship between cats and dogs is not exactly friendly.\", \"a good bookshop is just a genteel black hole that knows how to read.\"]\n        >>> reference = [[\"The relationship between dogs and cats is not exactly friendly.\"], [\"A good bookshop is just a genteel Black Hole that knows how to read.\"]]\n        >>> chrf = datasets.load_metric(\"chrf\")\n        >>> results = chrf.compute(predictions=prediction,\n        ...                         references=reference,\n        ...                         word_order=2,\n        ...                         lowercase=True)\n        >>> print(results)\n        {\'score\': 92.12853119829202, \'char_order\': 6, \'word_order\': 2, \'beta\': 2}\n'





@datasets.utils.file_utils.add_start_docstrings(_DESCRIPTION		,				_KWARGS_DESCRIPTION )
class 							__UpperCamelCase    (		datasets.Metric ):




	def 				__UpperCAmelCase							(       self							):

						'''simple docstring'''





						if version.parse(scb.__version__							) < version.parse('1.4.12'							):
											raise ImportWarning(
											    'To use `sacrebleu`, the module `sacrebleu>=1.4.12` is required, and the current version of `sacrebleu` doesn\'t match this condition.\n'
											    'You can install it with `pip install "sacrebleu>=1.4.12"`.'							)
						return datasets.MetricInfo(
						    description=_DESCRIPTION						,    citation=_CITATION						,    homepage='https://github.com/mjpost/sacreBLEU#chrf--chrf'						,    inputs_description=_KWARGS_DESCRIPTION						,    features=datasets.Features(
						        {
						            'predictions': datasets.Value('string'						,    id='sequence'							),
						            'references': datasets.Sequence(datasets.Value('string'						,    id='sequence'							)						,    id='references'							),
						        }							)						,    codebase_urls=['https://github.com/mjpost/sacreBLEU#chrf--chrf']						,    reference_urls=[
						        'https://github.com/m-popovic/chrF',
						    ]						,    )





	def 				__UpperCAmelCase							(       self						,    __a						,    __a						,    __a = CHRF.CHAR_ORDER						,    __a = CHRF.WORD_ORDER						,    __a = CHRF.BETA						,    __a = False						,    __a = False						,    __a = False						,    ):

						'''simple docstring'''





						__a      :	List[Any]    =  len(references[0]							)
						if any(len(__a							) != references_per_prediction for refs in references							):
											raise ValueError('Sacrebleu requires the same number of references for each prediction'							)
						__a      :	List[Any]    =  [[refs[i] for refs in references] for i in range(__a							)]

						__a      :	List[Any]    =  CHRF(__a						,    __a						,    __a						,    __a						,    __a						,    __a							)
						__a      :	int    =  sb_chrf.corpus_score(__a						,    __a							)

						return {
						    "score": output.score,
						    "char_order": output.char_order,
						    "word_order": output.word_order,
						    "beta": output.beta,
						}




'''simple docstring'''



import os
import socket
from contextlib import contextmanager

import torch

from ..commands.config.default import write_basic_config  # noqa: F401
from ..state import PartialState
from .dataclasses import DistributedType
from .imports import is_deepspeed_available, is_tpu_available
from .transformer_engine import convert_model
from .versions import is_torch_version


if is_deepspeed_available():
	from deepspeed import DeepSpeedEngine

if is_tpu_available(check_device=False):
	import torch_xla.core.xla_model as xm






def   lowerCamelCase							(_SCREAMING_SNAKE_CASE				:       Optional[Any]       ):
					if is_torch_version('<'						,				'2.0.0'       ) or not hasattr(_SCREAMING_SNAKE_CASE						,				'_dynamo'       ):
										return False
					return isinstance(_SCREAMING_SNAKE_CASE						,				torch._dynamo.eval_frame.OptimizedModule       )






def   lowerCamelCase							(_SCREAMING_SNAKE_CASE				:       Optional[Any]						,				_SCREAMING_SNAKE_CASE				:       bool = True       ):
					__a      :	int    =  (torch.nn.parallel.DistributedDataParallel, torch.nn.DataParallel)

					__a      :	Any    =  is_compiled_module(_SCREAMING_SNAKE_CASE       )
					if is_compiled:
										__a      :	List[Any]    =  model
										__a      :	Union[str, Any]    =  model._orig_mod

					if is_deepspeed_available():
										options += (DeepSpeedEngine,)

					while isinstance(_SCREAMING_SNAKE_CASE						,				_SCREAMING_SNAKE_CASE       ):
										__a      :	Union[str, Any]    =  model.module

					if not keep_fpaa_wrapper:
										__a      :	Optional[Any]    =  getattr(_SCREAMING_SNAKE_CASE						,				'forward'       )
										__a      :	str    =  model.__dict__.pop('_original_forward'						,				_SCREAMING_SNAKE_CASE       )
										if original_forward is not None:
															while hasattr(_SCREAMING_SNAKE_CASE						,				'__wrapped__'       ):
																				__a      :	Any    =  forward.__wrapped__
																				if forward == original_forward:
																									break
															__a      :	str    =  forward
										if getattr(_SCREAMING_SNAKE_CASE						,				'_converted_to_transformer_engine'						,				_SCREAMING_SNAKE_CASE       ):
															convert_model(_SCREAMING_SNAKE_CASE						,				to_transformer_engine=_SCREAMING_SNAKE_CASE       )

					if is_compiled:
										__a      :	List[str]    =  model
										__a      :	Optional[int]    =  compiled_model

					return model






def   lowerCamelCase							():
					PartialState().wait_for_everyone()






def   lowerCamelCase							(_SCREAMING_SNAKE_CASE				:       int						,				_SCREAMING_SNAKE_CASE				:       Tuple       ):
					if PartialState().distributed_type == DistributedType.TPU:
										xm.save(_SCREAMING_SNAKE_CASE						,				_SCREAMING_SNAKE_CASE       )
					elif PartialState().local_process_index == 0:
										torch.save(_SCREAMING_SNAKE_CASE						,				_SCREAMING_SNAKE_CASE       )






@contextmanager
def   lowerCamelCase							(**_SCREAMING_SNAKE_CASE				:       Tuple       ):
					for key, value in kwargs.items():
										__a      :	Optional[int]    =  str(_SCREAMING_SNAKE_CASE       )

					yield

					for key in kwargs:
										if key.upper() in os.environ:
															del os.environ[key.upper()]






def   lowerCamelCase							(_SCREAMING_SNAKE_CASE				:       Dict       ):
					if not hasattr(_SCREAMING_SNAKE_CASE						,				'__qualname__'       ) and not hasattr(_SCREAMING_SNAKE_CASE						,				'__name__'       ):
										__a      :	List[Any]    =  getattr(_SCREAMING_SNAKE_CASE						,				'__class__'						,				_SCREAMING_SNAKE_CASE       )
					if hasattr(_SCREAMING_SNAKE_CASE						,				'__qualname__'       ):
										return obj.__qualname__
					if hasattr(_SCREAMING_SNAKE_CASE						,				'__name__'       ):
										return obj.__name__
					return str(_SCREAMING_SNAKE_CASE       )






def   lowerCamelCase							(_SCREAMING_SNAKE_CASE				:       int						,				_SCREAMING_SNAKE_CASE				:       List[str]       ):
					for key, value in source.items():
										if isinstance(_SCREAMING_SNAKE_CASE						,				_SCREAMING_SNAKE_CASE       ):
															__a      :	int    =  destination.setdefault(_SCREAMING_SNAKE_CASE						,				{}       )
															merge_dicts(_SCREAMING_SNAKE_CASE						,				_SCREAMING_SNAKE_CASE       )
										else:
															__a      :	Tuple    =  value

					return destination






def   lowerCamelCase							(_SCREAMING_SNAKE_CASE				:       int = None       ):
					if port is None:
										__a      :	List[str]    =  29_500
					with socket.socket(socket.AF_INET						,				socket.SOCK_STREAM       ) as s:
										return s.connect_ex(('localhost', port)       ) == 0



