byceps.blueprints.admin.user.views

Complexity

Total Complexity

60

Size/Duplication

Total Lines	790
Duplicated Lines	14.43 %

Test Coverage

Coverage

56.1%

Importance

Changes

0

28 Functions

Rating	Name	Duplication	Size	Complexity
A	_calculate_days_since()	0	5	2
A	delete_account_form()	0	23	3
A	unsuspend_account()	35	36	3
A	change_email_address()	0	30	2
B	create_account()	0	62	5
A	view()	0	41	1
A	set_password()	0	23	2
A	role_deassign()	0	18	1
A	change_screen_name_form()	0	14	2
A	_get_role_or_404()	0	7	2
A	view_events()	0	21	2
A	manage_roles()	0	19	1
A	invalidate_email_address()	0	32	3
A	invalidate_email_address_form()	0	18	3
A	change_email_address_form()	0	14	2
A	delete_account()	0	34	3
A	set_password_form()	0	14	2
A	role_assign()	0	18	1
A	initialize_account()	0	15	1
A	_get_db_user_with_details_or_404()	0	7	2
A	unsuspend_account_form()	23	23	3
A	suspend_account_form()	23	23	3
A	index()	0	35	1
A	create_account_form()	0	9	2
A	_get_user_or_404()	0	7	2
A	view_permissions()	0	18	1
A	suspend_account()	33	34	3
A	change_screen_name()	0	30	2

"""
byceps.blueprints.admin.user.views
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

:Copyright: 2006-2021 Jochen Kupperschmidt
:License: Revised BSD (see `LICENSE` file for details)
"""

from datetime import datetime
from typing import Optional

from flask import abort, g, request
from flask_babel import gettext

from ....services.authentication.password import service as password_service
from ....services.authentication.session import service as session_service
from ....services.authorization import service as authorization_service
from ....services.orga_team import service as orga_team_service
from ....services.shop.order import service as order_service
from ....services.shop.shop import service as shop_service
from ....services.site import service as site_service
from ....services.user import (
    command_service as user_command_service,
    creation_service as user_creation_service,
    deletion_service as user_deletion_service,
    email_address_verification_service,
    service as user_service,
    stats_service as user_stats_service,
)
from ....services.user_badge import awarding_service as badge_awarding_service
from ....signals import user as user_signals
from ....util.authorization import register_permission_enum
from ....util.framework.blueprint import create_blueprint
from ....util.framework.flash import flash_error, flash_success
from ....util.framework.templating import templated
from ....util.views import permission_required, redirect_to, respond_no_content

from ..authorization.authorization import RolePermission

from .authorization import UserPermission
from .forms import (
    ChangeEmailAddressForm,
    ChangeScreenNameForm,
    CreateAccountForm,
    DeleteAccountForm,
    InvalidateEmailAddressForm,
    SetPasswordForm,
    SuspendAccountForm,
)
from .models import UserStateFilter
from . import service


blueprint = create_blueprint('user_admin', __name__)


register_permission_enum(UserPermission)


@blueprint.get('/', defaults={'page': 1})
@blueprint.get('/pages/<int:page>')
@permission_required(UserPermission.view)
@templated
def index(page):
    """List users."""
    per_page = request.args.get('per_page', type=int, default=20)
    search_term = request.args.get('search_term', default='').strip()
    only = request.args.get('only')

    user_state_filter = UserStateFilter.__members__.get(
        only, UserStateFilter.none
    )

    users = service.get_users_paginated(
        page, per_page, search_term=search_term, state_filter=user_state_filter
    )

    total_active = user_stats_service.count_active_users()
    total_uninitialized = user_stats_service.count_uninitialized_users()
    total_suspended = user_stats_service.count_suspended_users()
    total_deleted = user_stats_service.count_deleted_users()
    total_overall = user_stats_service.count_users()

    return {
        'users': users,
        'total_active': total_active,
        'total_uninitialized': total_uninitialized,
        'total_suspended': total_suspended,
        'total_deleted': total_deleted,
        'total_overall': total_overall,
        'search_term': search_term,
        'only': only,
        'UserStateFilter': UserStateFilter,
        'user_state_filter': user_state_filter,
    }


