





"""simple docstring"""


import importlib.metadata
import operator
import re
import sys
from typing import Optional

from packaging import version


__magic_name__       :					List[str]						=			{
    """<""": operator.lt,
    """<=""": operator.le,
    """==""": operator.eq,
    """!=""": operator.ne,
    """>=""": operator.ge,
    """>""": operator.gt,
}

def      UpperCamelCase							(SCREAMING_SNAKE_CASE							,     SCREAMING_SNAKE_CASE							,     SCREAMING_SNAKE_CASE							,     SCREAMING_SNAKE_CASE							,     SCREAMING_SNAKE_CASE							,     SCREAMING_SNAKE_CASE     ):
						if got_ver is None or want_ver is None:
												raise ValueError(
												    f"""Unable to compare versions for {requirement}: need={want_ver} found={got_ver}. This is unusual. Consider"""
												    f""" reinstalling {pkg}."""     )
						if not ops[op](version.parse(SCREAMING_SNAKE_CASE     )							,     version.parse(SCREAMING_SNAKE_CASE     )     ):
												raise ImportError(
												    f"""{requirement} is required for a normal functioning of this module, but found {pkg}=={got_ver}.{hint}"""     )

def      UpperCamelCase							(SCREAMING_SNAKE_CASE							,     SCREAMING_SNAKE_CASE = None     ):
						UpperCamelCase				:		str				   =			f"""\n{hint}""" if hint is not None else """"""

						# non-versioned check
						if re.match(r"""^[\w_\-\d]+$"""							,     SCREAMING_SNAKE_CASE     ):
												UpperCamelCase   ,						UpperCamelCase   ,						UpperCamelCase				:		Tuple				   =			requirement, None, None
						else:
												UpperCamelCase				:		str				   =			re.findall(r"""^([^!=<>\s]+)([\s!=<>]{1,2}.+)"""							,     SCREAMING_SNAKE_CASE     )
												if not match:
																		raise ValueError(
																		    """requirement needs to be in the pip package format, .e.g., package_a==1.23, or package_b>=1.23, but"""
																		    f""" got {requirement}"""     )
												UpperCamelCase   ,						UpperCamelCase				:		Dict				   =			match[0]
												UpperCamelCase				:		List[str]				   =			want_full.split(""","""     )  # there could be multiple requirements
												UpperCamelCase				:		List[Any]				   =			{}
												for w in want_range:
																		UpperCamelCase				:		Dict				   =			re.findall(r"""^([\s!=<>]{1,2})(.+)"""							,     SCREAMING_SNAKE_CASE     )
																		if not match:
																								raise ValueError(
																								    """requirement needs to be in the pip package format, .e.g., package_a==1.23, or package_b>=1.23,"""
																								    f""" but got {requirement}"""     )
																		UpperCamelCase   ,						UpperCamelCase				:		List[Any]				   =			match[0]
																		UpperCamelCase				:		Any				   =			want_ver
																		if op not in ops:
																								raise ValueError(f"""{requirement}: need one of {list(ops.keys()     )}, but got {op}"""     )

    # special case
						if pkg == "python":
												UpperCamelCase				:		Optional[Any]				   =			""".""".join([str(SCREAMING_SNAKE_CASE     ) for x in sys.version_info[:3]]     )
												for op, want_ver in wanted.items():
																		_compare_versions(SCREAMING_SNAKE_CASE							,     SCREAMING_SNAKE_CASE							,     SCREAMING_SNAKE_CASE							,     SCREAMING_SNAKE_CASE							,     SCREAMING_SNAKE_CASE							,     SCREAMING_SNAKE_CASE     )
												return

						# check if any version is installed
						try:
												UpperCamelCase				:		Tuple				   =			importlib.metadata.version(SCREAMING_SNAKE_CASE     )
						except importlib.metadata.PackageNotFoundError:
												raise importlib.metadata.PackageNotFoundError(
												    f"""The '{requirement}' distribution was not found and is required by this application. {hint}"""     )

						# check that the right version is installed if version number or a range was provided
						if want_ver is not None:
												for op, want_ver in wanted.items():
																		_compare_versions(SCREAMING_SNAKE_CASE							,     SCREAMING_SNAKE_CASE							,     SCREAMING_SNAKE_CASE							,     SCREAMING_SNAKE_CASE							,     SCREAMING_SNAKE_CASE							,     SCREAMING_SNAKE_CASE     )

