More documentation on all the core storage API methods

diff --git a/mediagoblin/storage.py b/mediagoblin/storage.py
index 8e62a3a6ad34bfe6030fc7a2c90b3cc73e848391..4e0960c7d7ca42eb766359978751437690ada831 100644 (file)
--- a/mediagoblin/storage.py
+++ b/mediagoblin/storage.py
@@ -84,11 +84,22 @@ class StorageInterface(object):
         # Subclasses should override this method.
         self.__raise_not_implemented()
 
-    def get_file(self, filepath):
+    def get_file(self, filepath, mode):
+        """
+        Return a file-like object for reading/writing from this filepath.
+
+        Should create directories, buckets, whatever, as necessary.
+        """
         # Subclasses should override this method.
         self.__raise_not_implemented()
 
     def delete_file(self, filepath):
+        """
+        Delete or dereference the file at filepath.
+
+        This might need to delete directories, buckets, whatever, for
+        cleanliness.  (Be sure to avoid race conditions on that though)
+        """
         # Subclasses should override this method.
         self.__raise_not_implemented()