Merge pull request #19 from d-chris/develop

Update for Python 3.13

Author: d-chris

.github/workflows/pytest.yml

@@ -14,7 +14,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, windows-latest]
-        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
     steps:
       - uses: actions/checkout@v4
       - name: Install poetry

.pre-commit-config.yaml

@@ -1,30 +1,30 @@
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.6.0
+    rev: v5.0.0
     hooks:
       - id: check-yaml
       - id: end-of-file-fixer
         exclude: \.md$
       - id: trailing-whitespace
       - id: check-toml
   - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: 2.2.1
+    rev: 2.4.3
     hooks:
       - id: pyproject-fmt
   - repo: https://github.com/tox-dev/tox-ini-fmt
-    rev: 1.3.1
+    rev: 1.4.1
     hooks:
       - id: tox-ini-fmt
   - repo: https://github.com/rhysd/actionlint
-    rev: v1.7.1
+    rev: v1.7.3
     hooks:
       - id: actionlint
   - repo: https://github.com/psf/black
-    rev: 24.8.0
+    rev: 24.10.0
     hooks:
       - id: black
   - repo: https://github.com/adamchainz/blacken-docs
-    rev: "1.18.0"
+    rev: "1.19.0"
     hooks:
       - id: blacken-docs
         files: pathlibutil/

docs/__main__.py

@@ -65,6 +65,7 @@ def main() -> int:
                 "pathlibutil.urlpath",
                 "pathlib",
                 "urllib.parse",
+                "urllib.request",
                 "shutil",
                 "hashlib",
                 "builtins",
@@ -103,4 +104,4 @@ def main() -> int:
 
 
 if __name__ == "__main__":
-    SystemExit(main())
+    raise SystemExit(main())

pathlibutil/urlpath.py

@@ -1,9 +1,11 @@
+import itertools
 import pathlib
 import re
 import urllib.parse as up
+import urllib.request
 from dataclasses import asdict, dataclass, field
-from functools import wraps
-from typing import Any, Dict, Optional, TypeVar, Union
+from functools import cached_property, wraps
+from typing import Any, Dict, Optional, Tuple, TypeVar, Union
 
 
 @dataclass
@@ -122,10 +124,10 @@ def urlpath(func):
     """
 
     @wraps(func)
-    def wrapper(self, *args, **kwargs):
+    def wrapper(self, *args, **kwargs) -> _UrlPath:
         result = func(self, *args, **kwargs)
 
-        return UrlPath(result.geturl(), **self._kwargs)
+        return self.__class__(result.geturl(), **self._kwargs)
 
     return wrapper
 
@@ -323,6 +325,77 @@ def with_credentials(self, username: str, password: str = None) -> _UrlPath:
 
         return self.with_netloc(netloc)
 
+    @cached_property
+    def parts(self) -> Tuple[str, ...]:
+        """
+        return the parts of the path without any '/'.
+        """
+        return tuple(part for part in self._path.parts if not part.startswith("/"))
+
+    @property
+    def anchor(self) -> str:
+        """
+        The concatenation of the netloc and root of the path.
+
+        >>> UrlPath("//server/root/path/file.txt").anchor
+        '//server/root'
+        """
+        try:
+            root = self.parts[0]
+        except IndexError:
+            root = ""
+
+        return f"//{self.netloc}/{root}"
+
+    def with_anchor(self, anchor: str, root: bool = False, **kwargs) -> _UrlPath:
+        """
+        Change the anchor of the URL.
+
+        If `root` is `True`, the root of the path will not be removed.
+
+        >>> url = UrlPath("//server/root/path/file.txt")
+        >>> url.with_anchor("https://www.server.com").geturl()
+        'https://www.server.com/path/file.txt'
+        """
+        anchor = self.__class__(anchor, **kwargs)
+
+        url = self.with_netloc(anchor.netloc)
+
+        if anchor.scheme != url.scheme:
+            url = url.with_scheme(anchor.scheme)
+
+        if root is False:
+            parts = url.parts[1:]
+        else:
+            parts = url.parts
+
+        # if anchor has a path, anchor and url path are concatenated
+        if any(anchor.parts):
+            return url.with_path("/".join(itertools.chain(anchor.parts, parts)))
+
+        # if root is False, the root of the path is removed
+        if root is False:
+            return url.with_path("/".join(parts))
+
+        return url
+
+    def exists(self, errors: bool = False, **kwargs) -> bool:
+        """
+        Check if the URL returns a 200 status code.
+
+        If `errors` is `False`, exceptions are suppressed and `False` is returned.
+
+        For `kwargs` see `urllib.request.urlopen`.
+        """
+        try:
+            with urllib.request.urlopen(self.normalize(False), **kwargs) as response:
+                return response.status == 200
+        except Exception as e:
+            if errors is not False:
+                raise e
+
+        return False
+
 
 __all__ = [
     "UrlNetloc",