rclone-api 1.5.25__py3-none-any.whl → 1.5.28__py3-none-any.whl

rclone_api/__init__.py

@@ -24,7 +24,7 @@ from .dir_listing import DirListing  # Directory contents representation
 from .file import File, FileItem  # File representation
 from .file_stream import FilesStream  # Streaming file listings
 from .filelist import FileList  # File list utilities
-from .fs import FSPath, RemoteFS  # Filesystem utilities
+from .fs import FSPath, RealFS, RemoteFS  # Filesystem utilities
 from .http_server import HttpFetcher, HttpServer, Range  # HTTP serving capabilities
 
 # Import logging configuration utilities
@@ -972,4 +972,8 @@ __all__ = [
     "Range",  # HTTP range
     "HttpFetcher",  # HTTP fetcher
     "PartInfo",  # Part information for uploads
+    "RealFS",  # Real filesystem
+    "RemoteFS",  # Remote filesystem
+    "FSPath",  # File object backed by a real or remote filesystem
+    "FilesStream",
 ]

rclone_api/fs.py

@@ -1,5 +1,6 @@
 import abc
 import shutil
+import warnings
 from pathlib import Path
 
 from rclone_api.config import Config
@@ -41,6 +42,10 @@ class FS(abc.ABC):
     def get_path(self, path: str) -> "FSPath":
         pass
 
+    @abc.abstractmethod
+    def dispose(self) -> None:
+        pass
+
 
 class RealFS(FS):
 
@@ -78,6 +83,9 @@ class RealFS(FS):
     def get_path(self, path: str) -> "FSPath":
         return FSPath(self, path)
 
+    def dispose(self) -> None:
+        pass
+
 
 class RemoteFS(FS):
 
@@ -180,8 +188,15 @@ class RemoteFS(FS):
 
 class FSPath:
     def __init__(self, fs: FS, path: str) -> None:
-        self.fs = fs
-        self.path = path
+        self.fs: FS = fs
+        self.path: str = path
+        self.fs_holder: FS | None = None
+
+    def set_owner(self) -> None:
+        self.fs_holder = self.fs
+
+    def is_real_fs(self) -> bool:
+        return isinstance(self.fs, RealFS)
 
     def read_text(self) -> str:
         data = self.read_bytes()
@@ -204,6 +219,16 @@ class FSPath:
     def __repr__(self) -> str:
         return f"FSPath({self.path})"
 
+    def __enter__(self) -> "FSPath":
+        if self.fs_holder is not None:
+            warnings.warn("This operation is reserved for the cwd returned by FS")
+        return self
+
+    def __exit__(self, exc_type, exc_value, traceback) -> None:
+        if self.fs_holder is not None:
+            self.fs_holder.dispose()
+            self.fs_holder = None
+
     def mkdir(self, parents=True, exist_ok=True) -> None:
         self.fs.mkdir(self.path, parents=parents, exist_ok=exist_ok)
 

