





import re
import tempfile
from pathlib import Path

import pytest
import yaml

from datasets.utils.readme import ReadMe


# @pytest.fixture
# def example_yaml_structure():

A_												=     yaml.safe_load(
    "\\nname: \"\"\nallow_empty: false\nallow_empty_text: true\nsubsections:\n  - name: \"Dataset Card for X\" # First-level markdown heading\n    allow_empty: false\n    allow_empty_text: true\n    subsections:\n      - name: \"Table of Contents\"\n        allow_empty: false\n        allow_empty_text: false\n        subsections: null\n      - name: \"Dataset Description\"\n        allow_empty: false\n        allow_empty_text: false\n        subsections:\n          - name: \"Dataset Summary\"\n            allow_empty: false\n            allow_empty_text: false\n            subsections: null\n          - name: \"Supported Tasks and Leaderboards\"\n            allow_empty: true\n            allow_empty_text: true\n            subsections: null\n          - name: Languages\n            allow_empty: false\n            allow_empty_text: true\n            subsections: null\n"
)


A_												=     {
    "name": "root",
    "text": "",
    "is_empty_text": True,
    "subsections": [
        {
            "name": "Dataset Card for My Dataset",
            "text": "",
            "is_empty_text": True,
            "subsections": [
                {"name": "Table of Contents", "text": "Some text here.", "is_empty_text": False, "subsections": []},
                {
                    "name": "Dataset Description",
                    "text": "Some text here.",
                    "is_empty_text": False,
                    "subsections": [
                        {
                            "name": "Dataset Summary",
                            "text": "Some text here.",
                            "is_empty_text": False,
                            "subsections": [],
                        },
                        {
                            "name": "Supported Tasks and Leaderboards",
                            "text": "",
                            "is_empty_text": True,
                            "subsections": [],
                        },
                        {"name": "Languages", "text": "Language Text", "is_empty_text": False, "subsections": []},
                    ],
                },
            ],
        }
    ],
}


A_												=     "\\n---\nlanguage:\n- zh\n- en\n---\n\n# Dataset Card for My Dataset\n## Table of Contents\nSome text here.\n## Dataset Description\nSome text here.\n### Dataset Summary\nSome text here.\n### Supported Tasks and Leaderboards\n### Languages\nLanguage Text\n"


A_												=     "\\n---\nlanguage:\n- zh\n- en\n---\n\n# Dataset Card for My Dataset\n## Table of Contents\nSome text here.\n## Dataset Description\nSome text here.\n### Dataset Summary\nSome text here.\n#### Extra Ignored Subsection\n### Supported Tasks and Leaderboards\n### Languages\nLanguage Text\n"

A_												=     {
    "name": "root",
    "text": "",
    "is_empty_text": True,
    "subsections": [
        {
            "name": "Dataset Card for My Dataset",
            "text": "",
            "is_empty_text": True,
            "subsections": [
                {"name": "Table of Contents", "text": "Some text here.", "is_empty_text": False, "subsections": []},
                {
                    "name": "Dataset Description",
                    "text": "Some text here.",
                    "is_empty_text": False,
                    "subsections": [
                        {
                            "name": "Dataset Summary",
                            "text": "Some text here.",
                            "is_empty_text": False,
                            "subsections": [
                                {
                                    "name": "Extra Ignored Subsection",
                                    "text": "",
                                    "is_empty_text": True,
                                    "subsections": [],
                                }
                            ],
                        },
                        {
                            "name": "Supported Tasks and Leaderboards",
                            "text": "",
                            "is_empty_text": True,
                            "subsections": [],
                        },
                        {"name": "Languages", "text": "Language Text", "is_empty_text": False, "subsections": []},
                    ],
                },
            ],
        }
    ],
}

A_												=     "\\n---\n---\n# Dataset Card for My Dataset\n## Table of Contents\nSome text here.\n## Dataset Description\nSome text here.\n### Dataset Summary\nSome text here.\n### Supported Tasks and Leaderboards\n### Languages\nLanguage Text\n"

A_												=     (
    "The following issues were found for the README at `{path}`:\n-\tEmpty YAML markers are present in the README."
)

