MOD: Change path validation to expand user dir

Author: nmacholl

CHANGELOG.md

@@ -6,6 +6,7 @@ This release adds support for Python 3.14.
 
 #### Enhancements
 - Added support for Python 3.14
+- Functions which accept a path as an argument now expand user directories
 
 ## 0.67.0 - 2025-12-02
 

databento/common/dbnstore.py

@@ -60,6 +60,7 @@
 from databento.common.validation import validate_enum
 from databento.common.validation import validate_file_write_path
 from databento.common.validation import validate_maybe_enum
+from databento.common.validation import validate_path
 
 
 logger = logging.getLogger(__name__)
@@ -138,15 +139,15 @@ class FileDataSource(DataSource):
         The name of the file.
     nbytes : int
         The size of the data in bytes; equal to the file size.
-    path : PathLike[str] or str
+    path : Path
         The path of the file.
     reader : IO[bytes]
         A `BufferedReader` for this file-backed data.
 
     """
 
-    def __init__(self, source: PathLike[str] | str):
-        self._path = Path(source)
+    def __init__(self, source: Path):
+        self._path = source
 
         if not self._path.is_file() or not self._path.exists():
             raise FileNotFoundError(source)
@@ -653,7 +654,7 @@ def from_file(cls, path: PathLike[str] | str) -> DBNStore:
             If an empty file is specified.
 
         """
-        return cls(FileDataSource(path))
+        return cls(FileDataSource(validate_path(path, "path")))
 
     @classmethod
     def from_bytes(cls, data: BytesIO | bytes | IO[bytes]) -> DBNStore:

databento/common/symbology.py

@@ -23,6 +23,7 @@
 from databento_dbn import SymbolMappingMsgV1
 
 from databento.common.parsing import datetime_to_unix_nanoseconds
+from databento.common.validation import validate_path
 
 
 class MappingInterval(NamedTuple):
@@ -49,15 +50,15 @@ def _validate_path_pair(
     in_file: PathLike[str] | str,
     out_file: PathLike[str] | str | None,
 ) -> tuple[Path, Path]:
-    in_file_valid = Path(in_file)
+    in_file_valid = validate_path(in_file, "in_file")
 
     if not in_file_valid.exists():
         raise ValueError(f"{in_file_valid} does not exist")
     if not in_file_valid.is_file():
         raise ValueError(f"{in_file_valid} is not a file")
 
     if out_file is not None:
-        out_file_valid = Path(out_file)
+        out_file_valid = validate_path(out_file, "out_file")
     else:
         out_file_valid = in_file_valid.with_name(
             f"{in_file_valid.stem}_mapped{in_file_valid.suffix}",

databento/common/types.py

@@ -1,6 +1,5 @@
 import datetime as dt
 import logging
-import pathlib
 import warnings
 from collections.abc import Callable
 from os import PathLike
@@ -13,6 +12,7 @@
 import pandas as pd
 
 from databento.common.error import BentoWarning
+from databento.common.validation import validate_file_write_path
 
 
 logger = logging.getLogger(__name__)
@@ -110,7 +110,7 @@ def __init__(
         is_managed = False
 
         if isinstance(stream, (str, PathLike)):
-            stream = pathlib.Path(stream).open("xb")
+            stream = validate_file_write_path(stream, "stream", False).open("xb")
             is_managed = True
 
         if not hasattr(stream, "write"):

databento/common/validation.py

@@ -20,7 +20,8 @@
 
 def validate_path(value: PathLike[str] | str, param: str) -> Path:
     """
-    Validate whether the given value is a valid path.
+    Validate whether the given value is a valid path. This also expands user
+    directories to form valid paths.
 
     Parameters
     ----------
@@ -38,10 +39,12 @@ def validate_path(value: PathLike[str] | str, param: str) -> Path:
     ------
     TypeError
         If value is not a valid path.
+    RuntimeError
+        If a user's home directory cannot be expanded.
 
     """
     try:
-        return Path(value)
+        return Path(value).expanduser()
     except TypeError:
         raise TypeError(
             f"The `{param}` was not a valid path type. " "Use any of [PathLike[str], str].",
@@ -72,6 +75,10 @@ def validate_file_write_path(
 
     Raises
     ------
+    TypeError
+        If value is not a valid path.
+    RuntimeError
+        If a user's home directory cannot be expanded.
     IsADirectoryError
         If path is a directory.
     FileExistsError