






'''simple docstring'''







from math import pi, sqrt, tan





def 		_UpperCAmelCase   (							__A							:   float      ):
				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      ):
				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      ):
				if radius < 0:
								raise ValueError('''surface_area_sphere() only accepts non-negative values'''      )
				return 4 * pi * radius**2





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





def 		_UpperCAmelCase   (							__A							:   float						,		__A							:   float      ):
				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      ):
				if radius_a < 0 or radius_a < 0 or height < 0:
								raise ValueError(
								    '''surface_area_conical_frustum() only accepts non-negative values'''      )
				a_		:  Any											=      (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      ):
				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      ):
				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      ):
				if length < 0 or width < 0:
								raise ValueError('''area_rectangle() only accepts non-negative values'''      )
				return length * width





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





def 		_UpperCAmelCase   (							__A							:   float						,		__A							:   float      ):
				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      ):
				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_		:  int											=      (sidea + sidea + sidea) / 2
				a_		:  Optional[Any]											=      sqrt(
				    semi_perimeter
				    * (semi_perimeter - sidea)
				    * (semi_perimeter - sidea)
				    * (semi_perimeter - sidea)      )
				return area





def 		_UpperCAmelCase   (							__A							:   float						,		__A							:   float      ):
				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      ):
				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      ):
				if radius < 0:
								raise ValueError('''area_circle() only accepts non-negative values'''      )
				return pi * radius**2





def 		_UpperCAmelCase   (							__A							:   float						,		__A							:   float      ):
				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      ):
				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      ):
				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 dataclasses import dataclass, field
from typing import TYPE_CHECKING, Any, ClassVar, Dict, List, Optional, Union

import pyarrow as pa


if TYPE_CHECKING:
		from .features import FeatureType





@dataclass
class 	SCREAMING_SNAKE_CASE					:
			snake_case__  =				42
			snake_case__  =				None
			# Automatically constructed
			snake_case__  =				"dict"
			snake_case__  =				None
			snake_case__  =				field(default="Translation"	,   init=SCREAMING_SNAKE_CASE_	,   repr=SCREAMING_SNAKE_CASE_       )






			def __call__( self      :			Dict					)			->			Tuple:
							return pa.struct({lang: pa.string() for lang in sorted(self.languages					)}					)







			def 			SCREAMING_SNAKE_CASE      ( self      :			Union[str, Any]					)			->			Union["FeatureType", Dict[str, "FeatureType"]]:
							from .features import Value

							return {k: Value('''string'''					) for k in sorted(self.languages					)}





@dataclass
class 	SCREAMING_SNAKE_CASE					:
			snake_case__  =				None
			snake_case__  =				None
			snake_case__  =				None
			# Automatically constructed
			snake_case__  =				"dict"
			snake_case__  =				None
			snake_case__  =				field(default="TranslationVariableLanguages"	,   init=SCREAMING_SNAKE_CASE_	,   repr=SCREAMING_SNAKE_CASE_       )






			def 			SCREAMING_SNAKE_CASE      ( self      :			Tuple					)			->			Dict:
							a_		:  List[str]											=      sorted(set(self.languages					)					) if self.languages else None
							a_		:  Optional[Any]											=      len(self.languages					) if self.languages else None






			def __call__( self      :			Any					)			->			Optional[Any]:
							return pa.struct({'''language''': pa.list_(pa.string()					), '''translation''': pa.list_(pa.string()					)}					)






			def 			SCREAMING_SNAKE_CASE      ( self      :			Optional[int]  ,						__SCREAMING_SNAKE_CASE      :			Optional[Any]					)			->			Optional[Any]:
							a_		:  str											=      set(self.languages					)
							if self.languages and set(__SCREAMING_SNAKE_CASE					) - lang_set:
											raise ValueError(
											    f'Some languages in example ({", ".join(sorted(set(__SCREAMING_SNAKE_CASE					) - lang_set					)					)}) are not in valid set ({", ".join(__SCREAMING_SNAKE_CASE					)}).'					)

							# Convert dictionary into tuples, splitting out cases where there are
							# multiple translations for a single language.
							a_		:  int											=      []
							for lang, text in translation_dict.items():
											if isinstance(__SCREAMING_SNAKE_CASE  ,						__SCREAMING_SNAKE_CASE					):
															translation_tuples.append((lang, text)					)
											else:
															translation_tuples.extend([(lang, el) for el in text]					)

        # Ensure translations are in ascending order by language code.
							a_				,			a_		:  List[Any]											=      zip(*sorted(__SCREAMING_SNAKE_CASE					)					)

							return {"language": languages, "translation": translations}







			def 			SCREAMING_SNAKE_CASE      ( self      :			Any					)			->			Union["FeatureType", Dict[str, "FeatureType"]]:
							from .features import Sequence, Value

							return {
							    "language": Sequence(Value('''string'''					)					),
							    "translation": Sequence(Value('''string'''					)					),
							}




