Commit 0fb11855 authored by Harry's avatar Harry Committed by Tim Graham
Browse files

Fixed #26152 -- Documented how to avoid django.setup() deadlock in standalone scripts.

parent ecd502cf
Loading
Loading
Loading
Loading
+11 −0
Original line number Diff line number Diff line
@@ -291,6 +291,17 @@ Note that calling ``django.setup()`` is only necessary if your code is truly
standalone. When invoked by your Web server, or through :doc:`django-admin
</ref/django-admin>`, Django will handle this for you.

.. admonition:: ``django.setup()`` may only be called once.

    Therefore, avoid putting reusable application logic in standalone scripts
    so that you have to import from the script elsewhere in your application.
    If you can't avoid that, put the call to ``django.setup()`` inside an
    ``if`` block::

        if __name__ == '__main__':
            import django
            django.setup()

.. seealso::

    :doc:`The Settings Reference </ref/settings>`