======
 USER 
======
| 

about
-----
| 

:author:  Bart Thate <bart@gozerbot.org>
:contact: IRCNET/#dunkbots
:website: http://plugins.gozerbot.org
:license: Public Domain
 
| 

description
-----------
| 

manage users

| 

commands
--------
| 


1) user-add

    user-add <name> <userhost> .. add <name> with <userhost> to the bot

    ::

        <user> !user-add dunker bart@localhost
        <output> dunker added to user database

2) user-addperm (setperms)

    add permission to user <name>

    ::

        <user> !user-addperm dunker rss
        <output> RSS perm added

3) user-addpermall

    user-addpermall <perm> .. add <permission> to all users

    ::

        <user> !addpermsall USER

4) user-addpermit

    user-addpermit <nick> <what> .. permit nick access to <what> .. use setperms to add permissions

    ::

        <user> !user-addpermit dunker todo
        <output> dunker is already allowed to do todo

5) user-addstatus (setstatus)

    user-addstatus <name> <status>

    ::

        <user> !user-addstatus dunker #bartbot
        <output> #BARTBOT status added

6) user-adduserhost (adduserhost)

    user-adduserhost <name> <userhost> .. add <userhost> to userhosts of <name>

    ::

        <user> !user-adduserhost dunker bart?@*.a2000.nl
        <output> userhost added

7) user-allperm

    user-allperm <perm> .. get users with <perm> permission

    ::

        <user> !user-allperm rss
        <output> dunker

8) user-allstatus

    user-allstatus <status> ..get users with <status> status

    ::

        <user> !user-allstatus #dunkbots
        <output> no users with #DUNKBOTS status found

9) user-check (check)

    user-check <nick>

    ::

        <user> !user-check dunker
        <output> userrecord = name: dunker userhosts: ['bart@gozerbot.org', 'bart?@*.a2000.nl'] perms: ['USER', 'RSS']
        <output>  email: bart@r8.cg.nu status: ['#BARTBOT'] allowed: [] notallowed: [] tempusershosts: [] permit: []

10) user-del (delete)

    user-del <name> .. delete user with <username>

    ::

        <user> !user-del dunker
        <output> dunker deleted

11) user-delemail (delemail)

    reset email

    ::

        <user> !user-delemail
        <output> email removed

12) user-delperm

    user-delperm <name> <perm> .. delete from user <name> permission <perm>

    ::

        <user> !user-delperms dunker rss

13) user-delpermall

    user-delpermall <perm> .. delete <permission> from all users

    ::

        <user> !delpermsall BLA

14) user-delpermit

    user-delpermit <name> <permit>

    ::

        <user> !user-delpermit dunker todo
        <output> can't find registered name of dunker

15) user-delstatus (delstatus)

    user-delstatus <name> <status>

    ::

        <user> !user-delstatus dunker #dunkbots
        <output> can't find user dunker

16) user-deluserhost (deluserhosts)

    user-deluserhost <name> <userhost> .. delete from usershosts of <name> userhost <userhost>

    ::

        <user> !user-deluserhost dunker bart1@bla.a2000.nl
        <output> can't find user dunker

17) user-email (email)

    get email

    ::

        <user> !user-email
        <output> no email set

18) user-getemail (getemail)

    user-getemail <name> .. get email from user <name>

    ::

        <user> !user-getemail dunker
        <output> can't find user dunker

19) user-getname (gn)

    user-getname <nick> .. get the name of <nick>

    ::

        <user> !user-getname dunker
        <output> can't find user for bart@gozerbot.org

20) user-getperms (getperms)

    user-getperms <name> .. get permissions of <name>

    ::

        <user> !user-getperms dunker
        <output> can't find user dunker

21) user-getstatus (getstatus)

    user-getstatus <name> .. get status of <name>

    ::

        <user> !user-getstatus dunker
        <output> can't find user dunker

22) user-getuserhosts (getuserhosts)

    user-getuserhosts <name> .. get userhosts of <name>

    ::

        <user> !user-getuserhosts dunker
        <output> can't find user dunker

23) user-match (match)

    user-match <userhost>

    ::

        <user> !user-match test@test
        <output> userrecord = name: test userhosts: ['test@test'] perms: ['OPER', 'USER', 'QUOTE'] email:  status: []
        <output>  allowed: [] notallowed: [] tempusershosts: [] permit: [('dunker', 'todo')]

24) user-meet (meet)

    meet <nick> .. introduce <nick> to the bot

    ::

        <user> !user-meet dunker
        <output> dunker added to user database

25) user-merge (merge)

    user-merge <name> <nick> .. merge record with <name> with userhost from <nick>

    ::

        <user> !merge bart dunker
        <output> we have no user bart

26) user-name (name)

    show name of user giving the command

    ::

        <user> !user-name
        <output> your name is test

27) user-names (names)

    show names of registered users

    ::

        <user> !user-names
        <output> owner .. web .. test .. root .. dunker

28) user-permit (permit)

    show permit of user giving the command

    ::

        <user> !user-permit
        <output> ('dunker', 'todo')

29) user-perms (perms)

    get permissions

    ::

        <user> !user-perms
        <output> OPER .. USER .. QUOTE

30) user-scan (us)

    user-scan <txt> .. search database for matching usernames

    ::

        <user> !user-scan dunk
        <output> dunker

31) user-search

    search for matching userhosts

    ::

        <user> !user-search r8
        <output> no userhost matching r8 found

32) user-setemail (setemail)

    user-setemail <name> <email>.. set email of user <name>

    ::

        <user> !user-setemail dunker bart@r8.cg.nu
        <output> email set

33) user-showuserhosts

34) user-status (status)

    get status

    ::

        <user> !user-status
        <output> you have no status set

35) user-userhosts (userhosts)

    get userhosts

    ::

        <user> !user-userhosts
        <output> test@test
