PyPI - python-taxes - Versions diffs - 0.5.0__tar.gz → 0.6.0a3__tar.gz - Mend

python-taxes 0.5.0tar.gz → 0.6.0a3tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (18) hide show

{python_taxes-0.5.0 → python_taxes-0.6.0a3}/LICENSE RENAMED Viewed

@@ -1,21 +1,21 @@
-MIT License
-Copyright (c) 2025 Stacy Noland
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+Copyright (c) 2025 Stacy Noland
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{python_taxes-0.5.0 → python_taxes-0.6.0a3}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: python-taxes
-Version: 0.5.0
+Version: 0.6.0a3
 Summary: A Python library for calculating US Social Security, Medicare, and Federal Income taxes.
 License: MIT License
@@ -24,7 +24,7 @@ License: MIT License
          OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
          SOFTWARE.
 Author: Stacy Noland
-Author-email: 46572585+stacynoland@users.noreply.github.com
+Author-email: stacy.noland@outlook.com
 Requires-Python: >=3.10
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
@@ -38,21 +38,23 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Classifier: Typing :: Typed
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Provides-Extra: cli
 Requires-Dist: pydantic (>=2.11.3,<3.0.0)
+Requires-Dist: typer (>=0.15.0,<1.0.0) ; extra == "cli"
 Project-URL: Homepage, https://github.com/stacynoland/python-taxes
 Project-URL: Source, https://github.com/stacynoland/python-taxes
 Description-Content-Type: text/markdown
 ![Python Taxes Image](https://github.com/user-attachments/assets/6c62946b-e749-46bb-a84e-6321397f1753)
-![PyPI - Python Version](https://img.shields.io/pypi/pyversions/python-taxes?logo=python&logoColor=yellow&label=Python)
-[![GitHub Release](https://img.shields.io/github/v/release/stacynoland/python-taxes?label=Current%20Release)](https://github.com/stacynoland/python-taxes/releases)
-![PyPI - Status](https://img.shields.io/pypi/status/python-taxes?label=Status)
-[![Tests](https://github.com/stacynoland/python-taxes/actions/workflows/test.yml/badge.svg)](https://github.com/stacynoland/python-taxes/actions/workflows/test.yml)
-![Coverage](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Fstacynoland%2Fpython-taxes%2Frefs%2Fheads%2Fmain%2Fcoverage.json&query=%24.totals.percent_covered_display&suffix=%25&label=Coverage&color=3fb831)
-[![Black](https://img.shields.io/badge/Code%20Style-black-000000)](https://github.com/psf/black)
+[![Tests](https://github.com/stacynoland/python-taxes/actions/workflows/tests.yml/badge.svg)](https://github.com/stacynoland/python-taxes/actions/workflows/tests.yml)
+![Coverage](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fstacynoland.com%2Fpython-taxes%2Fcoverage.json&query=%24.totals.percent_covered_display&suffix=%25&label=coverage&color=3fb831)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/python-taxes?logo=python&logoColor=yellow)
+[![PyPI - Version](https://img.shields.io/pypi/v/python-taxes)](https://pypi.org/project/python-taxes/)
+![PyPI - Status](https://img.shields.io/pypi/status/python-taxes)
+[![Black](https://img.shields.io/badge/code%20style-black-000000)](https://github.com/psf/black)
 > Disclaimer: This library is not intended to be used for tax advice. Please consult a tax professional for any tax-related questions or concerns.

{python_taxes-0.5.0 → python_taxes-0.6.0a3}/README.md RENAMED Viewed

@@ -1,109 +1,109 @@
-![Python Taxes Image](https://github.com/user-attachments/assets/6c62946b-e749-46bb-a84e-6321397f1753)
-![PyPI - Python Version](https://img.shields.io/pypi/pyversions/python-taxes?logo=python&logoColor=yellow&label=Python)
-[![GitHub Release](https://img.shields.io/github/v/release/stacynoland/python-taxes?label=Current%20Release)](https://github.com/stacynoland/python-taxes/releases)
-![PyPI - Status](https://img.shields.io/pypi/status/python-taxes?label=Status)
-[![Tests](https://github.com/stacynoland/python-taxes/actions/workflows/test.yml/badge.svg)](https://github.com/stacynoland/python-taxes/actions/workflows/test.yml)
-![Coverage](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Fstacynoland%2Fpython-taxes%2Frefs%2Fheads%2Fmain%2Fcoverage.json&query=%24.totals.percent_covered_display&suffix=%25&label=Coverage&color=3fb831)
-[![Black](https://img.shields.io/badge/Code%20Style-black-000000)](https://github.com/psf/black)
-> Disclaimer: This library is not intended to be used for tax advice. Please consult a tax professional for any tax-related questions or concerns.
-Python-Taxes is a library designed to make calculating US Federal taxes easy.
-The library supports Social Security, Medicare, and Federal Income taxes for tax years 2023 to 2025. Please note, 2025 is only added for future tax season.
-`CURRENT_TAX_YEAR` is set to 2024.
-## Installation
-To install the library, you can use pip or another dependency manager like Poetry.
-`pip install python-taxes`
-or
-`poetry add python-taxes`
-## Usage
-### Social Security Tax
-To calculate Social Security tax, use the `social_security` module:
-```python
-from python_taxes.federal import social_security
-social_security.withholding(5000)  # Returns the amount withheld for Social Security tax
-social_security.withholding(
-                taxable_wages=3000,
-                taxable_wages_ytd=100000,
-                self_employed=False,
-                tax_year=2024,
-                rounded=True,
-            )
-```
----
-### Medicare Tax
-To calculate Medicare tax, use the `medicare` module. There are two functions available:
-`medicare.required_withholding` - Returns the required amount to withhold for Medicare tax regardless of filing status.
-`medicare.additional_withholding` - Returns the amount that should be withheld based on filing status, including Additional Medicare tax.
-```python
-from python_taxes.federal import medicare
-medicare.required_withholding(5000)  # Returns the amount withheld for Medicare tax
-medicare.required_withholding(
-                taxable_wages=5000,
-                taxable_wages_ytd=100000,
-                self_employed=True,
-                rounded=True,
-            )
-medicare.additional_withholding(100000, "married")  # Returns the amount withheld for Medicare Tax and Additional Medicare tax, if applicable, based on filing status.
-medicare.additional_withholding(
-                taxable_wages_ytd=100000,
-                filing_status="married",
-                self_employed=False,
-                rounded=True,
-            )
-```
----
-### Federal Income Tax
-To calculate Federal Income tax, use the `income` package. Currently, the only payroll withholding supported is for automated systems. Specifically, the percentage tables in IRS Publication 15-T section 1 (Percentage Method Tables for Automated Payroll Systems).
-```python
-from python_taxes.federal import income
-income.employer_withholding(10000)  # Returns the amount withheld for Federal Income tax
-income.employer_withholding(
-                taxable_wages=10000,
-                pay_frequency="monthly",
-                filing_status="married",
-                multiple_jobs=False,
-                tax_credits=0,
-                other_income=0,
-                deductions=0,
-                extra_withholding=0,
-                tax_year=2024,
-                rounded=True,
-            )
-income.employer_withholding_pre_2020(10000)  # Returns the amount withheld for Federal Income tax - using this method is required if Form W-4 is from 2019 or earlier.
-income.employer_withholding_pre_2020(
-                taxable_wages=10000,
-                pay_frequency="monthly",
-                marital_status="married",
-                allowances_claimed=0,
-                extra_withholding=0,
-                tax_year=2024,
-                rounded=False,
-            )
-```
+![Python Taxes Image](https://github.com/user-attachments/assets/6c62946b-e749-46bb-a84e-6321397f1753)
+[![Tests](https://github.com/stacynoland/python-taxes/actions/workflows/tests.yml/badge.svg)](https://github.com/stacynoland/python-taxes/actions/workflows/tests.yml)
+![Coverage](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fstacynoland.com%2Fpython-taxes%2Fcoverage.json&query=%24.totals.percent_covered_display&suffix=%25&label=coverage&color=3fb831)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/python-taxes?logo=python&logoColor=yellow)
+[![PyPI - Version](https://img.shields.io/pypi/v/python-taxes)](https://pypi.org/project/python-taxes/)
+![PyPI - Status](https://img.shields.io/pypi/status/python-taxes)
+[![Black](https://img.shields.io/badge/code%20style-black-000000)](https://github.com/psf/black)
+> Disclaimer: This library is not intended to be used for tax advice. Please consult a tax professional for any tax-related questions or concerns.
+Python-Taxes is a library designed to make calculating US Federal taxes easy.
+The library supports Social Security, Medicare, and Federal Income taxes for tax years 2023 to 2025. Please note, 2025 is only added for future tax season.
+`CURRENT_TAX_YEAR` is set to 2024.
+## Installation
+To install the library, you can use pip or another dependency manager like Poetry.
+`pip install python-taxes`
+or
+`poetry add python-taxes`
+## Usage
+### Social Security Tax
+To calculate Social Security tax, use the `social_security` module:
+```python
+from python_taxes.federal import social_security
+social_security.withholding(5000)  # Returns the amount withheld for Social Security tax
+social_security.withholding(
+                taxable_wages=3000,
+                taxable_wages_ytd=100000,
+                self_employed=False,
+                tax_year=2024,
+                rounded=True,
+            )
+```
+---
+### Medicare Tax
+To calculate Medicare tax, use the `medicare` module. There are two functions available:
+`medicare.required_withholding` - Returns the required amount to withhold for Medicare tax regardless of filing status.
+`medicare.additional_withholding` - Returns the amount that should be withheld based on filing status, including Additional Medicare tax.
+```python
+from python_taxes.federal import medicare
+medicare.required_withholding(5000)  # Returns the amount withheld for Medicare tax
+medicare.required_withholding(
+                taxable_wages=5000,
+                taxable_wages_ytd=100000,
+                self_employed=True,
+                rounded=True,
+            )
+medicare.additional_withholding(100000, "married")  # Returns the amount withheld for Medicare Tax and Additional Medicare tax, if applicable, based on filing status.
+medicare.additional_withholding(
+                taxable_wages_ytd=100000,
+                filing_status="married",
+                self_employed=False,
+                rounded=True,
+            )
+```
+---
+### Federal Income Tax
+To calculate Federal Income tax, use the `income` package. Currently, the only payroll withholding supported is for automated systems. Specifically, the percentage tables in IRS Publication 15-T section 1 (Percentage Method Tables for Automated Payroll Systems).
+```python
+from python_taxes.federal import income
+income.employer_withholding(10000)  # Returns the amount withheld for Federal Income tax
+income.employer_withholding(
+                taxable_wages=10000,
+                pay_frequency="monthly",
+                filing_status="married",
+                multiple_jobs=False,
+                tax_credits=0,
+                other_income=0,
+                deductions=0,
+                extra_withholding=0,
+                tax_year=2024,
+                rounded=True,
+            )
+income.employer_withholding_pre_2020(10000)  # Returns the amount withheld for Federal Income tax - using this method is required if Form W-4 is from 2019 or earlier.
+income.employer_withholding_pre_2020(
+                taxable_wages=10000,
+                pay_frequency="monthly",
+                marital_status="married",
+                allowances_claimed=0,
+                extra_withholding=0,
+                tax_year=2024,
+                rounded=False,
+            )
+```

{python_taxes-0.5.0 → python_taxes-0.6.0a3}/pyproject.toml RENAMED Viewed

@@ -1,102 +1,130 @@
-[project]
-name = "python-taxes"
-version = "0.5.0"
-description = "A Python library for calculating US Social Security, Medicare, and Federal Income taxes."
-authors = [
-    {name = "Stacy Noland", email = "46572585+stacynoland@users.noreply.github.com"}
-]
-readme = "README.md"
-license = { file = "LICENSE" }
-requires-python = ">=3.10"
-dependencies = [
-    "pydantic (>=2.11.3,<3.0.0)"
-]
-classifiers = [
-    "Development Status :: 4 - Beta",
-    "Intended Audience :: Developers",
-    "Intended Audience :: Information Technology",
-    "License :: OSI Approved :: MIT License",
-    "Operating System :: OS Independent",
-    "Programming Language :: Python",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-    "Programming Language :: Python :: 3.13",
-    "Typing :: Typed",
-    "Topic :: Software Development :: Libraries",
-    "Topic :: Software Development :: Libraries :: Python Modules",
-]
-[project.urls]
-Homepage = "https://github.com/stacynoland/python-taxes"
-Source = "https://github.com/stacynoland/python-taxes"
-[tool.poetry]
-packages = [{include = "python_taxes", from = "src"}]
-[tool.poetry.group.dev.dependencies]
-pytest = "^8.3.5"
-pytest-cov = "^6.1.1"
-flake8 = "^7.2.0"
-mypy = "^1.15.0"
-tox = "^4.25.0"
-black = "^25.1.0"
-isort = "^6.0.1"
-pre-commit = "^4.2.0"
-[tool.tox]
-requires = ["tox>=4.25.0,<5.0.0"]
-env_list = ["py3", "type", "lint", "format"]
-[dependency-groups]
-pytest = [
-    "pytest>=8.3.0,<9.0.0",
-]
-[tool.tox.env_run_base]
-description = "Run tests under {base_python}"
-package = "wheel"
-dependency_groups = ["pytest"]
-deps = [
-    "pytest-cov>=6.1.0,<7.0.0",
-]
-commands = [["pytest"]]
-[tool.tox.env.type]
-description = "Run type checking on code base"
-package = "wheel"
-dependency_groups = ["pytest"]
-deps = [
-    "mypy>=1.15.0,<2.0.0",
-]
-commands = [["mypy", "."]]
-[tool.tox.env.lint]
-description = "Run linters on code base"
-package = "wheel"
-deps = ["flake8>=7.2.0,<8.0.0"]
-commands = [["flake8", "."]]
-[tool.tox.env.format]
-description = "Run formatters on code base"
-package = "wheel"
-deps = [
-    "black>=25.1.0,<26.0.0",
-    "isort>=6.0.0,<7.0.0",
-]
-commands = [
-    ["black", "."],
-    ["isort", "."],
-]
-[tool.isort]
-profile = "black"
-skip_gitignore = true
-extend_skip = [".pytest_cache",]
-skip_glob = ["*/__pycache__/*", "tests/__pycache__/*"]
-[build-system]
-requires = ["poetry-core>=2.0.0,<3.0.0"]
-build-backend = "poetry.core.masonry.api"
+[project]
+name = "python-taxes"
+version = "0.6.0-alpha.3"
+description = "A Python library for calculating US Social Security, Medicare, and Federal Income taxes."
+authors = [
+    {name = "Stacy Noland", email = "stacy.noland@outlook.com"}
+]
+readme = "README.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.10"
+dependencies = [
+    "pydantic (>=2.11.3,<3.0.0)"
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Information Technology",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+[project.optional-dependencies]
+cli = ["typer (>=0.15.0,<1.0.0)"]
+[project.scripts]
+pytax = "python_taxes.cli:app"
+[project.urls]
+Homepage = "https://github.com/stacynoland/python-taxes"
+Source = "https://github.com/stacynoland/python-taxes"
+[tool.poetry]
+packages = [{include = "python_taxes", from = "src"}]
+[tool.poetry.group.cli]
+optional = true
+[tool.poetry.group.cli.dependencies]
+typer = "^0.15.3"
+[tool.poetry.group.dev]
+optional = true
+[tool.poetry.group.dev.dependencies]
+pytest = "^8.3.5"
+pytest-cov = "^6.1.1"
+black = "^25.1.0"
+flake8 = "^7.2.0"
+isort = "^6.0.1"
+mypy = "^1.15.0"
+tox = "^4.25.0"
+pre-commit = "^4.2.0"
+[tool.tox]
+requires = ["tox>=4.25.0,<5.0.0"]
+env_list = ["lint", "testcov"]
+labels = { tests = ["3.10", "3.11", "3.12", "3.13"] }
+[dependency-groups]
+tests = [
+    "pytest>=8.3.0,<9.0.0",
+    "typer>=0.15.0,<1.0.0",
+]
+static = [
+    "black>=25.1.0,<26.0.0",
+    "isort>=6.0.0,<7.0.0",
+    "flake8>=7.2.0,<8.0.0",
+    "mypy>=1.15.0,<2.0.0",
+]
+[tool.tox.env_run_base]
+description = "Run tests under {base_python}"
+package = "wheel"
+dependency_groups = ["tests"]
+commands = [
+    ["pytest", { replace = "posargs", default = ["tests"], extend = true }],
+]
+[tool.tox.env.testcov]
+description = "Run tests and coverage report"
+package = "wheel"
+dependency_groups = ["tests"]
+deps = [
+    "pytest-cov>=6.1.0,<7.0.0",
+]
+commands = [
+    ["pytest", { replace = "posargs", default = ["--cov", "--cov-report", "term-missing"], extend = true }],
+]
+[tool.tox.env.lint]
+description = "Lint code base"
+package = "wheel"
+dependency_groups = ["static", "tests"]
+commands = [
+    ["black", { replace = "posargs", default = ["."], extend = true }],
+    ["isort", { replace = "posargs", default = ["src", "tests"], extend = true }],
+    ["flake8", { replace = "posargs", default = ["src", "tests"], extend = true }],
+    ["mypy", { replace = "posargs", default = ["src", "tests"], extend = true }],
+]
+[tool.tox.env.check]
+description = "Check code base"
+package = "wheel"
+dependency_groups = ["static", "tests"]
+commands = [
+    ["black", { replace = "posargs", default = ["--check", "."], extend = true }],
+    ["isort", { replace = "posargs", default = ["--check-only", "src", "tests"], extend = true }],
+    ["flake8", { replace = "posargs", default = ["src", "tests"], extend = true }],
+    ["mypy", { replace = "posargs", default = ["src", "tests"], extend = true }],
+]
+[tool.isort]
+profile = "black"
+skip_gitignore = true
+extend_skip = [".pytest_cache",]
+skip_glob = ["*/__pycache__/*", "tests/__pycache__/*"]
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"

{python_taxes-0.5.0 → python_taxes-0.6.0a3}/src/python_taxes/__init__.py RENAMED Viewed

@@ -1,7 +1,7 @@
-from decimal import Decimal
-from pydantic import Field
-CURRENT_TAX_YEAR = 2024
-currency_field = Field(ge=Decimal("0.01"), decimal_places=2)
+from decimal import Decimal
+from pydantic import Field
+CURRENT_TAX_YEAR = 2024
+currency_field = Field(ge=Decimal("0.00"), decimal_places=2)

python_taxes-0.6.0a3/src/python_taxes/__main__.py ADDED Viewed

@@ -0,0 +1,4 @@
+if __name__ == "__main__":
+    from python_taxes.cli import app
+    app()

python-taxes 0.5.0__tar.gz → 0.6.0a3__tar.gz

python-taxes 0.5.0tar.gz → 0.6.0a3tar.gz