kitchen-remodeling-cost 1.0.0__tar.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.
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Bellevue Kitchen Pros
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,117 @@
1
+ Metadata-Version: 2.4
2
+ Name: kitchen-remodeling-cost
3
+ Version: 1.0.0
4
+ Summary: Kitchen remodeling cost planner: split a kitchen remodel budget by line item, add sales tax, a contingency reserve and permits. Cost vs Value presets. Library + CLI, zero dependencies.
5
+ Author: Bellevue Kitchen Pros
6
+ License: MIT
7
+ Project-URL: Homepage, https://wakitchenremodelingbellevue.com/
8
+ Project-URL: Documentation, https://wakitchenremodelingbellevue.com/
9
+ Project-URL: Source, https://github.com/nbkdevs/kitchen-remodeling-bellevue
10
+ Project-URL: Issues, https://github.com/nbkdevs/kitchen-remodeling-bellevue/issues
11
+ Keywords: kitchen remodeling,kitchen remodel cost,remodel budget,renovation,calculator,sales tax,home improvement
12
+ Classifier: Programming Language :: Python :: 3
13
+ Classifier: License :: OSI Approved :: MIT License
14
+ Classifier: Operating System :: OS Independent
15
+ Classifier: Environment :: Console
16
+ Classifier: Intended Audience :: End Users/Desktop
17
+ Classifier: Topic :: Office/Business :: Financial
18
+ Requires-Python: >=3.8
19
+ Description-Content-Type: text/markdown
20
+ License-File: LICENSE
21
+ Dynamic: license-file
22
+
23
+ # kitchen-remodeling-cost: Kitchen Remodeling Cost Planner
24
+
25
+ Plan a kitchen remodel budget that holds. This package splits a budget across 12 line items
26
+ (cabinets, labor, appliances, countertops, flooring, lighting and more), then adds sales tax, a
27
+ contingency reserve and a permit allowance. It works both ways:
28
+
29
+ - **Split**: you know your all-in number. Tax, reserve and permits come out first, the rest is split by line item.
30
+ - **Estimate**: you know the construction cost (or pick a preset). Reserve, tax and permits are added on top.
31
+
32
+ All maths runs in integer cents, so every line adds up exactly to the total. No dependencies, no network.
33
+
34
+ ## Install
35
+
36
+ ```sh
37
+ pip install kitchen-remodeling-cost
38
+ ```
39
+
40
+ ## Library
41
+
42
+ ```python
43
+ from kitchen_remodeling_cost import split_budget, estimate_preset, format_table
44
+
45
+ r = split_budget(60000, permit=1500) # all-in budget
46
+ print(r["lines"][0]) # {'key': 'cabinets', 'label': 'Cabinets and shelving', 'share': 0.25, 'amount': 12053.9}
47
+ print(format_table(r))
48
+
49
+ major = estimate_preset("major-midrange", tax_rate=0.101)
50
+ print(major["total"])
51
+ ```
52
+
53
+ ## Command line
54
+
55
+ ```sh
56
+ kitchen-remodeling-cost split 60000 --permit 1500 # split an all-in budget
57
+ kitchen-remodeling-cost estimate 50000 --tax 10.1 # add reserve, tax and permits to a construction cost
58
+ kitchen-remodeling-cost preset major-upscale # price a Cost vs Value preset
59
+ kitchen-remodeling-cost presets # list presets
60
+ kitchen-remodeling-cost split 80000 --share cabinets=30 # override a line item share
61
+ ```
62
+
63
+ Output of the first command:
64
+
65
+ ```
66
+ Line item Share Amount
67
+ ---------------------------------------------
68
+ Cabinets and shelving 25.0% $12,053.90
69
+ Installation and labor 15.0% $7,232.34
70
+ Appliances 15.0% $7,232.34
71
+ Countertops and backsplash 10.0% $4,821.56
72
+ Flooring 7.0% $3,375.09
73
+ Lighting 5.0% $2,410.78
74
+ Painting and drywall 5.0% $2,410.78
75
+ Designer 5.0% $2,410.78
76
+ Sink and faucet 5.0% $2,410.78
77
+ Doors and windows 4.0% $1,928.63
78
+ Plumbing 3.0% $1,446.47
79
+ Miscellaneous 1.0% $482.16
80
+ ---------------------------------------------
81
+ Construction subtotal $48,215.61
82
+ Contingency reserve (10%) $4,821.56
83
+ Sales tax (10.3%) $5,462.83
84
+ Permit allowance $1,500.00
85
+ ---------------------------------------------
86
+ Total $60,000.00
87
+ ```
88
+
89
+ ## Defaults and sources
90
+
91
+ | Line item | Share |
92
+ |---|---|
93
+ | Cabinets and shelving | 25% |
94
+ | Installation and labor | 15% |
95
+ | Appliances | 15% |
96
+ | Countertops and backsplash | 10% |
97
+ | Flooring | 7% |
98
+ | Lighting, Painting and drywall, Designer, Sink and faucet | 5% each |
99
+ | Doors and windows | 4% |
100
+ | Plumbing | 3% |
101
+ | Miscellaneous | 1% |
102
+
103
+ - Shares: HomeGuide's kitchen remodel cost breakdown. Override any of them; the set is normalised to 100%.
104
+ - Presets: Cost vs Value 2025, Pacific region averages for a 200 sq ft kitchen.
105
+ `minor-midrange` $29,728 (permit allowance $500), `major-midrange` $86,480 ($2,500), `major-upscale` $171,950 ($4,000).
106
+ - Sales tax default: 10.3%, the Bellevue, WA combined rate for October to December 2026 (WA Department of Revenue).
107
+ Washington charges sales tax on the full contract price, labor included. Pass your own rate for other addresses.
108
+ - Contingency reserve default: 10%. Permit allowance is a planning number, not a fee quote.
109
+
110
+ ## Links
111
+
112
+ - Kitchen remodel cost guides and line-item bids: [Kitchen Remodeling Bellevue](https://wakitchenremodelingbellevue.com/)
113
+ - Source and issues: https://github.com/nbkdevs/kitchen-remodeling-bellevue
114
+
115
+ ## License
116
+
117
+ MIT © Bellevue Kitchen Pros
@@ -0,0 +1,95 @@
1
+ # kitchen-remodeling-cost: Kitchen Remodeling Cost Planner
2
+
3
+ Plan a kitchen remodel budget that holds. This package splits a budget across 12 line items
4
+ (cabinets, labor, appliances, countertops, flooring, lighting and more), then adds sales tax, a
5
+ contingency reserve and a permit allowance. It works both ways:
6
+
7
+ - **Split**: you know your all-in number. Tax, reserve and permits come out first, the rest is split by line item.
8
+ - **Estimate**: you know the construction cost (or pick a preset). Reserve, tax and permits are added on top.
9
+
10
+ All maths runs in integer cents, so every line adds up exactly to the total. No dependencies, no network.
11
+
12
+ ## Install
13
+
14
+ ```sh
15
+ pip install kitchen-remodeling-cost
16
+ ```
17
+
18
+ ## Library
19
+
20
+ ```python
21
+ from kitchen_remodeling_cost import split_budget, estimate_preset, format_table
22
+
23
+ r = split_budget(60000, permit=1500) # all-in budget
24
+ print(r["lines"][0]) # {'key': 'cabinets', 'label': 'Cabinets and shelving', 'share': 0.25, 'amount': 12053.9}
25
+ print(format_table(r))
26
+
27
+ major = estimate_preset("major-midrange", tax_rate=0.101)
28
+ print(major["total"])
29
+ ```
30
+
31
+ ## Command line
32
+
33
+ ```sh
34
+ kitchen-remodeling-cost split 60000 --permit 1500 # split an all-in budget
35
+ kitchen-remodeling-cost estimate 50000 --tax 10.1 # add reserve, tax and permits to a construction cost
36
+ kitchen-remodeling-cost preset major-upscale # price a Cost vs Value preset
37
+ kitchen-remodeling-cost presets # list presets
38
+ kitchen-remodeling-cost split 80000 --share cabinets=30 # override a line item share
39
+ ```
40
+
41
+ Output of the first command:
42
+
43
+ ```
44
+ Line item Share Amount
45
+ ---------------------------------------------
46
+ Cabinets and shelving 25.0% $12,053.90
47
+ Installation and labor 15.0% $7,232.34
48
+ Appliances 15.0% $7,232.34
49
+ Countertops and backsplash 10.0% $4,821.56
50
+ Flooring 7.0% $3,375.09
51
+ Lighting 5.0% $2,410.78
52
+ Painting and drywall 5.0% $2,410.78
53
+ Designer 5.0% $2,410.78
54
+ Sink and faucet 5.0% $2,410.78
55
+ Doors and windows 4.0% $1,928.63
56
+ Plumbing 3.0% $1,446.47
57
+ Miscellaneous 1.0% $482.16
58
+ ---------------------------------------------
59
+ Construction subtotal $48,215.61
60
+ Contingency reserve (10%) $4,821.56
61
+ Sales tax (10.3%) $5,462.83
62
+ Permit allowance $1,500.00
63
+ ---------------------------------------------
64
+ Total $60,000.00
65
+ ```
66
+
67
+ ## Defaults and sources
68
+
69
+ | Line item | Share |
70
+ |---|---|
71
+ | Cabinets and shelving | 25% |
72
+ | Installation and labor | 15% |
73
+ | Appliances | 15% |
74
+ | Countertops and backsplash | 10% |
75
+ | Flooring | 7% |
76
+ | Lighting, Painting and drywall, Designer, Sink and faucet | 5% each |
77
+ | Doors and windows | 4% |
78
+ | Plumbing | 3% |
79
+ | Miscellaneous | 1% |
80
+
81
+ - Shares: HomeGuide's kitchen remodel cost breakdown. Override any of them; the set is normalised to 100%.
82
+ - Presets: Cost vs Value 2025, Pacific region averages for a 200 sq ft kitchen.
83
+ `minor-midrange` $29,728 (permit allowance $500), `major-midrange` $86,480 ($2,500), `major-upscale` $171,950 ($4,000).
84
+ - Sales tax default: 10.3%, the Bellevue, WA combined rate for October to December 2026 (WA Department of Revenue).
85
+ Washington charges sales tax on the full contract price, labor included. Pass your own rate for other addresses.
86
+ - Contingency reserve default: 10%. Permit allowance is a planning number, not a fee quote.
87
+
88
+ ## Links
89
+
90
+ - Kitchen remodel cost guides and line-item bids: [Kitchen Remodeling Bellevue](https://wakitchenremodelingbellevue.com/)
91
+ - Source and issues: https://github.com/nbkdevs/kitchen-remodeling-bellevue
92
+
93
+ ## License
94
+
95
+ MIT © Bellevue Kitchen Pros
@@ -0,0 +1,33 @@
1
+ [build-system]
2
+ requires = ["setuptools>=68", "wheel"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "kitchen-remodeling-cost"
7
+ version = "1.0.0"
8
+ description = "Kitchen remodeling cost planner: split a kitchen remodel budget by line item, add sales tax, a contingency reserve and permits. Cost vs Value presets. Library + CLI, zero dependencies."
9
+ readme = "README.md"
10
+ license = { text = "MIT" }
11
+ authors = [{ name = "Bellevue Kitchen Pros" }]
12
+ requires-python = ">=3.8"
13
+ keywords = ["kitchen remodeling", "kitchen remodel cost", "remodel budget", "renovation", "calculator", "sales tax", "home improvement"]
14
+ classifiers = [
15
+ "Programming Language :: Python :: 3",
16
+ "License :: OSI Approved :: MIT License",
17
+ "Operating System :: OS Independent",
18
+ "Environment :: Console",
19
+ "Intended Audience :: End Users/Desktop",
20
+ "Topic :: Office/Business :: Financial",
21
+ ]
22
+
23
+ [project.urls]
24
+ Homepage = "https://wakitchenremodelingbellevue.com/"
25
+ Documentation = "https://wakitchenremodelingbellevue.com/"
26
+ Source = "https://github.com/nbkdevs/kitchen-remodeling-bellevue"
27
+ Issues = "https://github.com/nbkdevs/kitchen-remodeling-bellevue/issues"
28
+
29
+ [project.scripts]
30
+ kitchen-remodeling-cost = "kitchen_remodeling_cost.cli:main"
31
+
32
+ [tool.setuptools.packages.find]
33
+ where = ["src"]
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
@@ -0,0 +1,13 @@
1
+ """Kitchen remodeling cost planner: split a kitchen remodel budget by line item and add
2
+ sales tax, a contingency reserve and a permit allowance.
3
+
4
+ More kitchen remodel planning: https://wakitchenremodelingbellevue.com/
5
+ """
6
+ from .core import (DEFAULT_CONTINGENCY_RATE, DEFAULT_TAX_RATE, LINE_ITEMS, PRESET_SOURCE, PRESETS,
7
+ SHARE_SOURCE, estimate, estimate_preset, format_table, money, normalise_shares,
8
+ split_budget)
9
+
10
+ __version__ = "1.0.0"
11
+ __all__ = ["LINE_ITEMS", "PRESETS", "DEFAULT_TAX_RATE", "DEFAULT_CONTINGENCY_RATE", "PRESET_SOURCE",
12
+ "SHARE_SOURCE", "estimate", "split_budget", "estimate_preset", "normalise_shares",
13
+ "format_table", "money"]
@@ -0,0 +1,46 @@
1
+ """Command line: kitchen-remodeling-cost split 60000 --permit 1500"""
2
+ import argparse
3
+ import json
4
+ import sys
5
+
6
+ from . import core
7
+
8
+
9
+ def main(argv=None) -> int:
10
+ ap = argparse.ArgumentParser(prog="kitchen-remodeling-cost",
11
+ description="Kitchen remodeling budget planner: line items, sales tax, reserve, permits.")
12
+ ap.add_argument("command", choices=["split", "estimate", "preset", "presets"])
13
+ ap.add_argument("value", nargs="?", help="amount in dollars, or preset name")
14
+ ap.add_argument("--tax", type=float, help=f"sales tax percent (default {core.DEFAULT_TAX_RATE * 100:g})")
15
+ ap.add_argument("--contingency", type=float, help=f"reserve percent (default {core.DEFAULT_CONTINGENCY_RATE * 100:g})")
16
+ ap.add_argument("--permit", type=float, help="permit allowance in dollars")
17
+ ap.add_argument("--share", action="append", default=[], metavar="KEY=PERCENT", help="override a line item share")
18
+ ap.add_argument("--json", action="store_true")
19
+ a = ap.parse_args(argv)
20
+ if a.command == "presets":
21
+ for name, p in core.PRESETS.items():
22
+ print(f"{name:<15} {p['label']:<26} {core.money(p['construction'])} permit {core.money(p['permit'])}")
23
+ print(f"Source: {core.PRESET_SOURCE}")
24
+ return 0
25
+ if a.value is None:
26
+ ap.error("value is required")
27
+ kw = dict(tax_rate=None if a.tax is None else a.tax / 100,
28
+ contingency_rate=None if a.contingency is None else a.contingency / 100,
29
+ permit=a.permit,
30
+ shares={k: float(v) for k, v in (s.split("=", 1) for s in a.share)} or None)
31
+ try:
32
+ if a.command == "split":
33
+ r = core.split_budget(float(a.value), **kw)
34
+ elif a.command == "estimate":
35
+ r = core.estimate(float(a.value), **kw)
36
+ else:
37
+ r = core.estimate_preset(a.value, **kw)
38
+ except ValueError as e:
39
+ print(f"error: {e}", file=sys.stderr)
40
+ return 1
41
+ print(json.dumps(r, indent=2) if a.json else core.format_table(r))
42
+ return 0
43
+
44
+
45
+ if __name__ == "__main__":
46
+ sys.exit(main())
@@ -0,0 +1,164 @@
1
+ """Kitchen remodeling cost planner core. All arithmetic in integer cents."""
2
+ from __future__ import annotations
3
+
4
+ import math
5
+ from typing import Dict, List, Mapping, Optional
6
+
7
+ LINE_ITEMS = (
8
+ ("cabinets", "Cabinets and shelving", 0.25),
9
+ ("labor", "Installation and labor", 0.15),
10
+ ("appliances", "Appliances", 0.15),
11
+ ("countertops", "Countertops and backsplash", 0.10),
12
+ ("flooring", "Flooring", 0.07),
13
+ ("lighting", "Lighting", 0.05),
14
+ ("painting", "Painting and drywall", 0.05),
15
+ ("design", "Designer", 0.05),
16
+ ("sink", "Sink and faucet", 0.05),
17
+ ("doors_windows", "Doors and windows", 0.04),
18
+ ("plumbing", "Plumbing", 0.03),
19
+ ("misc", "Miscellaneous", 0.01),
20
+ )
21
+
22
+ PRESETS = {
23
+ "minor-midrange": {"label": "Minor remodel, midrange", "construction": 29728, "permit": 500},
24
+ "major-midrange": {"label": "Major remodel, midrange", "construction": 86480, "permit": 2500},
25
+ "major-upscale": {"label": "Major remodel, upscale", "construction": 171950, "permit": 4000},
26
+ }
27
+
28
+ DEFAULT_TAX_RATE = 0.103
29
+ DEFAULT_CONTINGENCY_RATE = 0.10
30
+ PRESET_SOURCE = "Cost vs Value 2025, Pacific region averages (200 sq ft kitchen)"
31
+ SHARE_SOURCE = "HomeGuide kitchen remodel cost breakdown"
32
+
33
+
34
+ def _round(x: float) -> int:
35
+ return int(math.floor(x + 0.5))
36
+
37
+
38
+ def _num(name: str, v, maximum: Optional[float] = None) -> float:
39
+ if isinstance(v, bool) or not isinstance(v, (int, float)) or not math.isfinite(v) or v < 0:
40
+ raise ValueError(f"{name} must be a finite number >= 0")
41
+ if maximum is not None and v > maximum:
42
+ raise ValueError(f"{name} must be <= {maximum}")
43
+ return float(v)
44
+
45
+
46
+ def normalise_shares(overrides: Optional[Mapping[str, float]] = None) -> List[dict]:
47
+ """Merge share overrides into the defaults and normalise them to sum to 1."""
48
+ items = [{"key": k, "label": l, "share": s} for k, l, s in LINE_ITEMS]
49
+ for k, v in (overrides or {}).items():
50
+ match = [i for i in items if i["key"] == k]
51
+ if not match:
52
+ raise ValueError(f"unknown line item: {k}")
53
+ match[0]["share"] = _num(f"share {k}", v)
54
+ total = 0.0
55
+ for i in items:
56
+ total += i["share"]
57
+ if total <= 0:
58
+ raise ValueError("shares must not all be zero")
59
+ for i in items:
60
+ i["share"] = i["share"] / total
61
+ return items
62
+
63
+
64
+ def _allocate(cents: int, items: List[dict]) -> List[dict]:
65
+ rows = []
66
+ for idx, it in enumerate(items):
67
+ raw = cents * it["share"]
68
+ base = math.floor(raw)
69
+ rows.append({"idx": idx, "key": it["key"], "label": it["label"], "share": it["share"],
70
+ "cents": int(base), "frac": raw - base})
71
+ left = cents - sum(r["cents"] for r in rows)
72
+ order = sorted(rows, key=lambda r: (-r["frac"], r["idx"]))
73
+ i = 0
74
+ while left > 0:
75
+ order[i % len(order)]["cents"] += 1
76
+ i += 1
77
+ left -= 1
78
+ return [{"key": r["key"], "label": r["label"], "share": r["share"], "amount": r["cents"] / 100}
79
+ for r in rows]
80
+
81
+
82
+ def _opts(tax_rate, contingency_rate, permit, shares):
83
+ return (
84
+ _num("tax_rate", DEFAULT_TAX_RATE if tax_rate is None else tax_rate, 1),
85
+ _num("contingency_rate", DEFAULT_CONTINGENCY_RATE if contingency_rate is None else contingency_rate, 1),
86
+ _num("permit", 0 if permit is None else permit),
87
+ normalise_shares(shares),
88
+ )
89
+
90
+
91
+ def _result(mode, c, k, t, p, tax, cont, items) -> Dict:
92
+ return {
93
+ "mode": mode,
94
+ "lines": _allocate(c, items),
95
+ "construction": c / 100,
96
+ "contingency": k / 100,
97
+ "tax": t / 100,
98
+ "permit": p / 100,
99
+ "total": (c + k + t + p) / 100,
100
+ "tax_rate": tax,
101
+ "contingency_rate": cont,
102
+ }
103
+
104
+
105
+ def estimate(construction: float, tax_rate: Optional[float] = None, contingency_rate: Optional[float] = None,
106
+ permit: Optional[float] = None, shares: Optional[Mapping[str, float]] = None) -> Dict:
107
+ """Forward estimate from a construction (pre-tax) cost."""
108
+ tax, cont, perm, items = _opts(tax_rate, contingency_rate, permit, shares)
109
+ c = _round(_num("construction", construction) * 100)
110
+ k = _round(c * cont)
111
+ t = _round((c + k) * tax)
112
+ return _result("estimate", c, k, t, _round(perm * 100), tax, cont, items)
113
+
114
+
115
+ def split_budget(total: float, tax_rate: Optional[float] = None, contingency_rate: Optional[float] = None,
116
+ permit: Optional[float] = None, shares: Optional[Mapping[str, float]] = None) -> Dict:
117
+ """Split an all-in budget (tax, reserve and permits included) into line items."""
118
+ tax, cont, perm, items = _opts(tax_rate, contingency_rate, permit, shares)
119
+ p = _round(perm * 100)
120
+ a = _round(_num("total", total) * 100) - p
121
+ if a <= 0:
122
+ raise ValueError("total must be larger than the permit allowance")
123
+ c = _round(a / ((1 + cont) * (1 + tax)))
124
+ k = _round(c * cont)
125
+ t = _round((c + k) * tax)
126
+ k += a - c - k - t
127
+ return _result("split", c, k, t, p, tax, cont, items)
128
+
129
+
130
+ def estimate_preset(name: str, tax_rate: Optional[float] = None, contingency_rate: Optional[float] = None,
131
+ permit: Optional[float] = None, shares: Optional[Mapping[str, float]] = None) -> Dict:
132
+ """Estimate a Cost vs Value preset; ``permit`` overrides the preset allowance."""
133
+ if name not in PRESETS:
134
+ raise ValueError(f"unknown preset: {name} (use {', '.join(PRESETS)})")
135
+ p = PRESETS[name]
136
+ r = estimate(p["construction"], tax_rate, contingency_rate, p["permit"] if permit is None else permit, shares)
137
+ return {"preset": name, "label": p["label"], **r}
138
+
139
+
140
+ def money(v: float) -> str:
141
+ return f"${v:,.2f}"
142
+
143
+
144
+ def _pct(rate: float) -> str:
145
+ s = f"{rate * 100:.2f}".rstrip("0").rstrip(".")
146
+ return s
147
+
148
+
149
+ def format_table(r: Dict) -> str:
150
+ """Plain-text itemised table."""
151
+ rows = [[l["label"], f"{l['share'] * 100:.1f}%", money(l["amount"])] for l in r["lines"]]
152
+ rows.append(["Construction subtotal", "", money(r["construction"])])
153
+ rows.append([f"Contingency reserve ({_pct(r['contingency_rate'])}%)", "", money(r["contingency"])])
154
+ rows.append([f"Sales tax ({_pct(r['tax_rate'])}%)", "", money(r["tax"])])
155
+ rows.append(["Permit allowance", "", money(r["permit"])])
156
+ rows.append(["Total", "", money(r["total"])])
157
+ head = ["Line item", "Share", "Amount"]
158
+ w = [max(len(head[c]), *(len(x[c]) for x in rows)) for c in range(3)]
159
+ line = lambda x: f"{x[0].ljust(w[0])} {x[1].rjust(w[1])} {x[2].rjust(w[2])}"
160
+ sep = "-" * (sum(w) + 4)
161
+ body = [line(x) for x in rows]
162
+ body.insert(len(r["lines"]), sep)
163
+ body.insert(len(body) - 1, sep)
164
+ return "\n".join([line(head), sep, *body])
@@ -0,0 +1,117 @@
1
+ Metadata-Version: 2.4
2
+ Name: kitchen-remodeling-cost
3
+ Version: 1.0.0
4
+ Summary: Kitchen remodeling cost planner: split a kitchen remodel budget by line item, add sales tax, a contingency reserve and permits. Cost vs Value presets. Library + CLI, zero dependencies.
5
+ Author: Bellevue Kitchen Pros
6
+ License: MIT
7
+ Project-URL: Homepage, https://wakitchenremodelingbellevue.com/
8
+ Project-URL: Documentation, https://wakitchenremodelingbellevue.com/
9
+ Project-URL: Source, https://github.com/nbkdevs/kitchen-remodeling-bellevue
10
+ Project-URL: Issues, https://github.com/nbkdevs/kitchen-remodeling-bellevue/issues
11
+ Keywords: kitchen remodeling,kitchen remodel cost,remodel budget,renovation,calculator,sales tax,home improvement
12
+ Classifier: Programming Language :: Python :: 3
13
+ Classifier: License :: OSI Approved :: MIT License
14
+ Classifier: Operating System :: OS Independent
15
+ Classifier: Environment :: Console
16
+ Classifier: Intended Audience :: End Users/Desktop
17
+ Classifier: Topic :: Office/Business :: Financial
18
+ Requires-Python: >=3.8
19
+ Description-Content-Type: text/markdown
20
+ License-File: LICENSE
21
+ Dynamic: license-file
22
+
23
+ # kitchen-remodeling-cost: Kitchen Remodeling Cost Planner
24
+
25
+ Plan a kitchen remodel budget that holds. This package splits a budget across 12 line items
26
+ (cabinets, labor, appliances, countertops, flooring, lighting and more), then adds sales tax, a
27
+ contingency reserve and a permit allowance. It works both ways:
28
+
29
+ - **Split**: you know your all-in number. Tax, reserve and permits come out first, the rest is split by line item.
30
+ - **Estimate**: you know the construction cost (or pick a preset). Reserve, tax and permits are added on top.
31
+
32
+ All maths runs in integer cents, so every line adds up exactly to the total. No dependencies, no network.
33
+
34
+ ## Install
35
+
36
+ ```sh
37
+ pip install kitchen-remodeling-cost
38
+ ```
39
+
40
+ ## Library
41
+
42
+ ```python
43
+ from kitchen_remodeling_cost import split_budget, estimate_preset, format_table
44
+
45
+ r = split_budget(60000, permit=1500) # all-in budget
46
+ print(r["lines"][0]) # {'key': 'cabinets', 'label': 'Cabinets and shelving', 'share': 0.25, 'amount': 12053.9}
47
+ print(format_table(r))
48
+
49
+ major = estimate_preset("major-midrange", tax_rate=0.101)
50
+ print(major["total"])
51
+ ```
52
+
53
+ ## Command line
54
+
55
+ ```sh
56
+ kitchen-remodeling-cost split 60000 --permit 1500 # split an all-in budget
57
+ kitchen-remodeling-cost estimate 50000 --tax 10.1 # add reserve, tax and permits to a construction cost
58
+ kitchen-remodeling-cost preset major-upscale # price a Cost vs Value preset
59
+ kitchen-remodeling-cost presets # list presets
60
+ kitchen-remodeling-cost split 80000 --share cabinets=30 # override a line item share
61
+ ```
62
+
63
+ Output of the first command:
64
+
65
+ ```
66
+ Line item Share Amount
67
+ ---------------------------------------------
68
+ Cabinets and shelving 25.0% $12,053.90
69
+ Installation and labor 15.0% $7,232.34
70
+ Appliances 15.0% $7,232.34
71
+ Countertops and backsplash 10.0% $4,821.56
72
+ Flooring 7.0% $3,375.09
73
+ Lighting 5.0% $2,410.78
74
+ Painting and drywall 5.0% $2,410.78
75
+ Designer 5.0% $2,410.78
76
+ Sink and faucet 5.0% $2,410.78
77
+ Doors and windows 4.0% $1,928.63
78
+ Plumbing 3.0% $1,446.47
79
+ Miscellaneous 1.0% $482.16
80
+ ---------------------------------------------
81
+ Construction subtotal $48,215.61
82
+ Contingency reserve (10%) $4,821.56
83
+ Sales tax (10.3%) $5,462.83
84
+ Permit allowance $1,500.00
85
+ ---------------------------------------------
86
+ Total $60,000.00
87
+ ```
88
+
89
+ ## Defaults and sources
90
+
91
+ | Line item | Share |
92
+ |---|---|
93
+ | Cabinets and shelving | 25% |
94
+ | Installation and labor | 15% |
95
+ | Appliances | 15% |
96
+ | Countertops and backsplash | 10% |
97
+ | Flooring | 7% |
98
+ | Lighting, Painting and drywall, Designer, Sink and faucet | 5% each |
99
+ | Doors and windows | 4% |
100
+ | Plumbing | 3% |
101
+ | Miscellaneous | 1% |
102
+
103
+ - Shares: HomeGuide's kitchen remodel cost breakdown. Override any of them; the set is normalised to 100%.
104
+ - Presets: Cost vs Value 2025, Pacific region averages for a 200 sq ft kitchen.
105
+ `minor-midrange` $29,728 (permit allowance $500), `major-midrange` $86,480 ($2,500), `major-upscale` $171,950 ($4,000).
106
+ - Sales tax default: 10.3%, the Bellevue, WA combined rate for October to December 2026 (WA Department of Revenue).
107
+ Washington charges sales tax on the full contract price, labor included. Pass your own rate for other addresses.
108
+ - Contingency reserve default: 10%. Permit allowance is a planning number, not a fee quote.
109
+
110
+ ## Links
111
+
112
+ - Kitchen remodel cost guides and line-item bids: [Kitchen Remodeling Bellevue](https://wakitchenremodelingbellevue.com/)
113
+ - Source and issues: https://github.com/nbkdevs/kitchen-remodeling-bellevue
114
+
115
+ ## License
116
+
117
+ MIT © Bellevue Kitchen Pros
@@ -0,0 +1,12 @@
1
+ LICENSE
2
+ README.md
3
+ pyproject.toml
4
+ src/kitchen_remodeling_cost/__init__.py
5
+ src/kitchen_remodeling_cost/cli.py
6
+ src/kitchen_remodeling_cost/core.py
7
+ src/kitchen_remodeling_cost.egg-info/PKG-INFO
8
+ src/kitchen_remodeling_cost.egg-info/SOURCES.txt
9
+ src/kitchen_remodeling_cost.egg-info/dependency_links.txt
10
+ src/kitchen_remodeling_cost.egg-info/entry_points.txt
11
+ src/kitchen_remodeling_cost.egg-info/top_level.txt
12
+ tests/test_core.py
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ kitchen-remodeling-cost = kitchen_remodeling_cost.cli:main
@@ -0,0 +1,63 @@
1
+ import pytest
2
+
3
+ import kitchen_remodeling_cost as k
4
+ from kitchen_remodeling_cost.cli import main
5
+
6
+
7
+ def cents(r):
8
+ return round(sum(l["amount"] * 100 for l in r["lines"]))
9
+
10
+
11
+ def test_estimate():
12
+ r = k.estimate(60000, permit=1500)
13
+ assert (r["construction"], r["contingency"], r["tax"], r["total"]) == (60000, 6000, 6798, 74298)
14
+ assert r["lines"][0]["amount"] == 15000
15
+ assert cents(r) == 6000000
16
+
17
+
18
+ def test_split_reference():
19
+ r = k.split_budget(100000, permit=2500)
20
+ assert (r["construction"], r["contingency"], r["tax"]) == (80359.35, 8035.94, 9104.71)
21
+ assert r["lines"][0]["amount"] == 20089.84
22
+
23
+
24
+ def test_split_exact_total():
25
+ for t in (10000, 33333.33, 60000, 98765.43, 250000):
26
+ r = k.split_budget(t, permit=1000)
27
+ assert round(r["total"] * 100) == round(t * 100)
28
+ assert cents(r) == round(r["construction"] * 100)
29
+
30
+
31
+ def test_rounding_ties():
32
+ r = k.split_budget(33333.33)
33
+ assert (r["construction"], r["contingency"], r["tax"]) == (27473.28, 2747.33, 3112.72)
34
+ assert r["lines"][6]["amount"] == 1373.67
35
+ assert r["lines"][7]["amount"] == 1373.66
36
+
37
+
38
+ def test_presets():
39
+ r = k.estimate_preset("major-midrange")
40
+ assert (r["permit"], r["tax"], r["total"]) == (2500, 9798.18, 107426.18)
41
+ with pytest.raises(ValueError):
42
+ k.estimate_preset("nope")
43
+
44
+
45
+ def test_validation_and_shares():
46
+ with pytest.raises(ValueError):
47
+ k.estimate(-1)
48
+ with pytest.raises(ValueError):
49
+ k.estimate(1, tax_rate=2)
50
+ with pytest.raises(ValueError):
51
+ k.split_budget(100, permit=200)
52
+ with pytest.raises(ValueError):
53
+ k.estimate(1, shares={"garage": 1})
54
+ r = k.estimate(1000, tax_rate=0, contingency_rate=0, shares={"cabinets": 50})
55
+ assert r["lines"][0]["share"] > 0.5 and cents(r) == 100000
56
+
57
+
58
+ def test_table_and_cli(capsys):
59
+ t = k.format_table(k.estimate(60000, permit=1500))
60
+ assert "Cabinets and shelving 25.0% $15,000.00" in t
61
+ assert "$74,298.00" in t
62
+ assert main(["split", "60000", "--permit", "1500"]) == 0
63
+ assert "$60,000.00" in capsys.readouterr().out