Re: [Docutils-develop] roman.py in docutils

[Fred L. D. Jr. <fd...@ac...>]

On Wednesday 23 June 2004 07:38 pm, David Goodger wrote:
 > I had to pull optik.py out when optparse was included in Python's
 > stdlib, so I pulled roman.py out at the same time, out of a general
 > desire for uniformity.

Why did you have to pull optik out because optparse was available?  optik 
should still work just fine.  Same for textwrap.  Whether they get installed 
as top-level modules or as part of the docutils package, that should be fine.  
A typical installation into site-packages/ would have them masked by the 
standard library, which is probably fine.  If that isn't, then they should 
either be installed inside docutils or alongside docutils under new names.

 > Simpler, perhaps, but roman.py didn't feel right in the docutils
 > package.  It's completely independent, and if Docutils is ever added
 > to Python's stdlib (as people keep threatening to do ;-), roman.py
 > ought to be included separately.

It's only independent if it's installation is going to be managed separately.  
Otherwise, it's all one big ball o' Python code.

 > Is there anything wrong with the Docutils setup.py, any bug?

No; I've not encountered any problems in the docutils setup.py.

I consider it a problem because of the way we've dealt with it in Zope (both 
versions 2 and 3); it may be that we don't deal with it well.

Our revision control repositories have a copy of docutils imported into them, 
with roman.py inside the docutils package.  We don't treat it specially when 
it's built/installed, so the module ends up being part of the docutils 
package.  Since nothing else in Zope imports roman, we figure keeping it as 
part of docutils is best.  For now, what we're doing is placing it 
specifically in the docutils.parsers.rst package so we can avoid changing the 
contents of any files that came from docutils.

 > What's painful is that Distutils doesn't (didn't) allow package and
 > module installs simultaneously.  The rest is easy.

Fixed for all versions of Python I care about.  ;-)


  -Fred

-- 
Fred L. Drake, Jr.  <fdrake at acm.org>
PythonLabs at Zope Corporation