ad-supermath 0.1.0__tar.gz

ad_supermath-0.1.0/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Yashvi Harsora
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files to deal in the Software
+without restriction.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

ad_supermath-0.1.0/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: ad-supermath
+Version: 0.1.0
+Summary: A custom Python math utility library
+Author: Yashvi Harsora
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+Dynamic: requires-python
+
+# SuperMath 📊
+
+SuperMath is a custom Python utility library that provides useful mathematical, statistical, geometry, finance, and random utility functions in one place.
+
+It is designed to make common calculations easier and more accessible for developers, students, and data enthusiasts.
+
+---
+
+## Features
+
+SuperMath includes multiple modules:
+
+### Basic Utilities
+
+- percentage
+- average
+- square
+- cube
+- factorial
+- gcd
+- lcm
+- map_range
+- normalize
+- round_to
+- sign
+- swap
+
+### Statistics
+
+- mean
+- median
+- mode
+- data_range
+- variance
+- standard_deviation
+- percentile
+
+### Geometry
+
+- circle_area
+- circle_circumference
+- rectangle_area
+- rectangle_perimeter
+- triangle_area
+- triangle_perimeter
+- square_area
+- square_perimeter
+- cylinder_volume
+- sphere_volume
+- sphere_surface_area
+- distance
+
+### Finance
+
+- simple_interest
+- compound_interest
+- compound_amount
+- profit
+- loss
+- profit_percentage
+- loss_percentage
+- discount_amount
+- discounted_price
+- gst_amount
+- price_with_gst
+- emi
+
+### Random Utilities
+
+- random_int
+- random_float
+- random_float_range
+- random_choice
+- shuffle_list
+- random_bool
+- random_char
+- random_digit
+- random_string
+- random_password
+- random_color
+- random_sample
+
+---
+
+## Installation
+
+```bash
+pip install supermath
+```

ad_supermath-0.1.0/README.md

@@ -0,0 +1,89 @@
+# SuperMath 📊
+
+SuperMath is a custom Python utility library that provides useful mathematical, statistical, geometry, finance, and random utility functions in one place.
+
+It is designed to make common calculations easier and more accessible for developers, students, and data enthusiasts.
+
+---
+
+## Features
+
+SuperMath includes multiple modules:
+
+### Basic Utilities
+
+- percentage
+- average
+- square
+- cube
+- factorial
+- gcd
+- lcm
+- map_range
+- normalize
+- round_to
+- sign
+- swap
+
+### Statistics
+
+- mean
+- median
+- mode
+- data_range
+- variance
+- standard_deviation
+- percentile
+
+### Geometry
+
+- circle_area
+- circle_circumference
+- rectangle_area
+- rectangle_perimeter
+- triangle_area
+- triangle_perimeter
+- square_area
+- square_perimeter
+- cylinder_volume
+- sphere_volume
+- sphere_surface_area
+- distance
+
+### Finance
+
+- simple_interest
+- compound_interest
+- compound_amount
+- profit
+- loss
+- profit_percentage
+- loss_percentage
+- discount_amount
+- discounted_price
+- gst_amount
+- price_with_gst
+- emi
+
+### Random Utilities
+
+- random_int
+- random_float
+- random_float_range
+- random_choice
+- shuffle_list
+- random_bool
+- random_char
+- random_digit
+- random_string
+- random_password
+- random_color
+- random_sample
+
+---
+
+## Installation
+
+```bash
+pip install supermath
+```

ad_supermath-0.1.0/ad_supermath.egg-info/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: ad-supermath
+Version: 0.1.0
+Summary: A custom Python math utility library
+Author: Yashvi Harsora
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+Dynamic: requires-python
+
+# SuperMath 📊
+
+SuperMath is a custom Python utility library that provides useful mathematical, statistical, geometry, finance, and random utility functions in one place.
+
+It is designed to make common calculations easier and more accessible for developers, students, and data enthusiasts.
+
+---
+
+## Features
+
+SuperMath includes multiple modules:
+
+### Basic Utilities
+
+- percentage
+- average
+- square
+- cube
+- factorial
+- gcd
+- lcm
+- map_range
+- normalize
+- round_to
+- sign
+- swap
+
+### Statistics
+
+- mean
+- median
+- mode
+- data_range
+- variance
+- standard_deviation
+- percentile
+
+### Geometry
+
+- circle_area
+- circle_circumference
+- rectangle_area
+- rectangle_perimeter
+- triangle_area
+- triangle_perimeter
+- square_area
+- square_perimeter
+- cylinder_volume
+- sphere_volume
+- sphere_surface_area
+- distance
+
+### Finance
+
+- simple_interest
+- compound_interest
+- compound_amount
+- profit
+- loss
+- profit_percentage
+- loss_percentage
+- discount_amount
+- discounted_price
+- gst_amount
+- price_with_gst
+- emi
+
+### Random Utilities
+
+- random_int
+- random_float
+- random_float_range
+- random_choice
+- shuffle_list
+- random_bool
+- random_char
+- random_digit
+- random_string
+- random_password
+- random_color
+- random_sample
+
+---
+
+## Installation
+
+```bash
+pip install supermath
+```

