rclone-api 1.5.2__py2.py3-none-any.whl → 1.5.4__py2.py3-none-any.whl

rclone_api/__init__.py

@@ -74,6 +74,23 @@ class Rclone:
     implementation details and providing a clean, consistent interface.
     """
 
+    @staticmethod
+    def upgrade_rclone() -> Path:
+        """
+        Upgrade the rclone executable to the latest version.
+
+        Downloads the latest rclone binary and replaces the current one.
+
+        If an external rclone is already in your path then although upgrade_rclone
+        will download the latest version, it will not affect the rclone selected.
+
+        Returns:
+            Path to the upgraded rclone executable
+        """
+        from rclone_api.util import upgrade_rclone
+
+        return upgrade_rclone()
+
     def __init__(
         self, rclone_conf: Path | Config, rclone_exe: Path | None = None
     ) -> None:
@@ -173,7 +190,7 @@ class Rclone:
 
     def ls_stream(
         self,
-        path: str,
+        src: str,
         max_depth: int = -1,
         fast_list: bool = False,
     ) -> FilesStream:
@@ -184,14 +201,14 @@ class Rclone:
         results incrementally rather than collecting them all at once.
 
         Args:
-            path: Remote path to list
+            src: Remote path to list
             max_depth: Maximum recursion depth (-1 for unlimited)
             fast_list: Use fast list (only recommended for listing entire repositories or small datasets)
 
         Returns:
             A stream of file entries that can be iterated over
         """
-        return self.impl.ls_stream(path=path, max_depth=max_depth, fast_list=fast_list)
+        return self.impl.ls_stream(src=src, max_depth=max_depth, fast_list=fast_list)
 
     def save_to_db(
         self,
@@ -218,7 +235,7 @@ class Rclone:
 
     def ls(
         self,
-        path: Dir | Remote | str | None = None,
+        src: Dir | Remote | str | None = None,
         max_depth: int | None = None,
         glob: str | None = None,
         order: Order = Order.NORMAL,
@@ -230,7 +247,7 @@ class Rclone:
         Provides a detailed listing with file metadata.
 
         Args:
-            path: Path to list (Dir, Remote, or string path)
+            src: Path to list (Dir, Remote, or string path)
             max_depth: Maximum recursion depth (None for default)
             glob: Optional glob pattern to filter results
             order: Sorting order for the results
@@ -240,7 +257,7 @@ class Rclone:
             DirListing object containing the results
         """
         return self.impl.ls(
-            path=path,
+            src=src,
             max_depth=max_depth,
             glob=glob,
             order=order,
@@ -308,7 +325,7 @@ class Rclone:
 
     def walk(
         self,
-        path: Dir | Remote | str,
+        src: Dir | Remote | str,
         max_depth: int = -1,
         breadth_first: bool = True,
         order: Order = Order.NORMAL,
@@ -320,7 +337,7 @@ class Rclone:
         and yields their contents.
 
         Args:
-            path: Remote path, Dir, or Remote object to walk through
+            src: Remote path, Dir, or Remote object to walk through
             max_depth: Maximum depth to traverse (-1 for unlimited)
             breadth_first: If True, use breadth-first traversal, otherwise depth-first
             order: Sorting order for directory entries
@@ -329,7 +346,7 @@ class Rclone:
             DirListing: Directory listing for each directory encountered
         """
         return self.impl.walk(
-            path=path, max_depth=max_depth, breadth_first=breadth_first, order=order
+            src=src, max_depth=max_depth, breadth_first=breadth_first, order=order
         )
 
     def scan_missing_folders(
@@ -359,7 +376,7 @@ class Rclone:
         )
 
     def cleanup(
-        self, path: str, other_args: list[str] | None = None
+        self, src: str, other_args: list[str] | None = None
     ) -> CompletedProcess:
         """
         Cleanup any resources used by the Rclone instance.
@@ -367,13 +384,13 @@ class Rclone:
         Removes temporary files and directories created by rclone.
 
         Args:
-            path: Path to clean up
+            src: Path to clean up
             other_args: Additional command-line arguments
 
         Returns:
             CompletedProcess with the result of the cleanup operation
         """
-        return self.impl.cleanup(path=path, other_args=other_args)
+        return self.impl.cleanup(src=src, other_args=other_args)
 
     def copy_to(
         self,
@@ -510,19 +527,19 @@ class Rclone:
             other_args=other_args,
         )
 
-    def purge(self, path: Dir | str) -> CompletedProcess:
+    def purge(self, src: Dir | str) -> CompletedProcess:
         """
         Purge a directory.
 
         Removes a directory and all its contents.
 
         Args:
-            path: Rclone style path
+            src: Rclone style path
 
         Returns:
             CompletedProcess with the result of the purge operation
         """
-        return self.impl.purge(path=path)
+        return self.impl.purge(src=src)
 
     def delete_files(
         self,
@@ -556,17 +573,17 @@ class Rclone:
             other_args=other_args,
         )
 
-    def exists(self, path: Dir | Remote | str | File) -> bool:
+    def exists(self, src: Dir | Remote | str | File) -> bool:
         """
         Check if a file or directory exists.
 
         Args:
-            path: Path to check (Dir, Remote, File, or path string)
+            src: Path to check (Dir, Remote, File, or path string)
 
         Returns:
             True if the path exists, False otherwise
         """
-        return self.impl.exists(path=path)
+        return self.impl.exists(src=src)
 
     def is_synced(self, src: str | Dir, dst: str | Dir) -> bool:
         """

rclone_api/rclone_impl.py

@@ -148,7 +148,7 @@ class RcloneImpl:
 
     def ls_stream(
         self,
-        path: str,
+        src: str,
         max_depth: int = -1,
         fast_list: bool = False,
     ) -> FilesStream:
@@ -160,7 +160,7 @@ class RcloneImpl:
             max_depth: Maximum recursion depth (-1 for unlimited)
             fast_list: Use fast list (only use when getting THE entire data repository from the root/bucket, or it's small)
         """
-        cmd = ["lsjson", path, "--files-only"]
+        cmd = ["lsjson", src, "--files-only"]
         recurse = max_depth < 0 or max_depth > 1
         if recurse:
             cmd.append("-R")
@@ -168,7 +168,7 @@ class RcloneImpl:
                 cmd += ["--max-depth", str(max_depth)]
         if fast_list:
             cmd.append("--fast-list")
-        streamer = FilesStream(path, self._launch_process(cmd, capture=True))
+        streamer = FilesStream(src, self._launch_process(cmd, capture=True))
         return streamer
 
     def save_to_db(
@@ -197,7 +197,7 @@ class RcloneImpl:
 
     def ls(
         self,
-        path: Dir | Remote | str | None = None,
+        src: Dir | Remote | str | None = None,
         max_depth: int | None = None,
         glob: str | None = None,
         order: Order = Order.NORMAL,
@@ -206,14 +206,14 @@ class RcloneImpl:
         """List files in the given path.
 
         Args:
-            path: Remote path or Remote object to list
+            src: Remote path or Remote object to list
             max_depth: Maximum recursion depth (0 means no recursion)
 
         Returns:
             List of File objects found at the path
         """
 
-        if path is None:
+        if src is None:
             # list remotes instead
             list_remotes: list[Remote] = self.listremotes()
             dirs: list[Dir] = [Dir(remote) for remote in list_remotes]
@@ -222,9 +222,9 @@ class RcloneImpl:
             rpaths = [d.path for d in dirs]
             return DirListing(rpaths)
 
-        if isinstance(path, str):
-            path = Dir(
-                to_path(path, self)
+        if isinstance(src, str):
+            src = Dir(
+                to_path(src, self)
             )  # assume it's a directory if ls is being called.
 
         cmd = ["lsjson"]
@@ -237,15 +237,15 @@ class RcloneImpl:
         if listing_option != ListingOption.ALL:
             cmd.append(f"--{listing_option.value}")
 
-        cmd.append(str(path))
-        remote = path.remote if isinstance(path, Dir) else path
+        cmd.append(str(src))
+        remote = src.remote if isinstance(src, Dir) else src
         assert isinstance(remote, Remote)
 
         cp = self._run(cmd, check=True)
         text = cp.stdout
         parent_path: str | None = None
-        if isinstance(path, Dir):
-            parent_path = path.path.path
+        if isinstance(src, Dir):
+            parent_path = src.path.path
         paths: list[RPath] = RPath.from_json_str(text, remote, parent_path=parent_path)
         # print(parent_path)
         for o in paths:
@@ -261,10 +261,10 @@ class RcloneImpl:
             random.shuffle(paths)
         return DirListing(paths)
 
-    def print(self, path: str) -> Exception | None:
+    def print(self, src: str) -> Exception | None:
         """Print the contents of a file."""
         try:
-            text_or_err = self.read_text(path)
+            text_or_err = self.read_text(src)
             if isinstance(text_or_err, Exception):
                 return text_or_err
             print(text_or_err)
@@ -372,7 +372,7 @@ class RcloneImpl:
 
     def walk(
         self,
-        path: Dir | Remote | str,
+        src: Dir | Remote | str,
         max_depth: int = -1,
         breadth_first: bool = True,
         order: Order = Order.NORMAL,
@@ -380,20 +380,20 @@ class RcloneImpl:
         """Walk through the given path recursively.
 
         Args:
-            path: Remote path or Remote object to walk through
+            src: Remote path or Remote object to walk through
             max_depth: Maximum depth to traverse (-1 for unlimited)
 
         Yields:
             DirListing: Directory listing for each directory encountered
         """
         dir_obj: Dir
-        if isinstance(path, Dir):
+        if isinstance(src, Dir):
             # Create a Remote object for the path
-            remote = path.remote
+            remote = src.remote
             rpath = RPath(
                 remote=remote,
-                path=path.path.path,
-                name=path.path.name,
+                path=src.path.path,
+                name=src.path.name,
                 size=0,
                 mime_type="inode/directory",
                 mod_time="",
@@ -401,13 +401,13 @@ class RcloneImpl:
             )
             rpath.set_rclone(self)
             dir_obj = Dir(rpath)
-        elif isinstance(path, str):
-            dir_obj = Dir(to_path(path, self))
-        elif isinstance(path, Remote):
-            dir_obj = Dir(path)
+        elif isinstance(src, str):
+            dir_obj = Dir(to_path(src, self))
+        elif isinstance(src, Remote):
+            dir_obj = Dir(src)
         else:
-            dir_obj = Dir(path)  # shut up pyright
-            assert f"Invalid type for path: {type(path)}"
+            dir_obj = Dir(src)  # shut up pyright
+            assert f"Invalid type for path: {type(src)}"
 
         yield from walk(
             dir_obj, max_depth=max_depth, breadth_first=breadth_first, order=order
@@ -441,11 +441,11 @@ class RcloneImpl:
         )
 
     def cleanup(
-        self, path: str, other_args: list[str] | None = None
+        self, src: str, other_args: list[str] | None = None
     ) -> CompletedProcess:
         """Cleanup any resources used by the Rclone instance."""
         # rclone cleanup remote:path [flags]
-        cmd = ["cleanup", path]
+        cmd = ["cleanup", src]
         if other_args:
             cmd += other_args
         out = self._run(cmd)
@@ -670,11 +670,11 @@ class RcloneImpl:
         cp = self._run(cmd_list, check=check, capture=False)
         return CompletedProcess.from_subprocess(cp)
 
-    def purge(self, path: Dir | str) -> CompletedProcess:
+    def purge(self, src: Dir | str) -> CompletedProcess:
         """Purge a directory"""
         # path should always be a string
-        path = path if isinstance(path, str) else str(path.path)
-        cmd_list: list[str] = ["purge", str(path)]
+        src = src if isinstance(src, str) else str(src.path)
+        cmd_list: list[str] = ["purge", str(src)]
         cp = self._run(cmd_list)
         return CompletedProcess.from_subprocess(cp)
 
@@ -761,9 +761,9 @@ class RcloneImpl:
         out = self.delete_files(files)
         return out
 
-    def exists(self, path: Dir | Remote | str | File) -> bool:
+    def exists(self, src: Dir | Remote | str | File) -> bool:
         """Check if a file or directory exists."""
-        arg: str = convert_to_str(path)
+        arg: str = convert_to_str(src)
         assert isinstance(arg, str)
         try:
             dir_listing = self.ls(arg)

rclone_api/util.py

@@ -166,7 +166,11 @@ def get_rclone_exe(rclone_exe: Path | None) -> Path:
         return _RCLONE_EXE
     return rclone_exe
 
-def 
+
+def upgrade_rclone() -> Path:
+    rclone_download(out=_RCLONE_EXE, replace=True)
+    return _RCLONE_EXE
+
 
 def rclone_execute(
     cmd: list[str],

{rclone_api-1.5.2.dist-info → rclone_api-1.5.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: rclone_api
-Version: 1.5.2
+Version: 1.5.4
 Summary: rclone api in python
 Home-page: https://github.com/zackees/rclone-api
 License: BSD 3-Clause License
@@ -99,22 +99,41 @@ def test_ls_glob_png(self) -> None:
 ## API
 
 ```python
+
 class Rclone:
     """
     Main interface for interacting with Rclone.
-    
+
     This class provides methods for all major Rclone operations including
     file transfers, listing, mounting, and remote management.
-    
+
     It serves as the primary entry point for the API, wrapping the underlying
     implementation details and providing a clean, consistent interface.
     """
+
+    @staticmethod
+    def upgrade_rclone() -> Path:
+        """
+        Upgrade the rclone executable to the latest version.
+
+        Downloads the latest rclone binary and replaces the current one.
+
+        If an external rclone is already in your path then although upgrade_rclone
+        will download the latest version, it will not affect the rclone selected.
+
+        Returns:
+            Path to the upgraded rclone executable
+        """
+        from rclone_api.util import upgrade_rclone
+
+        return upgrade_rclone()
+
     def __init__(
         self, rclone_conf: Path | Config, rclone_exe: Path | None = None
     ) -> None:
         """
         Initialize the Rclone interface.
-        
+
         Args:
             rclone_conf: Path to rclone config file or Config object
             rclone_exe: Optional path to rclone executable. If None, will search in PATH.
@@ -126,12 +145,12 @@ class Rclone:
     def webgui(self, other_args: list[str] | None = None) -> Process:
         """
         Launch the Rclone web GUI.
-        
+
         Starts the built-in web interface for interacting with rclone.
-        
+
         Args:
             other_args: Additional command-line arguments to pass to rclone
-            
+
         Returns:
             Process object representing the running web GUI
         """
@@ -146,15 +165,15 @@ class Rclone:
     ) -> Process:
         """
         Launch the Rclone server so it can receive commands.
-        
+
         Starts an rclone server that can be controlled remotely.
-        
+
         Args:
             addr: Address and port to listen on (e.g., "localhost:5572")
             user: Optional username for authentication
             password: Optional password for authentication
             other_args: Additional command-line arguments
-            
+
         Returns:
             Process object representing the running server
         """
@@ -172,14 +191,14 @@ class Rclone:
     ) -> CompletedProcess:
         """
         Send commands to a running rclone server.
-        
+
         Args:
             addr: Address of the rclone server (e.g., "localhost:5572")
             user: Optional username for authentication
             password: Optional password for authentication
             capture: Whether to capture and return command output
             other_args: Additional command-line arguments
-            
+
         Returns:
             CompletedProcess containing the command result
         """
@@ -194,13 +213,13 @@ class Rclone:
     def obscure(self, password: str) -> str:
         """
         Obscure a password for use in rclone config files.
-        
+
         Converts a plaintext password to rclone's obscured format.
         Note that this is not secure encryption, just light obfuscation.
-        
+
         Args:
             password: The plaintext password to obscure
-            
+
         Returns:
             The obscured password string
         """
@@ -208,25 +227,25 @@ class Rclone:
 
     def ls_stream(
         self,
-        path: str,
+        src: str,
         max_depth: int = -1,
         fast_list: bool = False,
     ) -> FilesStream:
         """
         List files in the given path as a stream of results.
-        
+
         This method is memory-efficient for large directories as it yields
         results incrementally rather than collecting them all at once.
-        
+
         Args:
-            path: Remote path to list
+            src: Remote path to list
             max_depth: Maximum recursion depth (-1 for unlimited)
             fast_list: Use fast list (only recommended for listing entire repositories or small datasets)
-            
+
         Returns:
             A stream of file entries that can be iterated over
         """
-        return self.impl.ls_stream(path=path, max_depth=max_depth, fast_list=fast_list)
+        return self.impl.ls_stream(src=src, max_depth=max_depth, fast_list=fast_list)
 
     def save_to_db(
         self,
@@ -237,10 +256,10 @@ class Rclone:
     ) -> None:
         """
         Save files to a database (sqlite, mysql, postgres).
-        
+
         Lists all files in the source path and stores their metadata in a database.
         Useful for creating searchable indexes of remote storage.
-        
+
         Args:
             src: Remote path to list, this will be used to populate an entire table, so always use the root-most path.
             db_url: Database URL, like sqlite:///data.db or mysql://user:pass@localhost/db or postgres://user:pass@localhost/db
@@ -253,7 +272,7 @@ class Rclone:
 
     def ls(
         self,
-        path: Dir | Remote | str | None = None,
+        src: Dir | Remote | str | None = None,
         max_depth: int | None = None,
         glob: str | None = None,
         order: Order = Order.NORMAL,
@@ -261,21 +280,21 @@ class Rclone:
     ) -> DirListing:
         """
         List files and directories at the specified path.
-        
+
         Provides a detailed listing with file metadata.
-        
+
         Args:
-            path: Path to list (Dir, Remote, or string path)
+            src: Path to list (Dir, Remote, or string path)
             max_depth: Maximum recursion depth (None for default)
             glob: Optional glob pattern to filter results
             order: Sorting order for the results
             listing_option: What types of entries to include
-            
+
         Returns:
             DirListing object containing the results
         """
         return self.impl.ls(
-            path=path,
+            src=src,
             max_depth=max_depth,
             glob=glob,
             order=order,
@@ -285,9 +304,9 @@ class Rclone:
     def listremotes(self) -> list[Remote]:
         """
         List all configured remotes.
-        
+
         Returns a list of all remotes defined in the rclone configuration.
-        
+
         Returns:
             List of Remote objects
         """
@@ -311,10 +330,10 @@ class Rclone:
     ) -> Generator[DiffItem, None, None]:
         """
         Compare two directories and yield differences.
-        
+
         Be extra careful with the src and dst values. If you are off by one
         parent directory, you will get a huge amount of false diffs.
-        
+
         Args:
             src: Rclone style src path
             dst: Rclone style dst path
@@ -325,7 +344,7 @@ class Rclone:
             size_only: Compare only file sizes, not content
             checkers: Number of checker threads
             other_args: Additional command-line arguments
-            
+
         Yields:
             DiffItem objects representing each difference found
         """
@@ -343,28 +362,28 @@ class Rclone:
 
     def walk(
         self,
-        path: Dir | Remote | str,
+        src: Dir | Remote | str,
         max_depth: int = -1,
         breadth_first: bool = True,
         order: Order = Order.NORMAL,
     ) -> Generator[DirListing, None, None]:
         """
         Walk through the given path recursively, yielding directory listings.
-        
+
         Similar to os.walk(), but for remote storage. Traverses directories
         and yields their contents.
-        
+
         Args:
-            path: Remote path, Dir, or Remote object to walk through
+            src: Remote path, Dir, or Remote object to walk through
             max_depth: Maximum depth to traverse (-1 for unlimited)
             breadth_first: If True, use breadth-first traversal, otherwise depth-first
             order: Sorting order for directory entries
-            
+
         Yields:
             DirListing: Directory listing for each directory encountered
         """
         return self.impl.walk(
-            path=path, max_depth=max_depth, breadth_first=breadth_first, order=order
+            src=src, max_depth=max_depth, breadth_first=breadth_first, order=order
         )
 
     def scan_missing_folders(
@@ -376,16 +395,16 @@ class Rclone:
     ) -> Generator[Dir, None, None]:
         """
         Find folders that exist in source but are missing in destination.
-        
+
         Useful for identifying directories that need to be created before
         copying files.
-        
+
         Args:
             src: Source directory or Remote to scan
             dst: Destination directory or Remote to compare against
             max_depth: Maximum depth to traverse (-1 for unlimited)
             order: Sorting order for directory entries
-            
+
         Yields:
             Dir: Each directory that exists in source but not in destination
         """
@@ -394,21 +413,21 @@ class Rclone:
         )
 
     def cleanup(
-        self, path: str, other_args: list[str] | None = None
+        self, src: str, other_args: list[str] | None = None
     ) -> CompletedProcess:
         """
         Cleanup any resources used by the Rclone instance.
-        
+
         Removes temporary files and directories created by rclone.
-        
+
         Args:
-            path: Path to clean up
+            src: Path to clean up
             other_args: Additional command-line arguments
-            
+
         Returns:
             CompletedProcess with the result of the cleanup operation
         """
-        return self.impl.cleanup(path=path, other_args=other_args)
+        return self.impl.cleanup(src=src, other_args=other_args)
 
     def copy_to(
         self,
@@ -420,17 +439,17 @@ class Rclone:
     ) -> CompletedProcess:
         """
         Copy one file from source to destination.
-        
+
         Warning - this can be slow for large files or when copying between
         different storage providers.
-        
+
         Args:
             src: Rclone style src path
             dst: Rclone style dst path
             check: Whether to verify the copy with checksums
             verbose: Whether to show detailed progress
             other_args: Additional command-line arguments
-            
+
         Returns:
             CompletedProcess with the result of the copy operation
         """
@@ -459,9 +478,9 @@ class Rclone:
     ) -> list[CompletedProcess]:
         """
         Copy multiple files from source to destination.
-        
+
         Efficiently copies a list of files, potentially in parallel.
-        
+
         Args:
             src: Rclone style src path
             dst: Rclone style dst path
@@ -479,7 +498,7 @@ class Rclone:
             max_partition_workers: Maximum number of partition workers
             multi_thread_streams: Number of streams for multi-thread copy
             other_args: Additional command-line arguments
-            
+
         Returns:
             List of CompletedProcess objects for each copy operation
         """
@@ -516,9 +535,9 @@ class Rclone:
     ) -> CompletedProcess:
         """
         Copy files from source to destination.
-        
+
         Recursively copies all files from src to dst.
-        
+
         Args:
             src: Rclone style src path
             dst: Rclone style dst path
@@ -529,7 +548,7 @@ class Rclone:
             low_level_retries: Number of low-level retries
             retries: Number of high-level retries
             other_args: Additional command-line arguments
-            
+
         Returns:
             CompletedProcess with the result of the copy operation
         """
@@ -545,19 +564,19 @@ class Rclone:
             other_args=other_args,
         )
 
-    def purge(self, path: Dir | str) -> CompletedProcess:
+    def purge(self, src: Dir | str) -> CompletedProcess:
         """
         Purge a directory.
-        
+
         Removes a directory and all its contents.
-        
+
         Args:
-            path: Rclone style path
-            
+            src: Rclone style path
+
         Returns:
             CompletedProcess with the result of the purge operation
         """
-        return self.impl.purge(path=path)
+        return self.impl.purge(src=src)
 
     def delete_files(
         self,
@@ -570,7 +589,7 @@ class Rclone:
     ) -> CompletedProcess:
         """
         Delete files or directories.
-        
+
         Args:
             files: Files to delete (single file/path or list)
             check: Whether to verify deletions
@@ -578,7 +597,7 @@ class Rclone:
             verbose: Whether to show detailed progress
             max_partition_workers: Maximum number of partition workers
             other_args: Additional command-line arguments
-            
+
         Returns:
             CompletedProcess with the result of the delete operation
         """
@@ -591,28 +610,28 @@ class Rclone:
             other_args=other_args,
         )
 
-    def exists(self, path: Dir | Remote | str | File) -> bool:
+    def exists(self, src: Dir | Remote | str | File) -> bool:
         """
         Check if a file or directory exists.
-        
+
         Args:
-            path: Path to check (Dir, Remote, File, or path string)
-            
+            src: Path to check (Dir, Remote, File, or path string)
+
         Returns:
             True if the path exists, False otherwise
         """
-        return self.impl.exists(path=path)
+        return self.impl.exists(src=src)
 
     def is_synced(self, src: str | Dir, dst: str | Dir) -> bool:
         """
         Check if two directories are in sync.
-        
+
         Compares the contents of src and dst to determine if they match.
-        
+
         Args:
             src: Source directory (Dir object or path string)
             dst: Destination directory (Dir object or path string)
-            
+
         Returns:
             True if the directories are in sync, False otherwise
         """
@@ -621,10 +640,10 @@ class Rclone:
     def modtime(self, src: str) -> str | Exception:
         """
         Get the modification time of a file or directory.
-        
+
         Args:
             src: Path to the file or directory
-            
+
         Returns:
             Modification time as a string, or Exception if an error occurred
         """
@@ -633,10 +652,10 @@ class Rclone:
     def modtime_dt(self, src: str) -> datetime | Exception:
         """
         Get the modification time of a file or directory as a datetime object.
-        
+
         Args:
             src: Path to the file or directory
-            
+
         Returns:
             Modification time as a datetime object, or Exception if an error occurred
         """
@@ -649,13 +668,13 @@ class Rclone:
     ) -> Exception | None:
         """
         Write text to a file.
-        
+
         Creates or overwrites the file at dst with the given text.
-        
+
         Args:
             text: Text content to write
             dst: Destination file path
-            
+
         Returns:
             None if successful, Exception if an error occurred
         """
@@ -668,13 +687,13 @@ class Rclone:
     ) -> Exception | None:
         """
         Write bytes to a file.
-        
+
         Creates or overwrites the file at dst with the given binary data.
-        
+
         Args:
             data: Binary content to write
             dst: Destination file path
-            
+
         Returns:
             None if successful, Exception if an error occurred
         """
@@ -683,10 +702,10 @@ class Rclone:
     def read_bytes(self, src: str) -> bytes | Exception:
         """
         Read bytes from a file.
-        
+
         Args:
             src: Source file path
-            
+
         Returns:
             File contents as bytes, or Exception if an error occurred
         """
@@ -695,10 +714,10 @@ class Rclone:
     def read_text(self, src: str) -> str | Exception:
         """
         Read text from a file.
-        
+
         Args:
             src: Source file path
-            
+
         Returns:
             File contents as a string, or Exception if an error occurred
         """
@@ -714,16 +733,16 @@ class Rclone:
     ) -> Exception | None:
         """
         Copy a slice of bytes from the src file to dst.
-        
+
         Extracts a portion of a file based on offset and length.
-        
+
         Args:
             src: Source file path
             offset: Starting position in the source file
             length: Number of bytes to copy
             outfile: Local file path to write the bytes to
             other_args: Additional command-line arguments
-            
+
         Returns:
             None if successful, Exception if an error occurred
         """
@@ -740,14 +759,14 @@ class Rclone:
     ) -> CompletedProcess:
         """
         Copy a directory from source to destination.
-        
+
         Recursively copies all files and subdirectories.
-        
+
         Args:
             src: Source directory (Dir object or path string)
             dst: Destination directory (Dir object or path string)
             args: Additional command-line arguments
-            
+
         Returns:
             CompletedProcess with the result of the copy operation
         """
@@ -759,14 +778,14 @@ class Rclone:
     ) -> CompletedProcess:
         """
         Copy a remote to another remote.
-        
+
         Copies all contents from one remote storage to another.
-        
+
         Args:
             src: Source remote
             dst: Destination remote
             args: Additional command-line arguments
-            
+
         Returns:
             CompletedProcess with the result of the copy operation
         """
@@ -782,20 +801,20 @@ class Rclone:
     ) -> Exception | None:
         """
         Copy a large file to S3 with resumable upload capability.
-        
+
         This method splits the file into parts for parallel upload and can
         resume interrupted transfers using a custom algorithm in python.
-        
+
         Particularly useful for very large files where network interruptions
         are likely.
-        
+
         Args:
             src: Source file path (format: remote:bucket/path/file)
             dst: Destination file path (format: remote:bucket/path/file)
             part_infos: Optional list of part information for resuming uploads
             upload_threads: Number of parallel upload threads
             merge_threads: Number of threads for merging uploaded parts
-            
+
         Returns:
             None if successful, Exception if an error occurred
         """
@@ -822,9 +841,9 @@ class Rclone:
     ) -> Mount:
         """
         Mount a remote or directory to a local path.
-        
+
         Makes remote storage accessible as a local filesystem.
-        
+
         Args:
             src: Remote or directory to mount
             outdir: Local path to mount to
@@ -836,7 +855,7 @@ class Rclone:
             cache_dir_delete_on_exit: Whether to delete cache on exit
             log: Path to write logs to
             other_args: Additional command-line arguments
-            
+
         Returns:
             Mount object representing the mounted filesystem
         """
@@ -861,19 +880,19 @@ class Rclone:
     ) -> HttpServer:
         """
         Serve a remote or directory via HTTP.
-        
+
         Creates an HTTP server that provides access to the specified remote.
         The returned HttpServer object includes a client for fetching files.
-        
+
         This is useful for providing web access to remote storage or for
         accessing remote files from applications that support HTTP but not
         the remote's native protocol.
-        
+
         Args:
             src: Remote or directory to serve
             addr: Network address and port to serve on (default: localhost:8080)
             other_args: Additional arguments to pass to rclone
-            
+
         Returns:
             HttpServer object with methods for accessing the served content
         """
@@ -890,9 +909,9 @@ class Rclone:
     ) -> SizeResult | Exception:
         """
         Get the size of a list of files.
-        
+
         Calculates the total size of the specified files.
-        
+
         Args:
             src: Base path for the files
             files: List of file paths relative to src
@@ -900,10 +919,10 @@ class Rclone:
             other_args: Additional command-line arguments
             check: Whether to verify file integrity
             verbose: Whether to show detailed output
-            
+
         Returns:
             SizeResult with size information, or Exception if an error occurred
-            
+
         Example:
             size_files("remote:bucket", ["path/to/file1", "path/to/file2"])
         """
@@ -919,10 +938,10 @@ class Rclone:
     def size_file(self, src: str) -> SizeSuffix | Exception:
         """
         Get the size of a file.
-        
+
         Args:
             src: Path to the file
-            
+
         Returns:
             SizeSuffix object representing the file size, or Exception if an error occurred
         """

{rclone_api-1.5.2.dist-info → rclone_api-1.5.4.dist-info}/RECORD

@@ -1,4 +1,4 @@
-rclone_api/__init__.py,sha256=Vtuyxjd7NUWgymTlZxjUeshCRqZ3zLoCmDPxtUtC1Jg,31680
+rclone_api/__init__.py,sha256=scamI3-3a5l0x14rkaDa4cREMpftBbtGZ33OGy3ZKS8,32204
 rclone_api/cli.py,sha256=dibfAZIh0kXWsBbfp3onKLjyZXo54mTzDjUdzJlDlWo,231
 rclone_api/completed_process.py,sha256=_IZ8IWK7DM1_tsbDEkH6wPZ-bbcrgf7A7smls854pmg,1775
 rclone_api/config.py,sha256=f6jEAxVorGFr31oHfcsu5AJTtOJj2wR5tTSsbGGZuIw,2558
@@ -19,12 +19,12 @@ rclone_api/install.py,sha256=Xb1BRn8rQcSpSd4dzmvIOELP2zM2DytUeIZ6jzv738A,2893
 rclone_api/log.py,sha256=VZHM7pNSXip2ZLBKMP7M1u-rp_F7zoafFDuR8CPUoKI,1271
 rclone_api/mount.py,sha256=TE_VIBMW7J1UkF_6HRCt8oi_jGdMov4S51bm2OgxFAM,10045
 rclone_api/process.py,sha256=tGooS5NLdPuqHh7hCH8SfK44A6LGftPQCPQUNgSo0a0,5714
-rclone_api/rclone_impl.py,sha256=emZjLztunr2tJ2a8YYM4XIQk-8Vb-uEcfNjBAqZAGqg,46184
+rclone_api/rclone_impl.py,sha256=h9jDtUC08b_5jciRZL0L-GGMkxGYKnursylb9p2gksU,46145
 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
 rclone_api/types.py,sha256=2ngxwpdNy88y0teeYJ5Vz5NiLK1rfaFx8Xf99i0J-Js,12155
-rclone_api/util.py,sha256=edkZ1XRBPAMcW5iLM3nKx2Ys3RmfV02eAUjWRJTIhjI,9286
+rclone_api/util.py,sha256=IOjutkZRIbgBChUemLbp6_siVDAYMZ1UlpJgWzV-Zvs,9387
 rclone_api/assets/example.txt,sha256=lTBovRjiz0_TgtAtbA1C5hNi2ffbqnNPqkKg6UiKCT8,54
 rclone_api/cmd/analyze.py,sha256=RHbvk1G5ZUc3qLqlm1AZEyQzd_W_ZjcbCNDvW4YpTKQ,1252
 rclone_api/cmd/copy_large_s3.py,sha256=E0B7P-JJTuOM7wMZtwQHJCpoLhccJleh0mnMq8ZiSUo,3234
@@ -52,9 +52,9 @@ rclone_api/s3/multipart/upload_parts_inline.py,sha256=V7syKjFyVIe4U9Ahl5XgqVTzt9
 rclone_api/s3/multipart/upload_parts_resumable.py,sha256=diJoUpVYow6No_dNgOZIYVsv43k4evb6zixqpzWJaUk,9771
 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.2.dist-info/LICENSE,sha256=b6pOoifSXiUaz_lDS84vWlG3fr4yUKwB8fzkrH9R8bQ,1064
-rclone_api-1.5.2.dist-info/METADATA,sha256=9bx4YHS7iO1NlD10Gk53a8R0vk9n0_O04oE_r2Qq66o,32776
-rclone_api-1.5.2.dist-info/WHEEL,sha256=rF4EZyR2XVS6irmOHQIJx2SUqXLZKRMUrjsg8UwN-XQ,109
-rclone_api-1.5.2.dist-info/entry_points.txt,sha256=fJteOlYVwgX3UbNuL9jJ0zUTuX2O79JFAeNgK7Sw7EQ,255
-rclone_api-1.5.2.dist-info/top_level.txt,sha256=EvZ7uuruUpe9RiUyEp25d1Keq7PWYNT0O_-mr8FCG5g,11
-rclone_api-1.5.2.dist-info/RECORD,,
+rclone_api-1.5.4.dist-info/LICENSE,sha256=b6pOoifSXiUaz_lDS84vWlG3fr4yUKwB8fzkrH9R8bQ,1064
+rclone_api-1.5.4.dist-info/METADATA,sha256=juhrazrRWIB2URR-gfT_9tyZnxWr9m1s_UKOc7seIA4,32424
+rclone_api-1.5.4.dist-info/WHEEL,sha256=rF4EZyR2XVS6irmOHQIJx2SUqXLZKRMUrjsg8UwN-XQ,109
+rclone_api-1.5.4.dist-info/entry_points.txt,sha256=fJteOlYVwgX3UbNuL9jJ0zUTuX2O79JFAeNgK7Sw7EQ,255
+rclone_api-1.5.4.dist-info/top_level.txt,sha256=EvZ7uuruUpe9RiUyEp25d1Keq7PWYNT0O_-mr8FCG5g,11
+rclone_api-1.5.4.dist-info/RECORD,,