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:
- # unit tests can override these to point at StringIO instances
- stdin = sys.stdin
- stdout = sys.stdout
- stderr = sys.stderr
- 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):
- import allmydata
- print allmydata.get_package_versions_string()
- sys.exit(0)
+ raise usage.UsageError("--version not allowed on subcommands")
+
+class BasedirOptions(BaseOptions):
+ default_nodedir = _default_nodedir
+
+ optParameters = [
+ ["basedir", "C", None, "Specify which Tahoe base directory should be used. [default: %s]"
+ % quote_local_unicode_path(_default_nodedir)],
+ ]
+
+ 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:
+ 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 BasedirMixin:
- optFlags = [
- ["multiple", "m", "allow multiple basedirs to be specified at once"],
- ]
+class NoDefaultBasedirOptions(BasedirOptions):
+ default_nodedir = None
- 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:
- if sys.platform == 'win32':
- from allmydata.windows import registry
- self.basedirs.append(registry.get_base_dir_path())
- else:
- 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)
- 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")
+ optParameters = [
+ ["basedir", "C", None, "Specify which Tahoe base directory should be used."],
+ ]
-DEFAULT_ALIAS = "tahoe"
+ # 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):
- from allmydata import uri
aliases = {}
aliasfile = os.path.join(nodedir, "private", "aliases")
rootfile = os.path.join(nodedir, "private", "root_dir.cap")
f = open(rootfile, "r")
rootcap = f.read().strip()
if rootcap:
- aliases["tahoe"] = uri.from_string_dirnode(rootcap).to_string()
+ aliases[DEFAULT_ALIAS] = rootcap
except EnvironmentError:
pass
try:
- f = open(aliasfile, "r")
+ 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(":", 1)
+ name, cap = line.split(u":", 1)
# normalize it: remove http: prefix, urldecode
- cap = cap.strip()
- aliases[name] = uri.from_string_dirnode(cap).to_string()
+ cap = cap.strip().encode('utf-8')
+ aliases[name] = cap
except EnvironmentError:
pass
return aliases
class DefaultAliasMarker:
pass
-def get_alias(aliases, path, default):
- # transform "work:path/filename" into (aliases["work"], "path/filename").
- # If default=None, then an empty alias is indicated by returning
- # DefaultAliasMarker. We special-case "URI:" to make it easy to access
- # specific files/directories by their read-cap.
- path = path.strip()
- if path.startswith("URI:"):
- # The only way to get a sub-path is to use URI:blah:./foo, and we
- # strip out the :./ sequence.
+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
- return aliases[default], path
- alias = path[:colon]
- if "/" in alias:
+ 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
- return aliases[default], path
- return aliases[alias], path[colon+1:]
+ 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(s.encode('utf-8')) for s in segments])
+ return "/".join([urllib.quote(unicode_to_url(s)) for s in segments])
projects / tahoe-lafs / tahoe-lafs.git / blobdiff