Hi Skip,

On 02 juillet 09:29, Skip Montanaro wrote:
> This warning seems specious:
> 
> __init__.py:1: [C0111] Missing module docstring
> 
> especially since __init__.py is often empty (as it is in this case),
> being used only as a marker that a directory is actually a package.
> This is in Python 2.7.  I'm doing nothing to override the
> docstring_min_length config parameter, so if my reading of
> DocStringChecker._check_docstring is correct, this message should not
> be emitted for any zero-length module.  I can't tell where/how
> self.config.docstring_min_length is initialized (find+grep doesn't
> return many hits), so can't tell what its value is, either.  (Well,
> not without inserting a print statement.)
> 
> What am I missing here?

docstring_min_length is initialized from the docstring-min-length option.
IIRC, this is only considered for functions / methods though, and I agree
that it should be considered for modules (classes?) as well. If you don't
have time to submit a patch, please consider opening an issue on bitbucket.

Thanks!
-- 
Sylvain Thénault, LOGILAB, Paris (01.45.32.03.12) - Toulouse (05.62.17.16.42)
Formations Python, Debian, Méth. Agiles: http://www.logilab.fr/formations
Développement logiciel sur mesure:       http://www.logilab.fr/services
CubicWeb, the semantic web framework:    http://www.cubicweb.org
_______________________________________________
code-quality mailing list
code-quality@python.org
http://mail.python.org/mailman/listinfo/code-quality

Reply via email to