Brodie Rao committed 9c3559d

Initial README

  • Participants
  • Parent commits 671cb14

Comments (0)

Files changed (1)

  Alastor: Constant vigilance!
+Alastor is a `Django`_ `middleware`_ that lets you interactively profile your
+Add ``?__alastor__`` to any URL, browse to it, and you'll get a PDF showing
+the request's call graph and the time spent in each time.
+If you've set ``DEBUG = True`` in your `Django settings`_, anyone can profile
+a page–even anonymous users. With ``DEBUG = False``, only super users can
+profile pages.
+If you're running your Django site under a server like `Gunicorn`_ and you've
+configured `time limits on requests`_, you can set ``ALASTOR_CELERY = True``
+to run the profiler in a background `Celery`_ task.
+.. _Django:
+.. _middleware:
+.. _Django settings:
+.. _Gunicorn:
+.. _time limits on requests:
+.. _Celery:
+After you've done ``pip install alastor``, add ``'alastor'`` to the
+``INSTALLED_APPS`` setting, and add ``'alastor.AlastorMiddleware'`` to the
+``MIDDLEWARE_CLASSES`` setting. You'll probably want to put it after Django's
+authentication middleware and before everything else.
+For background profiling with Celery, set ``ALASTOR_CELERY = True``.