






'''simple docstring'''


from math import pi, sqrt, tan







def 	__magic_name__( _A					):
						'''simple docstring'''





						if side_length < 0:
												raise ValueError("""surface_area_cube() only accepts non-negative values"""					)
						return 6 * side_length**2







def 	__magic_name__( _A						,      _A						,      _A					):
						'''simple docstring'''





						if length < 0 or breadth < 0 or height < 0:
												raise ValueError("""surface_area_cuboid() only accepts non-negative values"""					)
						return 2 * ((length * breadth) + (breadth * height) + (length * height))







def 	__magic_name__( _A					):
						'''simple docstring'''





						if radius < 0:
												raise ValueError("""surface_area_sphere() only accepts non-negative values"""					)
						return 4 * pi * radius**2







def 	__magic_name__( _A					):
						'''simple docstring'''





						if radius < 0:
												raise ValueError("""surface_area_hemisphere() only accepts non-negative values"""					)
						return 3 * pi * radius**2







def 	__magic_name__( _A						,      _A					):
						'''simple docstring'''





						if radius < 0 or height < 0:
												raise ValueError("""surface_area_cone() only accepts non-negative values"""					)
						return pi * radius * (radius + (height**2 + radius**2) ** 0.5)







def 	__magic_name__( _A						,      _A						,      _A					):
						'''simple docstring'''





						if radius_a < 0 or radius_a < 0 or height < 0:
												raise ValueError(
												    """surface_area_conical_frustum() only accepts non-negative values"""					)
						UpperCamelCase__         = (height**2 + (radius_a - radius_a) ** 2) ** 0.5
						return pi * ((slant_height * (radius_a + radius_a)) + radius_a**2 + radius_a**2)







def 	__magic_name__( _A						,      _A					):
						'''simple docstring'''





						if radius < 0 or height < 0:
												raise ValueError("""surface_area_cylinder() only accepts non-negative values"""					)
						return 2 * pi * radius * (height + radius)







def 	__magic_name__( _A						,      _A					):
						'''simple docstring'''





						if torus_radius < 0 or tube_radius < 0:
												raise ValueError("""surface_area_torus() only accepts non-negative values"""					)
						if torus_radius < tube_radius:
												raise ValueError(
												    """surface_area_torus() does not support spindle or self intersecting tori"""					)
						return 4 * pow(_A						,      2					) * torus_radius * tube_radius







def 	__magic_name__( _A						,      _A					):
						'''simple docstring'''





						if length < 0 or width < 0:
												raise ValueError("""area_rectangle() only accepts non-negative values"""					)
						return length * width







def 	__magic_name__( _A					):
						'''simple docstring'''





						if side_length < 0:
												raise ValueError("""area_square() only accepts non-negative values"""					)
						return side_length**2







def 	__magic_name__( _A						,      _A					):
						'''simple docstring'''





						if base < 0 or height < 0:
												raise ValueError("""area_triangle() only accepts non-negative values"""					)
						return (base * height) / 2







def 	__magic_name__( _A						,      _A						,      _A					):
						'''simple docstring'''





						if sidea < 0 or sidea < 0 or sidea < 0:
												raise ValueError("""area_triangle_three_sides() only accepts non-negative values"""					)
						elif sidea + sidea < sidea or sidea + sidea < sidea or sidea + sidea < sidea:
												raise ValueError("""Given three sides do not form a triangle"""					)
						UpperCamelCase__         = (sidea + sidea + sidea) / 2
						UpperCamelCase__         = sqrt(
						    semi_perimeter
						    * (semi_perimeter - sidea)
						    * (semi_perimeter - sidea)
						    * (semi_perimeter - sidea)					)
						return area







def 	__magic_name__( _A						,      _A					):
						'''simple docstring'''





						if base < 0 or height < 0:
												raise ValueError("""area_parallelogram() only accepts non-negative values"""					)
						return base * height







def 	__magic_name__( _A						,      _A						,      _A					):
						'''simple docstring'''





						if basea < 0 or basea < 0 or height < 0:
												raise ValueError("""area_trapezium() only accepts non-negative values"""					)
						return 1 / 2 * (basea + basea) * height







def 	__magic_name__( _A					):
						'''simple docstring'''





						if radius < 0:
												raise ValueError("""area_circle() only accepts non-negative values"""					)
						return pi * radius**2







def 	__magic_name__( _A						,      _A					):
						'''simple docstring'''





						if radius_x < 0 or radius_y < 0:
												raise ValueError("""area_ellipse() only accepts non-negative values"""					)
						return pi * radius_x * radius_y







