From: Elrond <elrond+mediagoblin.org@samba-tng.org>
Date: Mon, 8 Aug 2011 18:11:28 +0000 (+0200)
Subject: MountStorage: Add docs.
X-Git-Url: https://vcs.fsf.org/?a=commitdiff_plain;h=255f02c48623533f6e781d9d1eade12d18ee0745;p=mediagoblin.git

MountStorage: Add docs.
---

diff --git a/mediagoblin/storage.py b/mediagoblin/storage.py
index 25598c82..bbf1c034 100644
--- a/mediagoblin/storage.py
+++ b/mediagoblin/storage.py
@@ -287,6 +287,21 @@ class CloudFilesStorage(StorageInterface):
 
 
 class MountStorage(StorageInterface):
+    """
+    Experimental "Mount" virtual Storage Interface
+    
+    This isn't an interface to some real storage, instead
+    it's a redirecting interface, that redirects requests
+    to other "StorageInterface"s.
+    For example, requests for ["store1", "a"] to first
+    storage with the path ["a"], etc.
+    
+    To set this up, you currently need to call the mount()
+    method with the target path and a backend, that shall
+    be available under that target path.
+    You have to mount things in a sensible order,
+    especially you can't mount ["a", "b"] before ["a"].
+    """
     def __init__(self, **kwargs):
         self.mounttab = {}