Fabric

This is a Python library and command-line tool for streamlining and implementing the use of SSH for application deployment or systems administration tasks.

It provides a basic suite of operations for executing local or remote shell commands (normally or via sudo) and uploading/downloading files, as well as auxiliary functionality such as prompting the running user for input, or aborting execution.

What is new in this release:

• Fixed Bug:
• A typo preventing quiet operation of is_link.
• Update IPv6 support to work with link-local address formats.
• Encode Unicode text appropriately for its target stream object to avoid issues on non-ASCII systems.
• Fix to respect template_dir for non Jinja2 templates in upload_template.
• Skip bad hosts when the tasks are executed in parallel.
• A bug where upload_template failed to honor lcd when mirror_local_mode is True.
• Use stat instead of lstat when testing directory-ness in the SFTP module. This allows recursive downloads to avoid recursing into symlinks unexpectedly.
• Prevent infinite loop condition when a gateway host is enabled & the same host is in the regular target host list.

What is new in version 1.10.1:

• Fixed Bug:
• A typo preventing quiet operation of is_link.
• Update IPv6 support to work with link-local address formats.
• Encode Unicode text appropriately for its target stream object to avoid issues on non-ASCII systems.
• Fix to respect template_dir for non Jinja2 templates in upload_template.
• Skip bad hosts when the tasks are executed in parallel.
• A bug where upload_template failed to honor lcd when mirror_local_mode is True.
• Use stat instead of lstat when testing directory-ness in the SFTP module. This allows recursive downloads to avoid recursing into symlinks unexpectedly.
• Prevent infinite loop condition when a gateway host is enabled & the same host is in the regular target host list.

What is new in version 1.8.0:

• Added a keyword argument to rsync_project to configure the default options.
• Make the changelog easier to read.
• Allow overriding of abort behavior via a custom exception-returning callable set as env.abort_exception.

What is new in version 1.6.1:

• Fixed problem with missing -r flag in Mac OS X sed version.
• Gracefully handle situations where users give a single string literal to env.hosts.
• Expand paths with tilde inside (contrib.files).
• Downstream synchronization option implemented for rsync_project.

What is new in version 1.5.0:

• Added --initial-password-prompt to allow prefilling the password cache at the start of a run. Great for sudo-powered parallel runs.
• Updated upload_template to have a more useful return value, namely that of its internal put call.
• Added name argument to task (docs) to allow overriding of the default "function name is task name" behavior. Thanks to Daniel Simmons for catch & patch.
• Allow advanced users to parameterize fabric.main.main() to force loading of specific fabfiles.

What is new in version 1.3.3:

• Bug fixes:
• Specifying a task module as a task on the command line no longer blows up but presents the usual "no task by that name" error message instead.
• Allow escaping of equals signs in per-task args/kwargs.
• Improve traceback display when handling ``ImportError``s for dependencies.

What is new in version 1.3.0:

• Bugs:
• Put forgot how to expand leading tildes in the remote file path. This has been corrected.
• During display of remote stdout/stderr, Fabric occasionally printed extraneous line prefixes (which in turn sometimes overwrote wrapped text.) This has been fixed.
• Tasks decorated with runs_once printed extraneous ‘Executing...' status lines on subsequent invocations. This is noisy at best and misleading at worst, and has been corrected.
• Features:
• It is now possible, using the new execute API call, to execute task objects (by reference or by name) from within other tasks or in library mode. execute honors the other tasks' hosts/roles decorators, and also supports passing in explicit host and/or role arguments.
• Tasks may now be optionally executed in parallel. Please see the parallel execution docs for details. Major thanks to Morgan Goose for the initial implementation.

What is new in version 1.2.0:

• Enhanced @task to add aliasing, per-module default tasks, and control over the wrapping task class.
• Improved Unicode support when testing objects for being string-like.
• Experimental overhaul of changelog formatting & process to make supporting multiple lines of development less of a hassle.

What is new in version 1.1.2:

• Bug fixes:
• The logic used to separate tasks from modules when running fab --list incorrectly considered task classes implementing the mapping interface to be modules, not individual tasks. This has been corrected.

What is new in version 1.0.1:

• Fixed a bug in local‘s behavior when capture=False and output.stdout (or .stderr) was also False.
• Update edge case in put where using the mode kwarg alongside use_sudo=True runs a hidden sudo command. The mode kwarg needs to be octal but was being interpolated in the sudo call as a string/integer.
• Append was supposed to have its partial kwarg's default flipped from True to False. However, only the documentation was altered. This has been fixed.
• Tweak internal I/O related loops to prevent high CPU usage and poor screen-printing behavior on some systems.
• Some users reported problems with dropped input, particularly while entering sudo passwords.