def 	__magic_name__( _A						,      _A					):
						'''simple docstring'''





						if diagonal_a < 0 or diagonal_a < 0:
												raise ValueError("""area_rhombus() only accepts non-negative values"""					)
						return 1 / 2 * diagonal_a * diagonal_a







def 	__magic_name__( _A						,      _A					):
						'''simple docstring'''





						if not isinstance(_A						,      _A					) or sides < 3:
												raise ValueError(
												    """area_reg_polygon() only accepts integers greater than or \
equal to three as number of sides"""					)
						elif length < 0:
												raise ValueError(
												    """area_reg_polygon() only accepts non-negative values as \
length of a side"""					)
						return (sides * length**2) / (4 * tan(pi / sides					))
						return (sides * length**2) / (4 * tan(pi / sides					))


if __name__ == "__main__":
					import doctest

					doctest.testmod(verbose=True)  # verbose so we can see methods missing tests

					print('''[DEMO] Areas of various geometric shapes: \n''')
					print(f"""Rectangle: {area_rectangle(10, 20) = }""")
					print(f"""Square: {area_square(10) = }""")
					print(f"""Triangle: {area_triangle(10, 10) = }""")
					print(f"""Triangle: {area_triangle_three_sides(5, 12, 13) = }""")
					print(f"""Parallelogram: {area_parallelogram(10, 20) = }""")
					print(f"""Rhombus: {area_rhombus(10, 20) = }""")
					print(f"""Trapezium: {area_trapezium(10, 20, 30) = }""")
					print(f"""Circle: {area_circle(20) = }""")
					print(f"""Ellipse: {area_ellipse(10, 20) = }""")
					print('''\nSurface Areas of various geometric shapes: \n''')
					print(f"""Cube: {surface_area_cube(20) = }""")
					print(f"""Cuboid: {surface_area_cuboid(10, 20, 30) = }""")
					print(f"""Sphere: {surface_area_sphere(20) = }""")
					print(f"""Hemisphere: {surface_area_hemisphere(20) = }""")
					print(f"""Cone: {surface_area_cone(10, 20) = }""")
					print(f"""Conical Frustum: {surface_area_conical_frustum(10, 20, 30) = }""")
					print(f"""Cylinder: {surface_area_cylinder(10, 20) = }""")
					print(f"""Torus: {surface_area_torus(20, 10) = }""")
					print(f"""Equilateral Triangle: {area_reg_polygon(3, 10) = }""")
					print(f"""Square: {area_reg_polygon(4, 10) = }""")
					print(f"""Reqular Pentagon: {area_reg_polygon(5, 10) = }""")








'''simple docstring'''


from collections import Counter
from pathlib import Path
from typing import Optional, Tuple

import yaml
class    _SCREAMING_SNAKE_CASE							(		yaml.SafeLoader	):


			'''simple docstring'''





			def 				A      (   self							:						List[str] ,      lowercase							:						List[Any]			)							->    int:

									'''simple docstring'''







									UpperCamelCase__         = [self.constructed_objects[key_node] for key_node, _ in node.value]
									UpperCamelCase__         = [tuple(lowercase			) if isinstance(lowercase ,      lowercase			) else key for key in keys]
									UpperCamelCase__         = Counter(lowercase			)
									UpperCamelCase__         = [key for key in counter if counter[key] > 1]
									if duplicate_keys:
															raise TypeError(f"Got duplicate yaml keys: {duplicate_keys}"			)







			def 				A      (   self							:						List[str] ,      lowercase							:						int ,      lowercase							:						str=False			)							->    Any:

									'''simple docstring'''







									UpperCamelCase__         = super().construct_mapping(lowercase ,      deep=lowercase			)
									self._check_no_duplicates_on_constructed_node(lowercase			)
									return mapping







def 	__magic_name__( _A					):
						'''simple docstring'''





						UpperCamelCase__         = list(readme_content.splitlines()					)
						if full_content and full_content[0] == "---" and "---" in full_content[1:]:
												UpperCamelCase__         = full_content[1:].index("""---"""					) + 1
												UpperCamelCase__         = """\n""".join(full_content[1:sep_idx]					)
												return yamlblock, "\n".join(full_content[sep_idx + 1 :]					)

						return None, "\n".join(_A					)
