add path.is_path()

Author: AAriam

pkg/pyproject.toml

@@ -15,6 +15,6 @@ namespaces = true
 
 # ----------------------------------------- Project Metadata -------------------------------------
 [project]
-version = "0.2.1"
+version = "0.2.2"
 name = "FileEx"
 requires-python = ">=3.10"

pkg/src/fileex/__init__.py

@@ -1,3 +1,10 @@
 """FileEx"""
 
-from fileex import exception, directory, search
+from fileex import exception, directory, search, path
+
+__all__ = [
+    "exception",
+    "directory",
+    "search",
+    "path",
+]

pkg/src/fileex/path.py

@@ -0,0 +1,25 @@
+from pathlib import Path
+from typing import Any
+
+
+def is_path(path: Any) -> bool:
+    """Check if the input is a path.
+
+    The input is considered a path if it is a `pathlib.Path` object
+    or a string representing a path that exists on the filesystem.
+
+    Parameters
+    ----------
+    path
+        Path to check.
+    """
+    if isinstance(path, Path):
+        return True
+    if not isinstance(path, str):
+        return False
+    path = Path(path).resolve()
+    try:
+        return path.exists()
+    except OSError:
+        # If the path cannot be resolved, it is not a valid path (e.g., too long)
+        return False