orca.utils.copyutils
====================

.. py:module:: orca.utils.copyutils

.. autoapi-nested-parse::

   File copying utilities with fsync support.

   Provides file copying functions that include explicit fsync calls
   to ensure data is flushed to disk, important for HPC environments
   with network/parallel filesystems.

   Modified from shutil to add fsync after write operations.



Functions
---------

.. autoapisummary::

   orca.utils.copyutils.copy
   orca.utils.copyutils.copyfile


Module Contents
---------------

.. py:function:: copy(src: str, dst: str, *, follow_symlinks: bool = True) -> str

   Copy file with mode bits, ensuring data is synced to disk.

   :param src: Source file path.
   :param dst: Destination file or directory path.
   :param follow_symlinks: If False, copy symlinks as symlinks.

   :returns: Destination path.


.. py:function:: copyfile(src, dst, *, follow_symlinks=True)

   Copy data from src to dst in the most efficient way possible.

   If follow_symlinks is not set and src is a symbolic link, a new
   symlink will be created instead of copying the file it points to.

   Copied from shutil and modified to add an fsync.