Merge knownhosts-standards-6257

Author: exarkun
Reviewer: thijs, glyph
Fixes: #6257

Improve `twisted.conch.client.knownhosts` compliance with API documentation
standards.


git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/trunk@36997 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb
Merge template-sanitation-6275

Author: glyph

Reviewer: therve, exarkun

Fixes: #6275

Fix a bug where attribute values are not quoted properly in
twisted.web.template.  Significantly improve test coverage for many previously-
uncovered cases at the same time, as well as making the implementation somewhat
easier to read and better documented for maintainers (if not necessarily making
it much simpler...)



git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/trunk@37018 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb
Merge remove-zshcomp-5767: Remove deprecated `twisted.python.zshcomp`.

Author: tom.prince
Reviewers: rwall
Fixes: #5767

Shell tab-completion is now handled by twisted.python.usage.


git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/trunk@37058 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb
Introductory howto on using Deferreds

Author: jml

Reviewer: teratorn

Fixes: #6180

Document explaining how Deferreds work and how to map basic Python
control flow to Deferreds.  The existing Deferred howto is now linked
as a reference document.



git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/trunk@37070 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb
Merge mktemp-api-docs-6165: Improve documentation of twisted.trial.unittest.SynchronousTestCase.mktemp

Author: meissenPlate, exarkun
Reviewers: exarkun, tom.prince
Fixes: #6165

The original documentation didn't give any direction no how it should
be use used. Explain what it returns and how to use it.


git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/trunk@37071 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb
Merge admin-scripts-path-6208

Author: therve
Reviewer: tom.prince
Fixes: #6208

Make sure admin scripts use the current checkout when running.


git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/trunk@37076 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb
Merge auto-version-2915-3

Author: therve
Reviewer: tom.prince
Fixes: #2915

Automatically pick the next version in the change-versions release script.


git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/trunk@37084 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb
Merge filesender-py3-6026-2: Port twisted.protocols.basic.FileSender to Python 3.

Author: therve
Reviewers: tom.prince
Fixes: #6026

The interface implemented changed to the more specific IPullProducer.


git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/trunk@37101 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb
Merge improve-SafeRepr.test_brokenReprIncludesID-6265: Assert about the actual format of the repr.

Author: hash14
Reviewers: tom.prince
Fixes: #6265


git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/trunk@37116 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb
Merge sha1-py25-5864: Simple removal of an import of sha1 from pre-2.5.

Author: Julian
Reviewers: vperic
Fixes: #5864


git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/trunk@37119 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb
Merge python-2.3-5386-2: Get rid of references and code specific to Python 2.3.

Author: rockstar, thijs
Reviewer: jesstess, exarkun, tom.prince
Fixes: #5386


git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/trunk@37124 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb
Revert r37124: LookupsTestCase.test_importExceptions failing on python 3.3

test_importExceptions is failing on Python 3.3 only because  a statement was
modified to clean up Python 2.3 code which introduced an issue in
test_reflectpy3.LookupsTestCase. This wasn't caught initially because the
buildslave for python 3.3 wass down.

======================================================================
FAIL: test_importExceptions (twisted.python.test.test_reflectpy3.LookupsTestCase)
test_importExceptions
----------------------------------------------------------------------
Traceback (most recent call last):
  File "twisted/trial/_synctest.py", line 328, in assertRaises
    result = f(*args, **kwargs)
  File "twisted/python/_reflectpy3.py", line 273, in namedAny
    obj = getattr(obj, n)
AttributeError: 'module' object has no attribute 'reflect_helper_IE'

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "twisted/trial/_synctest.py", line 1185, in _run
    runWithWarningsSuppressed(suppress, method)
  File "twisted/python/util.py", line 1065, in runWithWarningsSuppressed
    return f(*args, **kwargs)
  File "twisted/python/test/test_reflectpy3.py", line 290, in test_importExceptions
    reflect.namedAny, "twisted.test.reflect_helper_IE")
  File "software/twisted/svn/Twisted/trunk/twisted/trial/_synctest.py", line 335, in assertRaises
    failure.Failure().getTraceback()))
