Path: csiph.com!usenet.pasdenom.info!weretis.net!feeder4.news.weretis.net!rt.uk.eu.org!newsfeed.xs4all.nl!newsfeed2a.news.xs4all.nl!xs4all!post.news.xs4all.nl!not-for-mail
Sender: itamar@itamarst.org
Date: Sat, 31 May 2014 16:08:35 -0400
From: Itamar Turner-Trauring <itamar@itamarst.org>
To: python-announce-list@python.org
Subject: Crochet 1.3.0 - Use Twisted Anywhere!
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit
Precedence: list
Reply-To: python-list@python.org
Approved: python-announce-list@python.org
Newsgroups: comp.lang.python.announce
Message-ID: <mailman.10544.1401695082.18130.python-announce-list@python.org>
Lines: 69
NNTP-Posting-Host: 2001:888:2000:d::a6
Xref: csiph.com comp.lang.python.announce:1290

Crochet is an MIT-licensed library that makes it easier to use Twisted 
from regular blocking code. Some use cases include:

  * Easily use Twisted from a blocking framework like Django or Flask.
  * Write a library that provides a blocking API, but uses Twisted for
    its implementation.
  * Port blocking code to Twisted more easily, by keeping a backwards
    compatibility layer.
  * Allow normal Twisted programs that use threads to interact with
    Twisted more cleanly from their threaded parts. For example this can
    be useful when using Twisted as a WSGI container.

This is a bugfix release, recommended for all users of Crochet.

Crochet can be downloaded from https://pypi.python.org/pypi/crochet or 
by running:

     $ pip install crochet

Documentation can be found at http://crochet.readthedocs.org 
<https://crochet.readthedocs.org/>

Bugs and feature requests should be filed at the project 
https://github.com/itamarst/crochet

Here’s an example of a program using Crochet. Notice that you get a 
completely blocking interface to Twisted and do not need to run the 
Twisted reactor, the event loop, yourself.

#!/usr/bin/python
"""
Do a DNS lookup using Twisted's APIs.
"""
from  __future__  import  print_function

# The Twisted code we'll be using:
from  twisted.names  import  client

from  crochet  import  setup,  wait_for
setup()


# Crochet layer, wrapping Twisted's DNS library in a blocking call.
@wait_for(timeout=5.0)
def  gethostbyname(name):
     """Lookup the IP of a given hostname.

     Unlike socket.gethostbyname() which can take an arbitrary amount of time
     to finish, this function will raise crochet.TimeoutError if more than 5
     seconds elapse without an answer being received.
     """
     d  =  client.lookupAddress(name)
     d.addCallback(lambda  result:  result[0][0].payload.dottedQuad())
     return  d


if  __name__  ==  '__main__':
     # Application code using the public API - notice it works in a normal
     # blocking manner, with no event loop visible:
     import  sys
     name  =  sys.argv[1]
     ip  =  gethostbyname(name)
     print(name,  "->",  ip)

Run on the command line:

> $ python blockingdns.py twistedmatrix.com
> twistedmatrix.com -> 66.35.39.66