Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > comp.lang.python > #26802

Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs

Path csiph.com!v102.xanadu-bbs.net!xanadu-bbs.net!news.mixmin.net!eweka.nl!hq-usenetpeers.eweka.nl!xlned.com!feeder1.xlned.com!newsfeed.xs4all.nl!newsfeed5.news.xs4all.nl!xs4all!post.news.xs4all.nl!not-for-mail
Return-Path <python-python-list@m.gmane.org>
X-Original-To python-list@python.org
Delivered-To python-list@mail.python.org
X-Spam-Status OK 0.000
X-Spam-Evidence '*H*': 1.00; '*S*': 0.00; 'skip:[ 20': 0.03; 'method.': 0.05; 'socket': 0.05; 'attributes': 0.07; 'method,': 0.07; 'handlers': 0.09; 'received:80.91': 0.09; 'received:80.91.229': 0.09; 'received:gmane.org': 0.09; 'received:list': 0.09; 'subclasses': 0.09; 'terry': 0.09; 'aug': 0.13; 'library': 0.15; '"file-like"': 0.16; 'eclipse': 0.16; 'message-id:@dough.gmane.org': 0.16; 'node.': 0.16; 'received:80.91.229.3': 0.16; 'received:plane.gmane.org': 0.16; 'reedy': 0.16; 'socketserver': 0.16; 'subject: \n ': 0.16; 'wrote:': 0.17; 'documented': 0.17; 'thu,': 0.17; 'examples': 0.18; 'jan': 0.18; 'bit': 0.21; 'doc': 0.22; 'explicit': 0.22; 'operations.': 0.22; 'chapter': 0.23; 'class.': 0.23; 'second': 0.24; 'url:bugs': 0.24; 'header:In-Reply-To:1': 0.25; 'header :User-Agent:1': 0.26; 'core': 0.27; 'header:X-Complaints-To:1': 0.28; 'actual': 0.28; '+0100,': 0.29; 'base,': 0.29; 'covered': 0.29; 'objects': 0.29; 'class': 0.29; 'classes': 0.30; 'connection': 0.30; 'performing': 0.30; 'url:python': 0.32; 'skip:s 30': 0.33; 'cases,': 0.33; 'handle': 0.33; 'to:addr :python-list': 0.33; 'operations': 0.33; "can't": 0.34; 'pm,': 0.35; 'there': 0.35; 'received:org': 0.36; 'but': 0.36; 'url:org': 0.36; 'method': 0.36; 'far': 0.37; 'subject:: ': 0.38; 'instead': 0.39; 'to:addr:python.org': 0.39; 'skip:" 10': 0.40; 'header:Received:5': 0.40; 'think': 0.40; 'improved': 0.62; 'within': 0.64; 'explorer': 0.65; 'received:fios.verizon.net': 0.84; 'dennis': 0.91; 'kat': 0.91; 'navigate': 0.91
X-Injected-Via-Gmane http://gmane.org/
To python-list@python.org
From Terry Reedy <tjreedy@udel.edu>
Subject Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs
Date Thu, 09 Aug 2012 15:45:56 -0400
References <34WdnQ8_38yFSb7NnZ2dnUVZ8qCdnZ2d@bt.com> <1os7281s5ad5e10f5v3tku0j7g9hjnsbuu@invalid.netcom.com>
Mime-Version 1.0
Content-Type text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding 7bit
X-Gmane-NNTP-Posting-Host pool-173-75-251-66.phlapa.fios.verizon.net
User-Agent Mozilla/5.0 (Windows NT 6.1; WOW64; rv:14.0) Gecko/20120713 Thunderbird/14.0
In-Reply-To <1os7281s5ad5e10f5v3tku0j7g9hjnsbuu@invalid.netcom.com>
X-BeenThere python-list@python.org
X-Mailman-Version 2.1.12
Precedence list
List-Id General discussion list for the Python programming language <python-list.python.org>
List-Unsubscribe <http://mail.python.org/mailman/options/python-list>, <mailto:python-list-request@python.org?subject=unsubscribe>
List-Archive <http://mail.python.org/pipermail/python-list>
List-Post <mailto:python-list@python.org>
List-Help <mailto:python-list-request@python.org?subject=help>
List-Subscribe <http://mail.python.org/mailman/listinfo/python-list>, <mailto:python-list-request@python.org?subject=subscribe>
Newsgroups comp.lang.python
Message-ID <mailman.3108.1344541591.4697.python-list@python.org> (permalink)
Lines 43
NNTP-Posting-Host 2001:888:2000:d::a6
X-Trace 1344541591 news.xs4all.nl 6877 [2001:888:2000:d::a6]:39286
X-Complaints-To abuse@xs4all.nl
Xref csiph.com comp.lang.python:26802

Show key headers only | View raw

On 8/9/2012 1:39 PM, Dennis Lee Bieber wrote:
> On Thu, 09 Aug 2012 16:15:33 +0100, lipska the kat
> <lipskathekat@yahoo.co.uk> declaimed the following in
> gmane.comp.python.general:
>
>
>> in the examples in this chapter we see usage examples for
>> socketserver.BaseRequestHandler
>>
> 	 So far as I can tell, all RequestHandler objects are covered in
> section "20.19.3 RequestHandler Objects"
>
>>
>> In Eclipse I have the entire standard library mounted on an explorer
>> node. When I find socketserver.py I can navigate to the
>> BaseRequestHandler and StreamRequestHandler classes
>> but I can't find the (documented) class [socketserver].RequestHandler
>> class in socketserver.py nor can I find any explicit documentation for
>> the classes socketserver.StreamRequestHandler
>> and socketserver.BaseRequestHandler.
>>
>
> 	There is no "RequestHandler" class. The section is general to all
> RequestHandler OBJECTS (Base, Stream, and Datagram).
>
> 	Stream and Datagram request handlers are subclasses of Base, in
> which the setup/finish methods handle the creation/destruction of
> "file-like" attributes -- allowing one to just do read/write operations
> within the core handle() method, instead of having to be concerned with
> the type of connection and performing actual socket recv()/send()
> operations. They are documented in the second paragraph of the .handle()
> method in sectin 20.19.3
>
> 	In all cases, you are responsible for providing the contents of the
> handle() method.

I think the doc can be improved a bit and opened an issue to "Improve 
socketserver doc"
http://bugs.python.org/issue15608

-- 
Terry Jan Reedy

Back to comp.lang.python | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread

Thread

socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs lipska the kat <lipskathekat@yahoo.co.uk> - 2012-08-09 16:15 +0100
  Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs Dennis Lee Bieber <wlfraed@ix.netcom.com> - 2012-08-09 13:39 -0400
    Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs lipska the kat <lipskathekat@yahoo.co.uk> - 2012-08-09 19:08 +0100
    Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs lipska the kat <lipskathekat@yahoo.co.uk> - 2012-08-09 19:37 +0100
      Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs Mark Lawrence <breamoreboy@yahoo.co.uk> - 2012-08-09 19:55 +0100
        Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs lipska the kat <lipskathekat@yahoo.co.uk> - 2012-08-09 20:20 +0100
      Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs Peter Otten <__peter__@web.de> - 2012-08-09 21:07 +0200
        Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs lipska the kat <lipskathekat@yahoo.co.uk> - 2012-08-09 20:23 +0100
      Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs Dave Angel <d@davea.name> - 2012-08-09 15:45 -0400
  Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs Terry Reedy <tjreedy@udel.edu> - 2012-08-09 15:45 -0400
    Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs lipska the kat <lipskathekat@yahoo.co.uk> - 2012-08-10 08:46 +0100

csiph-web