twisted.trial.unittest.FailTest: <class 'AttributeError'> raised instead of ImportError:
 Traceback (most recent call last):
  File "twisted/trial/_synctest.py", line 1216, in _runFixturesAndTest
    if self._run(suppress, todo, method, result):
  File "twisted/trial/_synctest.py", line 1185, in _run
    runWithWarningsSuppressed(suppress, method)
  File "twisted/python/util.py", line 1065, in runWithWarningsSuppressed
    return f(*args, **kwargs)
  File "twisted/python/test/test_reflectpy3.py", line 290, in test_importExceptions
    reflect.namedAny, "twisted.test.reflect_helper_IE")
--- <exception caught here> ---
  File "twisted/trial/_synctest.py", line 328, in assertRaises
    result = f(*args, **kwargs)
  File "twisted/python/_reflectpy3.py", line 273, in namedAny
    obj = getattr(obj, n)
builtins.AttributeError: 'module' object has no attribute 'reflect_helper_IE'

Reopens: #5386
Refs: #6298


git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/trunk@37129 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb
Merge systemd-howto-5601: Add a howto for "Deploying Twisted with SystemD"

Author: rwall
Reviewers: thijs, exarkun, tom.prince
Fixes: #5601

A new "Deploying Twisted with systemd" howto document which
demonstrates how to start a Twisted service using systemd socket
activation.


git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/trunk@37132 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb
Merge remove-asserts-6288: Remove asserts from OpenSSLCertificateOptions.

Author: hynek
Reviewers: exarkun, tom.prince
Fixes: #6288

This replaces them with raising ValueError in the appropriate cases. This
avoids the checks being removed when running with `-O`.


git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/trunk@37139 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb
Merge cooperator-running-5937: Add `running` property to `Cooperator`

Author: chris-, jml
Reviewers: jml, tom.prince
Fixes: #5937

`Cooperator` now has a boolean property, `running`, which can be used
to determine whether or not that cooperator is running.



git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/trunk@37153 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb
Merge getProcessOutput-epytext-6309: getProcessOutput doc string should use proper epydoc instead of *this*

Author: hynek
Reviewers: tom.prince
Fixes: #6309

This one is a bit OCD, but it caught my eye: twisted.internet.utils.getProcessOutput has the following sentence inside of its doc string:

The first string should *NOT* be the executable's name.

I think a B{NOT} would be more appropriate.


git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/trunk@37159 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb
Merge async-trim-frames-6282

Author: therve
Reviewer: tom.prince
Fixes: #6282

Fix a regression in Reporter._trimFrames where utils.runWithWarningsSuppressed
unexpectedly appeared.


git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/trunk@37172 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb
Merge deprecate-iswinnt-5925: Platform.isWinNT is deprecated in favor of isWindows.

Author: thijs
Reviewer: tom.prince
Fixes: #5925

Twisted only supports Windows NT-derived platforms at this point (Windows XP, Windows 7).


git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/trunk@37185 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb
Merge deprecate-tlsmode-5852: tlsMode attribute of twisted.mail.smtp.ESMTPClient is deprecated.

Author: moijes12, rwall
Reviewer: exarkun, namn, lvh, rwall, tom.prince, thijs
Fixes: #5852

The tlsMode attribute of twisted.mail.smtp.ESMTPClient is deprecated.



git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/trunk@37202 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb
Merge examples-react-5989-2: Use task.react in twisted.names examples

Author: rwall
Reviewer: thijs, tom.prince
Fixes: #5989

 * Updated all twisted.names example scripts to use task.react, which
   shuts down the reactor reliably and logs uncaught exceptions.

 * Tidied up the output of the twisted.names example scripts. Results
   of all scripts are now neatly printed to stdout and certain
   expected errors are printed to stderr.

 * Standardized the example script --help output

 * Examples now return non-zero exit code on certain errors

 * Added some new unit tests for the twisted.names examples - testing
   for consistent usage and error messages and for a standard shebang
   line.



git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/trunk@37209 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb