[Python-Dev] PEP 411 - request for pronouncement

[Lennart Regebro]

On Mon, Mar 26, 2012 at 05:40, Eli Bendersky <eliben at gmail.com> wrote:
> On Sat, Mar 24, 2012 at 13:53, Lennart Regebro <regebro at gmail.com> wrote:
>> On Fri, Mar 23, 2012 at 10:51, Eli Bendersky <eliben at gmail.com> wrote:
>>> The PEP received mostly positive feedback. The only undecided point is
>>> where to specify that the package is provisional. Currently the PEP
>>> mandates to specify it in the documentation and in the docstring.
>>> Other suggestions were to put it in the code, either as a
>>> __provisional__ attribute on the module, or collect all such modules
>>> in a single sys.provisional list.
>>
>> I'm not sure what the usecase is for checking in code if a module is
>> provisional or not. It doesn't seem useful, and risks being
>> unmaintained, especially when the flag is on the module itself.
>>
>
> Some usecases were given by Jim J. Jewett here:
> http://mail.python.org/pipermail/python-dev/2012-February/116400.html
> (and +1-ed by a couple of others.)

Having a list of provisional modules seems the most helpful there, in
that case, and also noting that it is provisional in the module docs
shown when you do help().