# -*- coding: iso-8859-1 -*-
"""
MoinMoin - creates user homepage for existing accounts

@copyright: 2009 MoinMoin:ReimarBauer
@license: GNU GPL, see COPYING for details.
"""

from MoinMoin import user, wikidicts
from MoinMoin.Page import Page
from MoinMoin.PageEditor import PageEditor
from MoinMoin.script import MoinScript
from MoinMoin.mail.sendmail import encodeSpamSafeEmail


class PluginScript(MoinScript):
    """\
Purpose:
========
This tool allows you to create user homepages via a command line interface.
For a wiki using hierarchical acls enabled it can become difficult to create
for a user his homepage because if there isn't default write right given.
It creates all user homepages if you don't give restrictions.

Detailed Instructions:
======================
General syntax: moin [options] account homepage [create-options]

[options] usually should be:
    --config-dir=/path/to/my/cfg/ --wiki-url=wiki.example.org/

1. Required is one of the options --name, --group or --all-users.
The --name argument could be added to the above examples to create the homepage
only for this name or the --group argument to create only homepages for members
of the given group. Or with --all-users you create homepages for ALL users.
2. Optionally, the --user argument could be added to the above examples,
causing the script to respect ACLs. The homepage creation is then done by this user name.
3. Optionally, the --template_page argument could be added to the above examples,
to give a template for the page creation. With e.g. #acl @ME@:read,write,delete,revert Default
on the page you can define acl rights for the user.
@EMAIL@ becomes expanded to the users obfuscated mail address.
"""

    def __init__(self, argv, def_values):
        MoinScript.__init__(self, argv, def_values)

        self.parser.add_option(
            "-u", "--user", dest="homepage_creater",
            help="User as whom the homepage creation operation will be performed as."
            )

        self.parser.add_option(
            "-t", "--template_page", dest="template_page",
            help="The template page which should be used for the homepage creation"
            )

        self.parser.add_option(
            "-n", "--name", dest="user_homepage",
            help="The name of the user the homepage should be created for."
            )

        self.parser.add_option(
            "-g", "--group", dest="name_of_group_page",
            help="The name of the group page to select users for creating their homepages."
            )

        self.parser.add_option(
            "-a", "--all-users", dest="all_users",
            help="The name of the group page to select users for creating their homepages."
            )

    def create_homepage(self, homepage_default_text, account):
        homepage_text = homepage_default_text % {
                                                 "username": account.name,
                                                 "obfuscated_mail": encodeSpamSafeEmail(account.email)
                                                 }
        self.write_homepage(account, homepage_text)

    def write_homepage(self, account, homepage_text):
        # writes the homepage
        if  account.exists() and not account.disabled and not Page(self.request, account.name).exists():
            userhomepage = PageEditor(self.request, account.name)
            try:
                userhomepage.saveText(homepage_text, 0)
                print "INFO homepage for %s created." % account.name
            except userhomepage.Unchanged:
                print "You did not change the page content, not saved!"
            except userhomepage.NoAdmin:
                print "You don't have enough rights to create the %s page" % account.name
        else:
            print "INFO homepage for %s already exists or account is disabled or user does not exist." % account.name

    def mainloop(self):
        # we don't expect non-option arguments
        self.init_request()
        request = self.request
        # Checks for a template page and sets homepage_default_text
        if self.options.template_page and Page(self.request, self.options.template_page).exists():
            homepage_default_text = Page(self.request, self.options.template_page).get_raw_body()
            # replace is needed because substitution is done for request.user
            # see option --user
            homepage_default_text = homepage_default_text.replace('@ME@', "%(username)s")
            homepage_default_text = homepage_default_text.replace('@EMAIL@', "<<MailTo(%(obfuscated_mail)s)>>")
        else:
            homepage_default_text = '''#acl %(username)s:read,write,delete,revert Default

== %(username)s ==

Email: <<MailTo(%(obfuscated_mail)s)>>
## You can even more obfuscate your email address by adding more uppercase letters followed by a leading and trailing blank.

----
CategoryHomepage
'''
        # Check for user
        if self.options.homepage_creater:
            uid = user.getUserId(request, self.options.homepage_creater)
            request.user = user.User(request, uid)
        # Check for Group definition
        members = []
        if self.options.user_homepage:
            members = [self.options.user_homepage, ]
        elif self.options.name_of_group_page:
            user_group = wikidicts.Group(request, self.options.name_of_group_page)
            members = user_group.members()
        elif self.options.all_users:
            uids = user.getUserList(request)
            members = [user.User(request, uid).name for uid in uids]

        if not members:
            print "See additional options because no user was found or look for a typo."
            return

        # loop though members for creating homepages
        for name in members:
            uid = user.getUserId(request, name)
            account = user.User(request, uid)
            self.create_homepage(homepage_default_text, account)
