__init__.py 2.0 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465
  1. # -*- coding: utf-8 -*-
  2. """
  3. celery.backends
  4. ~~~~~~~~~~~~~~~
  5. Backend abstract factory (...did I just say that?) and alias definitions.
  6. """
  7. from __future__ import absolute_import
  8. import sys
  9. from kombu.utils.url import _parse_url
  10. from celery.local import Proxy
  11. from celery._state import current_app
  12. from celery.five import reraise
  13. from celery.utils.imports import symbol_by_name
  14. from celery.utils.functional import memoize
  15. __all__ = ['get_backend_cls', 'get_backend_by_url']
  16. UNKNOWN_BACKEND = """\
  17. Unknown result backend: {0!r}. Did you spell that correctly? ({1!r})\
  18. """
  19. BACKEND_ALIASES = {
  20. 'amqp': 'celery.backends.amqp:AMQPBackend',
  21. 'rpc': 'celery.backends.rpc.RPCBackend',
  22. 'cache': 'celery.backends.cache:CacheBackend',
  23. 'redis': 'celery.backends.redis:RedisBackend',
  24. 'mongodb': 'celery.backends.mongodb:MongoBackend',
  25. 'db': 'celery.backends.database:DatabaseBackend',
  26. 'database': 'celery.backends.database:DatabaseBackend',
  27. 'cassandra': 'celery.backends.cassandra:CassandraBackend',
  28. 'couchbase': 'celery.backends.couchbase:CouchBaseBackend',
  29. 'disabled': 'celery.backends.base:DisabledBackend',
  30. }
  31. #: deprecated alias to ``current_app.backend``.
  32. default_backend = Proxy(lambda: current_app.backend)
  33. @memoize(100)
  34. def get_backend_cls(backend=None, loader=None):
  35. """Get backend class by name/alias"""
  36. backend = backend or 'disabled'
  37. loader = loader or current_app.loader
  38. aliases = dict(BACKEND_ALIASES, **loader.override_backends)
  39. try:
  40. return symbol_by_name(backend, aliases)
  41. except ValueError as exc:
  42. reraise(ValueError, ValueError(UNKNOWN_BACKEND.format(
  43. backend, exc)), sys.exc_info()[2])
  44. def get_backend_by_url(backend=None, loader=None):
  45. url = None
  46. if backend and '://' in backend:
  47. url = backend
  48. if '+' in url[:url.index('://')]:
  49. backend, url = url.split('+', 1)
  50. else:
  51. backend, _, _, _, _, _, _ = _parse_url(url)
  52. return get_backend_cls(backend, loader), url