celery.registry.html 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  2. "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  3. <html xmlns="http://www.w3.org/1999/xhtml">
  4. <head>
  5. <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  6. <title>Task Registry - celery.registry &mdash; Celery v0.3.20 (unstable) documentation</title>
  7. <link rel="stylesheet" href="../static/nature.css" type="text/css" />
  8. <link rel="stylesheet" href="../static/pygments.css" type="text/css" />
  9. <script type="text/javascript">
  10. var DOCUMENTATION_OPTIONS = {
  11. URL_ROOT: '../',
  12. VERSION: '0.3.20 (unstable)',
  13. COLLAPSE_MODINDEX: false,
  14. FILE_SUFFIX: '.html',
  15. HAS_SOURCE: true
  16. };
  17. </script>
  18. <script type="text/javascript" src="../static/jquery.js"></script>
  19. <script type="text/javascript" src="../static/doctools.js"></script>
  20. <link rel="top" title="Celery v0.3.20 (unstable) documentation" href="../index.html" />
  21. <link rel="up" title="Module API Reference" href="index.html" />
  22. <link rel="next" title="Built-in Task Classes - celery.task.builtins" href="celery.task.builtins.html" />
  23. <link rel="prev" title="Task Information and Utilities - celery.task" href="celery.task.html" />
  24. </head>
  25. <body>
  26. <div class="related">
  27. <h3>Navigation</h3>
  28. <ul>
  29. <li class="right" style="margin-right: 10px">
  30. <a href="../genindex.html" title="General Index"
  31. accesskey="I">index</a></li>
  32. <li class="right" >
  33. <a href="../modindex.html" title="Global Module Index"
  34. accesskey="M">modules</a> |</li>
  35. <li class="right" >
  36. <a href="celery.task.builtins.html" title="Built-in Task Classes - celery.task.builtins"
  37. accesskey="N">next</a> |</li>
  38. <li class="right" >
  39. <a href="celery.task.html" title="Task Information and Utilities - celery.task"
  40. accesskey="P">previous</a> |</li>
  41. <li><a href="../index.html">Celery v0.3.20 (unstable) documentation</a> &raquo;</li>
  42. <li><a href="index.html" accesskey="U">Module API Reference</a> &raquo;</li>
  43. </ul>
  44. </div>
  45. <div class="document">
  46. <div class="documentwrapper">
  47. <div class="bodywrapper">
  48. <div class="body">
  49. <div class="section" id="module-celery.registry">
  50. <h1>Task Registry - celery.registry<a class="headerlink" href="#module-celery.registry" title="Permalink to this headline">¶</a></h1>
  51. <p>celery.registry</p>
  52. <dl class="exception">
  53. <dt id="celery.registry.AlreadyRegistered">
  54. <em class="property">
  55. exception </em><tt class="descclassname">celery.registry.</tt><tt class="descname">AlreadyRegistered</tt><a class="headerlink" href="#celery.registry.AlreadyRegistered" title="Permalink to this definition">¶</a></dt>
  56. <dd>The task is already registered.</dd></dl>
  57. <dl class="exception">
  58. <dt id="celery.registry.NotRegistered">
  59. <em class="property">
  60. exception </em><tt class="descclassname">celery.registry.</tt><tt class="descname">NotRegistered</tt><a class="headerlink" href="#celery.registry.NotRegistered" title="Permalink to this definition">¶</a></dt>
  61. <dd>The task is not registered.</dd></dl>
  62. <dl class="class">
  63. <dt id="celery.registry.TaskRegistry">
  64. <em class="property">
  65. class </em><tt class="descclassname">celery.registry.</tt><tt class="descname">TaskRegistry</tt><a class="headerlink" href="#celery.registry.TaskRegistry" title="Permalink to this definition">¶</a></dt>
  66. <dd><p>Site registry for tasks.</p>
  67. <dl class="exception">
  68. <dt id="celery.registry.TaskRegistry.AlreadyRegistered">
  69. <em class="property">
  70. exception </em><tt class="descname">AlreadyRegistered</tt><a class="headerlink" href="#celery.registry.TaskRegistry.AlreadyRegistered" title="Permalink to this definition">¶</a></dt>
  71. <dd>The task is already registered.</dd></dl>
  72. <dl class="exception">
  73. <dt id="celery.registry.TaskRegistry.NotRegistered">
  74. <em class="property">
  75. exception </em><tt class="descclassname">TaskRegistry.</tt><tt class="descname">NotRegistered</tt><a class="headerlink" href="#celery.registry.TaskRegistry.NotRegistered" title="Permalink to this definition">¶</a></dt>
  76. <dd>The task is not registered.</dd></dl>
  77. <dl class="method">
  78. <dt id="celery.registry.TaskRegistry.autodiscover">
  79. <tt class="descclassname">TaskRegistry.</tt><tt class="descname">autodiscover</tt><big>(</big><big>)</big><a class="headerlink" href="#celery.registry.TaskRegistry.autodiscover" title="Permalink to this definition">¶</a></dt>
  80. <dd>Autodiscovers tasks using <a title="celery.discovery.autodiscover" class="reference external" href="celery.discovery.html#celery.discovery.autodiscover"><tt class="xref docutils literal"><span class="pre">celery.discovery.autodiscover()</span></tt></a>.</dd></dl>
  81. <dl class="method">
  82. <dt id="celery.registry.TaskRegistry.filter_types">
  83. <tt class="descclassname">TaskRegistry.</tt><tt class="descname">filter_types</tt><big>(</big><em>type</em><big>)</big><a class="headerlink" href="#celery.registry.TaskRegistry.filter_types" title="Permalink to this definition">¶</a></dt>
  84. <dd>Return all tasks of a specific type.</dd></dl>
  85. <dl class="method">
  86. <dt id="celery.registry.TaskRegistry.get_all">
  87. <tt class="descclassname">TaskRegistry.</tt><tt class="descname">get_all</tt><big>(</big><big>)</big><a class="headerlink" href="#celery.registry.TaskRegistry.get_all" title="Permalink to this definition">¶</a></dt>
  88. <dd>Get all task types.</dd></dl>
  89. <dl class="method">
  90. <dt id="celery.registry.TaskRegistry.get_all_periodic">
  91. <tt class="descclassname">TaskRegistry.</tt><tt class="descname">get_all_periodic</tt><big>(</big><big>)</big><a class="headerlink" href="#celery.registry.TaskRegistry.get_all_periodic" title="Permalink to this definition">¶</a></dt>
  92. <dd>Get all periodic task types.</dd></dl>
  93. <dl class="method">
  94. <dt id="celery.registry.TaskRegistry.get_all_regular">
  95. <tt class="descclassname">TaskRegistry.</tt><tt class="descname">get_all_regular</tt><big>(</big><big>)</big><a class="headerlink" href="#celery.registry.TaskRegistry.get_all_regular" title="Permalink to this definition">¶</a></dt>
  96. <dd>Get all regular task types.</dd></dl>
  97. <dl class="method">
  98. <dt id="celery.registry.TaskRegistry.get_task">
  99. <tt class="descclassname">TaskRegistry.</tt><tt class="descname">get_task</tt><big>(</big><em>name</em><big>)</big><a class="headerlink" href="#celery.registry.TaskRegistry.get_task" title="Permalink to this definition">¶</a></dt>
  100. <dd>Get task by name.</dd></dl>
  101. <dl class="method">
  102. <dt id="celery.registry.TaskRegistry.register">
  103. <tt class="descclassname">TaskRegistry.</tt><tt class="descname">register</tt><big>(</big><em>task</em>, <em>name=None</em><big>)</big><a class="headerlink" href="#celery.registry.TaskRegistry.register" title="Permalink to this definition">¶</a></dt>
  104. <dd><p>Register a task in the task registry.</p>
  105. <p>Task can either be a regular function, or a class inheriting
  106. from <tt class="xref docutils literal"><span class="pre">celery.task.Task</span></tt>.</p>
  107. <table class="docutils field-list" frame="void" rules="none">
  108. <col class="field-name" />
  109. <col class="field-body" />
  110. <tbody valign="top">
  111. <tr class="field"><th class="field-name">Parameter:</th><td class="field-body"><em>name</em> &#8211; By default the <tt class="xref docutils literal"><span class="pre">Task.name</span></tt> attribute on the
  112. task is used as the name of the task, but you can override it
  113. using this option.</td>
  114. </tr>
  115. <tr class="field"><th class="field-name" colspan="2">Raises <a title="celery.registry.AlreadyRegistered" class="reference internal" href="#celery.registry.AlreadyRegistered">AlreadyRegistered</a>:</th></tr>
  116. <tr><td>&nbsp;</td><td class="field-body">if the task is already registered.</td>
  117. </tr>
  118. </tbody>
  119. </table>
  120. </dd></dl>
  121. <dl class="method">
  122. <dt id="celery.registry.TaskRegistry.unregister">
  123. <tt class="descclassname">TaskRegistry.</tt><tt class="descname">unregister</tt><big>(</big><em>name</em><big>)</big><a class="headerlink" href="#celery.registry.TaskRegistry.unregister" title="Permalink to this definition">¶</a></dt>
  124. <dd><p>Unregister task by name.</p>
  125. <table class="docutils field-list" frame="void" rules="none">
  126. <col class="field-name" />
  127. <col class="field-body" />
  128. <tbody valign="top">
  129. <tr class="field"><th class="field-name">Parameter:</th><td class="field-body"><em>name</em> &#8211; name of the task to unregister, or a
  130. <tt class="xref docutils literal"><span class="pre">celery.task.Task</span></tt> class with a valid <tt class="docutils literal"><span class="pre">name</span></tt> attribute.</td>
  131. </tr>
  132. <tr class="field"><th class="field-name" colspan="2">Raises <a title="celery.registry.NotRegistered" class="reference internal" href="#celery.registry.NotRegistered">NotRegistered</a>:</th></tr>
  133. <tr><td>&nbsp;</td><td class="field-body">if the task has not been registered.</td>
  134. </tr>
  135. </tbody>
  136. </table>
  137. </dd></dl>
  138. </dd></dl>
  139. </div>
  140. </div>
  141. </div>
  142. </div>
  143. <div class="sphinxsidebar">
  144. <div class="sphinxsidebarwrapper">
  145. <h4>Previous topic</h4>
  146. <p class="topless"><a href="celery.task.html"
  147. title="previous chapter">Task Information and Utilities - celery.task</a></p>
  148. <h4>Next topic</h4>
  149. <p class="topless"><a href="celery.task.builtins.html"
  150. title="next chapter">Built-in Task Classes - celery.task.builtins</a></p>
  151. <h3>This Page</h3>
  152. <ul class="this-page-menu">
  153. <li><a href="../sources/reference/celery.registry.txt"
  154. rel="nofollow">Show Source</a></li>
  155. </ul>
  156. <div id="searchbox" style="display: none">
  157. <h3>Quick search</h3>
  158. <form class="search" action="../search.html" method="get">
  159. <input type="text" name="q" size="18" />
  160. <input type="submit" value="Go" />
  161. <input type="hidden" name="check_keywords" value="yes" />
  162. <input type="hidden" name="area" value="default" />
  163. </form>
  164. <p class="searchtip" style="font-size: 90%">
  165. Enter search terms or a module, class or function name.
  166. </p>
  167. </div>
  168. <script type="text/javascript">$('#searchbox').show(0);</script>
  169. </div>
  170. </div>
  171. <div class="clearer"></div>
  172. </div>
  173. <div class="related">
  174. <h3>Navigation</h3>
  175. <ul>
  176. <li class="right" style="margin-right: 10px">
  177. <a href="../genindex.html" title="General Index"
  178. >index</a></li>
  179. <li class="right" >
  180. <a href="../modindex.html" title="Global Module Index"
  181. >modules</a> |</li>
  182. <li class="right" >
  183. <a href="celery.task.builtins.html" title="Built-in Task Classes - celery.task.builtins"
  184. >next</a> |</li>
  185. <li class="right" >
  186. <a href="celery.task.html" title="Task Information and Utilities - celery.task"
  187. >previous</a> |</li>
  188. <li><a href="../index.html">Celery v0.3.20 (unstable) documentation</a> &raquo;</li>
  189. <li><a href="index.html" >Module API Reference</a> &raquo;</li>
  190. </ul>
  191. </div>
  192. <div class="footer">
  193. &copy; Copyright 2009, Ask Solem.
  194. Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 0.6.2.
  195. </div>
  196. </body>
  197. </html>