#31744: Pydoc support/helper
-------------------------------------+-------------------------------------
     Reporter:  Sardorbek Imomaliev  |                    Owner:  nobody
         Type:                       |                   Status:  closed
  Cleanup/optimization               |
    Component:  Core (Other)         |                  Version:  3.0
     Severity:  Normal               |               Resolution:  wontfix
     Keywords:                       |             Triage Stage:
                                     |  Unreviewed
    Has patch:  0                    |      Needs documentation:  0
  Needs tests:  0                    |  Patch needs improvement:  0
Easy pickings:  0                    |                    UI/UX:  0
-------------------------------------+-------------------------------------
Changes (by felixxm):

 * status:  new => closed
 * resolution:   => wontfix
 * component:  Documentation => Core (Other)
 * type:  Uncategorized => Cleanup/optimization


Comment:

 Yes, that's true. `pydoc` just like `sphinx.ext.viewcode` (see #29942)
 imports modules, that's why it will crash when required packages are
 missing or if settings are not configured. Setting
 `DJANGO_SETTINGS_MODULE` fixes this issue in most cases. I don't see a
 clear path to solve this in Django. I'm against adding a new management
 command for [https://docs.python.org/3/library/pydoc.html pydoc] and
 adding multiple `if __name__ == ...` seems clunky and decrease code
 readability.

 Maybe a discussion on DevelopersMailingList will bring some ideas, but I
 don't think it's feasible without side-effects.

 Thanks for the report.

-- 
Ticket URL: <https://code.djangoproject.com/ticket/31744#comment:4>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

-- 
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/067.c9550d3876b84a2cc54a032db4dfb058%40djangoproject.com.

Reply via email to