@blueprint.get('/<uuid:user_id>')
@permission_required(UserPermission.view)
@templated
def view(user_id):
    """Show a user's interal profile."""
    db_user = _get_db_user_with_details_or_404(user_id)
    user = user_service.get_user(db_user.id, include_avatar=True)

    recent_login = session_service.find_recent_login(user.id)
    days_since_recent_login = _calculate_days_since(recent_login)

    orga_activities = orga_team_service.get_orga_activities_for_user(user.id)

    newsletter_subscriptions = service.get_newsletter_subscriptions(user.id)

    orders = order_service.get_orders_placed_by_user(user.id)

    order_shop_ids = {order.shop_id for order in orders}
    shops = shop_service.find_shops(order_shop_ids)
    shops_by_id = {shop.id: shop for shop in shops}

    parties_and_tickets = service.get_parties_and_tickets(user.id)

    attended_parties = service.get_attended_parties(user.id)

    badges_with_awarding_quantity = (
        badge_awarding_service.get_badges_awarded_to_user(user.id)
    )

    return {
        'user': db_user,
        'user_dto': user,
        'recent_login': recent_login,
        'days_since_recent_login': days_since_recent_login,
        'orga_activities': orga_activities,
        'newsletter_subscriptions': newsletter_subscriptions,
        'orders': orders,
        'shops_by_id': shops_by_id,
        'parties_and_tickets': parties_and_tickets,
        'attended_parties': attended_parties,
        'badges_with_awarding_quantity': badges_with_awarding_quantity,
    }


def _calculate_days_since(dt: Optional[datetime]) -> Optional[int]:
    if dt is None:
        return None

    return (datetime.utcnow().date() - dt.date()).days


# -------------------------------------------------------------------- #
# account


@blueprint.get('/create')
@permission_required(UserPermission.create)
@templated
def create_account_form(erroneous_form=None):
    """Show a form to create a user account."""
    form = erroneous_form if erroneous_form else CreateAccountForm()
    form.set_site_choices()

    return {'form': form}


@blueprint.post('/')
@permission_required(UserPermission.create)
def create_account():
    """Create a user account."""
    form = CreateAccountForm(request.form)
    form.set_site_choices()

    if not form.validate():
        return create_account_form(form)

    screen_name = form.screen_name.data.strip()
    first_names = form.first_names.data.strip()
    last_name = form.last_name.data.strip()
    email_address = form.email_address.data.lower()
    password = form.password.data
    site_id_for_email = form.site_id.data

    if site_id_for_email:
        site_for_email = site_service.get_site(site_id_for_email)
    else:
        site_for_email = None

    initiator_id = g.user.id

    try:
        user, event = user_creation_service.create_basic_user(
            screen_name,
            email_address,
            password,
            first_names=first_names,
            last_name=last_name,
            creator_id=initiator_id,
            # Do not pass site ID here; the account is not created on a site.
        )
    except user_creation_service.UserCreationFailed:
        flash_error(
            gettext(
                'User "%(screen_name)s" could not be created.',
                screen_name=screen_name,
            )
        )
        return create_account_form(form)

    flash_success(
        gettext(
            'User "%(screen_name)s" has been created.',
            screen_name=user.screen_name,
        )
    )

    if site_for_email:
        user_creation_service.request_email_address_confirmation(
            user, email_address, site_id_for_email.id
        )
        flash_success(
            gettext('An email has been sent to the corresponding address.'),
            icon='email',
        )

    user_signals.account_created.send(None, event=event)

    return redirect_to('.view', user_id=user.id)


@blueprint.post('/<uuid:user_id>/initialize')
@permission_required(UserPermission.administrate)
@respond_no_content
def initialize_account(user_id):
    """Initialize the user account."""
    user = _get_user_or_404(user_id)

    initiator_id = g.user.id

    user_command_service.initialize_account(user.id, initiator_id=initiator_id)

    flash_success(
        gettext(
            "User '%(screen_name)s' has been initialized.",
            screen_name=user.screen_name,
        )
    )


@blueprint.get('/<uuid:user_id>/suspend')
@permission_required(UserPermission.administrate)
@templated
def suspend_account_form(user_id, erroneous_form=None):
    """Show form to suspend the user account."""
    db_user = _get_db_user_with_details_or_404(user_id)
    user = user_service.get_user(db_user.id, include_avatar=True)

    if user.suspended:
        flash_error(
            gettext(
                "User '%(screen_name)s' is already suspended.",
                screen_name=user.screen_name,
            )
        )
        return redirect_to('.view', user_id=user.id)

    form = erroneous_form if erroneous_form else SuspendAccountForm()

    return {
        'user': db_user,
        'user_dto': user,
        'form': form,
    }


