Added non_clobbering_path()

scripts/wk/io.py

@@ -1,6 +1,35 @@
 '''WizardKit: I/O Functions'''
 # vim: sts=2 sw=2 ts=2
 
+import pathlib
+
+
+# Functions
+def non_clobbering_path(path):
+  """Update path as needed to non-existing path, returns pathlib.Path."""
+  path = pathlib.Path(path)
+  name = path.name
+  new_path = None
+  suffix = ''.join(path.suffixes)
+  name = name.replace(suffix, '')
+
+  # Bail early
+  if not path.exists():
+    return path
+
+  # Find non-existant path
+  for _i in range(1000):
+    new_path = path.with_name(f'{name}_{_i}').with_suffix(suffix)
+    if not new_path.exists():
+      break
+
+  # Raise error if viable path not found
+  if not new_path:
+    raise FileExistsError(new_path)
+
+  # Done
+  return new_path
+
 
 if __name__ == '__main__':
   print("This file is not meant to be called directly.")