A_												=     "\\n# Dataset Card for My Dataset\n## Table of Contents\nSome text here.\n## Dataset Description\nSome text here.\n### Dataset Summary\nSome text here.\n### Supported Tasks and Leaderboards\n### Languages\nLanguage Text\n"

A_												=     (
    "The following issues were found for the README at `{path}`:\n-\tNo YAML markers are present in the README."
)

A_												=     "\\n---\n# Dataset Card for My Dataset\n## Table of Contents\nSome text here.\n## Dataset Description\nSome text here.\n### Dataset Summary\nSome text here.\n### Supported Tasks and Leaderboards\n### Languages\nLanguage Text\n"

A_												=     "The following issues were found for the README at `{path}`:\n-\tOnly the start of YAML tags present in the README."

A_												=     "\\n---\nlanguage:\n- zh\n- en\n---\n\n# Dataset Card for My Dataset\n## Table of Contents\nSome text here.\n## Dataset Description\nSome text here.\n### Dataset Summary\n### Supported Tasks and Leaderboards\n### Languages\nLanguage Text\n"
A_												=     "The following issues were found for the README at `{path}`:\n-\tExpected some content in section `Dataset Summary` but it is empty.\n-\tExpected some text in section `Dataset Summary` but it is empty (text in subsections are ignored)."


A_												=     "\\n---\nlanguage:\n- zh\n- en\n---\n\n# Dataset Card for My Dataset\n"
A_												=     "The following issues were found for the README at `{path}`:\n-\tExpected some content in section `Dataset Card for My Dataset` but it is empty.\n-\tSection `Dataset Card for My Dataset` expected the following subsections: `Table of Contents`, `Dataset Description`. Found 'None'."

A_												=     "\\n---\nlanguage:\n- zh\n- en\n---\n\n# Dataset Card for My Dataset\n## Table of Contents\nSome text here.\n## Dataset Description\nSome text here.\n### Dataset Summary\nSome text here.\n### Languages\nLanguage Text\n"

A_												=     "The following issues were found for the README at `{path}`:\n-\tSection `Dataset Description` is missing subsection: `Supported Tasks and Leaderboards`."


A_												=     "\\n---\nlanguage:\n- zh\n- en\n---\n\n# Dataset Card for My Dataset\n## Table of Contents\nSome text here.\n## Dataset Description\nSome text here.\n### Dataset Summary\nSome text here.\n### Supported Tasks and Leaderboards\n### Languages\n"

A_												=     "The following issues were found for the README at `{path}`:\n-\tExpected some content in section `Languages` but it is empty."

A_												=     "\\n---\nlanguage:\n- zh\n- en\n---\n\n## Table of Contents\nSome text here.\n## Dataset Description\nSome text here.\n### Dataset Summary\nSome text here.\n### Supported Tasks and Leaderboards\n### Languages\nLanguage Text\n"
A_												=     "The following issues were found for the README at `{path}`:\n-\tThe README has no first-level headings. One heading is expected. Skipping further validation for this README."

A_												=     "\\n---\nlanguage:\n- zh\n- en\n---\n\n# Dataset Card for My Dataset\n## Table of Contents\nSome text here.\n## Dataset Description\nSome text here.\n### Dataset Summary\nSome text here.\n### Supported Tasks and Leaderboards\n### Languages\nLanguage Text\n# Dataset Card My Dataset\n"

A_												=     "The following issues were found for the README at `{path}`:\n-\tThe README has several first-level headings: `Dataset Card for My Dataset`, `Dataset Card My Dataset`. Only one heading is expected. Skipping further validation for this README."

A_												=     "\\n---\nlanguage:\n- zh\n- en\n---\n\n# Dataset Card My Dataset\n## Table of Contents\nSome text here.\n## Dataset Description\nSome text here.\n### Dataset Summary\nSome text here.\n### Supported Tasks and Leaderboards\n### Languages\nLanguage Text\n"

A_												=     "The following issues were found for the README at `{path}`:\n-\tNo first-level heading starting with `Dataset Card for` found in README. Skipping further validation for this README."

A_												=     ""

A_												=     "The following issues were found for the README at `{path}`:\n-\tThe README has no first-level headings. One heading is expected. Skipping further validation for this README.\n-\tNo YAML markers are present in the README."