def      UpperCamelCase							(SCREAMING_SNAKE_CASE     ):
						UpperCamelCase				:		Any				   =			"""Try: pip install transformers -U or pip install -e '.[dev]' if you're working with git main"""
						return require_version(SCREAMING_SNAKE_CASE							,     SCREAMING_SNAKE_CASE     )










from math import pi, sqrt, tan





def 				__lowerCAmelCase(       _SCREAMING_SNAKE_CASE				)							-> float:




    """simple docstring"""




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





def 				__lowerCAmelCase(       _SCREAMING_SNAKE_CASE							,     _SCREAMING_SNAKE_CASE							,     _SCREAMING_SNAKE_CASE				)							-> 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 				__lowerCAmelCase(       _SCREAMING_SNAKE_CASE				)							-> float:




    """simple docstring"""




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





def 				__lowerCAmelCase(       _SCREAMING_SNAKE_CASE				)							-> float:




    """simple docstring"""




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





def 				__lowerCAmelCase(       _SCREAMING_SNAKE_CASE							,     _SCREAMING_SNAKE_CASE				)							-> 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 				__lowerCAmelCase(       _SCREAMING_SNAKE_CASE							,     _SCREAMING_SNAKE_CASE							,     _SCREAMING_SNAKE_CASE				)							-> 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'				)
    _A     =							(height**2 + (radius_a - radius_a) ** 2) ** 0.5
    return pi * ((slant_height * (radius_a + radius_a)) + radius_a**2 + radius_a**2)





def 				__lowerCAmelCase(       _SCREAMING_SNAKE_CASE							,     _SCREAMING_SNAKE_CASE				)							-> 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 				__lowerCAmelCase(       _SCREAMING_SNAKE_CASE							,     _SCREAMING_SNAKE_CASE				)							-> 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(_SCREAMING_SNAKE_CASE							,     2				) * torus_radius * tube_radius





def 				__lowerCAmelCase(       _SCREAMING_SNAKE_CASE							,     _SCREAMING_SNAKE_CASE				)							-> float:




    """simple docstring"""




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





def 				__lowerCAmelCase(       _SCREAMING_SNAKE_CASE				)							-> float:




    """simple docstring"""




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





def 				__lowerCAmelCase(       _SCREAMING_SNAKE_CASE							,     _SCREAMING_SNAKE_CASE				)							-> float:




    """simple docstring"""




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





def 				__lowerCAmelCase(       _SCREAMING_SNAKE_CASE							,     _SCREAMING_SNAKE_CASE							,     _SCREAMING_SNAKE_CASE				)							-> 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'				)
    _A     =							(sidea + sidea + sidea) / 2
    _A     =							sqrt(
        semi_perimeter
        * (semi_perimeter - sidea)
        * (semi_perimeter - sidea)
        * (semi_perimeter - sidea)				)
    return area





def 				__lowerCAmelCase(       _SCREAMING_SNAKE_CASE							,     _SCREAMING_SNAKE_CASE				)							-> float:




    """simple docstring"""




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





def 				__lowerCAmelCase(       _SCREAMING_SNAKE_CASE							,     _SCREAMING_SNAKE_CASE							,     _SCREAMING_SNAKE_CASE				)							-> 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 				__lowerCAmelCase(       _SCREAMING_SNAKE_CASE				)							-> float:




    """simple docstring"""




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





def 				__lowerCAmelCase(       _SCREAMING_SNAKE_CASE							,     _SCREAMING_SNAKE_CASE				)							-> 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 				__lowerCAmelCase(       _SCREAMING_SNAKE_CASE							,     _SCREAMING_SNAKE_CASE				)							-> 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 				__lowerCAmelCase(       _SCREAMING_SNAKE_CASE							,     _SCREAMING_SNAKE_CASE				)							-> float:




    """simple docstring"""




    if not isinstance(_SCREAMING_SNAKE_CASE							,     _SCREAMING_SNAKE_CASE				) 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) = }")





