nice-path 0.1.0__tar.gz

nice_path-0.1.0/LICENSE

@@ -0,0 +1,16 @@
+MIT No Attribution
+
+Copyright (c) 2026 Tom Koelman
+
+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.
+
+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.

nice_path-0.1.0/PKG-INFO

@@ -0,0 +1,16 @@
+Metadata-Version: 2.4
+Name: nice-path
+Version: 0.1.0
+Summary: Nice formatting of paths
+Author: Tom Koelman
+Author-email: Tom Koelman <tkoelman@xs4all.nl>
+License-Expression: MIT-0
+License-File: LICENSE
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+

nice_path-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[project]
+name = "nice-path"
+version = "0.1.0"
+description = "Nice formatting of paths"
+readme = "README.md"
+authors = [
+    { name = "Tom Koelman", email = "tkoelman@xs4all.nl" }
+]
+requires-python = ">=3.10"
+dependencies = []
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+license = "MIT-0"
+license-files = [ "LICENSE" ]
+
+[build-system]
+requires = ["uv_build>=0.10.7,<0.11.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.2",
+]

nice_path-0.1.0/src/nice_path/__init__.py

@@ -0,0 +1,13 @@
+from pathlib import Path
+
+
+def nice_path(path: Path | str) -> str:
+    """Return a nice path string, relative to ~ if possible."""
+    p = Path(path).expanduser().resolve()
+    home = Path.home()
+    try:
+        rel = p.relative_to(home)
+        rel_str = str(rel)
+        return "~/" + (rel_str if rel_str != "." else "")
+    except ValueError:
+        return str(p)