A_												=     "\\n---\nlanguage:\n- zh\n- en\n---\n\n# Dataset Card for My Dataset\n# Dataset Card for My Dataset\n## Table of Contents\nSome text here.\n## Dataset Description\nSome text here.\n### Dataset Summary\nSome text here.\n### Supported Tasks and Leaderboards\n### Languages\nLanguage Text\n"

A_												=     "The following issues were found while parsing the README at `{path}`:\n-\tMultiple sections with the same heading `Dataset Card for My Dataset` have been found. Please keep only one of these sections."





@pytest.mark.parametrize(
    "readme_md, expected_dict",     [
        (README_CORRECT, CORRECT_DICT),
        (README_CORRECT_FOUR_LEVEL, CORRECT_DICT_FOUR_LEVEL),
    ],     )
def    __UpperCamelCase      (    a,     a) ->Dict:
					assert ReadMe.from_string(a,     a).to_dict() == expected_dict





@pytest.mark.parametrize(
    "readme_md, expected_error",     [
        (README_NO_YAML, EXPECTED_ERROR_README_NO_YAML),
        (README_EMPTY_YAML, EXPECTED_ERROR_README_EMPTY_YAML),
        (README_INCORRECT_YAML, EXPECTED_ERROR_README_INCORRECT_YAML),
        (README_EMPTY, EXPECTED_ERROR_README_EMPTY),
        (README_NONE_SUBSECTION, EXPECTED_ERROR_README_NONE_SUBSECTION),
        (README_MISSING_FIRST_LEVEL, EXPECTED_ERROR_README_MISSING_FIRST_LEVEL),
        (README_MISSING_SUBSECTION, EXPECTED_ERROR_README_MISSING_SUBSECTION),
        (README_MISSING_TEXT, EXPECTED_ERROR_README_MISSING_TEXT),
        (README_WRONG_FIRST_LEVEL, EXPECTED_ERROR_README_WRONG_FIRST_LEVEL),
        (README_MULTIPLE_WRONG_FIRST_LEVEL, EXPECTED_ERROR_README_MULTIPLE_WRONG_FIRST_LEVEL),
        (README_MISSING_CONTENT, EXPECTED_ERROR_README_MISSING_CONTENT),
    ],     )
def    __UpperCamelCase      (    a,     a) ->List[str]:
					with pytest.raises(a,     match=re.escape(expected_error.format(path="root"))):
										lowerCamelCase__       =       ReadMe.from_string(a,     a)
										readme.validate()





@pytest.mark.parametrize(
    "readme_md, expected_error",     [
        (README_MULTIPLE_SAME_HEADING_1, EXPECTED_ERROR_README_MULTIPLE_SAME_HEADING_1),
    ],     )
def    __UpperCamelCase      (    a,     a) ->Optional[Any]:
					with pytest.raises(a,     match=re.escape(expected_error.format(path="root"))):
										ReadMe.from_string(a,     a)





@pytest.mark.parametrize(
    "readme_md,",     [
        (README_MULTIPLE_SAME_HEADING_1),
    ],     )
def    __UpperCamelCase      (    a) ->Union[str, Any]:
					ReadMe.from_string(a,     a,     suppress_parsing_errors=a)





@pytest.mark.parametrize(
    "readme_md, expected_dict",     [
        (README_CORRECT, CORRECT_DICT),
        (README_CORRECT_FOUR_LEVEL, CORRECT_DICT_FOUR_LEVEL),
    ],     )
def    __UpperCamelCase      (    a,     a) ->List[str]:
					with tempfile.TemporaryDirectory() as tmp_dir:
										lowerCamelCase__       =       Path(a) / "README.md"
										with open(a,     "w+") as readme_file:
															readme_file.write(a)
										lowerCamelCase__       =       ReadMe.from_readme(a,     a).to_dict()
										assert out["name"] == path
										assert out["text"] == ""
										assert out["is_empty_text"]
										assert out["subsections"] == expected_dict["subsections"]