@blueprint.post('/<uuid:user_id>/suspend')
@permission_required(UserPermission.administrate)
def suspend_account(user_id):
    """Suspend the user account."""
    user = _get_user_or_404(user_id)

    if user.suspended:
        flash_error(
            gettext(
                "User '%(screen_name)s' is already suspended.",
                screen_name=user.screen_name,
            )
        )
        return redirect_to('.view', user_id=user.id)

    form = SuspendAccountForm(request.form)
    if not form.validate():
        return suspend_account_form(user.id, form)

    initiator_id = g.user.id
    reason = form.reason.data.strip()

    event = user_command_service.suspend_account(user.id, initiator_id, reason)

    user_signals.account_suspended.send(None, event=event)

    flash_success(
        gettext(
            "User '%(screen_name)s' has been suspended.",
            screen_name=user.screen_name,
        )
    )

    return redirect_to('.view', user_id=user.id)


@blueprint.get('/<uuid:user_id>/unsuspend')
@permission_required(UserPermission.administrate)
@templated
def unsuspend_account_form(user_id, erroneous_form=None):
    """Show form to unsuspend the user account."""
    db_user = _get_db_user_with_details_or_404(user_id)
    user = user_service.get_user(db_user.id, include_avatar=True)

    if not user.suspended:
        flash_error(
            gettext(
                "User '%(screen_name)s' is not suspended.",
                screen_name=user.screen_name,
            )
        )
        return redirect_to('.view', user_id=user.id)

    form = erroneous_form if erroneous_form else SuspendAccountForm()

    return {
        'user': db_user,
        'user_dto': user,
        'form': form,
    }


@blueprint.post('/<uuid:user_id>/unsuspend')
@permission_required(UserPermission.administrate)
def unsuspend_account(user_id):
    """Unsuspend the user account."""
    user = _get_user_or_404(user_id)

    if not user.suspended:
        flash_error(
            gettext(
                "User '%(screen_name)s' is not suspended.",
                screen_name=user.screen_name,
            )
        )
        return redirect_to('.view', user_id=user.id)

    form = SuspendAccountForm(request.form)
    if not form.validate():
        return unsuspend_account_form(user.id, form)

    initiator_id = g.user.id
    reason = form.reason.data.strip()

    event = user_command_service.unsuspend_account(
        user.id, initiator_id, reason
    )

    user_signals.account_unsuspended.send(None, event=event)

    flash_success(
        gettext(
            "User '%(screen_name)s' has been unsuspended.",
            screen_name=user.screen_name,
        )
    )

    return redirect_to('.view', user_id=user.id)


@blueprint.get('/<uuid:user_id>/delete')
@permission_required(UserPermission.administrate)
@templated
def delete_account_form(user_id, erroneous_form=None):
    """Show form to delete the user account."""
    db_user = _get_db_user_with_details_or_404(user_id)
    user = user_service.get_user(db_user.id, include_avatar=True)

    if user.deleted:
        flash_error(
            gettext(
                "User '%(screen_name)s' has already been deleted.",
                screen_name=user.screen_name,
            )
        )
        return redirect_to('.view', user_id=user.id)

    form = erroneous_form if erroneous_form else DeleteAccountForm()

    return {
        'user': db_user,
        'user_dto': user,
        'form': form,
    }


@blueprint.post('/<uuid:user_id>/delete')
@permission_required(UserPermission.administrate)
def delete_account(user_id):
    """Delete the user account."""
    user = _get_user_or_404(user_id)

    if user.deleted:
        flash_error(
            gettext(
                "User '%(screen_name)s' has already been deleted.",
                screen_name=user.screen_name,
            )
        )
        return redirect_to('.view', user_id=user.id)

    form = DeleteAccountForm(request.form)
    if not form.validate():
        return delete_account_form(user.id, form)

    initiator_id = g.user.id
    reason = form.reason.data.strip()

    event = user_deletion_service.delete_account(user.id, initiator_id, reason)

    user_signals.account_deleted.send(None, event=event)

    flash_success(
        gettext(
            "User '%(screen_name)s' has been deleted.",
            screen_name=user.screen_name,
        )
    )

    return redirect_to('.view', user_id=user.id)


# -------------------------------------------------------------------- #
# screen name


@blueprint.get('/<uuid:user_id>/change_screen_name')
@permission_required(UserPermission.administrate)
@templated
def change_screen_name_form(user_id, erroneous_form=None):
    """Show form to change the user's screen name."""
    db_user = _get_db_user_with_details_or_404(user_id)
    user = user_service.get_user(db_user.id, include_avatar=True)

    form = erroneous_form if erroneous_form else ChangeScreenNameForm()

    return {
        'user': db_user,
        'user_dto': user,
        'form': form,
    }


