#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 django-updates+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/067.c9550d3876b84a2cc54a032db4dfb058%40djangoproject.com.

Reply via email to