"""
First Boot: Initial Plinth Configuration.

See docs/design/first-connection.mdwn for details.

The Plinth first-connection process has several stages:

0. The user connects to Plinth for the first time and is redirected from
   the home page to the Hello page.

1. The user sets the Box's name, the administrator's name and
   password, and the box's PGP key (optional).

2. The box generates and the user receives any PGP keys.

3. The box detects the network's configuration and restarts networking.

4. The user interacts with the box normally.
"""

import cherrypy
from django import forms
from django.core import validators
from gettext import gettext as _
from plugin_mount import PagePlugin
from modules.auth import add_user
from withsqlite.withsqlite import sqlite_db
import cfg
import config
import util


## TODO: flesh out these tests values
def valid_box_key(value):
    """Check whether box key is valid"""
    del value  # Unused

    return True


class State0Form(forms.Form):  # pylint: disable-msg=W0232
    """First boot state 0 form"""

    hostname = forms.CharField(
        label=_('Name your FreedomBox'),
        help_text=_('For convenience, your FreedomBox needs a name.  It \
should be something short that does not contain spaces or punctuation. \
"Willard" would be a good name while "Freestyle McFreedomBox!!!" would \
not. It must be alphanumeric, start with an alphabet and must not be greater \
than 63 characters in length.'),
        validators=[
            validators.RegexValidator(r'^[a-zA-Z][a-zA-Z0-9]{,62}$',
                                      _('Invalid hostname'))])

    username = forms.CharField(label=_('Username'))
    password = forms.CharField(label=_('Password'),
                               widget=forms.PasswordInput())

    box_key = forms.CharField(
        label=_('Box\'s key (optional)'), required=False,
        widget=forms.Textarea(), validators=[valid_box_key],
        help_text=_('Cryptographic keys are used so that Box\'s identity can \
proved when talking to you.  This key can be auto-generated, but if one \
already exists (from a prior FreedomBox, for example), you can paste it \
below.  This key should not be the same as your key because you are not your \
FreedomBox!'))


class FirstBoot(PagePlugin):
    """First boot wizard"""

    def __init__(self, *args, **kwargs):
        PagePlugin.__init__(self, *args, **kwargs)

        # this is the url this page will hang off of (/firstboot)
        self.register_page('firstboot')
        self.register_page('firstboot/state0')
        self.register_page('firstboot/state1')

    @cherrypy.expose
    def index(self, *args, **kwargs):
        return self.state0(*args, **kwargs)

    def generate_box_key(self):
        return "fake key"

    @cherrypy.expose
    def state0(self, **kwargs):
        """
        In this state, we do time config over HTTP, name the box and
        server key selection.

        All the parameters are form inputs.  They get passed in when
        the form is submitted.  This method checks the inputs and if
        they validate, uses them to take action.  If they do not
        validate, it displays the form to give the user a chance to
        input correct values.  It might display an error message (in
        the message parameter).

        message is an optional string that we can display to the
        user. It's a good place to put error messages.
        """

        # FIXME: reject connection attempt if db["state"] >= 5.
        ## Until LDAP is in place, we'll put the box key in the cfg.store_file
        status = self.get_state0()

        form = None
        messages = []

        if kwargs:
            form = State0Form(kwargs, prefix='firstboot')
            # pylint: disable-msg=E1101
            if form.is_valid():
                success = self._apply_state0(status, form.cleaned_data,
                                             messages)

                if success:
                    # Everything is good, permanently mark and move to page 2
                    with sqlite_db(cfg.store_file, table="firstboot",
                                   autocommit=True) as database:
                        database['state'] = 1

                        raise cherrypy.InternalRedirect('state1')
        else:
            form = State0Form(initial=status, prefix='firstboot')

        return util.render_template(template='firstboot_state0',
                                    title=_('First Boot!'), form=form,
                                    messages=messages)

    @staticmethod
    def get_state0():
        """Return the state for form state 0"""
        with sqlite_db(cfg.store_file, table="thisbox", autocommit=True) as \
                database:
            return {'hostname': config.get_hostname(),
                    'box_key': database.get('box_key', None)}

    def _apply_state0(self, old_state, new_state, messages):
        """Apply changes in state 0 form"""
        success = True
        with sqlite_db(cfg.store_file, table="thisbox", autocommit=True) as \
                database:
            database['about'] = 'Information about this FreedomBox'

            if new_state['box_key']:
                database['box_key'] = new_state['box_key']
            elif not old_state['box_key']:
                database['box_key'] = self.generate_box_key()

            if old_state['hostname'] != new_state['hostname']:
                config.set_hostname(new_state['hostname'])

            error = add_user(new_state['username'], new_state['password'],
                             'First user, please change', '', True)
            if error:
                messages.append(
                    ('error', _('User account creation failed: %s') % error))
                success = False
            else:
                messages.append(('success', _('User account created')))

        return success

    @staticmethod
    @cherrypy.expose
    def state1():
        """
        State 1 is when we have a box name and key.  In this state,
        our task is to provide a certificate and maybe to guide the
        user through installing it.  We automatically move to State 2,
        which is an HTTPS connection.

        TODO: HTTPS failure in State 2 should returns to state 1.
        """
        # TODO complete first_boot handling
        # Make sure the user is not stuck on a dead end for now.
        with sqlite_db(cfg.store_file, table='firstboot', autocommit=True) as \
                database:
            database['state'] = 5

        return util.render_template(template='firstboot_state1',
                                    title=_('Installing the Certificate'))