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.
- kitchen_remodeling_cost-1.0.0/LICENSE +21 -0
- kitchen_remodeling_cost-1.0.0/PKG-INFO +117 -0
- kitchen_remodeling_cost-1.0.0/README.md +95 -0
- kitchen_remodeling_cost-1.0.0/pyproject.toml +33 -0
- kitchen_remodeling_cost-1.0.0/setup.cfg +4 -0
- kitchen_remodeling_cost-1.0.0/src/kitchen_remodeling_cost/__init__.py +13 -0
- kitchen_remodeling_cost-1.0.0/src/kitchen_remodeling_cost/cli.py +46 -0
- kitchen_remodeling_cost-1.0.0/src/kitchen_remodeling_cost/core.py +164 -0
- kitchen_remodeling_cost-1.0.0/src/kitchen_remodeling_cost.egg-info/PKG-INFO +117 -0
- kitchen_remodeling_cost-1.0.0/src/kitchen_remodeling_cost.egg-info/SOURCES.txt +12 -0
- kitchen_remodeling_cost-1.0.0/src/kitchen_remodeling_cost.egg-info/dependency_links.txt +1 -0
- kitchen_remodeling_cost-1.0.0/src/kitchen_remodeling_cost.egg-info/entry_points.txt +2 -0
- kitchen_remodeling_cost-1.0.0/src/kitchen_remodeling_cost.egg-info/top_level.txt +1 -0
- kitchen_remodeling_cost-1.0.0/tests/test_core.py +63 -0
|
@@ -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,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 @@
|
|
|
1
|
+
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
kitchen_remodeling_cost
|
|
@@ -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
|