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.

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.)

Seeking a Motivated Maintainer for Twisted

The Twisted project, via the Software Freedom Conservancy, is seeking to recruit a full-time paid maintainer. We've got a fellowship proposal published on the wiki, but here are some highlights:

• You will be working on an open source project and your contributions will be consumed by companies such as Google, Canonical, Lucasfilm/Disney, Rackspace, and Justin.TV to name a few.
• We want to hire a full-time maintainer who will assist with the continued growth of the Twisted project.
• Thanks to the meticulous work of your predecessors, we have a clear view of what your average week would look like in terms of tasks and responsibilities (more below).

Desired qualifications in a maintainer:

• The ability to review code for suitability, stability, and clarity; to point out meritable work, and provide actionable feedback on how to improve the code when necessary. 
• The ability to implement features in the Twisted library. 
• A positive presence in Twisted's online community on IRC and the mailing list. 
• Have familiarity with the infrastructure of the Twisted project (including trac and buildbot). 
• Work to provide education or outreach on Twisted in other forums such as workshops, conferences, and user groups. 

We will strongly consider someone with experience maintaining other open source projects, but with just a little Twisted experience, as long as such an applicant is passionate about and committed to becoming a Twisted expert.

During an average work week, the maintainer will distribute their work along these lines:

• Code review (55%) Review code, apply patches, and set and enforce standards for code quality. Improve documentation and code test coverage. 
• Mailing list and IRC participation (10%) Encourage and participate in discussions on Twisted's mailing lists and IRC channels. 
• Bug report triage (5%) Supervise Twisted's ticket workflow to ensure that bug tickets are addressed and closed. 
• New feature development (30%) Serve as architect for the development and implementation of new features. 

Furthermore, the Maintainer will provide a forthnightly written report of their progress to the Conservancy and the Twisted community.

Information on whom to contact in the event of your interest is provided at the bottom of the page.

We look forward to hearing from you!