add files.overwriting_move()

edbob/files.py

@@ -100,6 +100,19 @@ def count_lines(path):
     return lines
 
 
+def overwriting_move(src, dst):
+    """
+    Convenience function which is equivalent to ``shutil.move()``, except it
+    will cause the destination file to be overwritten if it exists.
+    """
+
+    if os.path.isdir(dst):
+        dst = os.path.join(dst, os.path.basename(src))
+    if os.path.exists(dst):
+        os.remove(dst)
+    shutil.move(src, dst)
+
+
 def resource_path(path):
     """
     Returns a resource file path.  ``path`` is assumed either to be a package