Re: [Rest2web-develop] ConfigObj 4 Beta 1

[Nicola L. <ni...@te...>]

>> 1. the zip file, *and* the main directory inside it, should be named
>>    "configobj-4.0.0b1";

> Ok (This is the *highest* priority - the *name* of the zip file ? ;-)

Of course. It' a *human* issue, and takes precedence over the merely
technical ones. ;-)


>> 2. we should have a simple "setup.py" file in there;

> Great if you can do one. I'm about to commit a setup.py  for
> 'pythonutils' though.... (marginally less trivial because it generates
> the '.pth' file when used).

Let's recycle yours, then. :-)


>> 3b. we may want to try minimizing the usage of the isinstance
>>     built-in, especially to allow passing dict-like objects that
>>     are not subclasses of dict;

> What alternative do you suggest ?
> 
> ``IsmappingType`` is hopeless (it returns ``True`` for *any* class). I
> don't think restricting input to dicts or genuine subclasses is too
> restrictive.

That's what he asked for.


> We could assume that any item with a ``__getitem__`` method *and* a
> ``keys`` method will behave like a dictionary ? (I'd be happy with this
> as a solution - but it will need documenting).

Some kind of duck typing, yes, I'll explore current usage.


>> 4. we may want to omit the private API docs, by using the
>>    "--no-private" switch of the epydoc command;

> I think that removes *all* the Section documentation. I don't have a
> problem with distributing the private documentation - it's all nicely
> written.

My concern was about the size of the package.


>> 5. it would be nice to have a tar.gz file on Sourceforge, in addition
>>    to the zip: it's smaller than the zip, and more "native" to Linux;

> I can upload it if you generate it :-)
> Or I can add you to the sourceforge project ? (Let me know your user
> name and I'll add you)

Yes, I wanted to ask you about that. :-) It's "teknico" (lower case "n"),
of course.


>> 6. the "BSD-LICENSE.txt" and the generated HTML files have CRLF
>>    line endings, while the sources have LF ones. Also, the
>>    "configobj.txt" has LF ones, except for the HTML fragment at the
>>    end, that has ten CRLF endings.

> Ok - I can sort this. Committing will remove the carriage returns from
> configobj.txt.

Just updated, and it didn't. :-( I'll fix the files and their svn:eol-style
property.

-- 
Nicola Larosa - ni...@te...

PHP is such a load of crap, right down to the standard library, that it
creates a culture where it's acceptable to write horrible code. [...]
Maybe with PHP 5 they are trying to clean up the neighborhood, but that
doesn't change the fact when you program in PHP you are programming in
a dump. -- Ian Bicking, July 2005