ad_supermath-0.1.0/ad_supermath.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+ad_supermath.egg-info/PKG-INFO
+ad_supermath.egg-info/SOURCES.txt
+ad_supermath.egg-info/dependency_links.txt
+ad_supermath.egg-info/top_level.txt
+supermath/__init__.py
+supermath/basic.py
+supermath/finance.py
+supermath/geometry.py
+supermath/random_utils.py
+supermath/statistics.py

ad_supermath-0.1.0/ad_supermath.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ad_supermath-0.1.0/ad_supermath.egg-info/top_level.txt

@@ -0,0 +1 @@
+supermath

ad_supermath-0.1.0/pyproject.toml

@@ -0,0 +1,13 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ad-supermath"
+version = "0.1.0"
+description = "A custom Python math utility library"
+authors = [
+  { name="Yashvi Harsora" }
+]
+readme = "README.md"
+requires-python = ">=3.7"

ad_supermath-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ad_supermath-0.1.0/setup.py

@@ -0,0 +1,12 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="ad-supermath",
+    version="0.1.0",
+    description="A custom Python math utility library with statistics, geometry, finance and random utilities",
+    author="Yashvi Harsora",
+    packages=find_packages(),
+    python_requires=">=3.7",
+    install_requires=[],
+    license="MIT"
+)

ad_supermath-0.1.0/supermath/__init__.py

@@ -0,0 +1,6 @@
+from .basic import *
+from .statistics import *
+from .geometry import *
+from .finance import *
+from .random_utils import *
+

ad_supermath-0.1.0/supermath/basic.py

@@ -0,0 +1,72 @@
+# Basic math utilities for SuperMath
+
+
+# 1. Calculate percentage
+def percentage(value, total):
+    return (value / total) * 100
+
+# 2. square 
+def square(x):
+    return x*x
+
+# 3. cube
+def cube(x):
+    return x*x*x
+
+# 4. even numbers
+def is_even(num):
+    return num%2==0
+
+# 5. odd numbers 
+def is_odd(num):
+    return num%2!=0
+
+# 6. Limit value
+def clamp(value, min_value, max_value):
+    return max(min_value, min(value, max_value))
+
+# 7. average
+def average(numbers):
+    return sum(numbers) / len(numbers)
+
+# 8. factorial
+def factorial(n):
+    result = 1
+    for i in range(1, n + 1):
+        result *= i
+    return result
+
+# 9. GCD (Greatest Common Divisor (Euclidean algorithm))
+def gcd(a, b):
+    while b != 0:
+        a, b = b, a % b
+    return a
+
+# 10. LCM (Least Common Multiple)
+def lcm(a, b):
+    return abs(a * b) // gcd(a, b)
+
+# 11. map-range (Map value from one range to another)
+def map_range(value, in_min, in_max, out_min, out_max):
+    return (value - in_min) * (out_max - out_min) / (in_max - in_min) + out_min
+
+# 12. normalized value (Normalize value between 0 and 1)
+def normalize(value, min_val, max_val):
+    return (value - min_val) / (max_val - min_val)
+
+# 13. round (Round number to given decimal places)
+def round_to(value, decimals=0):
+    return round(value, decimals)
+
+# 14. sign  (check the sign of the number- positive/negative)
+def sign(num):
+    if num > 0:
+        return 1
+    elif num < 0:
+        return -1
+    else:
+        return 0
+    
+# 15. swap (Swap two values)
+def swap(a, b):
+    return b, a

ad_supermath-0.1.0/supermath/finance.py

@@ -0,0 +1,63 @@
+import math
+
+# Finance utilities for SuperMath
+
+# 1. Calculate simple interest
+def simple_interest(principal, rate, time):
+    return (principal * rate * time) / 100
+
+
+# 2. Calculate compound interest
+def compound_interest(principal, rate, time):
+    return principal * (1 + rate/100) ** time - principal
+
+
+# 3. Calculate total amount after compound interest
+def compound_amount(principal, rate, time):
+    return principal * (1 + rate/100) ** time
+
+
+# 4. Calculate profit
+def profit(cost_price, selling_price):
+    return selling_price - cost_price
+
+
+# 5. Calculate loss
+def loss(cost_price, selling_price):
+    return cost_price - selling_price
+
+
+# 6. Calculate profit percentage
+def profit_percentage(cost_price, selling_price):
+    return ((selling_price - cost_price) / cost_price) * 100
+
+
+# 7. Calculate loss percentage
+def loss_percentage(cost_price, selling_price):
+    return ((cost_price - selling_price) / cost_price) * 100
+
+
+# 8. Calculate discount amount
+def discount_amount(price, discount_percent):
+    return price * discount_percent / 100
+
+
+# 9. Calculate final price after discount
+def discounted_price(price, discount_percent):
+    return price - (price * discount_percent / 100)
+
+
+# 10. Calculate GST amount
+def gst_amount(price, gst_percent):
+    return price * gst_percent / 100
+
+
+# 11. Calculate price including GST
+def price_with_gst(price, gst_percent):
+    return price + (price * gst_percent / 100)
+
+
+# 12. Calculate EMI (Equated Monthly Installment)
+def emi(principal, annual_rate, months):
+    monthly_rate = annual_rate / (12 * 100)
+    return (principal * monthly_rate * (1 + monthly_rate) ** months) / ((1 + monthly_rate) ** months - 1)

