






"""simple docstring"""






import re
import tempfile
from pathlib import Path

import pytest
import yaml

from datasets.utils.readme import ReadMe


# @pytest.fixture
# def example_yaml_structure():

UpperCAmelCase_     :				Optional[int]         =				yaml.safe_load(
    """\
name: \"\"
allow_empty: false
allow_empty_text: true
subsections:
  - name: \"Dataset Card for X\" # First-level markdown heading
    allow_empty: false
    allow_empty_text: true
    subsections:
      - name: \"Table of Contents\"
        allow_empty: false
        allow_empty_text: false
        subsections: null
      - name: \"Dataset Description\"
        allow_empty: false
        allow_empty_text: false
        subsections:
          - name: \"Dataset Summary\"
            allow_empty: false
            allow_empty_text: false
            subsections: null
          - name: \"Supported Tasks and Leaderboards\"
            allow_empty: true
            allow_empty_text: true
            subsections: null
          - name: Languages
            allow_empty: false
            allow_empty_text: true
            subsections: null
"""
)


UpperCAmelCase_     :				List[str]         =				{
    """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""": []},
                    ],
                },
            ],
        }
    ],
}


UpperCAmelCase_     :				Union[str, Any]         =				"""\
---
language:
- zh
- en
---

# Dataset Card for My Dataset
## Table of Contents
Some text here.
## Dataset Description
Some text here.
### Dataset Summary
Some text here.
### Supported Tasks and Leaderboards
### Languages
Language Text
"""


UpperCAmelCase_     :				List[str]         =				"""\
---
language:
- zh
- en
---

# Dataset Card for My Dataset
## Table of Contents
Some text here.
## Dataset Description
Some text here.
### Dataset Summary
Some text here.
#### Extra Ignored Subsection
### Supported Tasks and Leaderboards
### Languages
Language Text
"""

UpperCAmelCase_     :				Union[str, Any]         =				{
    """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""": []},
                    ],
                },
            ],
        }
    ],
}

UpperCAmelCase_     :				Tuple         =				"""\
---
---
# Dataset Card for My Dataset
## Table of Contents
Some text here.
## Dataset Description
Some text here.
### Dataset Summary
Some text here.
### Supported Tasks and Leaderboards
### Languages
Language Text
"""

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

UpperCAmelCase_     :				str         =				"""\
# Dataset Card for My Dataset
## Table of Contents
Some text here.
## Dataset Description
Some text here.
### Dataset Summary
Some text here.
### Supported Tasks and Leaderboards
### Languages
Language Text
"""

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

UpperCAmelCase_     :				Optional[int]         =				"""\
---
# Dataset Card for My Dataset
## Table of Contents
Some text here.
## Dataset Description
Some text here.
### Dataset Summary
Some text here.
### Supported Tasks and Leaderboards
### Languages
Language Text
"""

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

UpperCAmelCase_     :				int         =				"""\
---
language:
- zh
- en
---

# Dataset Card for My Dataset
## Table of Contents
Some text here.
## Dataset Description
Some text here.
### Dataset Summary
### Supported Tasks and Leaderboards
### Languages
Language Text
"""
UpperCAmelCase_     :				Any         =				"""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)."""


UpperCAmelCase_     :				List[str]         =				"""\
---
language:
- zh
- en
---

# Dataset Card for My Dataset
"""
UpperCAmelCase_     :				str         =				"""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'."""

UpperCAmelCase_     :				Tuple         =				"""\
---
language:
- zh
- en
---

# Dataset Card for My Dataset
## Table of Contents
Some text here.
## Dataset Description
Some text here.
### Dataset Summary
Some text here.
### Languages
Language Text
"""

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


UpperCAmelCase_     :				Any         =				"""\
---
language:
- zh
- en
---

# Dataset Card for My Dataset
## Table of Contents
Some text here.
## Dataset Description
Some text here.
### Dataset Summary
Some text here.
### Supported Tasks and Leaderboards
### Languages
"""

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

UpperCAmelCase_     :				Optional[int]         =				"""\
---
language:
- zh
- en
---

## Table of Contents
Some text here.
## Dataset Description
Some text here.
### Dataset Summary
Some text here.
### Supported Tasks and Leaderboards
### Languages
Language Text
"""
UpperCAmelCase_     :				Any         =				"""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."""

UpperCAmelCase_     :				Optional[int]         =				"""\
---
language:
- zh
- en
---

# Dataset Card for My Dataset
## Table of Contents
Some text here.
## Dataset Description
Some text here.
### Dataset Summary
Some text here.
### Supported Tasks and Leaderboards
### Languages
Language Text
# Dataset Card My Dataset
"""

UpperCAmelCase_     :				int         =				"""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."""

