def locking_copy(src, dst, timeout=None):

    """

    Implements a "locking" version of the standard library's

    :func:`python:shutil.copy()` function.

    This exists to provide a more atomic method for copying a file into a

    folder which is being watched by a file monitor.  The assumption is that

    the monitor is configured to watch for file "locks" and therefore only

    process files once they have had their locks removed.  See also

    :ref:`filemon-profile-watchlocks`.

    :param src: Path to the source file.

    :type src: string

    :param dst: Path to the destination file (or directory).

    :type dst: string

    :type timeout: float

    :param timeout: Number of seconds to wait for the file lock to clear, if it

       already exists.  This value may be specified as an integer or float, or

       string (which will be coerced to a float).

       .. note::

          There is no default value for the timeout, which means that by

          default, the function will wait indefinitely for the lock to clear.

    """

    # Coerce timeout to float in case it isn't already, e.g. in the case of

    # being called as a filemon action.

    if timeout is not None:

        timeout = float(timeout)

    if os.path.isdir(dst):

        fn = os.path.basename(src)

        dst = os.path.join(dst, fn)

    with lockfile.LockFile(dst, timeout=timeout):

        shutil.copy(src, dst)

def locking_copy_test(src, destdir):