Twisted 13.2.0 Released

On behalf of Twisted Matrix Laboratories, I am honoured to announce the release of Twisted 13.2!

The highlights of this release are:

• Twisted now includes a HostnameEndpoint implementation which uses IPv4 and IPv6 in parallel, speeding up the connection by using whichever connects first (the 'Happy Eyeballs'/RFC 6555 algorithm). (#4859)
• Improved support for Cancellable Deferreds by kaizhang, our GSoC student. (#4320, #6532, #6572, #6639)
• Improved Twisted.Mail documentation by shira, our Outreach Program for Women intern. (#6649, #6652)
• twistd now waits for the application to start successfully before exiting after daemonization. (#823)
• SSL server endpoint string descriptions now support the specification of chain certificates. (#6499)
• Over 70 closed tickets since 13.1.0.

For more information, check the NEWS file.

You can find the downloads on PyPi (or alternatively the Twisted Matrix Downloads page).

Many thanks to everyone who had a part in this release - the supporters of the Twisted Software Foundation, the developers who contributed code as well as documentation, and all the people building great things with Twisted!

Announcing code.twistedmatrix.com

I'm please to announce that there is a new git mirror hosted on twistedmatrix.com infrastructure.

git clone https://code.twistedmatrix.com/git/Twisted

or

https://git.twistedmatrix.com/Twisted

For those that prefer bzr, the bzr mirror is also available as

bzr branch https://code.twistedmatrix.com/bzr/Twisted/trunk Twisted

The build bots are now using these mirrors for checking out code.

July Report

This will be my last report, until the beginning of September. I have, for many years, been a volunteer at the Edmonton Folk Music Festival. For the next month, I will be busy setting it up (and then taking it down, and so will not have time to devote to twisted.

This month, 23 tickets got some attention that they would not have received without the sponsored development. The result was 5 closed tickets and 11 other tickets unblocked for other developers to resume work on.

This month, I made a number of improvements to the buildobt:

• Switched most of the buildslaves to use git to checkout the source.
• All the git-using builders merge to trunk, before running tests, so the tests results reflect the code as it would be merged. In particular, all the lint steps should now accurately report only the regressions relative to current trunk of the merged result.
• I added a bunch of new builders on VMs provided by Rackspace (thanks to Jesse Noller) and the Fedora Project (thanks to Seth Vidal). These cover all recent versions of Debian, Fedora, Ubuntu and RHEL. As part of this, I automated the deployment of buildslaves, (currently only Debian and Fedora derivatives are supported).

This work is made possible by the sponsorship of individuals and organizations which have donated to the Twisted project, part of the Software Freedom Conservancy, a not-for-profit organization that helps promote, improve, and develop open source software. Thanks!

The tickets I reviewed, that have now been closed:

• #5574: Add support for SOCK_DGRAM to IReactorSocket
• #6221: Replace Deprecated Test Case Assertion Methods in twisted.internet
• #6393: Utility function to pretty-format list of things
• #6475: FileAuthority._lookup incorrectly returns AuthoritativeDomainError for non-subdomain names which happen to share the same suffix as the zone (eg the-example.com and example.com)
• #6572: twisted.mail.smtp.sendmail should return a cancellable Deferred

Other tickets I have reviewed:

• #2699: UDP DatagramProtocol reconnecting
• #3926: twisted.positioning – a better positioning framework
• #4173: WebSocket server support
• #4735: Implement something like ReconnectingClientFactory for endpoints
• #5001: replace call to functions from the string module in twisted.scripts.tap2deb
• #5004: replace call to functions from the string module in web
• #5685: SMTP Client Tutorial should be self-contained
• #6556: LineReceiver rejects lines of length MAX_LENGTH sometimes
• #6557: LineOnlyReceiver doesn't disconnect the transport when it detects an overlarge line
• #6558: LineOnlyReceiver doesn't pass the entire contents of its buffer to lineLengthExceeded()
• #6580: twisted.names.server.DNSServerFactory should query child zones before parent zones

Tickets I have worked on:

• #5513: Detailed documentation on Proxy by adding docstrings to many of the methods.
• #6537: Update coding-standard to reflect that documentation should be sentence per line.
• #6620: Document conventions for writting test assertions.
• #6626: Remove all uses of deferredGenerator.

Introducing our new Google Summer of Code and Outreach Program for Women interns

This year as part of the Outreach Program for Women and Google Summer of Code we have three summer interns working on Twisted. We are pleased to welcome them to our development community:

Stacey Sern ("shira" on IRC) is from New Jersey, USA. She is returning to programming after a ten year hiatus to take care of her family. Previously, she developed real-time embedded software in C and C++ in the telecom industry. This past winter, she participated in Hacker School where she used Twisted for a BitTorrent client and submitted her first Twisted patches. Stacey will be working on supporting Twisted's mail infrastructure.

Kai Zhang ("kaizhang" on IRC) is 24 years old graduate student from China who likes playing soccer. Kai is working on Deferred cancellation, implementing the API for all the various sources of Deferreds in Twisted.

Shiyao Ma ("introom" on IRC) is a senior student of Tsinghua University, P.R.C.. Shiyao will continue on to a PhD program in Hong Kong UST this September, doing research on wireless sensor network. Shiyao's hobbies range from programming to Japanese animation. This summer Shiyao will be working on integrating Twisted with the Parsley parser-generator, and any necessary improvements to Parsley.

June End-month report

I spent the majority of my time in the last half of the month, clearing the review queue, from 45 tickets when I started to a low of 19 tickets. All told, 34 tickets got some attention that they would not have received without the sponsored development. The result was 9 closed tickets and 22 other tickets unblocked for other developers to resume work on.

This work is made possible by the sponsorship of individuals and organizations which have donated to the Twisted project, part of the Software Freedom Conservancy, a not-for-profit organization that helps promote, improve, and develop open source software. Thanks!

The tickets I reviewed, that have now been closed:

• #5329: Replace deprecated string functions with str methods in t.w.p.irc
• #5894: ckeygen –changepass truncates private keys to zero bytes
• #5992: twistd dns without any options crashes when it is queried
• #5780: words: Unbound variable nickname in IRCUser for invalid user name
• #6217: iocpreactor events do not occur at the time they should
• #6220: Replace Deprecated Assertion Methods in twisted.conch
• #6328: twisted.names.client lookup functions duplicate or reference the documentation of `IResolver`
• #6499: Teach chain certificates to SSL server endpoints string syntax
• #6544: Replace usage of twisted.python.text in twisted.words

Other tickets I have reviewed:

• #2835: _pollingfile calls pauseProducing on registered Pull producers
• #2839: _pollingfile fails to call stopProducing when connection is lost
• #4353: Automate uploading pre-release tarballs
• #5001: replace call to functions from the string module in twisted.scripts.tap2deb
• #5004: replace call to functions from the string module in web
• #5387: Get rid of references and code specific to Python 2.4
• #5562: iocp reactor fails to support PB & AMP
• #5574: Add support for SOCK_DGRAM to IReactorSocket
• #5685: SMTP Client Tutorial should be self-contained
• #5795: Failure's startDebugMode should allow using a debugger other than pdb
• #6164: Returning an already-chained deferred breaks the callback chain
• #6357: LineReceiver uses O(n**2) complexity
• #6475: FileAuthority._lookup incorrectly returns AuthoritativeDomainError for non-subdomain names which happen to share the same suffix as the zone (eg the-example.com and example.com)
• #6491: test_pollingfile: producer data wrongly dropped when loseConnection() requested
• #6492: test_pollingfile: bufferEmpty sets producerPaused attribute on the producer instead of on itself
• #6493: test_pollingfile: writeSequence() doesn't pause the producer when outgoing buffer is full
• #6523: Constants HOWTO doesn’t document that constants are ordered.
• #6542: Use of map where the result is unused.
• #6543: Replace usage of twisted.python.text in twisted.conch
• #6545: Replace usage of twisted.python.text in twisted.mail
• #6546: Replace usage of twisted.python.text in twisted.lore
• #6547: Class mail.pb.MaildirBroker apparently broken and obsolete

Tickets I have worked on:

• #6301: There should be some clear documentation on how to document tests.
• #6595: twisted should provide a paste entry point, so that it can be used as a wsgi container by `paster serve`.
• #6596: twisted.application.reactors.installReactor should return the installed reactor.
• #6587: Remove out-of-place refernce to lore and howtos from coding-standard doc.

June Mid-month report

During the first half of the month, 24 tickets got some attention that they would not have received without the sponsored development. The result was 2 closed tickets and 22 other tickets unblocked for other developers to resume work on.

Also, as mentioned before, I've released a collection of tools for helping with twisted development on github and pypi.

This work is made possible by the sponsorship of individuals and organizations which have donated to the Twisted project, part of the Software Freedom Conservancy, a not-for-profit organization that helps promote, improve, and develop open source software. Thanks!

The tickets I reviewed, that have now been closed:

• #1518: trial option to exit on failure
• #5435: twisted.web.client.RedirectAgent doesn't inform caller of final URI

Other tickets I have reviewed:

• #1601: t.py.text.greedyWrap makes t.py.usage.Options.longdesc ugly
• #2835: _pollingfile calls pauseProducing on registered Pull producers
• #2839: _pollingfile fails to call stopProducing when connection is lost
• #3926: twisted.positioning – a better positioning framework
• #4929: Add LIST to IRCClient
• #5365: _pollingfile makes wrong assumption about WriteFile
• #5574: Add support for SOCK_DGRAM to IReactorSocket
• #5668: Support the OPT pseudo-record
• #5894: ckeygen –changepass truncates private keys to zero bytes
• #6064: Write tests for `twisted.internet.protocol.FileWrapper`
• #6116: twisted.web.http.stringToDatetime has incomplete test coverage
• #6135: twisted.web.http.HTTPFactory is incompletely tested
• #6137: Add unit tests for twisted.python.dist.getAllScripts
• #6217: iocpreactor events do not occur at the time they should
• #6393: Utility function to pretty-format list of things
• #6401: twisted.web.test.requesthelper.DummyChannel.TCP does not have the unregisterProducer method.
• #6475: twistd dns returns NXDomain for valid records when multiple zone names share a common suffix or parent domain
• #6484: Add unit tests for twisted.python.dist.get_setup_args
• #6491: test_pollingfile: producer data wrongly dropped when loseConnection() requested
• #6492: test_pollingfile: bufferEmpty sets producerPaused attribute on the producer instead of on itself
• #6493: test_pollingfile: writeSequence() doesn't pause the producer when outgoing buffer is full
• #6499: Teach chain certificates to SSL server endpoints string syntax

Announcing twisted-dev-tools

I'd like to announce the release of twisted-dev-tools. It is a project that collects various python scripts useful for developer working on twisted itself.

Right now, it contains the following tools.

force-build:

This is an updated version of force-builds.py from twisted-trac-integration. It has a different (more flexible) syntax.

If run from a git repository, where the current commit has been pushed to svn, running it with no arguments will automatically build the corresponding branch.

mkbranch

A helper for those using git: it creates a branch in svn, with a standard commit message.

Eventually, this should be enhanced to automatically fetch that commit, and switch to the branch locally.

review-tickets

Command-line list of tickets currently in review

fetch-ticket:

Command-line tool to view a ticket

get-attachemnt

Tool for interacting with trac attachments.

list

list all attachments on a given ticket

get

gets a gien ticket (defaults to the lat)

apply

applies that last attachment to the current git repository, and commits it with an appropriate message

Most of the functionality is also exposed as a python library, so custom scripts are possible as well.

The code is available at https://github.com/twisted/twisted-dev-tools and on pypi https://pypi.python.org/pypi/twisted-dev-tools

May end-of-month report

The migration to the new machine has been successfully completed, and reports are, that trac is much faster now. Special thanks to Jonathan Stoppani, whose help was invaluable in preparing for the migration.

Since the migration, I've returned to doing ticket review, 11 tickets got some attention that they would not have received without the sponsored development. The result was 2 closed tickets and 9 other tickets unblocked for other developers to resume work on.

This work is made possible by the sponsorship of individuals and organizations which have donated to the Twisted project, part of the Software Freedom Conservancy, a not-for-profit organization that helps promote, improve, and develop open source software. Thanks!

The tickets I reviewed, that have now been closed:

• #6443: setuid should be called in the child after forking the process in spawnProcess
• #6525: Constant docs have a mistake in an example

Other tickets I have reviewed:

• #3926: twisted.positioning – a better positioning framework
• #5387: Get rid of references and code specific to Python 2.4
• #5434: Web browser-like redirection Agent for twisted.web.client
• #5787: trial –order for selecting an order for running test cases
• #5795: Failure's startDebugMode should allow using a debugger other than pdb
• #5962: Clock.callLater(0, f) can lead to infinite loop
• #6042: twisted.protocols.test.test_basic doesn't following coding standard
• #6071: t.i.task.react's docstring doesn't mention the reactor argument
• #6166: Deprecate pickling support (__getstate__ and __setstate__) in twisted.internet._sslverfiy

Migration Report

I have completed the migration scripts for deploying the services currently running on cube. They have been run against our new machine, dornkirk which is currently running with a snapshot of data.

It can currently be accessed by putting

66.35.39.66     twistedmatrix.com speed.twistedmatrix.com

in /etc/hosts. Please tests it, and verify that things appear to be working, but be aware that any changes will be lost, when the transition occurs.

At some point Monday or Tuesday, there will be some downtime for mail and the mailing lists, as mail-service is migrated to the new machine. For those that have accounts on cube, your data will be copied to the new machine at this point.

On Wednesday, at about 10 MDT (16 UTC), there will be downtime of all twisted services, as live data is transfered over. This may last up-to a couple of hours.

This work is made possible by the sponsorship of individuals and organizations which have donated to the Twisted project, part of the Software Freedom Conservancy, a not-for-profit organization that helps promote, improve, and develop open source software. Thanks!

April end-month report

During the second half of the month, I have concentrated on the continuing development tools to automate the deployment of twisted infrastructure.

I've also spent some time developing some command-line tools for interacting with trac. It currently support view tickets, listing review tickets, and grabbing attachments (including applying them in git with an appropriate commit message). I plan to add support for doing reviews, as well.

This work is made possible by the sponsorship of individuals and organizations which have donated to the Twisted project, part of the Software Freedom Conservancy, a not-for-profit organization that helps promote, improve, and develop open source software. Thanks!

April mid-month Fellowship report

During the first half of the month, 43 tickets got some attention that they would not have received without the sponsored development. The result was 17 closed tickets and 24 other tickets unblocked for other developers to resume work on.

I set up an official git mirror that contains all the branches, including release branches and tags on github and documented my workflow on the wiki.

I've documened how our current infrastructure (cube), and with the help of Jonathan Stoppani, I've been working on scripts to automate the deployment of its successor (dornkirk).

This work is made possible by the sponsorship of individuals and organizations which have donated to the Twisted project, part of the Software Freedom Conservancy, a not-for-profit organization that helps promote, improve, and develop open source software. Thanks!

The tickets I reviewed, that have now been closed:

• #3844 (Parse mIRC format codes)
• #4696 (client endpoint: process)
• #5386 (Get rid of references and code specific to Python 2.3)
• #5411 (ftp_NLST and ftp_LIST should only send data as "str")
• #5952 (Improve docstring for test_notTrapped in twisted.test.test_failure)
• #5955 (Move inlineCallbacks test from twisted.test.test_failure to somewhere better (test_defer?))
• #5989 (Standardize twisted names examples to use task.react)
• #6120 (twisted.web.http.Request.__repr__ is untested)
• #6240 (Merge `twisted/internet/_utilspy3.py` into `twisted/internet/utils.py`)
• #6284 (FTP.ftp_STOR() should handle IsADirectoryError error)
• #6350: Add a few unittest2 assertions to TestCase
• #6391 (Improve the format of http.Request.__repr__ to include eg class and object identity)
• #6392: Typo in test_irc
• #6400 (trial.test.test_directoryNotPackage is incorrect)
• #6405 (os.geteuid and os.getegid are called unnecessarily in SSHPublicKeyDatabase.checkKey)
• #6430 (test_loader.FileTest.test_filenameNotPython should create its test data)
• #6439 (Spelling mistakes in pb-intro.xhtml)

Other tickets I have reviewed:

• #2061: _sslverify.py: Wrong use of param caCerts in OpenSSLCertificateOptions
• #3701: Add a checker for ISSHPrivateKey which parameterizes the location of the keys
• #4891: twisted.web.http does not throttle pipelined requests
• #5228: twisted.test.test_paths.FilePathTestCase.test_getPermissions_Windows creates undeleteable file
• #5270: Add API to endpoints for connecting a protocol instance
• #5329: Replace deprecated string functions with str methods in t.w.p.irc
• #5435: twisted.web.client.RedirectAgent doesn't inform caller of final URI
• #5531: Add anonymous support to Conch SSHFactory
• #5532: AMP Command specification format
• #5787: trial –order for selecting an order for running test cases
• #5795: Failure's startDebugMode should allow using a debugger other than pdb
• #585: Include sendfile(2) support into defaultreactor
• #5951: Documentation for the best way to get a reference to a reactor reads as contradictory
• #6115: twisted.web.http.parseContentRange has no unit tests
• #6119: twisted.web.http.Request.parseCookies has incomplete test coverage
• #6166: Deprecate pickling support (__getstate__ and __setstate__) in twisted.internet._sslverfiy
• #6341: Replace usage of twisted.python.text and deprecate it
• #6342: Deprecate twisted.python.hashlib
• #6390: Using trial -j can result in wrong paths in sys.path
• #6393: Utility function to pretty-format list of things
• #6395: Delete twisted.words.protocols.msn
• #6402: twisted.words setup metadata is not up to date anymore
• #6426: test_mail.py failure
• #6437: twisted.trial.unittest.TestCase.flushWarnings may fail if run without .py files (with only .pyc or .pyo files)

Other tickets I have worked on:

• #6251 (Add a helper function for getting the body of an HTTP request.)
• #6348 (trial doesn't show `DeprecationWarnings` by default on 2.7)

Join Twisted for Google Summer of Code and the Outreach Program for Women

Twisted is once again participating in Google's Summer of Code this year, as well as the GNOME Outreach Program for Women. If you're a student interested in working on Twisted as part of a paid internship, please visit our Google SoC page. We use best practices like in-depth code reviews and full coverage unit tests, so this is a great way to improve your technical skills whether you're a beginner or an expert programmer.

In addition, Twisted is once again participating the GNOME Outreach Program for Women, with the generous support of Mozilla, providing a paid internship for one woman to spend the summer participating in and contributing to Twisted. Unlike Google's program, the outreach program is not restricted to students; if you qualify, we do encourage you to apply to both. This internship is appropriate for any level of open source experience.

If you have worked on an open source project before, great! If not, we'll help you learn the development and communication tools we use as part of the internship. Some Python experience is a prerequisite, and a small initial contribution to Twisted is a part of applying (if this sounds intimidating, don't worry, we'll help you pick a task to complete and you'll have lots of support as you work through submitting your first patch.) Please check out the full OPW and GSoC descriptions and apply today!

Twisted 13.0.0 released

On behalf of Twisted Matrix Laboratories, I am pleased to announce the release of Twisted 13.0.

Among the 70 tickets closed, we can see:

• A new Introduction to Deferreds  document.
• A fix in twisted.web.template where attributes were not quoted properly, risking HTML injection. 
• Support for unicode domain names in twisted.names SRVConnector and Name classes, after a 12.3 regression
• A workaround for platform limitations when trying to schedule events far in the future.

For more information, see the NEWS file here: NEWS.txt

Download it now from Twisted-13.0.0.tar.bz2 or Twisted-13.0.0.win32-py2.7.msi

Thanks to the supporters of Twisted via the Software Freedom Conservancy and to the many contributors for this release.

Report the Third

During the past three weeks, 23 tickets got some attention that they would not have received without the sponsored development. The result was 9 closed tickets and 8 other tickets unblocked for other developers to resume work on.

I also spent some time working on getting newly donated slaves setup, as well as documenting the setup of the main twistedmatrix.com server, in preparation for automating the redeployment of services to new hardware.

This work is made possible by the sponsorship of individuals and organizations which have donated to the Twisted project, part of the Software Freedom Conservancy, a not-for-profit organization that helps promote, improve, and develop open source software. Thanks!

The tickets I reviewed, that have now been closed:

• #1333: Survey existing FTP servers and clients to figure out how LIST works
• #3908: Code using twisted.names.client.Resolver is hard to unit test
• #6240: Merge `twisted/internet/_utilspy3.py` into `twisted/internet/utils.py`
• #6337: OpenSSLCertificateOptions doesn’t disallow SSLv2
• #6354: Main NEWS file is not generated properly anymore
• #6377: print traceback in successResultOf error reporting
• #6380: Add optional expected exception types to failureResultOf
• #6392: Typo in test_irc

Other tickets I have reviewed:

• #5126: Add http cache support to Agent
• #5270: Add API to endpoints for connecting a protocol instance
• #5386: Get rid of references and code specific to Python 2.3
• #5411: ftp_NLST and ftp_LIST should only send data as "str"
• #5955: Move inlineCallbacks test from twisted.test.test_failure to somewhere better (test_defer?)
• #6286: SSL server endpoints string syntax results in creation of DefaultOpenSSLContextFactory
• #6341: Replace usage of twisted.python.text and deprecate it
• #6350: Add a few unittest2 assertions to TestCase

Tickets I have closed:

• #6316: Minor cleanup of pam tests in `twisted.test.test_newcred`.

Other tickets I have worked on:

• #1009: Document inlineCallbacks
• #6251: Add a helper function for getting the body of an HTTP request.
• #6284: FTP.ftp_STOR() should handle IsADirectoryError error
• #6286: SSL server endpoints string syntax results in creation of DefaultOpenSSLContextFactory
• #6363: Make twisted.trial.unittest._iterateTests public.

Second Fellowship Report

I've completed my second two weeks of development. I again spent a large amount of my time reviewing tickets. In addition, I did some development work, as well as buildbot improvements.

All told, 42 tickets got some attention that they would not have received without the sponsored development. The result was 23 closed tickets and 14 other tickets unblocked for other developers to resume work on.

Buildbot improvements

• Added a pyflakes builder.
• Improved lint-like builders to only show new warnings/errors introduced in the branch, rather than relative to the tip of trunk
• Added a form to the build results page to allow switching branches and forcing builds.
• Added an easy way to look at the history of the unsupported builders.
• Removed links to some useless views.

This work is made possible by the sponsorship of individuals and organizations which have donated to the Twisted project, part of the Software Freedom Conservancy, a not-for-profit organization that helps promote, improve, and develop open source software. Thanks!

The tickets I reviewed, that have now been closed:

• #1333 (Survey existing FTP servers and clients to figure out how LIST works)
• #4685 (IResolver doesn't document its argument types or return values)
• #5797 (constants cannot be attributes of another class)
• #5852 (Deprecating tlsMode)
• #5918 (t.p.b.StatefulStringProtocol has undocumented .state instance attribute)
• #5953 (Split up and improve a couple of printing tests for twisted.python.failure)
• #5989 (Standardize twisted names examples to use task.react)
• #6218 (AbstractMaildirDomain implements IAliasableDomain but doesn't advertise that fact.)
• #6256 (Long-lived KnownHostsFile instance will clobber changes made by others if its `save` method is used)
• #6259 (epoll reactor continually errors when given a delayed call with an excessive timeout)
• #6297 (Remove usage of twisted.python.compat.set and frozenset)
• #6322 (Missing tests for NotImplementedError in t.protocols.basic)
• #6332 (fake twisted.trial._dist.test.test_workertrial.MainTestCase.fdopen returns None sometimes)
• #6338 (IResolver docstrings contain broken references)
• #6349 (MemoryReactor incompletely implements IReactorSocket)
• #6337 (OpenSSLCertificateOptions doesn’t disallow SSLv2)
• #6354 (Main NEWS file is not generated properly anymore)

Other tickets I have reviewed:

• #84 (We need tests for example code)
• #585 (Include sendfile(2) support into defaultreactor)
• #4859 (client endpoint: super-smart name-based TCP connection algorithm)
• #5386 (Get rid of references and code specific to Python 2.3)
• #5411 (ftp_NLST and ftp_LIST should only send data as "str")
• #5513 (Detailed documentation on Proxy by adding docstrings to many of the methods.)
• #5952 (Improve docstring for test_notTrapped in twisted.test.test_failure)
• #5955 (Move inlineCallbacks test from twisted.test.test_failure to somewhere better (test_defer?))
• #6220 (Replace Deprecated Assertion Methods in twisted.conch)
• #6240 (Merge `twisted/internet/<sub>utilspy3</sub>.py` into `twisted/internet/utils.py`)
• #6286 (SSL server endpoints string syntax results in creation of DefaultOpenSSLContextFactory)

Tickets I have closed:

• #6290 (TimerService.stopService should wait for a running call to finish.)
• #6323 (twisted.python.test.test_reflect emits DeprecationWarning)
• #6324 (twisted/python/test/test_util.py emits DeprecationWarning)
• #6326 (web/test_template emits DeprecationWarning)

Other tickets I have worked on:

• #601 (ThrottlingFactory doesn't throttle static web resource)
  • #6339 (Make twisted.protocol.tls._PullToPush public.)
• #3231 (twisted.trial.test.test_testvisitor emits deprecation warnings)
• #5513 (Detailed documentation on Proxy by adding docstrings to many of the methods.)
• #5921 (Trial fails flushing reporter stream with ENOSPC on Windows)
• #6291 (SyncTestCase.assertNoResult should not eat any eventual result.)
• #6314 (There are failing tests with tip of python 2.7 branch)
• #6333 (Deprecate DryRunVisitor.)

Welcome our new Twisted Fellow: Tom Prince

Twisted is an open, community-based project that aims for the highest quality and technical standards. As a community-based open source project, Twisted is for the most part run by volunteers, with code contributed by users and developers. As part of our ongoing goal to produce reliable, maintainable software we have strict requirements for coding standards, unit testing and code reviews. Unfortunately, sometimes these goals work at cross purposes. For example, code reviews have become a bottleneck for our development process; they're hard thankless work. There's a reason they'll get you the most points in our high scores.

The Twisted Maintainer Fellowship is our attempt to bridge these two goals: to remove bottlenecks and get necessary work done, thus enabling more contributions from the community. By paying for the Fellow's efforts we can ensure an ongoing focus on the maintenance needs of Twisted, most importantly code reviews.

I am happy to announce that we have signed a contract with Tom Prince to be our new Fellow. Tom Prince is a core developer of Buildbot, who became a Twisted contributor last year via his involvement with the Buildbot project. As a result, he has been maintaining Twisted's buildbot deployment on a volunteer basis for the last eight months.  He also maintains the buildbots of other open source projects.

As you can see from the progress report below, Tom is already hard at work! I encourage you to donate to Twisted via the Software Freedom Conservancy (a 501(c)3 non-profit). By paying for Tom's time you can help support our efforts to maintain and improve Twisted.

---

Tom Prince's First Progress Report

I'm pleased to announce that I have been accepted as a Twisted fellow and full-time maintainer for 2013. I've completed my first two weeks of development. I spent the majority of my time clearing the review queue, from 32 tickets when I started to a low of 4 tickets.

All told, 42 tickets got some attention that they would not have received without the sponsored development. The result was 10 closed tickets and 29 other tickets unblocked for other developers to resume work on.

This work is made possible by the sponsorship of individuals and organizations which have donated to the Twisted project, part of the Software Freedom Conservancy, a not-for-profit organization that helps promote, improve, and develop open source software. Thanks!

The tickets I reviewed, that have now been closed:

• #2915 (Provide way of incrementing patch number with date-based versioning)
• #5601 (Add a howto for "Deploying Twisted with SystemD")
• #5925 (Deprecate twisted.python.runtime.Platform.isWinNT)
• #5937 (Check current Cooperator status)
• #6026 (MultiService.stopService doesn't handle failures in startService)
• #6208 (Admin scripts don't tweak sys.path)
• #6265 (SafeRepr.test_brokenReprIncludesID)
• #6282 (Trial tracebacks are not properly trimmed since 12.3.0)
• #6288 (OpenSSLCertificateOptions contains asserts)
• #6309 (getProcessOutput doc string should use proper epydoc instead of *this*)

Other tickets I have reviewed:

• #585 (Include sendfile(2) support into defaultreactor)
• #2611 (Protocols in twisted.protocols.basic use O(n**2) complexity)
• #4151 (Remove deprecated IDomain.startMessage)
• #4152 (Remove deprecated DomainSMTP and DomainESMTP)
• #4173 (WebSocket server support)
• #4398 (PBServerFactory should support plain password credentials)
• #4623 (Missing interface IQueue)
• #4685 (IResolver doesn't document its argument types or return values)
• #4696 (client endpoint: process)
• #4847 (Improve integration of SerialPort (via an endpoint))
• #5270 (Add API to endpoints for connecting a protocol instance)
• #5386 (Get rid of references and code specific to Python 2.3)
• #5411 (ftp_NLST and ftp_LIST should only send data as "str")
• #5787 (trial –order for selecting an order for running test cases)
• #5797 (constants cannot be attributes of another class)
• #5852 (Deprecating tlsMode)
• #5864 (Remove a sha1 import from < 2.5)
• #5953 (Split up and improve a couple of printing tests for twisted.python.failure)
• #5981 (Clean up twisted.python.threadpool implementation using context managers)
• #5989 (Standardize twisted names examples to use task.react)
• #6042 (twisted.protocols.test.test_basic doesn't following coding standard)
• #6118 (twisted.web.http.Request.noLongerQueued has no test coverage)
• #6120 (twisted.web.http.Request.__repr__ is untested)
• #6165 (Docstring for twisted.trial.unittest.SynchronousTestCase.mktemp not informative enough)
• #6249 (twisted.mail.pop3client.__all__ should be empty, so API docs list those objects in correct module)
• #6256 (Long-lived KnownHostsFile instance will clobber changes made by others if its `save` method is used)
• #6259 (epoll reactor continually errors when given a delayed call with an excessive timeout)
• #6284 (FTP.ftp_STOR() should handle IsADirectoryError error)
• #6302 (FlagConstant objects should be iterable)

Other tickets I have worked on:

• #6290 (TimerService.stopService should wait for a running call to finish.)
• #6314 (There are failing tests with tip of python 2.7 branch)
• #6044 (Deprecate `deferredGenerator')
  • #6315 (twisted/words/test/test_service.py uses `deferredGenerator`)

Twisted, Python 3, and You

As we described in our last announcement, Twisted 12.3.0 contains partial support for Python 3.3.  But what exactly does "partial support" mean?  Unfortunately, It doesn't mean that Twisted is ready for you to use on Python 3, unless all you need is the core reactor functionality.

What it really means is that it's time for you, Twisted users who care about Python 3, to contribute patches that port specific modules to Python 3.  Our development infrastructure is now set up to efficiently deal with such patches, and to keep modules working once they're ported.

• We have a buildbot set up to run a subset of the tests on Python 3.
• There is a list of supported modules that can be updated as new modules are ported, to ensure they keep working.  Most of the modules which are particularly tricky have now been ported, so contributors should now just need to do the tedious work of examining each module for small things that need to be addressed.
• There's a tool that the buildbot runs, which all Twisted developers (including you) can run to verify that everything is working properly on 3.x if you have a functioning local Python 3.3 installation.  (This tool is an interim step until Trial itself is fully ported to 3.x.)
• There's a milestone you can look at containing a list of tasks for python 3.x, although this list is not exhaustive.  If you come up with some work that needs to be done to port a module to python 3, put the ticket in that milestone.

So, if you're interested in using Twisted for a project that runs on Python 3, it should be pretty quick to port the functionality you need and submit a patch.