add atomic-argument to UrlOperations

datalad_next/url_operations/base.py

@@ -176,7 +176,8 @@ def upload(self,
                *,
                credential: str | None = None,
                hash: list[str] | None = None,
-               timeout: float | None = None) -> Dict:
+               timeout: float | None = None,
+               atomic: bool = False) -> Dict:
         """Upload from a local file or stream to a URL
 
         Parameters
@@ -203,6 +204,11 @@ def upload(self,
           If given, specifies a timeout in seconds. If the operation is not
           completed within this time, it will raise a `TimeoutError`-exception.
           If timeout is None, the operation will never timeout.
+        atomic: bool, optional, default: ``False``
+          If ``True``, the upload is performed atomically. This means that the
+          destination will never see a partially uploaded file. It will either
+          see the previous content (or nothing) or the newly uploaded content.
+          Note: this is not supported by all implementations of URL-operations.
 
         Returns
         -------
@@ -362,6 +368,3 @@ def _with_progress(self,
                 end_log_msg
             )
         )
-
-
-