[OMCPath] add copy()

Author: syntron

OMPython/OMCSession.py

@@ -418,6 +418,25 @@ def size(self) -> int:
 
         raise OMCSessionException(f"Error reading file size for path {self.as_posix()}!")
 
+    def copy(self, dst: OMCPath, overwrite_ok: bool = False) -> OMCPath:
+        """
+        Copy a (binary) file.
+        """
+        if not isinstance(dst, OMCPath):
+            raise OMCSessionException("Destination must be an OMCPath object!")
+
+        if dst.is_dir():
+            dst /= self.name
+
+        if dst.is_file() and not overwrite_ok:
+            raise OMCSessionException(f"Not overwriting file {dst.as_posix()} "
+                                      "- use overwrite_ok=True to force the operation!")
+
+        if not self._session.sendExpression(f'copy("{self.as_posix()}", "{dst.as_posix()}")'):
+            raise OMCSessionException(f"Could not copy {self.as_posix()} to {dst.as_posix()}!")
+
+        return OMCPath(dst.as_posix(), session=self._session)
+
 
 if sys.version_info < (3, 12):
 
@@ -447,6 +466,27 @@ def size(self) -> int:
             """
             return self.stat().st_size
 
+        def copy(self, dst: OMCPath, overwrite_ok: bool = False) -> bool:
+            """
+            Copy a (binary) file.
+
+            TODO: Python 3.14 will support copy() nativley
+                  see: https://docs.python.org/3.14/library/pathlib.html#pathlib.Path.copy
+            """
+            if not isinstance(dst, OMCPath):
+                raise OMCSessionException("Destination must be an OMCPath object!")
+
+            if dst.is_dir():
+                dst /= self.name
+
+            if dst.is_file() and not overwrite_ok:
+                raise OMCSessionException(f"Not overwriting file {dst.as_posix()} "
+                                          "- use overwrite_ok=True to force the operation!")
+
+            dst.write_bytes(self.read_bytes())
+
+            return dst.is_file()
+
     class OMCPathCompatibilityPosix(pathlib.PosixPath, OMCPathCompatibility):
         pass