|
from threading import local |
|
|
|
_local = local() |
|
|
|
|
|
def get_current_context(silent=False): |
|
"""Returns the current click context. This can be used as a way to |
|
access the current context object from anywhere. This is a more implicit |
|
alternative to the :func:`pass_context` decorator. This function is |
|
primarily useful for helpers such as :func:`echo` which might be |
|
interested in changing its behavior based on the current context. |
|
|
|
To push the current context, :meth:`Context.scope` can be used. |
|
|
|
.. versionadded:: 5.0 |
|
|
|
:param silent: if set to `True` the return value is `None` if no context |
|
is available. The default behavior is to raise a |
|
:exc:`RuntimeError`. |
|
""" |
|
try: |
|
return _local.stack[-1] |
|
except (AttributeError, IndexError): |
|
if not silent: |
|
raise RuntimeError("There is no active click context.") |
|
|
|
|
|
def push_context(ctx): |
|
"""Pushes a new context to the current stack.""" |
|
_local.__dict__.setdefault("stack", []).append(ctx) |
|
|
|
|
|
def pop_context(): |
|
"""Removes the top level from the stack.""" |
|
_local.stack.pop() |
|
|
|
|
|
def resolve_color_default(color=None): |
|
""""Internal helper to get the default value of the color flag. If a |
|
value is passed it's returned unchanged, otherwise it's looked up from |
|
the current context. |
|
""" |
|
if color is not None: |
|
return color |
|
ctx = get_current_context(silent=True) |
|
if ctx is not None: |
|
return ctx.color |
|
|