@blueprint.post('/<uuid:user_id>/change_screen_name')
@permission_required(UserPermission.administrate)
def change_screen_name(user_id):
    """Change the user's screen name."""
    user = _get_user_or_404(user_id)

    form = ChangeScreenNameForm(request.form)
    if not form.validate():
        return change_screen_name_form(user.id, form)

    old_screen_name = user.screen_name
    new_screen_name = form.screen_name.data.strip()
    initiator_id = g.user.id
    reason = form.reason.data.strip()

    event = user_command_service.change_screen_name(
        user.id, new_screen_name, initiator_id, reason=reason
    )

    user_signals.screen_name_changed.send(None, event=event)

    flash_success(
        gettext(
            "User '%(old_screen_name)s' has been renamed to '%(new_screen_name)s'.",
            old_screen_name=old_screen_name,
            new_screen_name=new_screen_name,
        )
    )

    return redirect_to('.view', user_id=user.id)


# -------------------------------------------------------------------- #
# email address


@blueprint.get('/<uuid:user_id>/change_email_address')
@permission_required(UserPermission.administrate)
@templated
def change_email_address_form(user_id, erroneous_form=None):
    """Show form to change the user's e-mail address."""
    db_user = _get_db_user_with_details_or_404(user_id)
    user = user_service.get_user(db_user.id, include_avatar=True)

    form = erroneous_form if erroneous_form else ChangeEmailAddressForm()

    return {
        'user': db_user,
        'user_dto': user,
        'form': form,
    }


@blueprint.post('/<uuid:user_id>/change_email_address')
@permission_required(UserPermission.administrate)
def change_email_address(user_id):
    """Change the user's e-mail address."""
    user = _get_user_or_404(user_id)

    form = ChangeEmailAddressForm(request.form)
    if not form.validate():
        return change_email_address_form(user.id, form)

    old_email_address = user_service.find_email_address(user.id)
    new_email_address = form.email_address.data.strip()
    verified = False
    initiator_id = g.user.id
    reason = form.reason.data.strip()

    event = user_command_service.change_email_address(
        user.id, new_email_address, verified, initiator_id, reason=reason
    )

    user_signals.email_address_changed.send(None, event=event)

    flash_success(
        gettext(
            "Email address for user '%(screen_name)s' has been updated.",
            screen_name=user.screen_name,
        )
    )

    return redirect_to('.view', user_id=user.id)


@blueprint.get('/<uuid:user_id>/invalidate_email_address')
@permission_required(UserPermission.administrate)
@templated
def invalidate_email_address_form(user_id, erroneous_form=None):
    """Show form to invalidate the email address assigned with the account."""
    db_user = _get_db_user_with_details_or_404(user_id)
    user = user_service.get_user(db_user.id, include_avatar=True)

    if not db_user.email_address_verified:
        flash_error(gettext('Email address is already invalidated.'))
        return redirect_to('.view', user_id=user.id)

    form = erroneous_form if erroneous_form else InvalidateEmailAddressForm()

    return {
        'user': db_user,
        'user_dto': user,
        'form': form,
    }


@blueprint.post('/<uuid:user_id>/invalidate_email_address')
@permission_required(UserPermission.administrate)
def invalidate_email_address(user_id):
    """Invalidate the email address assigned with the account."""
    db_user = _get_db_user_with_details_or_404(user_id)
    user = user_service.get_user(db_user.id, include_avatar=True)

    if not db_user.email_address_verified:
        flash_error(gettext('Email address is already invalidated.'))
        return redirect_to('.view', user_id=user.id)

    form = InvalidateEmailAddressForm(request.form)
    if not form.validate():
        return invalidate_email_address_form(user.id, form)

    initiator_id = g.user.id
    reason = form.reason.data.strip()

    event = email_address_verification_service.invalidate_email_address(
        user.id, reason, initiator_id=initiator_id
    )

    user_signals.email_address_invalidated.send(None, event=event)

    flash_success(
        gettext(
            "The email address of user '%(screen_name)s' has been invalidated.",
            screen_name=user.screen_name,
        )
    )

    return redirect_to('.view', user_id=user.id)


# -------------------------------------------------------------------- #
# authentication


