Gecko [ c.stage.kornherr.net ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2024-07-10 10:57
_internal	[ DIR ]	drwxr-xr-x	2024-07-10 10:57
compat	[ DIR ]	drwxr-xr-x	2024-07-10 10:57
display	[ DIR ]	drwxr-xr-x	2024-07-10 10:57
plugins	[ DIR ]	drwxr-xr-x	2024-07-10 10:57
tests	[ DIR ]	drwxr-xr-x	2024-07-10 10:57
__init__.py	113 B	-rw-r--r--	2024-02-08 19:45
achallenges.py	1.98 KB	-rw-r--r--	2024-02-08 19:45
configuration.py	18.67 KB	-rw-r--r--	2024-02-08 19:45
crypto_util.py	24.01 KB	-rw-r--r--	2024-02-08 19:45
errors.py	2.72 KB	-rw-r--r--	2024-02-08 19:45
interfaces.py	15.22 KB	-rw-r--r--	2024-02-08 19:45
main.py	535 B	-rw-r--r--	2024-02-08 19:45
ocsp.py	14.7 KB	-rw-r--r--	2024-02-08 19:45
py.typed	0 B	-rw-r--r--	2024-02-08 19:45
reverter.py	21.55 KB	-rw-r--r--	2024-02-08 19:45
ssl-dhparams.pem	424 B	-rw-r--r--	2024-02-08 19:45
util.py	25.07 KB	-rw-r--r--	2024-02-08 19:45

Rename

"""Client annotated ACME challenges.

Please use names such as ``achall`` to distinguish from variables "of type"
:class:`acme.challenges.Challenge` (denoted by ``chall``)
and :class:`.ChallengeBody` (denoted by ``challb``)::

from acme import challenges
  from acme import messages
  from certbot import achallenges

chall = challenges.DNS(token='foo')
  challb = messages.ChallengeBody(chall=chall)
  achall = achallenges.DNS(chall=challb, domain='example.com')

Note, that all annotated challenges act as a proxy objects::

achall.token == challb.token

"""
import logging
from typing import Any
from typing import Type

import josepy as jose

from acme import challenges
from acme.challenges import Challenge

logger = logging.getLogger(__name__)

class AnnotatedChallenge(jose.ImmutableMap):
    """Client annotated challenge.

Wraps around server provided challenge and annotates with data
    useful for the client.

:ivar ~.challb: Wrapped `~.ChallengeBody`.

"""
    __slots__ = ('challb',)
    _acme_type: Type[Challenge] = NotImplemented

def __getattr__(self, name: str) -> Any:
        return getattr(self.challb, name)

class KeyAuthorizationAnnotatedChallenge(AnnotatedChallenge):
    """Client annotated `KeyAuthorizationChallenge` challenge."""
    __slots__ = ('challb', 'domain', 'account_key') # pylint: disable=redefined-slots-in-subclass

def response_and_validation(self, *args: Any, **kwargs: Any) -> Any:
        """Generate response and validation."""
        return self.challb.chall.response_and_validation(
            self.account_key, *args, **kwargs)

class DNS(AnnotatedChallenge):
    """Client annotated "dns" ACME challenge."""
    __slots__ = ('challb', 'domain') # pylint: disable=redefined-slots-in-subclass
    acme_type = challenges.DNS

class Other(AnnotatedChallenge):
    """Client annotated ACME challenge of an unknown type."""
    __slots__ = ('challb', 'domain') # pylint: disable=redefined-slots-in-subclass
    acme_type = challenges.Challenge