Changes between Version 26 and Version 27 of GoogleSOC

03/01/2013 05:30:44 AM (7 years ago)
Itamar Turner-Trauring

delete some overly-2012 projects


  • GoogleSOC

    v26 v27  
    6666Requirements: This is probably easier to do on Linux than on Windows, so some basic familiarity with Linux, and a computer configured to use it, in addition to knowledge of Python.
    68 === Automatic Coding Standard Enforcement ===
    70 Twisted applies certain naming and style standards to all contributed code.  These are things like giving all classes and functions docstrings, documenting all parameters and instances attributes, having the correct amount of whitespace between definitions, etc.  Currently, a human reviewer needs to check all of these things and point out violations to contributors.  The development process would be sped up by a tool which can automatically make these simple, mechanical checks, freeing up human reviewer time to focus on more important aspects of proposed changes.  Integration with the issue tracker, to automatically generate this feedback before a ticket is submitted for review, would also be a big win.  For background about the Twisted development process, see [wiki:ReviewProcess].
    72 Requirements: Little Twisted-specific knowledge is necessary, but general Python knowledge, perhaps with prior parsing experience (or a willingness to learn about parsing).
    74 === Expanded Endpoints Support ===
    76 Twisted recently added two new related high-level APIs, one for specifying what address servers should listen for connections on, the other for specifying  what address a client should connect to.  These APIs are known as "endpoints", mostly implemented in [ twisted.internet.endpoints].  Only a few of the many kinds of addresses that Twisted supports have had endpoint support added to them so far.  Additionally, there are some kinds of connections which it was very awkward to set up before the invention of the endpoints APIs, so there is no convenient way to set them up at all.
    78 Some endpoints Twisted does have are for TCP (eg, when using the string syntax to create a TCP server, "tcp:port=80:interface="), SSL, and UNIX domain sockets.  Some endpoints it doesn't have, and could be easily implemented by wrapping existing code: serial ports, standard I/O. A bit more difficult, but still mostly using existing code, would be endpoints for child processes and SSH connections. SOCKS proxies would require writing additional (but fairly simple) network code. Rather trickier would be support HTTPS proxies.  Many more are possible.
    80 For this project, add a lot of new endpoint implementations to Twisted, starting the easiest and moving on the more difficult ones. Some endpoint implementations will be simple wrappers around existing APIs. Others will involve some network programming, where there was no convenient existing API to provide the functionality at all.
    82 Requirements: General Python knowledge, some networking knowledge would be helpful but that may be acquired over the course of the project.
    84 === Python 3 Preparation ===
    86 In preparation for Python 3 support, there is a lot of cleanup work that needs to be done:
    88   * Remove use of old APIs that have more modern equivalents.
    89   * Add support code for features Python 3 is missing (execfile).
    90   * Get rid of deprecated code (eligible only; see CompatibilityPolicy) that cannot easily be ported.
    92 A partial list can be found here:
    94 There's also additional development to be done, e.g. the FilePath path management library should probably get Unicode support in Python 2, so that it's easier to write code that works in both Python 2 and 3.
    96 The goal is *not* to port Twisted to Python 3, but rather to make it easier to support Twisted on Python 3 later on.
    98 Requirements: Good knowledge of Python 2, and ideally the differences with Python 3.
    10068=== Other Tasks, Some of which Google may not like, but some of which may be workable ===