Update area.py

Added a function to calculate the surface area of a regular prism

Author: kvadrik

maths/area.py

@@ -607,6 +607,50 @@ def area_reg_polygon(sides: int, length: float) -> float:
     return (sides * length**2) / (4 * tan(pi / sides))
 
 
+def surface_area_reg_prism(sides: int, edge: float, height: float) -> float:
+    """
+    Calculate the surface area of a regular prism.
+    Wikipedia reference: https://en.wikipedia.org/wiki/Prism
+    Formula: 2*S(base) + n*a*h
+
+    >>> surface_area_reg_prism(3, 10, 20)
+    686.6025403784439
+    >>> surface_area_reg_prism(4, 10, 10)
+    600.0
+    >>> surface_area_reg_prism(2, 10, 15)
+    Traceback (most recent call last):
+        ...
+    ValueError: surface_area_reg_prism() only accepts integers greater than or equal to \
+three as number of sides
+    >>> surface_area_reg_prism(5, -2, 3)
+    Traceback (most recent call last):
+        ...
+    ValueError: surface_area_reg_prism() only accepts non-negative values as \
+length of an edge or height
+    >>> surface_area_reg_prism(5, 2, -3)
+    Traceback (most recent call last):
+        ...
+    ValueError: surface_area_reg_prism() only accepts non-negative values as \
+length of an edge or height
+    >>> surface_area_reg_prism(2, -10, 15)
+    Traceback (most recent call last):
+        ...
+    ValueError: surface_area_reg_prism() only accepts integers greater than or equal to \
+three as number of sides
+    """
+    if not isinstance(sides, int) or sides < 3:
+        raise ValueError(
+            "surface_area_reg_prism() only accepts integers greater than or \
+equal to three as number of sides"
+        )
+    elif edge < 0 or height < 0:
+        raise ValueError(
+            "surface_area_reg_prism() only accepts non-negative values as \
+length of an edge or height"
+        )
+    return 2 * area_reg_polygon(sides, edge) + sides * edge * height
+
+
 if __name__ == "__main__":
     import doctest
 
@@ -636,3 +680,5 @@ def area_reg_polygon(sides: int, length: float) -> float:
     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) = }")
+    print(f"Regular Pentagonal Prism: {surface_area_reg_prism(5, 10, 15) = }")
+