Na}{

File Content: `eff.py`

"""Subscribes users to the EFF newsletter."""
import logging

import requests
import zope.component

from certbot import constants
from certbot import interfaces


logger = logging.getLogger(__name__)


def handle_subscription(config):
    """High level function to take care of EFF newsletter subscriptions.

    The user may be asked if they want to sign up for the newsletter if
    they have not already specified.

    :param .IConfig config: Client configuration.

    """
    if config.email is None:
        if config.eff_email:
            _report_failure("you didn't provide an e-mail address")
        return
    if config.eff_email is None:
        config.eff_email = _want_subscription()
    if config.eff_email:
        subscribe(config.email)


def _want_subscription():
    """Does the user want to be subscribed to the EFF newsletter?

    :returns: True if we should subscribe the user, otherwise, False
    :rtype: bool

    """
    prompt = (
        'Would you be willing to share your email address with the '
        "Electronic Frontier Foundation, a founding partner of the Let's "
        'Encrypt project and the non-profit organization that develops '
        "Certbot? We'd like to send you email about our work encrypting "
        "the web, EFF news, campaigns, and ways to support digital freedom. ")
    display = zope.component.getUtility(interfaces.IDisplay)
    return display.yesno(prompt, default=False)


def subscribe(email):
    """Subscribe the user to the EFF mailing list.

    :param str email: the e-mail address to subscribe

    """
    url = constants.EFF_SUBSCRIBE_URI
    data = {'data_type': 'json',
            'email': email,
            'form_id': 'eff_supporters_library_subscribe_form'}
    logger.debug('Sending POST request to %s:\n%s', url, data)
    _check_response(requests.post(url, data=data))


def _check_response(response):
    """Check for errors in the server's response.

    If an error occurred, it will be reported to the user.

    :param requests.Response response: the server's response to the
        subscription request

    """
    logger.debug('Received response:\n%s', response.content)
    try:
        response.raise_for_status()
        if not response.json()['status']:
            _report_failure('your e-mail address appears to be invalid')
    except requests.exceptions.HTTPError:
        _report_failure()
    except (ValueError, KeyError):
        _report_failure('there was a problem with the server response')


def _report_failure(reason=None):
    """Notify the user of failing to sign them up for the newsletter.

    :param reason: a phrase describing what the problem was
        beginning with a lowercase letter and no closing punctuation
    :type reason: `str` or `None`

    """
    msg = ['We were unable to subscribe you the EFF mailing list']
    if reason is not None:
        msg.append(' because ')
        msg.append(reason)
    msg.append('. You can try again later by visiting https://act.eff.org.')
    reporter = zope.component.getUtility(interfaces.IReporter)
    reporter.add_message(''.join(msg), reporter.LOW_PRIORITY)

Name	Size	Permission
__pycache__	---	0755
compat	---	0755
display	---	0755
plugins	---	0755
tests	---	0755
__init__.py	114 bytes	0644
account.py	13957 bytes	0644
achallenges.py	1624 bytes	0644
auth_handler.py	18860 bytes	0644
cert_manager.py	15370 bytes	0644
cli.py	72525 bytes	0644
client.py	30364 bytes	0644
configuration.py	5811 bytes	0644
constants.py	6762 bytes	0644
crypto_util.py	16227 bytes	0644
eff.py	3138 bytes	0644
error_handler.py	7086 bytes	0644
errors.py	2655 bytes	0644
hooks.py	9051 bytes	0644
interfaces.py	22042 bytes	0644
lock.py	9784 bytes	0644
log.py	12724 bytes	0644
main.py	49992 bytes	0644
notify.py	1064 bytes	0644
ocsp.py	13137 bytes	0644
renewal.py	21388 bytes	0644
reporter.py	3547 bytes	0644
reverter.py	24546 bytes	0644
ssl-dhparams.pem	424 bytes	0644
storage.py	46074 bytes	0644
updater.py	3954 bytes	0644
util.py	19548 bytes	0644

File Content: eff.py

File Content: `eff.py`