pathutilx 0.1.0__tar.gz

pathutilx-0.1.0/PKG-INFO

@@ -0,0 +1,44 @@
+Metadata-Version: 2.4
+Name: pathutilx
+Version: 0.1.0
+Summary: Simple, readable Windows path helpers inspired by pathlib and os.
+Keywords: path,pathlib,windows,filesystem,utility
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Filesystems
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# pathutilx
+
+`pathutilx` is a small Python package that exposes readable Windows path shortcuts and path-building helpers.
+
+## Examples
+
+```python
+from pathutilx import desktop, join
+
+notes = join("notes.txt", base=desktop)
+print(notes)
+```
+```python
+import pathutilx as p
+
+program_files = p.program_files
+appdata_local = p.appdata.local
+desktop = p.desktop
+```
+
+## Available helpers
+
+- `build(*parts, base=None)`
+- `join(*parts, base=None)`
+- `windows_root()`
+- common Windows locations like `desktop`, `downloads`, `documents`, `appdata`, and `temp`

pathutilx-0.1.0/README.md

@@ -0,0 +1,26 @@
+# pathutilx
+
+`pathutilx` is a small Python package that exposes readable Windows path shortcuts and path-building helpers.
+
+## Examples
+
+```python
+from pathutilx import desktop, join
+
+notes = join("notes.txt", base=desktop)
+print(notes)
+```
+```python
+import pathutilx as p
+
+program_files = p.program_files
+appdata_local = p.appdata.local
+desktop = p.desktop
+```
+
+## Available helpers
+
+- `build(*parts, base=None)`
+- `join(*parts, base=None)`
+- `windows_root()`
+- common Windows locations like `desktop`, `downloads`, `documents`, `appdata`, and `temp`

pathutilx-0.1.0/pathutilx/__init__.py

@@ -0,0 +1 @@
+from .main import *

pathutilx-0.1.0/pathutilx/finder/__init__.py

@@ -0,0 +1,3 @@
+from .windows import PathNode, build_path, windows_root
+
+__all__ = ["PathNode", "build_path", "windows_root"]

pathutilx-0.1.0/pathutilx/finder/windows.py

@@ -0,0 +1,150 @@
+from __future__ import annotations
+
+import os
+from pathlib import Path
+from typing import Iterable
+
+
+PathLike = str | os.PathLike[str]
+
+
+def _as_path(value: PathLike | "PathNode") -> Path:
+    if isinstance(value, PathNode):
+        return value.path
+    return Path(value)
+
+
+def _normalize_part(part: PathLike | "PathNode") -> Path:
+    raw = os.fspath(_as_path(part))
+    expanded = os.path.expandvars(os.path.expanduser(raw))
+    return Path(expanded)
+
+
+def build_path(
+    *parts: PathLike | "PathNode",
+    base: PathLike | "PathNode" | None = None,
+) -> Path:
+    if base is None and not parts:
+        raise ValueError("build_path requires at least one path part or a base path")
+
+    path = _normalize_part(base) if base is not None else _normalize_part(parts[0])
+    remaining_parts: Iterable[PathLike | PathNode] = parts if base is not None else parts[1:]
+
+    for part in remaining_parts:
+        path = path / _normalize_part(part)
+
+    return path
+
+
+class PathNode:
+    def __init__(self, path: PathLike, **children: "PathNode") -> None:
+        self._path = _normalize_part(path)
+        for name, child in children.items():
+            setattr(self, name, child)
+
+    @property
+    def path(self) -> Path:
+        return self._path
+
+    @property
+    def name(self) -> str:
+        return self._path.name
+
+    @property
+    def parent(self) -> Path:
+        return self._path.parent
+
+    def build(self, *parts: PathLike | "PathNode") -> Path:
+        return build_path(*parts, base=self)
+
+    def joinpath(self, *parts: PathLike | "PathNode") -> Path:
+        return self.build(*parts)
+
+    def exists(self) -> bool:
+        return self._path.exists()
+
+    def is_dir(self) -> bool:
+        return self._path.is_dir()
+
+    def is_file(self) -> bool:
+        return self._path.is_file()
+
+    def __call__(self, *parts: PathLike | "PathNode") -> Path:
+        return self.build(*parts)
+
+    def __truediv__(self, other: PathLike | "PathNode") -> Path:
+        return self._path / _normalize_part(other)
+
+    def __fspath__(self) -> str:
+        return os.fspath(self._path)
+
+    def __str__(self) -> str:
+        return str(self._path)
+
+    def __repr__(self) -> str:
+        return f"PathNode({self._path!s})"
+
+
+def _env_path(name: str, fallback: PathLike) -> Path:
+    value = os.environ.get(name)
+    if value:
+        return Path(value)
+    return _normalize_part(fallback)
+
+
+def windows_root() -> PathNode:
+    home = _env_path("USERPROFILE", Path.home())
+    appdata_roaming = _env_path("APPDATA", home / "AppData" / "Roaming")
+    appdata_local = _env_path("LOCALAPPDATA", home / "AppData" / "Local")
+    appdata_local_low = appdata_local.parent / "LocalLow"
+    desktop = home / "Desktop"
+    documents = home / "Documents"
+    downloads = home / "Downloads"
+    pictures = home / "Pictures"
+    videos = home / "Videos"
+    music = home / "Music"
+    favorites = home / "Favorites"
+    saved_games = home / "Saved Games"
+    contacts = home / "Contacts"
+    links = home / "Links"
+
+    system_drive = _env_path("SystemDrive", r"C:")
+    windows_dir = _env_path("WINDIR", system_drive / "Windows")
+    system32 = windows_dir / "System32"
+    temp = _env_path("TEMP", appdata_local / "Temp")
+    tmp = _env_path("TMP", temp)
+    program_files = _env_path("ProgramFiles", r"C:\Program Files")
+    program_files_x86 = _env_path("ProgramFiles(x86)", r"C:\Program Files (x86)")
+    program_data = _env_path("ProgramData", r"C:\ProgramData")
+    public = _env_path("PUBLIC", system_drive / "Users" / "Public")
+
+    return PathNode(
+        system_drive,
+        appdata=PathNode(
+            appdata_roaming,
+            roaming=PathNode(appdata_roaming),
+            local=PathNode(appdata_local),
+            local_low=PathNode(appdata_local_low),
+        ),
+        contacts=PathNode(contacts),
+        desktop=PathNode(desktop),
+        documents=PathNode(documents),
+        downloads=PathNode(downloads),
+        favorites=PathNode(favorites),
+        home=PathNode(home),
+        links=PathNode(links),
+        music=PathNode(music),
+        pictures=PathNode(pictures),
+        program_data=PathNode(program_data),
+        program_files=PathNode(program_files),
+        program_files_x86=PathNode(program_files_x86),
+        public=PathNode(public),
+        saved_games=PathNode(saved_games),
+        system32=PathNode(system32),
+        system_drive=PathNode(system_drive),
+        temp=PathNode(temp),
+        tmp=PathNode(tmp),
+        user_profile=PathNode(home),
+        videos=PathNode(videos),
+        windows_dir=PathNode(windows_dir),
+    )

