333 use logger in place of print

AUTHORS

@@ -36,3 +36,13 @@ Stephen Goss
 James Murty
 Thomas Ballinger
 Rick Harding
+Kirill Pinchuk
+Ales Zoulek
+Casey Banner
+Roman Imankulov
+Rodrigue Alcazar
+Jeremy Avnet
+Matt Chisholm
+Mark Merritt
+Max Arnold
+Szymon Reichmann

docs/api/core/decorators.rst

@@ -3,4 +3,4 @@ Decorators
 ==========
 
 .. automodule:: fabric.decorators
-    :members: hosts, roles, runs_once
+    :members: hosts, roles, runs_once, task, with_settings

docs/api/core/tasks.rst

@@ -0,0 +1,6 @@
+=====
+Tasks
+=====
+
+.. automodule:: fabric.tasks
+    :members: Task

docs/changes/0.9.6.rst

@@ -0,0 +1,12 @@
+========================
+Changes in version 0.9.6
+========================
+
+The following changes were implemented in Fabric 0.9.6:
+
+Bugfixes
+========
+
+* :issue:`347`: `~fabric.contrib.files.append` incorrectly tested for ``str``
+  instead of ``types.StringTypes``, causing it to split up Unicode strings as
+  if they were one character per line. This has been fixed.

docs/changes/0.9.7.rst

@@ -0,0 +1,10 @@
+========================
+Changes in version 0.9.7
+========================
+
+The following changes were implemented in Fabric 0.9.7:
+
+Bugfixes
+========
+
+* :issue:`329`: `~fabric.operations.reboot` would have problems reconnecting post-reboot (resulting in a traceback) if ``env.host_string`` was not fully-formed (did not contain user and port specifiers.) This has been fixed.

docs/changes/1.0.1.rst

@@ -12,13 +12,21 @@ Bugfixes
 * :issue:`301`: Fixed a bug in `~fabric.operations.local`'s behavior when
   ``capture=False`` and ``output.stdout`` (or ``.stderr``) was also ``False``.
   Thanks to Chris Rose for the catch.
