This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: SimpleXMLRPCServer auto-docing subclass
Type: Stage:
Components: Library (Lib) Versions: Python 2.3
process
Status: closed Resolution: accepted
Dependencies: Superseder:
Assigned To: loewis Nosy List: bquinlan, gvanrossum, loewis
Priority: normal Keywords: patch

Created on 2002-03-29 19:52 by bquinlan, last changed 2022-04-10 16:05 by admin. This issue is now closed.

Files
File name Uploaded Description Edit
DocXMLRPCServer.py bquinlan, 2002-03-29 19:52 DocXMLRPCServer.py
DocXMLRPCServer.txt bquinlan, 2003-04-03 07:01
DocXMLRPCServer.py bquinlan, 2003-04-03 07:02
Messages (12)
msg39422 - (view) Author: Brian Quinlan (bquinlan) * (Python committer) Date: 2002-03-29 19:52
This SimpleXMLRPCServer subclass automatically serves 
HTML documentation, generated using pydoc, in response 
to an HTTP GET request (XML-RPC always uses POST).

Here are some examples:
http://www.sweetapp.com/cgi-bin/xmlrpc-test/rpc1.py
http://www.sweetapp.com/cgi-bin/xmlrpc-test/rpc2.py
msg39423 - (view) Author: Guido van Rossum (gvanrossum) * (Python committer) Date: 2002-04-04 17:31
Logged In: YES 
user_id=6380

Looks cute to me. Fredrik, any problem if I just check this
in?
msg39424 - (view) Author: Brian Quinlan (bquinlan) * (Python committer) Date: 2002-04-04 17:55
Logged In: YES 
user_id=108973

Sorry, I was sloppy about the description:

This patch is dependant on patch 473586:
[473586] SimpleXMLRPCServer - fixes and CGI

So please don't check this in until that patch is accepted.
msg39425 - (view) Author: Brian Quinlan (bquinlan) * (Python committer) Date: 2002-04-04 19:26
Logged In: YES 
user_id=108973

Sorry, I was sloppy about the description:

This patch is dependant on patch 473586:
[473586] SimpleXMLRPCServer - fixes and CGI

So please don't check this in until that patch is accepted.
msg39426 - (view) Author: Brian Quinlan (bquinlan) * (Python committer) Date: 2003-02-10 20:25
Logged In: YES 
user_id=108973

Patch 473586 has been accepted so this patch can be 
accepted.
msg39427 - (view) Author: Martin v. Löwis (loewis) * (Python committer) Date: 2003-03-30 14:59
Logged In: YES 
user_id=21627

I'm not sure how to place this. Is this an extension to
pydoc? Should it go into Tools, or into Lib, or into some
existing module?

If this goes into Lib somewhere, it lacks documentation.
msg39428 - (view) Author: Brian Quinlan (bquinlan) * (Python committer) Date: 2003-03-31 06:56
Logged In: YES 
user_id=108973

>I'm not sure how to place this. Is this an extension to
>pydoc? 

No. This module provides subclasses for 
SimpleXMLRPCServer and CGIXMLRPCServer. These 
subclasses serve pydoc-style documentation when you point 
your browser at them - see the examples in the patch 
summary.

> Should it go into Tools, or into Lib, or into some
> existing module?

The attached file should go into Lib.

> If this goes into Lib somewhere, it lacks documentation.

Fair enough. Conditional on me writing documentation, is this 
contribution acceptable as is?
msg39429 - (view) Author: Martin v. Löwis (loewis) * (Python committer) Date: 2003-03-31 09:07
Logged In: YES 
user_id=21627

I see. The code is fine, but it needs to come with a test 
function, to operate the module as a program. I suggest that 
the test server provides the get_source_code() operation just 
as your demo client does; the docstring of the class may 
provide an xmlrpclib fragment that retrieves the source code 
(AFAICT, the source code is not directly accessible through 
an URL, is it?)

I also recommend that you reconsider renaming the classes: 
If the module is named, say, DocXMLRPCServer, there is no 
need to have the Doc prefix on the class names. Instead, 
they can be named just "XMLRPCServer" etc.
msg39430 - (view) Author: Brian Quinlan (bquinlan) * (Python committer) Date: 2003-03-31 09:22
Logged In: YES 
user_id=108973

Write test function: ok
Write documentation: ok

>If the module is named, say, DocXMLRPCServer, there is 
>no need to have the Doc prefix on the class names.

Hmmm. If you look at the core BaseHTTPRequestHandler 
derived classes,  each one is prefixed to match the module 
that it is found in. The only two modules that I can think of 
with identical class names are cStringIO and StringIO, which 
theoretically provide identical semantics.
msg39431 - (view) Author: Martin v. Löwis (loewis) * (Python committer) Date: 2003-03-31 21:30
Logged In: YES 
user_id=21627

Ok, leave the naming as-is, unless other reviewers comment
in one direction or the other.
msg39432 - (view) Author: Brian Quinlan (bquinlan) * (Python committer) Date: 2003-04-03 07:06
Logged In: YES 
user_id=108973

Module resubmitted with test function.

Documentation attached in text format. The documentation 
doesn't seem terribly good to me so feel free to suggest 
changes. Will it be clear to the newbie that they should look 
at SimpleXMLRPCServer for RPC related methods?
msg39433 - (view) Author: Martin v. Löwis (loewis) * (Python committer) Date: 2003-04-18 21:06
Logged In: YES 
user_id=21627

Thanks for the patch. Committed as

lib.tex 1.220
libdocxmlrpc.tex 1.1
whatsnew23.tex 1.139
DocXMLRPCServer.py 1.1
NEWS 1.734

I think the documentation is fine; I have trimmed it
somewhat to avoid repetition (I have also texified it).
History
Date User Action Args
2022-04-10 16:05:10adminsetgithub: 36356
2002-03-29 19:52:57bquinlancreate