{rclone_api-1.5.25.dist-info → rclone_api-1.5.28.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rclone_api
-Version: 1.5.25
+Version: 1.5.28
 Summary: rclone api in python
 Home-page: https://github.com/zackees/rclone-api
 License: BSD 3-Clause License

{rclone_api-1.5.25.dist-info → rclone_api-1.5.28.dist-info}/RECORD

@@ -1,4 +1,4 @@
-rclone_api/__init__.py,sha256=2B3NUnmPmEfV3f6hLKqMxioJIIB4Ry7jxpPjvA1JxLo,33064
+rclone_api/__init__.py,sha256=1bmwlfdExJS7wFFWJyaS8GFhxbBUDfKhCGYD-h_6pgk,33232
 rclone_api/cli.py,sha256=dibfAZIh0kXWsBbfp3onKLjyZXo54mTzDjUdzJlDlWo,231
 rclone_api/completed_process.py,sha256=_IZ8IWK7DM1_tsbDEkH6wPZ-bbcrgf7A7smls854pmg,1775
 rclone_api/config.py,sha256=f6jEAxVorGFr31oHfcsu5AJTtOJj2wR5tTSsbGGZuIw,2558
@@ -13,7 +13,7 @@ rclone_api/file_item.py,sha256=cH-AQYsxedhNPp4c8NHY1ad4Z7St4yf_VGbmiGD59no,1770
 rclone_api/file_part.py,sha256=i6ByS5_sae8Eba-4imBVTxd-xKC8ExWy7NR8QGr0ors,6155
 rclone_api/file_stream.py,sha256=_W3qnwCuigqA0hzXl2q5pAxSZDRaUSwet4BkT0lpnzs,1431
 rclone_api/filelist.py,sha256=xbiusvNgaB_b_kQOZoHMJJxn6TWGtPrWd2J042BI28o,767
-rclone_api/fs.py,sha256=judqhucGuhlsqUCoxa0cELZ-cjVDymlJirrjPzIrJ84,7219
+rclone_api/fs.py,sha256=T08YXyHgxyWbjK09hNAIhchLyWtA1LLU5o1rJe6zvcE,7899
 rclone_api/group_files.py,sha256=H92xPW9lQnbNw5KbtZCl00bD6iRh9yRbCuxku4j_3dg,8036
 rclone_api/http_server.py,sha256=ZdL-rGaq0zIjcaIiRIbPBQ4OIWZ7dCu71aq0nRlKtY4,11686
 rclone_api/install.py,sha256=Xb1BRn8rQcSpSd4dzmvIOELP2zM2DytUeIZ6jzv738A,2893
@@ -54,9 +54,9 @@ rclone_api/s3/multipart/upload_parts_inline.py,sha256=V7syKjFyVIe4U9Ahl5XgqVTzt9
 rclone_api/s3/multipart/upload_parts_resumable.py,sha256=6-nlMclS8jyVvMvFbQDcZOX9MY1WbCcKA_s9bwuYxnk,9793
 rclone_api/s3/multipart/upload_parts_server_side_merge.py,sha256=Fp2pdrs5dONQI9LkfNolgAGj1-Z2V1SsRd0r0sreuXI,18040
 rclone_api/s3/multipart/upload_state.py,sha256=f-Aq2NqtAaMUMhYitlICSNIxCKurWAl2gDEUVizLIqw,6019
-rclone_api-1.5.25.dist-info/licenses/LICENSE,sha256=b6pOoifSXiUaz_lDS84vWlG3fr4yUKwB8fzkrH9R8bQ,1064
-rclone_api-1.5.25.dist-info/METADATA,sha256=VWQEhDMCtvkYAf_Ts_fiVaTKuy-KRD8k7R9zoVpQqww,37155
-rclone_api-1.5.25.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
-rclone_api-1.5.25.dist-info/entry_points.txt,sha256=fJteOlYVwgX3UbNuL9jJ0zUTuX2O79JFAeNgK7Sw7EQ,255
-rclone_api-1.5.25.dist-info/top_level.txt,sha256=EvZ7uuruUpe9RiUyEp25d1Keq7PWYNT0O_-mr8FCG5g,11
-rclone_api-1.5.25.dist-info/RECORD,,
+rclone_api-1.5.28.dist-info/licenses/LICENSE,sha256=b6pOoifSXiUaz_lDS84vWlG3fr4yUKwB8fzkrH9R8bQ,1064
+rclone_api-1.5.28.dist-info/METADATA,sha256=RsDZv4SyyPBilnMykL9Yywt0p9ORIYHoqqUporH1V2c,37155
+rclone_api-1.5.28.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
+rclone_api-1.5.28.dist-info/entry_points.txt,sha256=fJteOlYVwgX3UbNuL9jJ0zUTuX2O79JFAeNgK7Sw7EQ,255
+rclone_api-1.5.28.dist-info/top_level.txt,sha256=EvZ7uuruUpe9RiUyEp25d1Keq7PWYNT0O_-mr8FCG5g,11
+rclone_api-1.5.28.dist-info/RECORD,,