class    _SCREAMING_SNAKE_CASE							(		SCREAMING_SNAKE_CASE	):


			'''simple docstring'''





			__a							:							Tuple					     =					{"train_eval_index"}  # train-eval-index in the YAML metadata






			@classmethod
			def 				A      (   cls							:						int ,      lowercase							:						Path			)							->    "DatasetMetadata":

									'''simple docstring'''







									with open(lowercase ,      encoding="""utf-8"""			) as readme_file:
															UpperCamelCase__    ,   UpperCamelCase__         = _split_yaml_from_readme(readme_file.read()			)
									if yaml_string is not None:
															return cls.from_yaml_string(lowercase			)
									else:
															return cls()






			def 				A      (   self							:						int ,      lowercase							:						Path			)							->    Dict:

									'''simple docstring'''







									if path.exists():
															with open(lowercase ,      encoding="""utf-8"""			) as readme_file:
																					UpperCamelCase__         = readme_file.read()
									else:
															UpperCamelCase__         = None
									UpperCamelCase__         = self._to_readme(lowercase			)
									with open(lowercase ,      """w""" ,      encoding="""utf-8"""			) as readme_file:
															readme_file.write(lowercase			)






			def 				A      (   self							:						Any ,      lowercase							:						Optional[str] = None			)							->    str:

									'''simple docstring'''







									if readme_content is not None:
															UpperCamelCase__    ,   UpperCamelCase__         = _split_yaml_from_readme(lowercase			)
															UpperCamelCase__         = """---\n""" + self.to_yaml_string() + """---\n""" + content
									else:
															UpperCamelCase__         = """---\n""" + self.to_yaml_string() + """---\n"""
									return full_content






			@classmethod
			def 				A      (   cls							:						Tuple ,      lowercase							:						str			)							->    "DatasetMetadata":

									'''simple docstring'''







									UpperCamelCase__         = yaml.load(lowercase ,      Loader=_NoDuplicateSafeLoader			) or {}

									# Convert the YAML keys to DatasetMetadata fields
									UpperCamelCase__         = {
									    (key.replace("""-""" ,      """_"""			) if key.replace("""-""" ,      """_"""			) in cls._FIELDS_WITH_DASHES else key): value
									    for key, value in metadata_dict.items()
									}
									return cls(**lowercase			)







			def 				A      (   self							:						Dict			)							->    str:

									'''simple docstring'''







									return yaml.safe_dump(
									    {
									        (key.replace("""_""" ,      """-"""			) if key in self._FIELDS_WITH_DASHES else key): value
									        for key, value in self.items()
									    } ,      sort_keys=lowercase ,      allow_unicode=lowercase ,      encoding="""utf-8""" ,      ).decode("""utf-8"""			)
lowerCamelCase_				: str    	=							{
    '''image-classification''': [],
    '''translation''': [],
    '''image-segmentation''': [],
    '''fill-mask''': [],
    '''automatic-speech-recognition''': [],
    '''token-classification''': [],
    '''sentence-similarity''': [],
    '''audio-classification''': [],
    '''question-answering''': [],
    '''summarization''': [],
    '''zero-shot-classification''': [],
    '''table-to-text''': [],
    '''feature-extraction''': [],
    '''other''': [],
    '''multiple-choice''': [],
    '''text-classification''': [],
    '''text-to-image''': [],
    '''text2text-generation''': [],
    '''zero-shot-image-classification''': [],
    '''tabular-classification''': [],
    '''tabular-regression''': [],
    '''image-to-image''': [],
    '''tabular-to-text''': [],
    '''unconditional-image-generation''': [],
    '''text-retrieval''': [],
    '''text-to-speech''': [],
    '''object-detection''': [],
    '''audio-to-audio''': [],
    '''text-generation''': [],
    '''conversational''': [],
    '''table-question-answering''': [],
    '''visual-question-answering''': [],
    '''image-to-text''': [],
    '''reinforcement-learning''': [],
    '''voice-activity-detection''': [],
    '''time-series-forecasting''': [],
    '''document-question-answering''': [],
}


if __name__ == "__main__":
					from argparse import ArgumentParser

					lowerCamelCase_				: Tuple    	=							ArgumentParser(usage='''Validate the yaml metadata block of a README.md file.''')
					ap.add_argument('''readme_filepath''')
					lowerCamelCase_				: str    	=							ap.parse_args()

					lowerCamelCase_				: List[str]    	=							Path(args.readme_filepath)
					lowerCamelCase_				: Tuple    	=							DatasetMetadata.from_readme(readme_filepath)
					print(dataset_metadata)
					dataset_metadata.to_readme(readme_filepath)
