Re: [python-odtwriter] package name wrong?

2008-02-10 Thread Michael Schutte
On Sat, Feb 09, 2008 at 02:20:26PM +0100, Bernd Zeimetz wrote:
 So python-docutils-writers-odtwriter would be the right name in theory,
 but this doesn't make sense, indeed.

Does anybody insist on that name?  If not, I’m going to update the long
description to mention the relationship to python-docutils, which
probably would have avoided that bug report in the first place.

Cheers,
-- 
Michael Schutte [EMAIL PROTECTED]


signature.asc
Description: Digital signature


Re: [python-odtwriter] package name wrong?

2008-02-10 Thread Tristan Seligmann
* Michael Schutte [EMAIL PROTECTED] [2008-02-10 09:17:54 +0100]:

 On Sat, Feb 09, 2008 at 02:20:26PM +0100, Bernd Zeimetz wrote:
  So python-docutils-writers-odtwriter would be the right name in theory,
  but this doesn't make sense, indeed.
 
 Does anybody insist on that name?  If not, I’m going to update the long
 description to mention the relationship to python-docutils, which
 probably would have avoided that bug report in the first place.

Personally, I think that package name is ludicrous; python-odtwriter
seems fine, this kind of extend another package package is an
exceptional case, so I think it makes sense to bend the naming rules a
little.
-- 
mithrandi, i Ainil en-Balandor, a faer Ambar


signature.asc
Description: Digital signature


Re: [python-odtwriter] package name wrong?

2008-02-10 Thread Ben Finney
Tristan Seligmann [EMAIL PROTECTED] writes:

 * Michael Schutte [EMAIL PROTECTED] [2008-02-10 09:17:54 +0100]:
 
  On Sat, Feb 09, 2008 at 02:20:26PM +0100, Bernd Zeimetz wrote:
   So python-docutils-writers-odtwriter would be the right name in
   theory, but this doesn't make sense, indeed.
  
  Does anybody insist on that name? If not, I’m going to update the
  long description to mention the relationship to python-docutils,
  which probably would have avoided that bug report in the first
  place.
 
 Personally, I think that package name is ludicrous; python-odtwriter
 seems fine

The name 'python-docutils-odtwriter' seems better to me (I think what
makes the above name ludicrous is the utterly redundant '-writers' in
the middle).

-- 
 \ “A cynic is a man who, when he smells flowers, looks around for |
  `\  a coffin.” —Henry L. Mencken |
_o__)  |
Ben Finney


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]



Re: [python-odtwriter] package name wrong?

2008-02-09 Thread Michael Schutte
On Sat, Feb 09, 2008 at 12:55:33PM +0100, Rene Engelhard wrote:
 Hmm. Is it now a program or a module? In the latter case the pakcage
 name would be right but then rst2odt, the manpage etc. shoudln't be in
 there. 
 
 OTOH, this looks like a private module for just the rst2odt program, in
 which case the package should be called rst2odt. Splitting the package
 up doesn't make that much sense given that it's a) a internal module and
 b) __init__.py is only 88K

First of all, the package enhances python-docutils in that it adds an
extra output format, a “writer,” to its capabilities.  A minimum-size
re-implementation of rst2odt could look like this:

#!/usr/bin/python

from docutils.core import publish_cmdline

publish_cmdline(writer_name='odtwriter')

(The real implementation of rst2odt is longer because of operating
systems which make a difference between text and binary file output.)

Therefore, the module is not really private; it is at least known to
docutils and can be used in any program which uses docutils’ API.

Then, the main reason why I have chosen to use this name is that calling
it rst2odt would be inconsequent; python-docutils also contains rst2*
scripts and is not named after them, even though they arguably provide
the interface that is used most of the time.  So I think it is not the
worst solution to stick with “python-odtwriter”—something like
“python-docutils-odtwriter” would still make sense to me, but that’s a
bit bulky.

Ccing debian-python to get some more opinions.

Thanks for your comment,
-- 
Michael Schutte [EMAIL PROTECTED]


signature.asc
Description: Digital signature


Re: [python-odtwriter] package name wrong?

2008-02-09 Thread Bernd Zeimetz
Hi,

 Then, the main reason why I have chosen to use this name is that calling
 it rst2odt would be inconsequent; python-docutils also contains rst2*
 scripts and is not named after them, even though they arguably provide
 the interface that is used most of the time.

Python module packages are supposed to be anmed after the module they
contain. So if you use
import foo
in your code to import a module, the package would be called python-foo.

  So I think it is not the
 worst solution to stick with “python-odtwriter”—something like
 “python-docutils-odtwriter” would still make sense to me, but that’s a
 bit bulky.

So python-docutils-writers-odtwriter would be the right name in theory,
but this doesn't make sense, indeed.

I don't have a better idea than python-odtwriter, though.

Cheers,

Bernd


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]