Install & Compatibility
Where this runs
tested against v3.10.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 19MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 1.7s · import 0.000s · 20MB
17MB installed
● package 17MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
true_str
✓ from domdf_python_tools import true_str
✗ from domdf_python_tools import true_str
This quickstart demonstrates key utilities from `domdf-python-tools`, including boolean string conversion, custom delimited lists, and extended `pathlib.Path` functionality.
from domdf_python_tools.utils import true_str
from domdf_python_tools.stringlist import StringList
from domdf_python_tools.paths import PathPlus
import os
# Using a utility function
print(f"Converting 'True' to boolean: {true_str('True')}")
print(f"Converting 'false' to boolean: {true_str('false')}")
# Using StringList for custom delimited output
my_list = StringList([1, 2, 3], delimiter="|")
print(f"Custom delimited list: {my_list}")
# Using PathPlus for extended path operations
current_dir = PathPlus(os.getcwd())
print(f"Current directory path (PathPlus): {current_dir}")
print(f"Is current directory a directory? {current_dir.is_dir()}")
Debug
Known issues
breakingThe license changed from LGPLv3+ to MIT License starting with version 3.0.0. Users upgrading from versions prior to 3.0.0 should be aware of this license change.fixReview the MIT License for compliance if migrating from an LGPLv3+ licensed version.
affects: <3.0.0
gotchaThe PyPI package name is `domdf-python-tools` (with hyphens), but the Python import name uses underscores: `domdf_python_tools`. This is a common pattern but can trip up new users.fixAlways use `import domdf_python_tools` or `from domdf_python_tools import ...` in your Python code after installing with `pip install domdf-python-tools`.
affects: All versions
gotchaSome versions of `domdf-python-tools` (e.g., prior to a fix in Fedora's `3.9.0-7.fc43` package) have exhibited compatibility issues with newer Python versions, specifically Python 3.14, leading to `AssertionError` in tests related to string processing (e.g., `test_words.py::test_alpha_sort`).fixEnsure you are using the latest available version of `domdf-python-tools` and check its release notes for explicit compatibility with the target Python version. If encountering issues with Python 3.14 or newer, consider checking for distribution-specific patches or reporting an upstream issue if using the latest library version.
affects: <3.9.0 (and potentially others with Python 3.14+)
Upgrade
Version history
3.10.0latest on PyPI · released Feb 12, 2025
Audit
Dependencies
pythonrequiredRequires Python 3.6 or newer.