Re: [Pyobjc-dev] setVerbose()

[Lele G. <le...@se...>]

>>>>> On Fri, 3 Jan 2003 13:14:00 +0100, Jack Jansen <Jac...@cw...> said:

    JJ> On Friday, Jan 3, 2003, at 07:54 Europe/Amsterdam, Ronald
    JJ> Oussoren wrote:
    >> We could define __all__ in objc/__init__.py:
    >> 
    >> __all__ = [ 'YES', 'NO', 'IBAction', 'IBOutlet' ]
    >> 
    >> That would make it possible to do 'from objc import *' for
    >> accessing often used 'end-user' functionality, while keeping
    >> the namespace > clean.

    JJ> I think this is too magic. People expect "from xxx import *"
    JJ> to really import everything that is remotely useful.

Uh? That syntax is deprecated since the BigBang. To be remotely
useful, one has to know about it, and thus the "correct" form is to
explicit its name. The "__all__" magic is to allow *the*developer* to
export major "entry points" of the module, for lazy on-the-fly
imports... 

    JJ> My vote would be for the {py}objc_ prefix to the methods, even
    JJ> though you then have to type objc.pyobjc_setVerbose() if you
    JJ> "import objc".  Again with the same reasoning as last time: it
    JJ> communicates to the reader that it's useless to try and look
    JJ> up this function in Apple's documentation.

I'm with Ronald here: adding another prefix does not bring significant
information, that by the way could be better explained by
setVerbose.__doc__.

ciao, lele.
-- 
nickname: Lele Gaifax	| Quando vivro' di quello che ho pensato ieri
real: Emanuele Gaifas	| comincero' ad aver paura di chi mi copia.
email: le...@se...	|		-- Fortunato Depero, 1929.