rclone-api 1.5.17__py3-none-any.whl → 1.5.19__py3-none-any.whl

rclone_api/__init__.py

@@ -24,6 +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 .filesystem import FSPath, RemoteFS  # Filesystem utilities
 from .http_server import HttpFetcher, HttpServer, Range  # HTTP serving capabilities
 
 # Import logging configuration utilities
@@ -119,6 +120,27 @@ class Rclone:
         """
         return self.impl.webgui(other_args=other_args)
 
+    def filesystem(self, src: str) -> RemoteFS:
+        """
+        Get a RealFS object for interacting with the local filesystem.
+
+        Returns:
+            RealFS object for local filesystem operations
+        """
+        return self.impl.filesystem(src=src)
+
+    def cwd(self, src: str) -> FSPath:
+        """
+        Get the local root path for a filesystem.
+
+        Args:
+            src: Source path for the filesystem
+
+        Returns:
+            FSPath object representing the root of the filesystem
+        """
+        return self.impl.cwd(src=src)
+
     def launch_server(
         self,
         addr: str,

rclone_api/filesystem.py

@@ -2,6 +2,8 @@ import abc
 import shutil
 from pathlib import Path
 
+from rclone_api.config import Config
+
 
 class FileSystem(abc.ABC):
     def __init__(self) -> None:
@@ -31,6 +33,10 @@ class FileSystem(abc.ABC):
     def ls(self, path: Path | str) -> list[str]:
         pass
 
+    @abc.abstractmethod
+    def cwd(self) -> "FSPath":
+        pass
+
     @abc.abstractmethod
     def get_path(self, path: str) -> "FSPath":
         pass
@@ -45,12 +51,12 @@ class FileSystem(abc.ABC):
         self.write_binary(path, utf)
 
 
-class RealFileSystem(FileSystem):
+class RealFS(FileSystem):
 
     @staticmethod
-    def get_real_path(path: Path | str) -> "FSPath":
+    def from_path(path: Path | str) -> "FSPath":
         path_str = Path(path).as_posix()
-        return FSPath(RealFileSystem(), path_str)
+        return FSPath(RealFS(), path_str)
 
     def __init__(self) -> None:
         super().__init__()
@@ -58,6 +64,9 @@ class RealFileSystem(FileSystem):
     def ls(self, path: Path | str) -> list[str]:
         return [str(p) for p in Path(path).iterdir()]
 
+    def cwd(self) -> "FSPath":
+        return RealFS.from_path(Path.cwd())
+
     def copy(self, src: Path | str, dest: Path | str) -> None:
         shutil.copy(str(src), str(dest))
 
@@ -79,16 +88,23 @@ class RealFileSystem(FileSystem):
         return FSPath(self, path)
 
 
-class RemoteFileSystem(FileSystem):
-    def __init__(self, rclone_conf: Path, src: str) -> None:
+class RemoteFS(FileSystem):
+    def __init__(self, rclone_conf: Path | Config, src: str) -> None:
         from rclone_api import HttpServer, Rclone
 
         super().__init__()
+        self.src = src
         self.rclone_conf = rclone_conf
         self.rclone: Rclone = Rclone(rclone_conf)
         self.server: HttpServer = self.rclone.serve_http(src=src)
         self.shutdown = False
 
+    def root(self) -> "FSPath":
+        return FSPath(self, self.src)
+
+    def cwd(self) -> "FSPath":
+        return self.root()
+
     def _to_str(self, path: Path | str) -> str:
         if isinstance(path, Path):
             return path.as_posix()
@@ -115,7 +131,7 @@ class RemoteFileSystem(FileSystem):
         return self.server.exists(path)
 
     def mkdir(self, path: str, parents=True, exist_ok=True) -> None:
-        raise NotImplementedError("RemoteFileSystem does not support mkdir")
+        raise NotImplementedError("RemoteFS does not support mkdir")
 
     def is_dir(self, path: Path | str) -> bool:
         path = self._to_str(path)
@@ -176,8 +192,8 @@ class FSPath:
 
     def rmtree(self, ignore_errors=False) -> None:
         assert self.exists(), f"Path does not exist: {self.path}"
-        # check fs is RealFileSystem
-        assert isinstance(self.fs, RealFileSystem)
+        # check fs is RealFS
+        assert isinstance(self.fs, RealFS)
         shutil.rmtree(self.path, ignore_errors=ignore_errors)
 
     def ls(self) -> "list[FSPath]":

rclone_api/rclone_impl.py

@@ -26,6 +26,7 @@ from rclone_api.dir_listing import DirListing
 from rclone_api.exec import RcloneExec
 from rclone_api.file import File
 from rclone_api.file_stream import FilesStream
+from rclone_api.filesystem import FSPath, RemoteFS
 from rclone_api.group_files import group_files
 from rclone_api.http_server import HttpServer
 from rclone_api.mount import Mount
@@ -103,6 +104,12 @@ class RcloneImpl:
             cmd += other_args
         return self._launch_process(cmd, capture=False)
 
+    def filesystem(self, src: str) -> RemoteFS:
+        return RemoteFS(self.config, src)
+
+    def cwd(self, src: str) -> FSPath:
+        return self.filesystem(src).cwd()
+
     def launch_server(
         self,
         addr: str,

{rclone_api-1.5.17.dist-info → rclone_api-1.5.19.dist-info}/METADATA

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

{rclone_api-1.5.17.dist-info → rclone_api-1.5.19.dist-info}/RECORD

@@ -1,4 +1,4 @@
-rclone_api/__init__.py,sha256=tzjjY0b-VfJ8BFYs15S3OApVwd7S1JEYbv0gUz-13aE,32421
+rclone_api/__init__.py,sha256=KIIHPqHIg_wykYC7vyRgnq6QOGlA2RAfrdf4XwXJbZ4,33072
 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/filesystem.py,sha256=QPERBMxrTWNaWMxuHu5QnbRLF5eoSYDODNpjhD8K694,6008
+rclone_api/filesystem.py,sha256=Hq8rwm7ogDW5Sst4xNKHr3WIwQpLa-jt2g9CYZnRLOU,6301
 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
@@ -21,7 +21,7 @@ rclone_api/log.py,sha256=VZHM7pNSXip2ZLBKMP7M1u-rp_F7zoafFDuR8CPUoKI,1271
 rclone_api/mount.py,sha256=LZqEhuKZunbWVqmsOIqkkCotaxWJpdFRS1InXveoU5E,1428
 rclone_api/mount_util.py,sha256=jqhJEVTHV6c6lOOzUYb4FLMbqDMHdz7-QRcdH-IobFc,10154
 rclone_api/process.py,sha256=MeWiN-TrrN0HmtWexBPxGwf84z6f-_E5yaXE-YtLYpY,5879
-rclone_api/rclone_impl.py,sha256=STHQ_hT0chyp2yj3Cp-Vd0xXc1Pdpo3p9J3bTQEm0XE,46531
+rclone_api/rclone_impl.py,sha256=yMb-yS6zXVdcggsDQU1zfvcYzaSUUPW-3I8HbgxZruU,46755
 rclone_api/remote.py,sha256=mTgMTQTwxUmbLjTpr-AGTId2ycXKI9mLX5L7PPpDIoc,520
 rclone_api/rpath.py,sha256=Y1JjQWcie39EgQrq-UtbfDz5yDLCwwfu27W7AQXllSE,2860
 rclone_api/scan_missing_folders.py,sha256=-8NCwpCaHeHrX-IepCoAEsX1rl8S-GOCxcIhTr_w3gA,4747
@@ -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.17.dist-info/licenses/LICENSE,sha256=b6pOoifSXiUaz_lDS84vWlG3fr4yUKwB8fzkrH9R8bQ,1064
-rclone_api-1.5.17.dist-info/METADATA,sha256=BkNxUxGH2-ZTFkBL2vfpCEf03jm8IVizA0uuzDh6gDQ,32696
-rclone_api-1.5.17.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
-rclone_api-1.5.17.dist-info/entry_points.txt,sha256=fJteOlYVwgX3UbNuL9jJ0zUTuX2O79JFAeNgK7Sw7EQ,255
-rclone_api-1.5.17.dist-info/top_level.txt,sha256=EvZ7uuruUpe9RiUyEp25d1Keq7PWYNT0O_-mr8FCG5g,11
-rclone_api-1.5.17.dist-info/RECORD,,
+rclone_api-1.5.19.dist-info/licenses/LICENSE,sha256=b6pOoifSXiUaz_lDS84vWlG3fr4yUKwB8fzkrH9R8bQ,1064
+rclone_api-1.5.19.dist-info/METADATA,sha256=IvGqWqAC_5vXWiQCAJKyXNlHcGQ58dIOd_v27U2H0l8,32696
+rclone_api-1.5.19.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
+rclone_api-1.5.19.dist-info/entry_points.txt,sha256=fJteOlYVwgX3UbNuL9jJ0zUTuX2O79JFAeNgK7Sw7EQ,255
+rclone_api-1.5.19.dist-info/top_level.txt,sha256=EvZ7uuruUpe9RiUyEp25d1Keq7PWYNT0O_-mr8FCG5g,11
+rclone_api-1.5.19.dist-info/RECORD,,