python-taxes 0.1.0__tar.gz

python_taxes-0.1.0/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.3
+Name: python-taxes
+Version: 0.1.0
+Summary: Development in progress - please come back later.
+Author: Stacy Noland
+Author-email: 46572585+stacynoland@users.noreply.github.com
+Requires-Python: >=3.13
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: pydantic (>=2.10.6,<3.0.0)
+Description-Content-Type: text/markdown
+
+

python_taxes-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[project]
+name = "python-taxes"
+version = "0.1.0"
+description = "Development in progress - please come back later."
+authors = [
+    {name = "Stacy Noland", email = "46572585+stacynoland@users.noreply.github.com"}
+]
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "pydantic (>=2.10.6,<3.0.0)"
+]
+
+[tool.poetry]
+packages = [{include = "python_taxes", from = "src"}]
+
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^8.3.5"
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"

python_taxes-0.1.0/src/python_taxes/federal/calculators/__init__.py

@@ -0,0 +1,13 @@
+from decimal import Decimal, getcontext, ROUND_HALF_UP
+
+
+getcontext().rounding = ROUND_HALF_UP
+
+ROUNDED = Decimal('1.')
+
+NOT_ROUNDED = Decimal('0.01')
+
+rounding = {
+    True: ROUNDED,
+    False: NOT_ROUNDED,
+}

python_taxes-0.1.0/src/python_taxes/federal/calculators/medicare.py

@@ -0,0 +1,88 @@
+from decimal import Decimal
+from typing import Annotated, Literal, Optional
+
+from pydantic import Field, StrictBool, validate_call
+
+from . import rounding
+
+
+STANDARD_PERCENT = Decimal("1.45") / 100
+
+SELF_EMPLOYED_PERCENT = Decimal("2.9") / 100
+
+ADDITIONAL_PERCENT = Decimal("0.9") / 100
+
+DEFAULT_THRESHOLD = Decimal("200000")
+
+status_threshold = {
+    'single': DEFAULT_THRESHOLD,
+    'married': Decimal("250000"),
+    'separate': Decimal("125000"),
+    'hoh': DEFAULT_THRESHOLD,
+}
+
+
+@validate_call
+def withholding(
+    taxable_wages: Annotated[Decimal, Field(ge=Decimal("0.01"), decimal_places=2)],
+    taxable_wages_ytd: Optional[
+        Annotated[Decimal, Field(ge=Decimal("0.01"), decimal_places=2)]] = None,
+    self_employed: StrictBool = False,
+    rounded: StrictBool = False,
+) -> Decimal:
+    """Required amount to withhold regardless of filing status
+
+    Parameters:
+    taxable_wages -- Earned this period
+    taxable_wages_ytd -- Earned this year
+    self_employed -- Person/employee is self-employed (default False)
+    round -- Round response to nearest whole dollar amount (default False)
+    """
+
+    if not taxable_wages_ytd:
+        taxable_wages_ytd = 0
+
+    if self_employed:
+        tax_rate = SELF_EMPLOYED_PERCENT
+    else:
+        tax_rate = STANDARD_PERCENT
+
+    if (taxable_wages > DEFAULT_THRESHOLD
+            or (taxable_wages_ytd + taxable_wages) > DEFAULT_THRESHOLD):
+        tax_rate = tax_rate + ADDITIONAL_PERCENT
+
+    return (taxable_wages * tax_rate).quantize(rounding[rounded])
+
+
+@validate_call
+def additional_withholding(
+    taxable_wages_ytd: Annotated[Decimal, Field(ge=Decimal("0.01"), decimal_places=2)],
+    self_employed: StrictBool = False,
+    status: Optional[Literal['single', 'married', 'separate' 'hoh']] = 'single',
+    rounded: StrictBool = False,
+) -> Decimal:
+    """Additional withholding based on status
+
+    Parameters:
+    taxable_wages_ytd -- Earned this year
+    self_employed -- Person/employee is self-employed (default False)
+    status -- Filing status of person (default 'single')
+    round -- Round response to nearest whole dollar amount (default False)
+    """
+
+    if self_employed:
+        tax_rate = SELF_EMPLOYED_PERCENT
+    else:
+        tax_rate = STANDARD_PERCENT
+
+    threshold = status_threshold[status]
+
+    if taxable_wages_ytd > threshold:
+        wages_over_threshold = taxable_wages_ytd - threshold
+        med_taxes = (taxable_wages_ytd - wages_over_threshold) * tax_rate
+        tax_rate = tax_rate + ADDITIONAL_PERCENT
+        med_taxes = med_taxes + (wages_over_threshold * tax_rate)
+    else:
+        med_taxes = taxable_wages_ytd * tax_rate
+
+    return med_taxes.quantize(rounding[rounded])

python_taxes-0.1.0/src/python_taxes/federal/calculators/social_security.py

@@ -0,0 +1,32 @@
+from decimal import Decimal
+from typing import Annotated, Literal, Optional
+
+from pydantic import Field, StrictBool, validate_call
+
+from . import rounding
+
+STANDARD_TAX = Decimal('6.200') / 100
+
+SELF_EMPLOYED_TAX = Decimal('12.400') / 100
+
+
+@validate_call
+def withholding(
+    taxable_wages: Annotated[Decimal, Field(ge=0.01, decimal_places=2)],
+    self_employed: StrictBool = False,
+    rounded: StrictBool = False,
+) -> Decimal:
+    """Social security tax withholding.
+
+    Parameters:
+    taxable_wages -- Total wages to be taxed
+    self_employed -- Person/employee is self-employed (default False)
+    round -- Round response to nearest whole dollar amount (default False)
+    """
+
+    if self_employed:
+        tax_rate = SELF_EMPLOYED_TAX
+    else:
+        tax_rate = STANDARD_TAX
+
+    return (taxable_wages * tax_rate).quantize(rounding[rounded])