ad_supermath-0.1.0/supermath/geometry.py

@@ -0,0 +1,51 @@
+import math
+
+# Geometry utilities for SuperMath
+
+# 1. Calculate area of circle
+def circle_area(radius):
+    return math.pi * radius ** 2
+
+# 2. Calculate circumference of circle
+def circle_circumference(radius):
+    return 2 * math.pi * radius
+
+# 3. Calculate rectangle area
+def rectangle_area(length, width):
+    return length * width
+
+# 4. Calculate rectangle perimeter
+def rectangle_perimeter(length, width):
+    return 2 * (length + width)
+
+# 5. Calculate triangle area
+def triangle_area(base, height):
+    return 0.5 * base * height
+
+# 6. Calculate triangle perimeter
+def triangle_perimeter(a, b, c):
+    return a + b + c
+
+# 7. Calculate square area
+def square_area(side):
+    return side * side
+
+# 8. Calculate square perimeter
+def square_perimeter(side):
+    return 4 * side
+
+# 9. Calculate cylinder volume
+def cylinder_volume(radius, height):
+    return math.pi * radius ** 2 * height
+
+# 10. Calculate sphere volume
+def sphere_volume(radius):
+    return (4/3) * math.pi * radius ** 3
+
+# 11. Calculate sphere surface area
+def sphere_surface_area(radius):
+    return 4 * math.pi * radius ** 2
+
+# 12. Distance between two points
+def distance(x1, y1, x2, y2):
+    return math.sqrt((x2-x1)**2 + (y2-y1)**2)

ad_supermath-0.1.0/supermath/random_utils.py

@@ -0,0 +1,66 @@
+import random
+import string
+
+# Random utilities for SuperMath
+
+# 1. Generate random integer in range
+def random_int(min_val, max_val):
+    return random.randint(min_val, max_val)
+
+
+# 2. Generate random float between 0 and 1
+def random_float():
+    return random.random()
+
+
+# 3. Generate random float in range
+def random_float_range(min_val, max_val):
+    return random.uniform(min_val, max_val)
+
+
+# 4. Select random element from list
+def random_choice(items):
+    return random.choice(items)
+
+
+# 5. Shuffle a list
+def shuffle_list(items):
+    random.shuffle(items)
+    return items
+
+
+# 6. Generate random boolean
+def random_bool():
+    return random.choice([True, False])
+
+
+# 7. Generate random character
+def random_char():
+    return random.choice(string.ascii_letters)
+
+
+# 8. Generate random digit
+def random_digit():
+    return random.choice(string.digits)
+
+
+# 9. Generate random string
+def random_string(length):
+    chars = string.ascii_letters + string.digits
+    return ''.join(random.choice(chars) for _ in range(length))
+
+
+# 10. Generate random password
+def random_password(length):
+    chars = string.ascii_letters + string.digits + "!@#$%^&*"
+    return ''.join(random.choice(chars) for _ in range(length))
+
+
+# 11. Generate random color (hex)
+def random_color():
+    return "#{:06x}".format(random.randint(0, 0xFFFFFF))
+
+
+# 12. Randomly pick multiple items
+def random_sample(items, count):
+    return random.sample(items, count)

ad_supermath-0.1.0/supermath/statistics.py

@@ -0,0 +1,46 @@
+# Statistics utilities for SuperMath
+
+
+# 1. Calculate mean (average)
+def mean(numbers):
+    return sum(numbers) / len(numbers)
+
+# 2. Find median value
+def median(numbers):
+    nums = sorted(numbers)
+    n = len(nums)
+
+    if n % 2 == 0:
+        return (nums[n//2 - 1] + nums[n//2]) / 2
+    else:
+        return nums[n//2]
+
+# 3. Find mode (most frequent value)
+
+def mode(numbers):
+    return max(set(numbers), key=numbers.count)
+
+# 4. Find range of data
+def data_range(numbers):
+    return max(numbers) - min(numbers)
+
+# 5. Calculate variance
+def variance(numbers):
+    m = mean(numbers)
+    return sum((x - m) ** 2 for x in numbers) / len(numbers)
+
+# 6. Calculate standard deviation
+def standard_deviation(numbers):
+    return variance(numbers) ** 0.5
+
+# 7. Find percentile
+def percentile(numbers, p):
+    nums = sorted(numbers)
+    k = (len(nums)-1) * (p/100)
+    f = int(k)
+    c = f + 1
+
+    if c >= len(nums):
+        return nums[f]
+
+    return nums[f] + (nums[c] - nums[f]) * (k - f)