htd 0.0.1__tar.gz

htd-0.0.1/LICENSE

@@ -0,0 +1,18 @@
+Copyright © 2025 – Bixoto.com
+
+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.

htd-0.0.1/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.3
+Name: htd
+Version: 0.0.1
+Summary: Parse time deltas from human-readable strings
+Author: Baptiste Fontaine
+Author-email: baptiste@bixoto.com
+Requires-Python: >=3.9
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Description-Content-Type: text/markdown
+
+# htd
+
+**htd** stands for **h**uman **t**ime **d**elta and is a micro-library to parse strings such as `7d4h`
+into `timedelta(days=7, hours=4)`.
+
+## Install
+
+    pip install htd
+
+With Poetry:
+
+    poetry add htd
+
+## Usage
+
+```python
+import htd
+
+htd.parse("7d")
+# => datetime.timedelta(days=7)
+```
+

htd-0.0.1/README.md

@@ -0,0 +1,21 @@
+# htd
+
+**htd** stands for **h**uman **t**ime **d**elta and is a micro-library to parse strings such as `7d4h`
+into `timedelta(days=7, hours=4)`.
+
+## Install
+
+    pip install htd
+
+With Poetry:
+
+    poetry add htd
+
+## Usage
+
+```python
+import htd
+
+htd.parse("7d")
+# => datetime.timedelta(days=7)
+```

htd-0.0.1/htd/__init__.py

@@ -0,0 +1,27 @@
+import re
+from datetime import timedelta
+
+__all__ = ['parse', '__version__']
+__version__ = '0.0.1'
+
+SYMBOLS = {
+    "s": 1,
+    "m": 60,
+    "h": 60 * 60,
+    "d": 60 * 60 * 24,
+    "w": 60 * 60 * 24 * 7,
+}
+
+RE = re.compile(rf"(\d+(?:\.\d+)?[{''.join(SYMBOLS)}])")
+
+
+def parse(s: str):
+    """
+    Parse a string such as `"2d4h10s"` and return a `datetime.timedelta` object.
+    """
+    total_seconds = 0.0
+    for fragment in RE.findall(s):
+        unit = fragment[-1]
+        total_seconds += float(fragment[:-1]) * SYMBOLS[unit]
+
+    return timedelta(seconds=total_seconds)

htd-0.0.1/pyproject.toml

@@ -0,0 +1,21 @@
+[project]
+name = "htd"
+version = "0.0.1"
+description = "Parse time deltas from human-readable strings"
+authors = [
+    {name = "Baptiste Fontaine",email = "baptiste@bixoto.com"}
+]
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = []
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.poetry.group.dev.dependencies]
+mypy = "^1"
+pytest = "^8"
+ruff = "^0.9"
+pytest-cov = "^6.0"
+