-import os.path, re, sys, fnmatch
+import os.path, re, fnmatch
from twisted.python import usage
from allmydata.scripts.common import BaseOptions, get_aliases, get_default_nodedir, DEFAULT_ALIAS
from allmydata.util.encodingutil import argv_to_unicode, argv_to_abspath, quote_output
"Specify which Tahoe node directory should be used. The directory "
"should either contain a full Tahoe node, or a file named node.url "
"that points to some other Tahoe node. It should also contain a file "
- "named private/aliases which contains the mapping from alias name "
- "to root dirnode URI." + (
- _default_nodedir and (" [default for most commands: " + quote_output(_default_nodedir) + "]") or "")],
+ "named '" + os.path.join('private', 'aliases') + "' which contains the "
+ "mapping from alias name to root dirnode URI." + (
+ _default_nodedir and (" [default: " + quote_output(_default_nodedir) + "]") or "")],
["node-url", "u", None,
"Specify the URL of the Tahoe gateway node, such as 'http://127.0.0.1:3456'. "
"This overrides the URL found in the --node-directory ."],
class MakeDirectoryOptions(VDriveOptions):
+ optParameters = [
+ ("format", None, None, "Create directory with the given format: SDMF and MDMF for mutable. (case-insensitive)"),
+ ]
+
def parseArgs(self, where=""):
self.where = argv_to_unicode(where)
+
+ if self['format']:
+ if self['format'].upper() not in ("SDMF", "MDMF", "CHK"):
+ raise usage.UsageError("%s is an invalid format" % self['format'])
+
+ def getSynopsis(self):
+ return "Usage: %s mkdir [options] [REMOTE_DIR]" % (self.command_name,)
+
longdesc = """Create a new directory, either unlinked or as a subdirectory."""
class AddAliasOptions(VDriveOptions):
def parseArgs(self, alias, cap):
self.alias = argv_to_unicode(alias)
+ if self.alias.endswith(u':'):
+ self.alias = self.alias[:-1]
self.cap = cap
def getSynopsis(self):
- return "%s add-alias ALIAS DIRCAP" % (os.path.basename(sys.argv[0]),)
+ return "Usage: %s add-alias [options] ALIAS[:] DIRCAP" % (self.command_name,)
longdesc = """Add a new alias for an existing directory."""
class CreateAliasOptions(VDriveOptions):
def parseArgs(self, alias):
self.alias = argv_to_unicode(alias)
+ if self.alias.endswith(u':'):
+ self.alias = self.alias[:-1]
def getSynopsis(self):
- return "%s create-alias ALIAS" % (os.path.basename(sys.argv[0]),)
+ return "Usage: %s create-alias [options] ALIAS[:]" % (self.command_name,)
longdesc = """Create a new directory and add an alias for it."""
-class ListAliasOptions(VDriveOptions):
+class ListAliasesOptions(VDriveOptions):
+ def getSynopsis(self):
+ return "Usage: %s list-aliases [options]" % (self.command_name,)
+
longdesc = """Display a table of all configured aliases."""
class ListOptions(VDriveOptions):
self.to_file = None
def getSynopsis(self):
- return "%s get REMOTE_FILE LOCAL_FILE" % (os.path.basename(sys.argv[0]),)
+ return "Usage: %s get [options] REMOTE_FILE LOCAL_FILE" % (self.command_name,)
longdesc = """
Retrieve a file from the grid and write it to the local filesystem. If
class PutOptions(VDriveOptions):
optFlags = [
- ("mutable", "m", "Create a mutable file instead of an immutable one."),
+ ("mutable", "m", "Create a mutable file instead of an immutable one. (DEPRECATED, use --format=SDMF)"),
+ ]
+ optParameters = [
+ ("format", None, None, "Create file with the given format: SDMF and MDMF for mutable, CHK (default) for immutable. (case-insensitive)"),
]
def parseArgs(self, arg1=None, arg2=None):
if self.from_file == u"-":
self.from_file = None
+ if self['format']:
+ if self['format'].upper() not in ("SDMF", "MDMF", "CHK"):
+ raise usage.UsageError("%s is an invalid format" % self['format'])
+
def getSynopsis(self):
- return "%s put LOCAL_FILE REMOTE_FILE" % (os.path.basename(sys.argv[0]),)
+ return "Usage: %s put [options] LOCAL_FILE REMOTE_FILE" % (self.command_name,)
longdesc = """
Put a file into the grid, copying its contents from the local filesystem.
t += """
Examples:
% cat FILE | tahoe put # create unlinked file from stdin
- % cat FILE | tahoe - # same
+ % cat FILE | tahoe put - # same
% tahoe put bar # create unlinked file from local 'bar'
% cat FILE | tahoe put - FOO # create tahoe:FOO from stdin
% tahoe put bar FOO # copy local 'bar' to tahoe:FOO
"When copying to local files, write out filecaps instead of actual "
"data (only useful for debugging and tree-comparison purposes)."),
]
+
def parseArgs(self, *args):
if len(args) < 2:
raise usage.UsageError("cp requires at least two arguments")
self.sources = map(argv_to_unicode, args[:-1])
self.destination = argv_to_unicode(args[-1])
+
def getSynopsis(self):
- return "Usage: tahoe [options] cp FROM.. TO"
+ return "Usage: %s cp [options] FROM.. TO" % (self.command_name,)
+
longdesc = """
Use 'tahoe cp' to copy files between a local filesystem and a Tahoe grid.
Any FROM/TO arguments that begin with an alias indicate Tahoe-side
tahoe cp URI:DIR2-RO:ixqhc4kdbjxc7o65xjnveoewym:5x6lwoxghrd5rxhwunzavft2qygfkt27oj3fbxlq4c6p45z5uneq/blog.html ./ # copy Zooko's wiki page to a local file
- This command still has some limitations: symlinks, special files (device
- nodes, named pipes), and non-ASCII filenames are not handled very well.
- Arguments should probably not have trailing slashes. 'tahoe cp' does not
- behave as much like /bin/cp as you would wish, especially with respect to
- trailing slashes.
+ This command still has some limitations: symlinks and special files
+ (device nodes, named pipes) are not handled very well. Arguments should
+ probably not have trailing slashes. 'tahoe cp' does not behave as much
+ like /bin/cp as you would wish, especially with respect to trailing
+ slashes.
"""
-class RmOptions(VDriveOptions):
+class UnlinkOptions(VDriveOptions):
def parseArgs(self, where):
self.where = argv_to_unicode(where)
def getSynopsis(self):
- return "%s rm REMOTE_FILE" % (os.path.basename(sys.argv[0]),)
+ return "Usage: %s unlink [options] REMOTE_FILE" % (self.command_name,)
-class UnlinkOptions(RmOptions):
+class RmOptions(UnlinkOptions):
def getSynopsis(self):
- return "%s unlink REMOTE_FILE" % (os.path.basename(sys.argv[0]),)
+ return "Usage: %s rm [options] REMOTE_FILE" % (self.command_name,)
class MvOptions(VDriveOptions):
def parseArgs(self, frompath, topath):
self.to_file = argv_to_unicode(topath)
def getSynopsis(self):
- return "%s mv FROM TO" % (os.path.basename(sys.argv[0]),)
+ return "Usage: %s mv [options] FROM TO" % (self.command_name,)
+
longdesc = """
Use 'tahoe mv' to move files that are already on the grid elsewhere on
the grid, e.g., 'tahoe mv alias:some_file alias:new_file'.
self.to_file = argv_to_unicode(topath)
def getSynopsis(self):
- return "%s ln FROM TO" % (os.path.basename(sys.argv[0]),)
+ return "Usage: %s ln [options] FROM_LINK TO_LINK" % (self.command_name,)
+
+ longdesc = """
+ Use 'tahoe ln' to duplicate a link (directory entry) already on the grid
+ to elsewhere on the grid. For example 'tahoe ln alias:some_file
+ alias:new_file'. causes 'alias:new_file' to point to the same object that
+ 'alias:some_file' points to.
+
+ (The argument order is the same as Unix ln. To remember the order, you
+ can think of this command as copying a link, rather than copying a file
+ as 'tahoe cp' does. Then the argument order is consistent with that of
+ 'tahoe cp'.)
+
+ When linking a remote file into a remote directory, you'll need to append
+ a '/' to the name of the remote directory, e.g. 'tahoe ln tahoe:file1
+ tahoe:dir/' (which is shorthand for 'tahoe ln tahoe:file1
+ tahoe:dir/file1'). If you forget the '/', e.g. 'tahoe ln tahoe:file1
+ tahoe:dir', the 'ln' command will refuse to overwrite the 'tahoe:dir'
+ directory, and will exit with an error.
+
+ Note that it is not possible to use this command to create links between
+ local and remote files.
+ """
class BackupConfigurationError(Exception):
pass
self.from_dir = argv_to_unicode(localdir)
self.to_dir = argv_to_unicode(topath)
- def getSynopsis(Self):
- return "%s backup FROM ALIAS:TO" % os.path.basename(sys.argv[0])
+ def getSynopsis(self):
+ return "Usage: %s backup [options] FROM ALIAS:TO" % (self.command_name,)
def opt_exclude(self, pattern):
"""Ignore files matching a glob pattern. You may give multiple
def opt_exclude_from(self, filepath):
"""Ignore file matching glob patterns listed in file, one per
line. The file is assumed to be in the argv encoding."""
+ abs_filepath = argv_to_abspath(filepath)
try:
- exclude_file = file(filepath)
+ exclude_file = file(abs_filepath)
except:
- raise BackupConfigurationError('Error opening exclude file %r.' % filepath)
+ raise BackupConfigurationError('Error opening exclude file %s.' % quote_output(abs_filepath))
try:
for line in exclude_file:
self.opt_exclude(line)
self.where = argv_to_unicode(where)
def getSynopsis(self):
- return "%s webopen [ALIAS:PATH]" % (os.path.basename(sys.argv[0]),)
+ return "Usage: %s webopen [options] [ALIAS:PATH]" % (self.command_name,)
longdesc = """Open a web browser to the contents of some file or
directory on the grid. When run without arguments, open the Welcome
self.where = argv_to_unicode(where)
def getSynopsis(self):
- return "%s manifest [ALIAS:PATH]" % (os.path.basename(sys.argv[0]),)
+ return "Usage: %s manifest [options] [ALIAS:PATH]" % (self.command_name,)
longdesc = """Print a list of all files and directories reachable from
the given starting point."""
self.where = argv_to_unicode(where)
def getSynopsis(self):
- return "%s stats [ALIAS:PATH]" % (os.path.basename(sys.argv[0]),)
+ return "Usage: %s stats [options] [ALIAS:PATH]" % (self.command_name,)
longdesc = """Print statistics about of all files and directories
reachable from the given starting point."""
self.where = argv_to_unicode(where)
def getSynopsis(self):
- return "%s check [ALIAS:PATH]" % (os.path.basename(sys.argv[0]),)
+ return "Usage: %s check [options] [ALIAS:PATH]" % (self.command_name,)
longdesc = """
Check a single file or directory: count how many shares are available and
self.where = argv_to_unicode(where)
def getSynopsis(self):
- return "%s deep-check [ALIAS:PATH]" % (os.path.basename(sys.argv[0]),)
+ return "Usage: %s deep-check [options] [ALIAS:PATH]" % (self.command_name,)
longdesc = """
Check all files and directories reachable from the given starting point
["mkdir", None, MakeDirectoryOptions, "Create a new directory."],
["add-alias", None, AddAliasOptions, "Add a new alias cap."],
["create-alias", None, CreateAliasOptions, "Create a new alias cap."],
- ["list-aliases", None, ListAliasOptions, "List all alias caps."],
+ ["list-aliases", None, ListAliasesOptions, "List all alias caps."],
["ls", None, ListOptions, "List a directory."],
["get", None, GetOptions, "Retrieve a file from the grid."],
["put", None, PutOptions, "Upload a file into the grid."],
- ["cp", None, CpOptions, "Copy one or more files."],
- ["rm", None, RmOptions, "Unlink a file or directory on the grid."],
- ["unlink", None, UnlinkOptions, "Unlink a file or directory on the grid (same as rm)."],
+ ["cp", None, CpOptions, "Copy one or more files or directories."],
+ ["unlink", None, UnlinkOptions, "Unlink a file or directory on the grid."],
+ ["rm", None, RmOptions, "Unlink a file or directory on the grid (same as unlink)."],
["mv", None, MvOptions, "Move a file within the grid."],
- ["ln", None, LnOptions, "Make an additional link to an existing file."],
+ ["ln", None, LnOptions, "Make an additional link to an existing file or directory."],
["backup", None, BackupOptions, "Make target dir look like local dir."],
["webopen", None, WebopenOptions, "Open a web browser to a grid file or directory."],
["manifest", None, ManifestOptions, "List all files/directories in a subtree."],
rc = tahoe_cp.copy(options)
return rc
-def rm(options):
- from allmydata.scripts import tahoe_rm
- rc = tahoe_rm.rm(options)
+def unlink(options, command="unlink"):
+ from allmydata.scripts import tahoe_unlink
+ rc = tahoe_unlink.unlink(options, command=command)
return rc
+def rm(options):
+ return unlink(options, command="rm")
+
def mv(options):
from allmydata.scripts import tahoe_mv
rc = tahoe_mv.mv(options, mode="move")
"get": get,
"put": put,
"cp": cp,
+ "unlink": unlink,
"rm": rm,
- "unlink": rm,
"mv": mv,
"ln": ln,
"backup": backup,
projects / tahoe-lafs / tahoe-lafs.git / blobdiff