





from math import pi, sqrt, tan





def     _UpperCamelCase     (a__   :float       ):






							"""simple docstring"""





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





def     _UpperCamelCase     (a__   :float   ,			a__   :float   ,			a__   :float       ):






							"""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     _UpperCamelCase     (a__   :float       ):






							"""simple docstring"""





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





def     _UpperCamelCase     (a__   :float       ):






							"""simple docstring"""





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





def     _UpperCamelCase     (a__   :float   ,			a__   :float       ):






							"""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     _UpperCamelCase     (a__   :float   ,			a__   :float   ,			a__   :float       ):






							"""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     _UpperCamelCase     (a__   :float   ,			a__   :float       ):






							"""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     _UpperCamelCase     (a__   :float   ,			a__   :float       ):






							"""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     _UpperCamelCase     (a__   :float   ,			a__   :float       ):






							"""simple docstring"""





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





def     _UpperCamelCase     (a__   :float       ):






							"""simple docstring"""





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





def     _UpperCamelCase     (a__   :float   ,			a__   :float       ):






							"""simple docstring"""





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





def     _UpperCamelCase     (a__   :float   ,			a__   :float   ,			a__   :float       ):






							"""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     _UpperCamelCase     (a__   :float   ,			a__   :float       ):






							"""simple docstring"""





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





def     _UpperCamelCase     (a__   :float   ,			a__   :float   ,			a__   :float       ):






							"""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     _UpperCamelCase     (a__   :float       ):






							"""simple docstring"""





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





def     _UpperCamelCase     (a__   :float   ,			a__   :float       ):






							"""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     _UpperCamelCase     (a__   :float   ,			a__   :float       ):






							"""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     _UpperCamelCase     (a__   :int   ,			a__   :float       ):






							"""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) = }""")











import os

import pytest
import yaml

from datasets.features.features import Features, Value
from datasets.info import DatasetInfo, DatasetInfosDict





@pytest.mark.parametrize(
    """files"""   ,			[
        ["""full:README.md""", """dataset_infos.json"""],
        ["""empty:README.md""", """dataset_infos.json"""],
        ["""dataset_infos.json"""],
        ["""full:README.md"""],
    ]   ,			)
def     _UpperCamelCase     (a__   :Any   ,			a__   :Union[str, Any]       ):






							"""simple docstring"""





							UpperCamelCase__				     =			tmp_path_factory.mktemp("""dset_infos_dir"""       )
							if "full:README.md" in files:
														with open(dataset_infos_dir / """README.md"""   ,			"""w"""       ) as f:
																					f.write("""---\ndataset_info:\n  dataset_size: 42\n---"""       )
							if "empty:README.md" in files:
														with open(dataset_infos_dir / """README.md"""   ,			"""w"""       ) as f:
																					f.write(""""""       )
    # we want to support dataset_infos.json for backward compatibility
							if "dataset_infos.json" in files:
														with open(dataset_infos_dir / """dataset_infos.json"""   ,			"""w"""       ) as f:
																					f.write("""{\"default\": {\"dataset_size\": 42}}"""       )
							UpperCamelCase__				     =			DatasetInfosDict.from_directory(a__       )
							assert dataset_infos
							assert dataset_infos["default"].dataset_size == 42





@pytest.mark.parametrize(
    """dataset_info"""   ,			[
        DatasetInfo(),
        DatasetInfo(
            description="""foo"""   ,			features=Features({"""a""": Value("""int32"""       )}       )   ,			builder_name="""builder"""   ,			config_name="""config"""   ,			version="""1.0.0"""   ,			splits=[{"""name""": """train"""}]   ,			download_size=42   ,			),
    ]   ,			)
def     _UpperCamelCase     (a__   :Optional[int]   ,			a__   :DatasetInfo       ):






							"""simple docstring"""





							UpperCamelCase__				     =			str(a__       )
							dataset_info.write_to_directory(a__       )
							UpperCamelCase__				     =			DatasetInfo.from_directory(a__       )
							assert dataset_info == reloaded
							assert os.path.exists(os.path.join(a__   ,			"""dataset_info.json"""       )       )





def     _UpperCamelCase     ():






							"""simple docstring"""





							UpperCamelCase__				     =			DatasetInfo(
							    description="""foo"""   ,			citation="""bar"""   ,			homepage="""https://foo.bar"""   ,			license="""CC0"""   ,			features=Features({"""a""": Value("""int32"""       )}       )   ,			post_processed={}   ,			supervised_keys=()   ,			task_templates=[]   ,			builder_name="""builder"""   ,			config_name="""config"""   ,			version="""1.0.0"""   ,			splits=[{"""name""": """train""", """num_examples""": 42}]   ,			download_checksums={}   ,			download_size=1337   ,			post_processing_size=442   ,			dataset_size=1234   ,			size_in_bytes=1337 + 442 + 1234   ,			)
							UpperCamelCase__				     =			dataset_info._to_yaml_dict()
							assert sorted(a__       ) == sorted(DatasetInfo._INCLUDED_INFO_IN_YAML       )
							for key in DatasetInfo._INCLUDED_INFO_IN_YAML:
														assert key in dataset_info_yaml_dict
														assert isinstance(dataset_info_yaml_dict[key]   ,			(list, dict, int, str)       )
							UpperCamelCase__				     =			yaml.safe_dump(a__       )
							UpperCamelCase__				     =			yaml.safe_load(a__       )
							assert dataset_info_yaml_dict == reloaded





def     _UpperCamelCase     ():






							"""simple docstring"""





							UpperCamelCase__				     =			DatasetInfo()
							UpperCamelCase__				     =			dataset_info._to_yaml_dict()
							assert dataset_info_yaml_dict == {}





@pytest.mark.parametrize(
    """dataset_infos_dict"""   ,			[
        DatasetInfosDict(),
        DatasetInfosDict({"""default""": DatasetInfo()}       ),
        DatasetInfosDict({"""my_config_name""": DatasetInfo()}       ),
        DatasetInfosDict(
            {
                """default""": DatasetInfo(
                    description="""foo"""   ,			features=Features({"""a""": Value("""int32"""       )}       )   ,			builder_name="""builder"""   ,			config_name="""config"""   ,			version="""1.0.0"""   ,			splits=[{"""name""": """train"""}]   ,			download_size=42   ,			)
            }       ),
        DatasetInfosDict(
            {
                """v1""": DatasetInfo(dataset_size=42       ),
                """v2""": DatasetInfo(dataset_size=1337       ),
            }       ),
    ]   ,			)
def     _UpperCamelCase     (a__   :int   ,			a__   :DatasetInfosDict       ):






							"""simple docstring"""





							UpperCamelCase__				     =			str(a__       )
							dataset_infos_dict.write_to_directory(a__       )
							UpperCamelCase__				     =			DatasetInfosDict.from_directory(a__       )

							# the config_name of the dataset_infos_dict take over the attribute
							for config_name, dataset_info in dataset_infos_dict.items():
														UpperCamelCase__				     =			config_name
														# the yaml representation doesn't include fields like description or citation
														# so we just test that we can recover what we can from the yaml
														UpperCamelCase__				     =			DatasetInfo._from_yaml_dict(dataset_info._to_yaml_dict()       )
							assert dataset_infos_dict == reloaded

							if dataset_infos_dict:
														assert os.path.exists(os.path.join(a__   ,			"""README.md"""       )       )




