]> git.rkrishnan.org Git - tahoe-lafs/tahoe-lafs.git/blobdiff - src/allmydata/scripts/common.py
refactor scripts/common.py: move _default_nodedir out to its own file
[tahoe-lafs/tahoe-lafs.git] / src / allmydata / scripts / common.py
index 64cceb88e57cab62312766dc066584e0a3f7bb7a..2894d3dd77723c50d219c62e2dda4b691c16ef96 100644 (file)
 
-import os, sys
+import os, sys, urllib
+import codecs
 from twisted.python import usage
+from allmydata.util.assertutil import precondition
+from allmydata.util.encodingutil import unicode_to_url, quote_output, \
+    quote_local_unicode_path, argv_to_abspath
+from allmydata.scripts.default_nodedir import _default_nodedir
 
+def get_default_nodedir():
+    return _default_nodedir
 
-class BaseOptions:
-    optFlags = [
-        ["quiet", "q", "Operate silently."],
-        ["version", "V", "Display version numbers and exit."],
-        ]
 
+class BaseOptions(usage.Options):
+    def __init__(self):
+        super(BaseOptions, self).__init__()
+        self.command_name = os.path.basename(sys.argv[0])
+        if self.command_name == 'trial':
+            self.command_name = 'tahoe'
+
+    # Only allow "tahoe --version", not e.g. "tahoe start --version"
     def opt_version(self):
-        from twisted import copyright
-        import allmydata, zfec, foolscap
-        print "Twisted version:", copyright.version
-        print "Foolscap version:", foolscap.__version__
-        print "zfec version:", zfec.__version__
-        print "allmydata version:", allmydata.__version__
-        sys.exit(0)
+        raise usage.UsageError("--version not allowed on subcommands")
 
+class BasedirOptions(BaseOptions):
+    default_nodedir = _default_nodedir
 
-class BasedirMixin:
-    optFlags = [
-        ["multiple", "m", "allow multiple basedirs to be specified at once"],
-        ]
+    optParameters = [
+        ["basedir", "C", None, "Specify which Tahoe base directory should be used. [default: %s]"
+         % quote_local_unicode_path(_default_nodedir)],
+    ]
 
-    def postOptions(self):
-        if not self.basedirs:
-            raise usage.UsageError("<basedir> parameter is required")
-        if self['basedir']:
-            del self['basedir']
-        self['basedirs'] = [os.path.abspath(os.path.expanduser(b))
-                            for b in self.basedirs]
-
-    def parseArgs(self, *args):
-        self.basedirs = []
-        if self['basedir']:
-            self.basedirs.append(self['basedir'])
-        if self['multiple']:
-            self.basedirs.extend(args)
-        else:
-            if len(args) == 0 and not self.basedirs:
-                self.basedirs.append(os.path.expanduser("~/.tahoe"))
-            if len(args) > 0:
-                self.basedirs.append(args[0])
-            if len(args) > 1:
-                raise usage.UsageError("I wasn't expecting so many arguments")
-
-class NoDefaultBasedirMixin(BasedirMixin):
-    def parseArgs(self, *args):
-        # create-client won't default to --basedir=~/.tahoe
-        self.basedirs = []
-        if self['basedir']:
-            self.basedirs.append(self['basedir'])
-        if self['multiple']:
-            self.basedirs.extend(args)
+    def parseArgs(self, basedir=None):
+        if self.parent['node-directory'] and self['basedir']:
+            raise usage.UsageError("The --node-directory (or -d) and --basedir (or -C) options cannot both be used.")
+        if self.parent['node-directory'] and basedir:
+            raise usage.UsageError("The --node-directory (or -d) option and a basedir argument cannot both be used.")
+        if self['basedir'] and basedir:
+            raise usage.UsageError("The --basedir (or -C) option and a basedir argument cannot both be used.")
+
+        if basedir:
+            b = argv_to_abspath(basedir)
+        elif self['basedir']:
+            b = argv_to_abspath(self['basedir'])
+        elif self.parent['node-directory']:
+            b = argv_to_abspath(self.parent['node-directory'])
+        elif self.default_nodedir:
+            b = self.default_nodedir
         else:
