pylint and the 'missing docstring' warning

Jean-Michel Pichavant jeanmichel at sequans.com
Tue Jan 26 12:20:42 EST 2010


John Posner wrote:
> On 1/26/2010 9:22 AM, Jean-Michel Pichavant wrote:
>> John Posner wrote:
>>> On 1/26/2010 8:43 AM, Jean-Michel Pichavant wrote:
>>>> Hello,
>>>>
>>>> Does anyone using pylint knows a way to make pylint ignore these
>>>> 'missing docstring' warnings when the base class version of the method
>>>> actually defines the docstring ?
>>>> 'Cause my doc builder (epydoc) handle it properly and propagate
>>>> docstrings if asked to. Too bad pylint is complaining about it.
>>>> I don't want to deactivate this warning.
>>>>
>>>
>>> Look for this setting in the pylint configuration file:
>>>
>>> # not require a docstring
>>> no-docstring-rgx=__.*__
>>>
>>> -John
>>>
>>>
>> If I'm no wrong this just disables docstring checks for methods matching
>> __.*__
>> I'd like to disable it for any method which base class version already
>> defines the docstring.
>>
>
> I'm a Pylint newbie myself. The only (half-baked) idea I can come up 
> with is to use a naming convention for such derived classes. For 
> example, if all such class names ended with "_d" (ugh!), you could 
> modify the configuration setting like this:
>
>   no-docstring-rgx=(__.*__|.*_d)
>
> -John
That would work but I definitely don't want to do that.

JM




More information about the Python-list mailing list