Add get_text, get_bytes (#12)

* Add methods get_text and get_bytes

- Remove path resolving in method open

* Update version to 0.2.8

Author: mhxion

CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.8] - 2025-10-16
+
+Release with minor features.
+
+### Added
+
+- Added [`get_text`](https://uhd-urz.github.io/properpath/apis/properpath/#properpath.ProperPath.get_text) and
+  [`get_bytes`](https://uhd-urz.github.io/properpath/apis/properpath/#properpath.ProperPath.get_bytes) methods
+
+### Changed
+
+- Avoid resolving the path in `open` method
+
+## [0.2.7] - 2025-10-09
+
+This release adds Pydantic support and Rich pretty REPL printing support to ProperPath. 2 additional optional
+dependencies have been added: `properpath[pydantic]`,` properpath[rich]`.
+
 ## [0.2.6] - 2025-09-29
 
 Release with minor improvements.

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "properpath"
-version = "0.2.7"
+version = "0.2.8"
 authors = [{ name = "Alexander Haller, Mahadi Xion", email = "[email protected]" }]
 maintainers = [{ name = "Mahadi Xion", email = "[email protected]" }]
 readme = "README.md"

src/properpath/properpath.py

@@ -609,7 +609,7 @@ def open(self, mode="r", encoding=None, *args, **kwargs):
         ProperPath open first resolves the whole path and then simply returns pathlib.Path.open.
         This method is mainly overloaded to log exceptions.
         """
-        file = super().resolve()
+        file = self._expanded
         try:
             return Path(file).open(
                 mode=mode,
@@ -632,5 +632,65 @@ def open(self, mode="r", encoding=None, *args, **kwargs):
             self.PathException = os_exception
             raise e
 
+    # noinspection PyIncorrectDocstring
+    def get_text(
+        self,
+        encoding: Optional[str] = None,
+        errors: Optional[str] = None,
+        newline: Optional[str] = None,
+        default: Optional[str] = None,
+    ) -> Optional[str]:
+        """
+        `get_text` method is basically [`read_text`](https://docs.python.org/3.13/library/pathlib.html#pathlib.Path.read_text)
+        with support for extra `defaults` parameter. `get_text` passes optional arguments `encoding`, `errors`, `newline` to
+        `read_text`.
+
+        Args:
+            encoding: The same meaning as the `encoding` argument for method
+                [`open`](https://docs.python.org/3.13/library/functions.html#open).
+            errors: The same meaning as the `encoding` argument for method
+                [`open`](https://docs.python.org/3.13/library/functions.html#open).
+            newline: The same meaning as the `encoding` argument for method
+                [`open`](https://docs.python.org/3.13/library/functions.html#open).
+                `newline` is only supported in Python 3.13 and above.
+            default:
+                If the file does not exist, then `default` is returned. By default, `default` is `None`.
+
+        Example:
+            ```python
+            import json
+            from properpath import P
+
+            cache = json.loads(P("~/.cache/app/cache.json").get_text(encoding="utf-8", default='{}'))
+            ```
+
+        Returns:
+            The decoded contents of the pointed-to file as a string or default (when file does not exist).
+        """
+        try:
+            if sys.version_info.minor >= 13:
+                return super().read_text(encoding, errors, newline)
+            return super().read_text(encoding, errors)
+        except FileNotFoundError:
+            return default
+
+    # noinspection PyIncorrectDocstring
+    def get_bytes(self, default: Optional[bytes] = None) -> Optional[bytes]:
+        """
+        `get_bytes` method is basically [`read_bytes`](https://docs.python.org/3.13/library/pathlib.html#pathlib.Path.read_bytes)
+        with support for extra `defaults` parameter.
+
+        Args:
+            default:
+                If the file does not exist, then `default` is returned. By default, `default` is `None`.
+
+        Returns:
+            The binary contents of the pointed-to file as a bytes object or default (when file does not exist).
+        """
+        try:
+            return super().read_bytes()
+        except FileNotFoundError:
+            return default
+
 
 P = ProperPath