-            if len(args) > 0:
-                self.basedirs.append(args[0])
-            if len(args) > 1:
-                raise usage.UsageError("I wasn't expecting so many arguments")
-        if not self.basedirs:
-            raise usage.UsageError("--basedir must be provided")
+            raise usage.UsageError("No default basedir available, you must provide one with --node-directory, --basedir, or a basedir argument")
+        self['basedir'] = b
+
+    def postOptions(self):
+        if not self['basedir']:
+            raise usage.UsageError("A base directory for the node must be provided.")
+
+class NoDefaultBasedirOptions(BasedirOptions):
+    default_nodedir = None
+
+    optParameters = [
+        ["basedir", "C", None, "Specify which Tahoe base directory should be used."],
+    ]
+
+    # This is overridden in order to ensure we get a "Wrong number of arguments."
+    # error when more than one argument is given.
+    def parseArgs(self, basedir=None):
+        BasedirOptions.parseArgs(self, basedir)
+
+    def getSynopsis(self):
+        return "Usage:  %s [global-opts] %s [options] NODEDIR" % (self.command_name, self.subcommand_name)
+
+
+DEFAULT_ALIAS = u"tahoe"
+
+
+def get_aliases(nodedir):
+    aliases = {}
+    aliasfile = os.path.join(nodedir, "private", "aliases")
+    rootfile = os.path.join(nodedir, "private", "root_dir.cap")
+    try:
+        f = open(rootfile, "r")
+        rootcap = f.read().strip()
+        if rootcap:
+            aliases[DEFAULT_ALIAS] = rootcap
+    except EnvironmentError:
+        pass
+    try:
+        f = codecs.open(aliasfile, "r", "utf-8")
+        for line in f.readlines():
+            line = line.strip()
+            if line.startswith("#") or not line:
+                continue
+            name, cap = line.split(u":", 1)
+            # normalize it: remove http: prefix, urldecode
+            cap = cap.strip().encode('utf-8')
+            aliases[name] = cap
+    except EnvironmentError:
+        pass
+    return aliases
+
+class DefaultAliasMarker:
+    pass
+
+pretend_platform_uses_lettercolon = False # for tests
+def platform_uses_lettercolon_drivename():
+    if ("win32" in sys.platform.lower()
+        or "cygwin" in sys.platform.lower()
+        or pretend_platform_uses_lettercolon):
+        return True
+    return False
+
+
+class TahoeError(Exception):
+    def __init__(self, msg):
+        Exception.__init__(self, msg)
+        self.msg = msg
+
+    def display(self, err):
+        print >>err, self.msg
+
+
+class UnknownAliasError(TahoeError):
+    def __init__(self, msg):
+        TahoeError.__init__(self, "error: " + msg)
+
+
+def get_alias(aliases, path_unicode, default):
+    """
+    Transform u"work:path/filename" into (aliases[u"work"], u"path/filename".encode('utf-8')).
+    If default=None, then an empty alias is indicated by returning
+    DefaultAliasMarker. We special-case strings with a recognized cap URI
+    prefix, to make it easy to access specific files/directories by their
+    caps.
+    If the transformed alias is either not found in aliases, or is blank
+    and default is not found in aliases, an UnknownAliasError is
+    raised.
+    """
+    precondition(isinstance(path_unicode, unicode), path_unicode)
+
+    from allmydata import uri
+    path = path_unicode.encode('utf-8').strip(" ")
+    if uri.has_uri_prefix(path):
+        # We used to require "URI:blah:./foo" in order to get a subpath,
+        # stripping out the ":./" sequence. We still allow that for compatibility,
+        # but now also allow just "URI:blah/foo".
+        sep = path.find(":./")
+        if sep != -1:
+            return path[:sep], path[sep+3:]
+        sep = path.find("/")
+        if sep != -1:
+            return path[:sep], path[sep+1:]
+        return path, ""
+    colon = path.find(":")
+    if colon == -1:
+        # no alias
+        if default == None:
+            return DefaultAliasMarker, path
+        if default not in aliases:
+            raise UnknownAliasError("No alias specified, and the default %s alias doesn't exist. "
+                                    "To create it, use 'tahoe create-alias %s'."
+                                    % (quote_output(default), quote_output(default, quotemarks=False)))
+        return uri.from_string_dirnode(aliases[default]).to_string(), path
+    if colon == 1 and default is None and platform_uses_lettercolon_drivename():
+        # treat C:\why\must\windows\be\so\weird as a local path, not a tahoe
+        # file in the "C:" alias
+        return DefaultAliasMarker, path
+
+    # decoding must succeed because path is valid UTF-8 and colon & space are ASCII
+    alias = path[:colon].decode('utf-8')
+    if u"/" in alias:
+        # no alias, but there's a colon in a dirname/filename, like
+        # "foo/bar:7"
+        if default == None:
+            return DefaultAliasMarker, path
+        if default not in aliases:
+            raise UnknownAliasError("No alias specified, and the default %s alias doesn't exist. "
+                                    "To create it, use 'tahoe create-alias %s'."
+                                    % (quote_output(default), quote_output(default, quotemarks=False)))
+        return uri.from_string_dirnode(aliases[default]).to_string(), path
+    if alias not in aliases:
+        raise UnknownAliasError("Unknown alias %s, please create it with 'tahoe add-alias' or 'tahoe create-alias'." %
+                                quote_output(alias))
+    return uri.from_string_dirnode(aliases[alias]).to_string(), path[colon+1:]
 
+def escape_path(path):
+    # this always returns bytes, specifically US-ASCII, valid URL characters
+    segments = path.split("/")
+    return "/".join([urllib.quote(unicode_to_url(s)) for s in segments])