+* :issue:`310`: Update edge case in `~fabric.operations.put` where using the
+  ``mode`` kwarg alongside ``use_sudo=True`` runs a hidden
+  `~fabric.operations.sudo` command. The ``mode`` kwarg needs to be octal but
+  was being interpolated in the ``sudo`` call as a string/integer. Thanks to
+  Adam Ernst for the catch and suggested fix.
 * :issue:`311`: `~fabric.contrib.files.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. Thanks to Adam Ernst for
   bringing it to our attention.
 * :issue:`312`: Tweak internal I/O related loops to prevent high CPU usage and
-  poor screen-printing behavior on some systems. Thanks to Redmine user ``cbr
-  grind`` for the initial patch.
+  poor screen-printing behavior on some systems. Thanks to Kirill Pinchuk for
+  the initial patch.
+* :issue:`320`: Some users reported problems with dropped input, particularly
+  while entering `~fabric.operations.sudo` passwords. This was fixed via the
+  same change as for :issue:`312`.
 
 Documentation
 =============

docs/changes/1.0.2.rst

@@ -0,0 +1,35 @@
+========================
+Changes in version 1.0.2
+========================
+
+.. note::
+    This release also includes all applicable changes from the :doc:`0.9.7
+    release </changes/0.9.7>`.
+
+Bugfixes
+========
+
+* :issue:`258`: Bugfix to a previous, incorrectly applied fix regarding
+  `~fabric.operations.local` on Windows platforms.
+* :issue:`324`: Update `~fabric.operations.run`/`~fabric.operations.sudo`'s
+  ``combine_stderr`` kwarg so that it correctly overrides the global setting in
+  all cases. This required changing its default value to ``None``, but the
+  default behavior (behaving as if the setting were ``True``) has not changed.
+  Thanks to Matthew Woodcraft and Connor Smith for the catch.
+* :issue:`337`: Fix logic bug in `~fabric.operations.put` preventing use of
+  ``mirror_local_mode``. Thanks to Roman Imankulov for catch & patch.
+* :issue:`352` (also :issue:`320`): Seemingly random issues with output lockup
+  and input problems (e.g. sudo prompts incorrectly rejecting passwords) appear
+  to have been caused by an I/O race condition. This has been fixed. Thanks to
+  Max Arnold and Paul Oswald for the detailed reports and to Max for the
+  diagnosis and patch.
+
+
+Documentation
+=============
+
+* Updated the API documentation for `~fabric.context_managers.cd` to explicitly
+  point users to `~fabric.context_managers.lcd` for modifying local paths.
+* Clarified the behavior of `~fabric.contrib.project.rsync_project` re: how
+  trailing slashes in ``local_dir`` affect ``remote_dir``. Thanks to Mark
+  Merritt for the catch.

docs/changes/1.1.1.rst

@@ -0,0 +1,19 @@
+========================
+Changes in version 1.1.1
+========================
+
+Bugfixes
+========
+
+* The public API for `~fabric.tasks.Task` mentioned use of the ``run()``
+  method, but Fabric's main execution loop had not been updated to look for and
+  call it, forcing users who subclassed `~fabric.tasks.Task` to define
+  ``__call__()`` instead. This was an oversight and has been corrected.
+
+
+Documentation
+=============
+
+* The documentation for use of `~fabric.tasks.Task` subclasses (contained under
+  :ref:`new-style-tasks`) has been slightly fleshed out and has also grown an
+  example snippet or two.

docs/changes/1.1.rst

@@ -4,20 +4,91 @@ Changes in version 1.1
 
 This page lists all changes made to Fabric in its 1.1.0 release.
 
+.. note::
+    This release also includes all applicable changes from the :doc:`1.0.2
+    release </changes/1.0.2>`.
+
+Highlights
+==========
+
+* :issue:`76`: :ref:`New-style tasks <new-style-tasks>` have been added. With
+  the addition of the `~fabric.decorators.task` decorator and the
+  `~fabric.tasks.Task` class, you can now "opt-in" and explicitly mark task
+  functions as tasks, and Fabric will ignore the rest. The original behavior
+  (now referred to as :ref:`"classic" tasks <classic-tasks>`) will still take
+  effect if no new-style tasks are found. Major thanks to Travis Swicegood for
+  the original implementation.
+* :issue:`56`: Namespacing is now possible: Fabric will crawl imported module
+  objects looking for new-style task objects and build a dotted hierarchy
+  (tasks named e.g. ``web.deploy`` or ``db.migrations.run``), allowing for
+  greater organization. See :ref:`namespaces` for details. Thanks again to
+  Travis Swicegood.
+
 
 Feature additions
 =================
 
+* :issue:`10`: `~fabric.contrib.upload_project` now allows control over the
+  local and remote directory paths, and has improved error handling. Thanks to
+  Rodrigue Alcazar for the patch.
+* As part of :issue:`56` (highlighted above), added :option:`--list-format
+  <-F>` to allow specification of a nested output format from :option:`--list
+  <-l>`.
 * :issue:`107`: `~fabric.operations.require`'s ``provided_by`` kwarg now
   accepts iterables in addition to single values. Thanks to Thomas Ballinger
   for the patch.
+* :issue:`117`: `~fabric.contrib.files.upload_template` now supports the
+  `~fabric.operations.put` flags ``mirror_local_mode`` and ``mode``. Thanks to
+  Joe Stump for the suggestion and Thomas Ballinger for the patch.
+* :issue:`154`: `~fabric.contrib.files.sed` now allows customized regex flags
+  to be specified via a new ``flags`` parameter. Thanks to Nick Trew for the
+  suggestion and Morgan Goose for initial implementation.
+* :issue:`170`: Allow :ref:`exclusion <excluding-hosts>` of specific hosts from
+  the final run list. Thanks to Casey Banner for the suggestion and patch.
+* :issue:`189`: Added :option:`--abort-on-prompts`/:ref:`env.abort_on_prompts
+  <abort-on-prompts>` to allow a more non-interactive behavior,
+  aborting/exiting instead of trying to prompt the running user. Thanks to
+  Jeremy Avnet and Matt Chisholm for the initial patch.
+* :issue:`273`: `~fabric.contrib.files.upload_template` now offers control over
+  whether it attempts to create backups of pre-existing destination files.
+  Thanks to Ales Zoulek for the suggestion and initial patch.
+* :issue:`283`: Added the `~fabric.decorators.with_settings` decorator to allow
+  application of env var settings to an entire function, as an alternative to
+  using the `~fabric.context_managers.settings` context manager. Thanks to
+  Travis Swicegood for the patch.
+* :issue:`353`: Added :option:`--keepalive`/:ref:`env.keepalive <keepalive>` to
+  allow specification of an SSH keepalive parameter for troublesome network
+  connections. Thanks to Mark Merritt for catch & patch.
 
 Bugfixes
 ========
 
-* N/A
+* :issue:`115`: An implementation detail causing host lists to lose order
+  when deduped by the ``fab`` execution loop, has been patched to preserve
+  order instead. So e.g. ``fab -H a,b,c`` (or setting ``env.hosts = ['a', 'b',
+  'c']``) will now always run on ``a``, then ``b``, then ``c``. Previously,
+  there was a chance the order could get mixed up during deduplication. Thanks
+  to Rohit Aggarwal for the report.
+* :issue:`345`: `~fabric.contrib.files.contains` returned the stdout of its
+  internal ``grep`` command instead of success/failure, causing incorrect
+  behavior when stderr exists and is combined with stdout. This has been
+  corrected. Thanks to Szymon Reichmann for catch and patch.
 
 Documentation updates
 =====================
 
-* N/A
+* Documentation for task declaration has been moved from
+  :doc:`/usage/execution` into its own docs page, :doc:`/usage/tasks`, as a
+  result of the changes added in :issue:`76` and :issue:`56`.
+* :issue:`184`: Make the usage of `~fabric.contrib.project.rsync_project`'s
+  ``local_dir`` argument more obvious, regarding its use in the ``rsync`` call.
+  (Specifically, so users know they can pass in multiple, space-joined
+  directory names instead of just one single directory.)
+
+Internals
+=========
+
+* :issue:`307`: A whole pile of minor PEP8 tweaks. Thanks to Markus Gattol for
+  highlighting the ``pep8`` tool and to Rick Harding for the patch.
+* :issue:`314`: Test utility decorator improvements. Thanks to Rick Harding for
+  initial catch & patch.

docs/conf.py

@@ -120,7 +120,8 @@ def issues_role(name, rawtext, text, lineno, inliner, options={}, content=[]):
 
 from fabric.api import local, hide
 with hide('everything'):
-    fabric_tags = local('git tag | sort -r | egrep "(0\.9|1\.0)\.."', True).split()
+    get_tags = 'git tag | sort -r | egrep "(0\.9|1\.[[:digit:]]+)\.."'
+    fabric_tags = local(get_tags, True).split()
 html_context = {'fabric_tags': fabric_tags}
 
 

docs/tutorial.rst

@@ -55,7 +55,7 @@ That's all there is to it. This functionality allows Fabric to be used as a
     functions you instruct it to. There's nothing magic about it -- anything
     you can do in a normal Python script can be done in a fabfile!
 
-.. seealso:: :ref:`execution-strategy`, :ref:`tasks-and-imports`, :doc:`usage/fab`
+.. seealso:: :ref:`execution-strategy`, :doc:`/usage/tasks`, :doc:`/usage/fab`
 
 
 Task arguments

docs/usage/env.rst

@@ -104,6 +104,23 @@ as `~fabric.context_managers.cd`.
 Note that many of these may be set via ``fab``'s command-line switches -- see
 :doc:`fab` for details. Cross-links will be provided where appropriate.
 
+.. _abort-on-prompts:
+
+``abort_on_prompts``
+--------------------
+
+**Default:** ``False``
+
+When ``True``, Fabric will run in a non-interactive mode, calling
+`~fabric.utils.abort` anytime it would normally prompt the user for input (such
+as password prompts, "What host to connect to?" prompts, fabfile invocation of
+`~fabric.operations.prompt`, and so forth.) This allows users to ensure a Fabric
+session will always terminate cleanly instead of blocking on user input forever
+when unforeseen circumstances arise.
+
+.. versionadded:: 1.1
+.. seealso:: :option:`--abort-on-prompts`
+
 ``all_hosts``
 -------------
 
@@ -185,6 +202,19 @@ host key is actually valid (e.g. cloud servers such as EC2.)
 
 .. seealso:: :doc:`ssh`
 
+.. _exclude-hosts:
+
+``exclude_hosts``
+-----------------
+
+**Default:** ``[]``
+
+Specifies a list of host strings to be :ref:`skipped over <exclude-hosts>`
+during ``fab`` execution. Typically set via :option:`--exclude-hosts/-x <-x>`.
+
+.. versionadded:: 1.1
+
+
 ``fabfile``
 -----------
 
@@ -229,6 +259,20 @@ The global host list used when composing per-task host lists.
 
 .. seealso:: :doc:`execution`
 
+.. _keepalive:
+
+``keepalive``
+-------------
+
+**Default:** ``0`` (i.e. no keepalive)
+
+An integer specifying an SSH keepalive interval to use; basically maps to the
+SSH config option ``ClientAliveInterval``. Useful if you find connections are
+timing out due to meddlesome network hardware or what have you.
+
+.. seealso:: :option:`--keepalive`
+.. versionadded:: 1.1
+
 .. _key-filename:
 
 ``key_filename``