xlfmt 0.1.0__tar.gz

xlfmt-0.1.0/LICENSE

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

xlfmt-0.1.0/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: xlfmt
+Version: 0.1.0
+Summary: Turn an Excel number format and a value into the string Excel shows.
+License-Expression: MIT
+Project-URL: Homepage, https://pypi.org/project/xlfmt/
+Keywords: excel,xlsx,number-format,openpyxl
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# xlfmt
+
+`m` in an Excel format means minutes when it sits next to hours or seconds, and months otherwise. Excel also thinks 1900 was a leap year. `xlfmt` turns a format code and a value into the string Excel shows, including fractions and `[Red]`.
+
+```python
+from openpyxl import load_workbook
+from openpyxl.utils.datetime import CALENDAR_MAC_1904
+from xlfmt import format_value
+
+wb = load_workbook("report.xlsx")
+ws = wb.active
+cell = ws["B2"]
+
+# cell.value         -> 0.4375
+# cell.number_format -> "h:mm AM/PM"
+
+text = format_value(cell.value, cell.number_format, date1904=wb.epoch == CALENDAR_MAC_1904)
+# text -> "10:30 AM"
+```
+
+`text` is a `str`. When the matching section names a color, `text.color` is that color (`"Red"`, `"Color 3"`, …). Excel paints the color; it is not part of the text.
+
+```python
+text = format_value(-1234, '#,##0 ;[Red](#,##0)')
+# text == "(1,234)"
+# text.color == "Red"
+```
+
+Pass `date1904=True` for workbooks that use the 1904 date system. In the 1900 system, serial 60 is February 29, 1900.
+
+## Install
+
+```bash
+pip install xlfmt
+```
+
+## Develop
+
+```bash
+uv sync
+uv run pytest
+```
+
+`uv sync` installs the package plus the dev group (`pytest` and `openpyxl`). openpyxl is not a runtime dependency.

xlfmt-0.1.0/README.md

@@ -0,0 +1,44 @@
+# xlfmt
+
+`m` in an Excel format means minutes when it sits next to hours or seconds, and months otherwise. Excel also thinks 1900 was a leap year. `xlfmt` turns a format code and a value into the string Excel shows, including fractions and `[Red]`.
+
+```python
+from openpyxl import load_workbook
+from openpyxl.utils.datetime import CALENDAR_MAC_1904
+from xlfmt import format_value
+
+wb = load_workbook("report.xlsx")
+ws = wb.active
+cell = ws["B2"]
+
+# cell.value         -> 0.4375
+# cell.number_format -> "h:mm AM/PM"
+
+text = format_value(cell.value, cell.number_format, date1904=wb.epoch == CALENDAR_MAC_1904)
+# text -> "10:30 AM"
+```
+
+`text` is a `str`. When the matching section names a color, `text.color` is that color (`"Red"`, `"Color 3"`, …). Excel paints the color; it is not part of the text.
+
+```python
+text = format_value(-1234, '#,##0 ;[Red](#,##0)')
+# text == "(1,234)"
+# text.color == "Red"
+```
+
+Pass `date1904=True` for workbooks that use the 1904 date system. In the 1900 system, serial 60 is February 29, 1900.
+
+## Install
+
+```bash
+pip install xlfmt
+```
+
+## Develop
+
+```bash
+uv sync
+uv run pytest
+```
+
+`uv sync` installs the package plus the dev group (`pytest` and `openpyxl`). openpyxl is not a runtime dependency.

xlfmt-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "xlfmt"
+version = "0.1.0"
+description = "Turn an Excel number format and a value into the string Excel shows."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["excel", "xlsx", "number-format", "openpyxl"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+dependencies = []
+
+[dependency-groups]
+dev = ["pytest>=7", "openpyxl>=3.0"]
+
+[project.urls]
+Homepage = "https://pypi.org/project/xlfmt/"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

xlfmt-0.1.0/setup.cfg

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

xlfmt-0.1.0/src/xlfmt/__init__.py

@@ -0,0 +1,6 @@
+"""Format Excel values the way Excel displays them."""
+
+from xlfmt.format import Formatted, format_value
+
+__all__ = ["Formatted", "format_value"]
+__version__ = "0.1.0"