UpperCAmelCase_     :				List[Any]         =				"""\
---
language:
- zh
- en
---

# Dataset Card My Dataset
## Table of Contents
Some text here.
## Dataset Description
Some text here.
### Dataset Summary
Some text here.
### Supported Tasks and Leaderboards
### Languages
Language Text
"""

UpperCAmelCase_     :				int         =				"""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."""

UpperCAmelCase_     :				str         =				""""""

UpperCAmelCase_     :				Optional[int]         =				"""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."""

UpperCAmelCase_     :				List[str]         =				"""\
---
language:
- zh
- en
---

# Dataset Card for My Dataset
# Dataset Card for My Dataset
## Table of Contents
Some text here.
## Dataset Description
Some text here.
### Dataset Summary
Some text here.
### Supported Tasks and Leaderboards
### Languages
Language Text
"""

UpperCAmelCase_     :				Union[str, Any]         =				"""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       _A    (__a					,       __a							)				-> Optional[int]:
    """simple docstring"""






    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       _A    (__a					,       __a							)				-> Optional[int]:
    """simple docstring"""






    with pytest.raises(__a					,       match=re.escape(expected_error.format(path='''root'''							)							)							):
        SCREAMING_SNAKE_CASE_   :						Optional[Any]							=	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       _A    (__a					,       __a							)				-> str:
    """simple docstring"""






    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       _A    (__a							)				-> Tuple:
    """simple docstring"""






    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       _A    (__a					,       __a							)				-> Tuple:
    """simple docstring"""






    with tempfile.TemporaryDirectory() as tmp_dir:
        SCREAMING_SNAKE_CASE_   :						List[Any]							=	Path(__a							) / '''README.md'''
        with open(__a					,       '''w+'''							) as readme_file:
            readme_file.write(__a							)
        SCREAMING_SNAKE_CASE_   :						List[Any]							=	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       _A    (__a					,       __a							)				-> List[Any]:
    """simple docstring"""






    with tempfile.TemporaryDirectory() as tmp_dir:
        SCREAMING_SNAKE_CASE_   :						List[Any]							=	Path(__a							) / '''README.md'''
        with open(__a					,       '''w+'''							) as readme_file:
            readme_file.write(__a							)
        SCREAMING_SNAKE_CASE_   :						List[Any]							=	expected_error.format(path=__a							)
        with pytest.raises(__a					,       match=re.escape(__a							)							):
            SCREAMING_SNAKE_CASE_   :						Union[str, Any]							=	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       _A    (__a					,       __a							)				-> List[Any]:
    """simple docstring"""






    with tempfile.TemporaryDirectory() as tmp_dir:
        SCREAMING_SNAKE_CASE_   :						int							=	Path(__a							) / '''README.md'''
        with open(__a					,       '''w+'''							) as readme_file:
            readme_file.write(__a							)
        SCREAMING_SNAKE_CASE_   :						List[str]							=	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       _A    (__a							)				-> str:
    """simple docstring"""






    with tempfile.TemporaryDirectory() as tmp_dir:
        SCREAMING_SNAKE_CASE_   :						List[Any]							=	Path(__a							) / '''README.md'''
        with open(__a					,       '''w+'''							) as readme_file:
            readme_file.write(__a							)
        ReadMe.from_readme(__a					,       __a					,       suppress_parsing_errors=__a							)










"""simple docstring"""






# Algorithm for the pigeonhole sorting





def       _A    (__a							)				-> Dict:
    """simple docstring"""






    SCREAMING_SNAKE_CASE_   :						Dict							=	min(__a							)  # min() finds the minimum value
    SCREAMING_SNAKE_CASE_   :						int							=	max(__a							)  # max() finds the maximum value

    SCREAMING_SNAKE_CASE_   :						Dict							=	max_val - min_val + 1  # size is difference of max and min values plus one

    # list of pigeonholes of size equal to the variable size
    SCREAMING_SNAKE_CASE_   :						Any							=	[0] * size

    # Populate the pigeonholes.
    for x in a:
        assert isinstance(__a					,       __a							), "integers only please"
        holes[x - min_val] += 1

    # Putting the elements back into the array in an order.
    SCREAMING_SNAKE_CASE_   :						Any							=	0
    for count in range(__a							):
        while holes[count] > 0:
            holes[count] -= 1
            SCREAMING_SNAKE_CASE_   :						Dict							=	count + min_val
            i += 1



def       _A    ()				-> Optional[int]:
    """simple docstring"""






    SCREAMING_SNAKE_CASE_   :						List[str]							=	[8, 3, 2, 7, 4, 6, 8]
    pigeonhole_sort(__a							)
    print('''Sorted order is:'''					,       ''' '''.join(__a							)							)


if __name__ == "__main__":
  main()