@pytest.mark.parametrize(
    "readme_md, expected_error",     [
        (README_NO_YAML, EXPECTED_ERROR_README_NO_YAML),
        (README_EMPTY_YAML, EXPECTED_ERROR_README_EMPTY_YAML),
        (README_INCORRECT_YAML, EXPECTED_ERROR_README_INCORRECT_YAML),
        (README_EMPTY, EXPECTED_ERROR_README_EMPTY),
        (README_NONE_SUBSECTION, EXPECTED_ERROR_README_NONE_SUBSECTION),
        (README_MISSING_FIRST_LEVEL, EXPECTED_ERROR_README_MISSING_FIRST_LEVEL),
        (README_MISSING_SUBSECTION, EXPECTED_ERROR_README_MISSING_SUBSECTION),
        (README_MISSING_TEXT, EXPECTED_ERROR_README_MISSING_TEXT),
        (README_WRONG_FIRST_LEVEL, EXPECTED_ERROR_README_WRONG_FIRST_LEVEL),
        (README_MULTIPLE_WRONG_FIRST_LEVEL, EXPECTED_ERROR_README_MULTIPLE_WRONG_FIRST_LEVEL),
        (README_MISSING_CONTENT, EXPECTED_ERROR_README_MISSING_CONTENT),
    ],     )
def    __UpperCamelCase      (    a,     a) ->Any:
					with tempfile.TemporaryDirectory() as tmp_dir:
										lowerCamelCase__       =       Path(a) / "README.md"
										with open(a,     "w+") as readme_file:
															readme_file.write(a)
										lowerCamelCase__       =       expected_error.format(path=a)
										with pytest.raises(a,     match=re.escape(a)):
															lowerCamelCase__       =       ReadMe.from_readme(a,     a)
															readme.validate()





@pytest.mark.parametrize(
    "readme_md, expected_error",     [
        (README_MULTIPLE_SAME_HEADING_1, EXPECTED_ERROR_README_MULTIPLE_SAME_HEADING_1),
    ],     )
def    __UpperCamelCase      (    a,     a) ->List[Any]:
					with tempfile.TemporaryDirectory() as tmp_dir:
										lowerCamelCase__       =       Path(a) / "README.md"
										with open(a,     "w+") as readme_file:
															readme_file.write(a)
										lowerCamelCase__       =       expected_error.format(path=a)
										with pytest.raises(a,     match=re.escape(a)):
															ReadMe.from_readme(a,     a)







@pytest.mark.parametrize(
    "readme_md,",     [
        (README_MULTIPLE_SAME_HEADING_1),
    ],     )
def    __UpperCamelCase      (    a) ->int:
					with tempfile.TemporaryDirectory() as tmp_dir:
										lowerCamelCase__       =       Path(a) / "README.md"
										with open(a,     "w+") as readme_file:
															readme_file.write(a)
										ReadMe.from_readme(a,     a,     suppress_parsing_errors=a)












from __future__ import annotations

import math
import random
from collections.abc import Collection
from typing import overload