pathutilx-0.1.0/pathutilx/main.py

@@ -0,0 +1,65 @@
+from .finder.windows import PathNode, build_path, windows_root
+
+
+_windows = windows_root()
+
+appdata = _windows.appdata
+contacts = _windows.contacts
+desktop = _windows.desktop
+documents = _windows.documents
+downloads = _windows.downloads
+favorites = _windows.favorites
+home = _windows.home
+links = _windows.links
+music = _windows.music
+pictures = _windows.pictures
+program_files = _windows.program_files
+program_files_x86 = _windows.program_files_x86
+program_data = _windows.program_data
+public = _windows.public
+saved_games = _windows.saved_games
+system32 = _windows.system32
+system_drive = _windows.system_drive
+temp = _windows.temp
+tmp = _windows.tmp
+user_profile = _windows.user_profile
+videos = _windows.videos
+windows_dir = _windows.windows_dir
+
+
+def build(*parts, base=None):
+    return build_path(*parts, base=base)
+
+
+def join(*parts, base=None):
+    return build(*parts, base=base)
+
+
+__all__ = [
+    "PathNode",
+    "appdata",
+    "build",
+    "contacts",
+    "desktop",
+    "documents",
+    "downloads",
+    "favorites",
+    "home",
+    "join",
+    "links",
+    "music",
+    "pictures",
+    "program_data",
+    "program_files",
+    "program_files_x86",
+    "public",
+    "saved_games",
+    "system32",
+    "system_drive",
+    "temp",
+    "tmp",
+    "user_profile",
+    "videos",
+    "windows_dir",
+    "windows_root",
+]

pathutilx-0.1.0/pathutilx.egg-info/PKG-INFO

@@ -0,0 +1,44 @@
+Metadata-Version: 2.4
+Name: pathutilx
+Version: 0.1.0
+Summary: Simple, readable Windows path helpers inspired by pathlib and os.
+Keywords: path,pathlib,windows,filesystem,utility
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Filesystems
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# pathutilx
+
+`pathutilx` is a small Python package that exposes readable Windows path shortcuts and path-building helpers.
+
+## Examples
+
+```python
+from pathutilx import desktop, join
+
+notes = join("notes.txt", base=desktop)
+print(notes)
+```
+```python
+import pathutilx as p
+
+program_files = p.program_files
+appdata_local = p.appdata.local
+desktop = p.desktop
+```
+
+## Available helpers
+
+- `build(*parts, base=None)`
+- `join(*parts, base=None)`
+- `windows_root()`
+- common Windows locations like `desktop`, `downloads`, `documents`, `appdata`, and `temp`

pathutilx-0.1.0/pathutilx.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+pathutilx/__init__.py
+pathutilx/main.py
+pathutilx.egg-info/PKG-INFO
+pathutilx.egg-info/SOURCES.txt
+pathutilx.egg-info/dependency_links.txt
+pathutilx.egg-info/top_level.txt
+pathutilx/finder/__init__.py
+pathutilx/finder/windows.py

pathutilx-0.1.0/pathutilx.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pathutilx-0.1.0/pathutilx.egg-info/top_level.txt

@@ -0,0 +1 @@
+pathutilx

pathutilx-0.1.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pathutilx"
+version = "0.1.0"
+description = "Simple, readable Windows path helpers inspired by pathlib and os."
+readme = "README.md"
+requires-python = ">=3.10"
+keywords = ["path", "pathlib", "windows", "filesystem", "utility"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: System :: Filesystems",
+]
+
+[tool.setuptools]
+include-package-data = false
+
+[tool.setuptools.packages.find]
+include = ["pathutilx*"]

pathutilx-0.1.0/setup.cfg

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