~canonical-livepatch-dependencies/canonical-livepatch-service-dependencies/twisted

« back to all changes in this revision

Viewing changes to docs/core/examples/threadedselect/README

  • Committer: Free Ekanayaka
  • Date: 2016-07-01 12:22:33 UTC
  • Revision ID: free.ekanayaka@canonical.com-20160701122233-nh55w514zwzoz1ip
Tags: upstream-16.2.0
ImportĀ upstreamĀ versionĀ 16.2.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
The examples in this directory import a private module from the
 
2
twisted.internet package.  The _threadedselect module provides an object
 
3
which is similar to a Twisted reactor in many ways, but which is not
 
4
actually intended to be used in the same way as a Twisted reactor (it has a
 
5
method named interleave which is intended to be the main entrypoint).  This
 
6
functionality should be considered highly experimental and the API subject
 
7
to change at any time.
 
8
 
 
9
Possibly the best way to make use of this functionality is to use it to
 
10
implement an object which actually presents the Twisted reactor interface
 
11
(specifically, an object with a run method).  That object can then be used
 
12
by application-code in the usual way.
 
13
 
 
14
Another course of action is to avoid _threadedselect entirely until the
 
15
issues surrounding it have been resolved.