class SCREAMING_SNAKE_CASE_ :





					"""simple docstring"""


					def __init__( self	,  _lowerCAmelCase = None	):
										if components is None:
															lowerCamelCase__       =       []
										lowerCamelCase__       =       list(_lowerCAmelCase	)





					def __len__( self	):
										return len(self.__components	)





					def __str__( self	):
										return "(" + ",".join(map(_lowerCAmelCase	,  self.__components	)	) + ")"





					def __add__( self	,  _lowerCAmelCase	):
										lowerCamelCase__       =       len(self	)
										if size == len(_lowerCAmelCase	):
															lowerCamelCase__       =       [self.__components[i] + other.component(_lowerCAmelCase	) for i in range(_lowerCAmelCase	)]
															return Vector(_lowerCAmelCase	)
										else:
															raise Exception("must have the same size"	)





					def __sub__( self	,  _lowerCAmelCase	):
										lowerCamelCase__       =       len(self	)
										if size == len(_lowerCAmelCase	):
															lowerCamelCase__       =       [self.__components[i] - other.component(_lowerCAmelCase	) for i in range(_lowerCAmelCase	)]
															return Vector(_lowerCAmelCase	)
										else:  # error case
															raise Exception("must have the same size"	)





					@overload
					def __mul__( self	,  _lowerCAmelCase	):
										...





					@overload
					def __mul__( self	,  _lowerCAmelCase	):
										...





					def __mul__( self	,  _lowerCAmelCase	):
										if isinstance(_lowerCAmelCase	,  (float, int)	):
															lowerCamelCase__       =       [c * other for c in self.__components]
															return Vector(_lowerCAmelCase	)
										elif isinstance(_lowerCAmelCase	,  _lowerCAmelCase	) and len(self	) == len(_lowerCAmelCase	):
															lowerCamelCase__       =       len(self	)
															lowerCamelCase__       =       [self.__components[i] * other.component(_lowerCAmelCase	) for i in range(_lowerCAmelCase	)]
															return sum(_lowerCAmelCase	)
										else:  # error case
															raise Exception("invalid operand!"	)





					def 					__magic_name__ ( self	):
										return Vector(self.__components	)





					def 					__magic_name__ ( self	,  _lowerCAmelCase	):
										if isinstance(_lowerCAmelCase	,  _lowerCAmelCase	) and -len(self.__components	) <= i < len(self.__components	):
															return self.__components[i]
										else:
															raise Exception("index out of range"	)





					def 					__magic_name__ ( self	,  _lowerCAmelCase	,  _lowerCAmelCase	):
										assert -len(self.__components	) <= pos < len(self.__components	)
										lowerCamelCase__       =       value





					def 					__magic_name__ ( self	):
										if len(self.__components	) == 0:
															raise Exception("Vector is empty"	)
										lowerCamelCase__       =       [c**2 for c in self.__components]
										return math.sqrt(sum(_lowerCAmelCase	)	)






					def 					__magic_name__ ( self	,  _lowerCAmelCase	,  _lowerCAmelCase = False	):
										lowerCamelCase__       =       self * other
										lowerCamelCase__       =       self.euclidean_length() * other.euclidean_length()
										if deg:
															return math.degrees(math.acos(num / den	)	)
										else:
															return math.acos(num / den	)





def    __UpperCamelCase      (    a) ->Vector:
					assert isinstance(a,     a)
					return Vector([0] * dimension)





def    __UpperCamelCase      (    a,     a) ->Vector:
					assert isinstance(a,     a) and (isinstance(a,     a))
					lowerCamelCase__       =       [0] * dimension
					lowerCamelCase__       =       1
					return Vector(a)





def    __UpperCamelCase      (    a,     a,     a) ->Vector:
					assert (
					    isinstance(a,     a)
					    and isinstance(a,     a)
					    and (isinstance(a,     (int, float)))
					)
					return x * scalar + y





def    __UpperCamelCase      (    a,     a,     a) ->Vector:
					random.seed(a)
					lowerCamelCase__       =       [random.randint(a,     a) for _ in range(a)]
					return Vector(a)

