macrs 0.1.0__tar.gz

macrs-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SybilGambleyyu
+
+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.

macrs-0.1.0/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: macrs
+Version: 0.1.0
+Summary: IRS Publication 946 MACRS depreciation schedules with decimal precision and an audit trail
+Author: SybilGambleyyu
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/SybilGambleyyu/macrs
+Project-URL: Documentation, https://github.com/SybilGambleyyu/macrs#readme
+Project-URL: Repository, https://github.com/SybilGambleyyu/macrs
+Project-URL: Issues, https://github.com/SybilGambleyyu/macrs/issues
+Project-URL: IRS Pub 946, https://www.irs.gov/publications/p946
+Keywords: macrs,depreciation,tax,irs,publication-946,fixed-assets,accounting,section-179,bonus-depreciation,schedule
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Office/Business :: Financial :: Accounting
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# macrs
+
+**IRS Publication 946 MACRS depreciation schedules** — decimal-precise, table-driven, with an audit trail.
+
+Tax accountants, bookkeepers, and controllers still rebuild MACRS schedules in spreadsheets every year. Year-1 rates, mid-quarter vs half-year, and the residual last year are easy to get wrong. `macrs` encodes the IRS percentage tables from [Publication 946](https://www.irs.gov/publications/p946) and produces a full recovery schedule you can export, review, and reconcile.
+
+> **Not tax advice.** Recovery period, convention, §179, and bonus depreciation eligibility depend on current law and facts. Always verify against the current IRS Publication 946 and your tax professional before filing.
+
+## Install
+
+```bash
+pip install macrs
+```
+
+Requires Python 3.10+.
+
+## Quick start
+
+```python
+from macrs import AssetInput, build_schedule, schedule_for_class
+
+# $10,000 office furniture, 7-year GDS, half-year (Pub 946 Table A-1)
+sched = build_schedule(
+    AssetInput(cost="10000", recovery_years=7, convention="half_year",
+               placed_in_service_year=2024)
+)
+print(sched.lines[0].depreciation)   # 1429.00  (14.29%)
+print(sched.total_macrs_depreciation)  # 10000.00
+for reason in sched.reasons:
+    print(reason)
+```
+
+Named asset classes for common lookups:
+
+```python
+sched = schedule_for_class("12000", "computers", placed_in_service_year=2025)
+# 5-year GDS half-year → year 1 = 2400.00
+```
+
+## CLI
+
+```bash
+# 7-year property, half-year
+macrs schedule --cost 10000 --years 7 --year 2024 -v
+
+# Computers shortcut with §179 and 60% bonus
+macrs schedule --cost 8000 --class computers \
+  --section-179 1000 --bonus 60 --format json
+
+# Mid-quarter test (>40% of personal property in Q4?)
+macrs mq-test --q1 5000 --q2 3000 --q3 2000 --q4 12000
+
+# List class shortcuts
+macrs classes
+```
+
+## What it covers
+
+| Feature | Detail |
+|---------|--------|
+| GDS personal property | 3, 5, 7, 10, 15, 20-year — Table A-1 half-year |
+| Mid-quarter | Tables A-2…A-5 (Q1–Q4) |
+| Residential rental | 27.5-year mid-month — Table A-6 |
+| Nonresidential real | 39-year mid-month — Table A-7a |
+| §179 | Reduces basis before MACRS |
+| Bonus depreciation | % of remaining basis after §179 |
+| Business-use % | Scales qualified cost |
+| Mid-quarter test | >40% Q4 personal property helper |
+| Audit trail | `reasons` list cites table and steps |
+| Export | text / CSV / JSON |
+
+**Not yet covered** (by design for v0.1): ADS full straight-line tables for every period, short tax years, listed-property luxury auto limits, disposition / like-kind exchange, general asset accounts, and state decoupling. Open an issue if one of these is blocking you.
+
+## Rates source
+
+Percentage rates are taken from **IRS Publication 946 (2025), Appendix A**. The IRS publishes these tables for public use. This package does not modify them; it applies them with `decimal.Decimal` math and absorbs the final-year residual so remaining basis hits `$0.00`.
+
+- Tables: https://www.irs.gov/publications/p946  
+- PDF: https://www.irs.gov/pub/irs-pdf/p946.pdf  
+
+## Example: mid-quarter vs half-year
+
+```python
+from macrs import mid_quarter_required, AssetInput, build_schedule
+
+required, ratio, why = mid_quarter_required([2000, 1500, 1000, 8000])
+print(required, ratio)  # True, ~0.64
+
+# If required, build each personal-property asset with mid_quarter:
+a = AssetInput(cost="8000", recovery_years=5, convention="mid_quarter",
+               placed_in_service_month=11)  # Q4
+print(build_schedule(a).lines[0].depreciation)  # 5% year-1 rate → 400.00
+```
+
+## Demo
+
+Browser calculator: https://sybilgambleyyu.github.io/demo/macrs.html
+
+## License
+
+MIT. IRS tables are public government data; the software encoding is MIT-licensed.
+
+## Related tools
+
+- [cashapply](https://github.com/SybilGambleyyu/cashapply) — cash application / AR matching  
+- [courtdays](https://github.com/SybilGambleyyu/courtdays) — FRCP legal deadlines  
+- [loadcomb](https://github.com/SybilGambleyyu/loadcomb) — ASCE 7 load combinations  

macrs-0.1.0/README.md

@@ -0,0 +1,107 @@
+# macrs
+
+**IRS Publication 946 MACRS depreciation schedules** — decimal-precise, table-driven, with an audit trail.
+
+Tax accountants, bookkeepers, and controllers still rebuild MACRS schedules in spreadsheets every year. Year-1 rates, mid-quarter vs half-year, and the residual last year are easy to get wrong. `macrs` encodes the IRS percentage tables from [Publication 946](https://www.irs.gov/publications/p946) and produces a full recovery schedule you can export, review, and reconcile.
+
+> **Not tax advice.** Recovery period, convention, §179, and bonus depreciation eligibility depend on current law and facts. Always verify against the current IRS Publication 946 and your tax professional before filing.
+
+## Install
+
+```bash
+pip install macrs
+```
+
+Requires Python 3.10+.
+
+## Quick start
+
+```python
+from macrs import AssetInput, build_schedule, schedule_for_class
+
+# $10,000 office furniture, 7-year GDS, half-year (Pub 946 Table A-1)
+sched = build_schedule(
+    AssetInput(cost="10000", recovery_years=7, convention="half_year",
+               placed_in_service_year=2024)
+)
+print(sched.lines[0].depreciation)   # 1429.00  (14.29%)
+print(sched.total_macrs_depreciation)  # 10000.00
+for reason in sched.reasons:
+    print(reason)
+```
+
+Named asset classes for common lookups:
+
+```python
+sched = schedule_for_class("12000", "computers", placed_in_service_year=2025)
+# 5-year GDS half-year → year 1 = 2400.00
+```
+
+## CLI
+
+```bash
+# 7-year property, half-year
+macrs schedule --cost 10000 --years 7 --year 2024 -v
+
+# Computers shortcut with §179 and 60% bonus
+macrs schedule --cost 8000 --class computers \
+  --section-179 1000 --bonus 60 --format json
+
+# Mid-quarter test (>40% of personal property in Q4?)
+macrs mq-test --q1 5000 --q2 3000 --q3 2000 --q4 12000
+
+# List class shortcuts
+macrs classes
+```
+
+## What it covers
+
+| Feature | Detail |
+|---------|--------|
+| GDS personal property | 3, 5, 7, 10, 15, 20-year — Table A-1 half-year |
+| Mid-quarter | Tables A-2…A-5 (Q1–Q4) |
+| Residential rental | 27.5-year mid-month — Table A-6 |
+| Nonresidential real | 39-year mid-month — Table A-7a |
+| §179 | Reduces basis before MACRS |
+| Bonus depreciation | % of remaining basis after §179 |
+| Business-use % | Scales qualified cost |
+| Mid-quarter test | >40% Q4 personal property helper |
+| Audit trail | `reasons` list cites table and steps |
+| Export | text / CSV / JSON |
+
+**Not yet covered** (by design for v0.1): ADS full straight-line tables for every period, short tax years, listed-property luxury auto limits, disposition / like-kind exchange, general asset accounts, and state decoupling. Open an issue if one of these is blocking you.
+
+## Rates source
+
+Percentage rates are taken from **IRS Publication 946 (2025), Appendix A**. The IRS publishes these tables for public use. This package does not modify them; it applies them with `decimal.Decimal` math and absorbs the final-year residual so remaining basis hits `$0.00`.
+
+- Tables: https://www.irs.gov/publications/p946  
+- PDF: https://www.irs.gov/pub/irs-pdf/p946.pdf  
+
+## Example: mid-quarter vs half-year
+
+```python
+from macrs import mid_quarter_required, AssetInput, build_schedule
+
+required, ratio, why = mid_quarter_required([2000, 1500, 1000, 8000])
+print(required, ratio)  # True, ~0.64
+
+# If required, build each personal-property asset with mid_quarter:
+a = AssetInput(cost="8000", recovery_years=5, convention="mid_quarter",
+               placed_in_service_month=11)  # Q4
+print(build_schedule(a).lines[0].depreciation)  # 5% year-1 rate → 400.00
+```
+
+## Demo
+
+Browser calculator: https://sybilgambleyyu.github.io/demo/macrs.html
+
+## License
+
+MIT. IRS tables are public government data; the software encoding is MIT-licensed.
+
+## Related tools
+
+- [cashapply](https://github.com/SybilGambleyyu/cashapply) — cash application / AR matching  
+- [courtdays](https://github.com/SybilGambleyyu/courtdays) — FRCP legal deadlines  
+- [loadcomb](https://github.com/SybilGambleyyu/loadcomb) — ASCE 7 load combinations  

macrs-0.1.0/pyproject.toml

@@ -0,0 +1,59 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "macrs"
+version = "0.1.0"
+description = "IRS Publication 946 MACRS depreciation schedules with decimal precision and an audit trail"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.10"
+authors = [
+    { name = "SybilGambleyyu" },
+]
+keywords = [
+    "macrs",
+    "depreciation",
+    "tax",
+    "irs",
+    "publication-946",
+    "fixed-assets",
+    "accounting",
+    "section-179",
+    "bonus-depreciation",
+    "schedule",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Financial and Insurance Industry",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Office/Business :: Financial :: Accounting",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = []
+
+[project.optional-dependencies]
+dev = ["pytest>=7.0", "build", "twine"]
+
+[project.scripts]
+macrs = "macrs.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/SybilGambleyyu/macrs"
+Documentation = "https://github.com/SybilGambleyyu/macrs#readme"
+Repository = "https://github.com/SybilGambleyyu/macrs"
+Issues = "https://github.com/SybilGambleyyu/macrs/issues"
+"IRS Pub 946" = "https://www.irs.gov/publications/p946"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

macrs-0.1.0/setup.cfg

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

macrs-0.1.0/src/macrs/__init__.py

@@ -0,0 +1,40 @@
+"""macrs — IRS Publication 946 MACRS depreciation schedules.
+
+Deterministic, decimal-precise depreciation schedules for US tax depreciation
+under the Modified Accelerated Cost Recovery System. Rates come from IRS
+Publication 946 Appendix A tables.
+
+Not tax advice. Verify recovery period, convention, section 179, and bonus
+depreciation eligibility against current law and the current Publication 946
+before filing.
+"""
+
+from .models import AssetInput, DepreciationSchedule, ScheduleLine, money
+from .schedule import (
+    asset_from_class,
+    build_schedule,
+    lookup_asset_class,
+    mid_quarter_required,
+    month_to_quarter,
+    schedule_for_class,
+)
+from .tables import ASSET_CLASSES, TABLE_SOURCE, TABLE_URL
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "ASSET_CLASSES",
+    "AssetInput",
+    "DepreciationSchedule",
+    "ScheduleLine",
+    "TABLE_SOURCE",
+    "TABLE_URL",
+    "asset_from_class",
+    "build_schedule",
+    "lookup_asset_class",
+    "mid_quarter_required",
+    "money",
+    "month_to_quarter",
+    "schedule_for_class",
+    "__version__",
+]

macrs-0.1.0/src/macrs/cli.py

@@ -0,0 +1,284 @@
+"""Command-line interface for MACRS depreciation schedules."""
+
+from __future__ import annotations
+
+import argparse
+import csv
+import json
+import sys
+from decimal import Decimal
+from typing import Optional, Sequence, TextIO
+
+from . import __version__
+from .models import AssetInput, money
+from .schedule import (
+    build_schedule,
+    lookup_asset_class,
+    mid_quarter_required,
+    schedule_for_class,
+)
+from .tables import ASSET_CLASSES, GDS_PERSONAL_PERIODS, TABLE_SOURCE, TABLE_URL
+
+
+def _print_schedule(sched, out: Optional[TextIO] = None, *, verbose: bool = False) -> None:
+    if out is None:
+        out = sys.stdout
+    a = sched.asset
+    print(f"# MACRS depreciation schedule", file=out)
+    if a.label:
+        print(f"# Asset: {a.label}", file=out)
+    if a.description:
+        print(f"# Class: {a.description}", file=out)
+    print(f"# Cost: {a.cost}", file=out)
+    print(f"# Recovery: {a.recovery_years}-year  Convention: {sched.convention}", file=out)
+    print(f"# Table: {sched.table_id}", file=out)
+    print(f"# Source: {sched.table_source}", file=out)
+    print(f"# §179: {sched.section_179_deduction}  Bonus: {sched.bonus_deduction}", file=out)
+    print(f"# MACRS basis: {sched.macrs_basis}", file=out)
+    print(f"# Year-1 total (§179+bonus+MACRS): {sched.total_first_year}", file=out)
+    print(file=out)
+    headers = [
+        "year",
+        "calendar",
+        "rate_%",
+        "depreciation",
+        "cumulative",
+        "remaining",
+    ]
+    print("\t".join(headers), file=out)
+    for line in sched.lines:
+        print(
+            "\t".join(
+                [
+                    str(line.recovery_year),
+                    str(line.calendar_year or ""),
+                    str(line.rate_percent),
+                    str(line.depreciation),
+                    str(line.cumulative_depreciation),
+                    str(line.remaining_basis),
+                ]
+            ),
+            file=out,
+        )
+    print(file=out)
+    print(f"# Total MACRS depreciation: {sched.total_macrs_depreciation}", file=out)
+    if sched.warnings:
+        print("# Warnings:", file=out)
+        for w in sched.warnings:
+            print(f"#   - {w}", file=out)
+    if verbose:
+        print("# Audit trail:", file=out)
+        for r in sched.reasons:
+            print(f"#   - {r}", file=out)
+    print(
+        "# Disclaimer: Not tax advice. Verify against current IRS Publication 946.",
+        file=out,
+    )
+
+
+def cmd_schedule(args: argparse.Namespace) -> int:
+    if args.asset_class:
+        sched = schedule_for_class(
+            args.cost,
+            args.asset_class,
+            convention=args.convention,
+            placed_in_service_month=args.month,
+            placed_in_service_year=args.year,
+            section_179=args.section_179,
+            bonus_percent=args.bonus,
+            business_use_percent=args.business_use,
+            label=args.label,
+        )
+    else:
+        asset = AssetInput(
+            cost=money(args.cost),
+            recovery_years=args.years,
+            convention=args.convention,
+            placed_in_service_month=args.month,
+            placed_in_service_year=args.year,
+            quarter=args.quarter,
+            section_179=money(args.section_179),
+            bonus_percent=Decimal(str(args.bonus)),
+            business_use_percent=Decimal(str(args.business_use)),
+            label=args.label,
+        )
+        sched = build_schedule(asset)
+
+    if args.format == "json":
+        payload = {
+            "cost": str(sched.asset.cost),
+            "recovery_years": sched.asset.recovery_years,
+            "convention": sched.convention,
+            "table_id": sched.table_id,
+            "table_source": sched.table_source,
+            "section_179": str(sched.section_179_deduction),
+            "bonus": str(sched.bonus_deduction),
+            "macrs_basis": str(sched.macrs_basis),
+            "total_first_year": str(sched.total_first_year),
+            "total_macrs": str(sched.total_macrs_depreciation),
+            "lines": sched.to_rows(),
+            "reasons": sched.reasons if args.verbose else [],
+            "warnings": sched.warnings,
+            "disclaimer": "Not tax advice. Verify against current IRS Publication 946.",
+        }
+        json.dump(payload, sys.stdout, indent=2)
+        print()
+    elif args.format == "csv":
+        w = csv.DictWriter(
+            sys.stdout,
+            fieldnames=[
+                "recovery_year",
+                "calendar_year",
+                "rate_percent",
+                "depreciation",
+                "cumulative_depreciation",
+                "remaining_basis",
+                "notes",
+            ],
+        )
+        w.writeheader()
+        for row in sched.to_rows():
+            w.writerow(row)
+    else:
+        _print_schedule(sched, verbose=args.verbose)
+    return 0
+
+
+def cmd_classes(_: argparse.Namespace) -> int:
+    print(f"# Common asset classes (from {TABLE_SOURCE})")
+    print("key\tgds_years\tads_years\tkind\tdescription")
+    for key, meta in sorted(ASSET_CLASSES.items()):
+        print(
+            f"{key}\t{meta['gds_years']}\t{meta['ads_years']}\t"
+            f"{meta['kind']}\t{meta['description']}"
+        )
+    return 0
+
+
+def cmd_mq_test(args: argparse.Namespace) -> int:
+    qs = [args.q1, args.q2, args.q3, args.q4]
+    required, ratio, reasons = mid_quarter_required(qs)
+    if args.format == "json":
+        json.dump(
+            {
+                "mid_quarter_required": required,
+                "q4_ratio": str(ratio),
+                "quarters": [str(money(q)) for q in qs],
+                "reasons": reasons,
+            },
+            sys.stdout,
+            indent=2,
+        )
+        print()
+    else:
+        print(f"Mid-quarter required: {required}")
+        print(f"Q4 ratio: {ratio * 100}%")
+        for r in reasons:
+            print(f"  - {r}")
+    return 0
+
+
+def cmd_rates(args: argparse.Namespace) -> int:
+    from .tables import personal_gds_rates
+
+    rates = personal_gds_rates(
+        args.years,
+        convention=args.convention,
+        quarter=args.quarter,
+    )
+    for i, r in enumerate(rates, 1):
+        print(f"{i}\t{r}")
+    return 0
+
+
+def build_parser() -> argparse.ArgumentParser:
+    p = argparse.ArgumentParser(
+        prog="macrs",
+        description=(
+            "MACRS depreciation schedules from IRS Publication 946 percentage tables. "
+            "Not tax advice."
+        ),
+    )
+    p.add_argument("--version", action="version", version=f"macrs {__version__}")
+    sub = p.add_subparsers(dest="command", required=True)
+
+    s = sub.add_parser("schedule", help="Build a depreciation schedule")
+    s.add_argument("--cost", type=str, required=True, help="Asset cost / basis")
+    s.add_argument(
+        "--years",
+        type=int,
+        default=5,
+        help="Recovery period: 3,5,7,10,15,20 (personal); 27 residential; 39 nonresidential",
+    )
+    s.add_argument(
+        "--convention",
+        default="half_year",
+        choices=["half_year", "mid_quarter", "mid_month"],
+        help="Depreciation convention",
+    )
+    s.add_argument("--month", type=int, default=1, help="Month placed in service (1-12)")
+    s.add_argument("--year", type=int, default=None, help="Calendar year placed in service")
+    s.add_argument("--quarter", type=int, default=None, help="Quarter 1-4 (mid_quarter)")
+    s.add_argument("--section-179", type=str, default="0", dest="section_179")
+    s.add_argument("--bonus", type=str, default="0", help="Bonus depreciation percent 0-100")
+    s.add_argument(
+        "--business-use",
+        type=str,
+        default="100",
+        dest="business_use",
+        help="Business-use percent 0-100",
+    )
+    s.add_argument(
+        "--class",
+        dest="asset_class",
+        default=None,
+        help=f"Named asset class: {', '.join(sorted(ASSET_CLASSES))}",
+    )
+    s.add_argument("--label", default=None)
+    s.add_argument(
+        "--format",
+        choices=["text", "json", "csv"],
+        default="text",
+    )
+    s.add_argument("-v", "--verbose", action="store_true", help="Show audit trail")
+    s.set_defaults(func=cmd_schedule)
+
+    c = sub.add_parser("classes", help="List common asset class shortcuts")
+    c.set_defaults(func=cmd_classes)
+
+    m = sub.add_parser(
+        "mq-test",
+        help="Apply the >40%% fourth-quarter mid-quarter convention test",
+    )
+    m.add_argument("--q1", type=str, required=True)
+    m.add_argument("--q2", type=str, required=True)
+    m.add_argument("--q3", type=str, required=True)
+    m.add_argument("--q4", type=str, required=True)
+    m.add_argument("--format", choices=["text", "json"], default="text")
+    m.set_defaults(func=cmd_mq_test)
+
+    r = sub.add_parser("rates", help="Print raw IRS percentage rates for a class/convention")
+    r.add_argument("--years", type=int, required=True, choices=list(GDS_PERSONAL_PERIODS))
+    r.add_argument(
+        "--convention",
+        default="half_year",
+        choices=["half_year", "mid_quarter"],
+    )
+    r.add_argument("--quarter", type=int, default=None)
+    r.set_defaults(func=cmd_rates)
+
+    return p
+
+
+def main(argv: Optional[Sequence[str]] = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    try:
+        return args.func(args)
+    except (ValueError, KeyError) as e:
+        print(f"error: {e}", file=sys.stderr)
+        return 2
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())