@blueprint.get('/<uuid:user_id>/password')
@permission_required(UserPermission.set_password)
@templated
def set_password_form(user_id, erroneous_form=None):
    """Show a form to set a new password for the user."""
    db_user = _get_db_user_with_details_or_404(user_id)
    user = user_service.get_user(db_user.id, include_avatar=True)

    form = erroneous_form if erroneous_form else SetPasswordForm()

    return {
        'user': db_user,
        'user_dto': user,
        'form': form,
    }


@blueprint.post('/<uuid:user_id>/password')
@permission_required(UserPermission.set_password)
def set_password(user_id):
    """Set a new password for the user."""
    user = _get_user_or_404(user_id)

    form = SetPasswordForm(request.form)
    if not form.validate():
        return set_password_form(user.id, form)

    new_password = form.password.data
    initiator_id = g.user.id

    password_service.update_password_hash(user.id, new_password, initiator_id)

    flash_success(
        gettext(
            "New password has been set for user '%(screen_name)s'.",
            screen_name=user.screen_name,
        )
    )

    return redirect_to('.view', user_id=user.id)


# -------------------------------------------------------------------- #
# authorization


@blueprint.get('/<uuid:user_id>/permissions')
@permission_required(UserPermission.view)
@templated
def view_permissions(user_id):
    """Show user's permissions."""
    db_user = _get_db_user_with_details_or_404(user_id)
    user = user_service.get_user(db_user.id, include_avatar=True)

    permissions_by_role = (
        authorization_service.get_permissions_by_roles_for_user_with_titles(
            user.id
        )
    )

    return {
        'user': db_user,
        'user_dto': user,
        'permissions_by_role': permissions_by_role,
    }


@blueprint.get('/<uuid:user_id>/roles/assignment')
@permission_required(RolePermission.assign)
@templated
def manage_roles(user_id):
    """Manage what roles are assigned to the user."""
    db_user = _get_db_user_with_details_or_404(user_id)
    user = user_service.get_user(db_user.id, include_avatar=True)

    permissions_by_role = (
        authorization_service.get_permissions_by_roles_with_titles()
    )

    user_role_ids = authorization_service.find_role_ids_for_user(user.id)

    return {
        'user': db_user,
        'user_dto': user,
        'permissions_by_role': permissions_by_role,
        'user_role_ids': user_role_ids,
    }


@blueprint.post('/<uuid:user_id>/roles/<role_id>')
@permission_required(RolePermission.assign)
@respond_no_content
def role_assign(user_id, role_id):
    """Assign the role to the user."""
    user = _get_user_or_404(user_id)
    role = _get_role_or_404(role_id)
    initiator_id = g.user.id

    authorization_service.assign_role_to_user(
        role.id, user.id, initiator_id=initiator_id
    )

    flash_success(
        gettext(
            '%(role_title)s has been assigned to "%(screen_name)s".',
            screen_name=user.screen_name,
            role_title=role.title,
        )
    )


@blueprint.delete('/<uuid:user_id>/roles/<role_id>')
@permission_required(RolePermission.assign)
@respond_no_content
def role_deassign(user_id, role_id):
    """Deassign the role from the user."""
    user = _get_user_or_404(user_id)
    role = _get_role_or_404(role_id)
    initiator_id = g.user.id

    authorization_service.deassign_role_from_user(
        role.id, user.id, initiator_id=initiator_id
    )

    flash_success(
        gettext(
            '%(role_title)s has been withdrawn from "%(screen_name)s".',
            screen_name=user.screen_name,
            role_title=role.title,
        )
    )


# -------------------------------------------------------------------- #
# events


@blueprint.get('/<uuid:user_id>/events')
@permission_required(UserPermission.view)
@templated
def view_events(user_id):
    """Show user's events."""
    db_user = _get_db_user_with_details_or_404(user_id)
    user = user_service.get_user(db_user.id, include_avatar=True)

    events = list(service.get_events(user.id))

    include_logins = request.args.get('include_logins', default='yes') == 'yes'
    if not include_logins:
        events = [
            event for event in events if event['event'] != 'user-logged-in'
        ]

    return {
        'user': db_user,
        'user_dto': user,
        'events': events,
        'logins_included': include_logins,
    }


# -------------------------------------------------------------------- #
# helpers


def _get_db_user_with_details_or_404(user_id):
    user = user_service.find_user_with_details(user_id)

    if user is None:
        abort(404)

    return user


def _get_user_or_404(user_id):
    user = user_service.find_user(user_id)

    if user is None:
        abort(404)

    return user


def _get_role_or_404(role_id):
    role = authorization_service.find_role(role_id)

    if role is None:
        abort(404)

    return role