class SCREAMING_SNAKE_CASE_ :





					"""simple docstring"""


					def __init__( self	,  _lowerCAmelCase	,  _lowerCAmelCase	,  _lowerCAmelCase	):
										lowerCamelCase__       =       matrix
										lowerCamelCase__       =       w
										lowerCamelCase__       =       h





					def __str__( self	):
										lowerCamelCase__       =       ""
										for i in range(self.__height	):
															ans += "|"
															for j in range(self.__width	):
																				if j < self.__width - 1:
																									ans += str(self.__matrix[i][j]	) + ","
																				else:
																									ans += str(self.__matrix[i][j]	) + "|\n"
										return ans





					def __add__( self	,  _lowerCAmelCase	):
										if self.__width == other.width() and self.__height == other.height():
															lowerCamelCase__       =       []
															for i in range(self.__height	):
																				lowerCamelCase__       =       [
																				    self.__matrix[i][j] + other.component(_lowerCAmelCase	,  _lowerCAmelCase	)
																				    for j in range(self.__width	)
																				]
																				matrix.append(_lowerCAmelCase	)
															return Matrix(_lowerCAmelCase	,  self.__width	,  self.__height	)
										else:
															raise Exception("matrix must have the same dimension!"	)





					def __sub__( self	,  _lowerCAmelCase	):
										if self.__width == other.width() and self.__height == other.height():
															lowerCamelCase__       =       []
															for i in range(self.__height	):
																				lowerCamelCase__       =       [
																				    self.__matrix[i][j] - other.component(_lowerCAmelCase	,  _lowerCAmelCase	)
																				    for j in range(self.__width	)
																				]
																				matrix.append(_lowerCAmelCase	)
															return Matrix(_lowerCAmelCase	,  self.__width	,  self.__height	)
										else:
															raise Exception("matrices must have the same dimension!"	)





					@overload
					def __mul__( self	,  _lowerCAmelCase	):
										...





					@overload
					def __mul__( self	,  _lowerCAmelCase	):
										...





					def __mul__( self	,  _lowerCAmelCase	):
										if isinstance(_lowerCAmelCase	,  _lowerCAmelCase	):  # matrix-vector
															if len(_lowerCAmelCase	) == self.__width:
																				lowerCamelCase__       =       zero_vector(self.__height	)
																				for i in range(self.__height	):
																									lowerCamelCase__       =       [
																									    self.__matrix[i][j] * other.component(_lowerCAmelCase	)
																									    for j in range(self.__width	)
																									]
																									ans.change_component(_lowerCAmelCase	,  sum(_lowerCAmelCase	)	)
																				return ans
															else:
																				raise Exception(
																				    "vector must have the same size as the "
																				    "number of columns of the matrix!"	)
										elif isinstance(_lowerCAmelCase	,  (int, float)	):  # matrix-scalar
															lowerCamelCase__       =       [
															    [self.__matrix[i][j] * other for j in range(self.__width	)]
															    for i in range(self.__height	)
															]
															return Matrix(_lowerCAmelCase	,  self.__width	,  self.__height	)
										return None





					def 					__magic_name__ ( self	):
										return self.__height





					def 					__magic_name__ ( self	):
										return self.__width





					def 					__magic_name__ ( self	,  _lowerCAmelCase	,  _lowerCAmelCase	):
										if 0 <= x < self.__height and 0 <= y < self.__width:
															return self.__matrix[x][y]
										else:
															raise Exception("change_component: indices out of bounds"	)





					def 					__magic_name__ ( self	,  _lowerCAmelCase	,  _lowerCAmelCase	,  _lowerCAmelCase	):
										if 0 <= x < self.__height and 0 <= y < self.__width:
															lowerCamelCase__       =       value
										else:
															raise Exception("change_component: indices out of bounds"	)





					def 					__magic_name__ ( self	,  _lowerCAmelCase	,  _lowerCAmelCase	):
										if self.__height != self.__width:
															raise Exception("Matrix is not square"	)
										lowerCamelCase__       =       self.__matrix[:x] + self.__matrix[x + 1 :]
										for i in range(len(_lowerCAmelCase	)	):
															lowerCamelCase__       =       minor[i][:y] + minor[i][y + 1 :]
										return Matrix(_lowerCAmelCase	,  self.__width - 1	,  self.__height - 1	).determinant()





					def 					__magic_name__ ( self	,  _lowerCAmelCase	,  _lowerCAmelCase	):
										if self.__height != self.__width:
															raise Exception("Matrix is not square"	)
										if 0 <= x < self.__height and 0 <= y < self.__width:
															return (-1) ** (x + y) * self.minor(_lowerCAmelCase	,  _lowerCAmelCase	)
										else:
															raise Exception("Indices out of bounds"	)






					def 					__magic_name__ ( self	):
										if self.__height != self.__width:
															raise Exception("Matrix is not square"	)
										if self.__height < 1:
															raise Exception("Matrix has no element"	)
										elif self.__height == 1:
															return self.__matrix[0][0]
										elif self.__height == 2:
															return (
															    self.__matrix[0][0] * self.__matrix[1][1]
															    - self.__matrix[0][1] * self.__matrix[1][0]
															)
										else:
															lowerCamelCase__       =       [
															    self.__matrix[0][y] * self.cofactor(0	,  _lowerCAmelCase	) for y in range(self.__width	)
															]
															return sum(_lowerCAmelCase	)





def    __UpperCamelCase      (    a) ->Matrix:
					lowerCamelCase__       =       [[0] * n for _ in range(a)]
					return Matrix(a,     a,     a)







def    __UpperCamelCase      (    a,     a,     a,     a) ->Matrix:
					random.seed(a)
					lowerCamelCase__       =       [
					    [random.randint(a,     a) for _ in range(a)] for _ in range(a)
					]
					return Matrix(a,     a,     a)

