Users
Base class from which all other Users classes should be derived.
The Users class is accessible via the authkit.users module.
Methods
f group_delete(self, group) ...
Remove the group specified. Rasies an exception if the group is still in use. To delete the group and remove it from all existing users use group_delete_cascade()
f group_delete_cascade(self, group) ...
Remove the group specified and remove the group from any users who used it
f group_exists(self, group) ...
Returns True if the group exists, False otherwise. Groups are case insensitive.
f role_delete(self, role) ...
Remove the role specified. Rasies an exception if the role is still in use. To delete the role and remove it from all existing users use role_delete_cascade()
f role_delete_cascade(self, role) ...
Remove the role specified and remove the role from any users who used it
f role_exists(self, role) ...
Returns True if the role exists, False otherwise. Roles are case insensitive.
f user(self, username) ...
Returns a dictionary in the following format:
1 2 3 4 5 6 | { 'username': username, 'group': group, 'password': password, 'roles': [role1,role2,role3... etc] } |
The role names are ordered alphabetically Raises an exception if the user doesn't exist.
f user_add_role(self, username, role, add_if_necessary=False) ...
Sets the user's role to the lowercase of role. If the role doesn't exist and add_if_necessary is True the role will also be added. Otherwise an AuthKitNoSuchRoleError will be raised. Raises an exception if the user doesn't exist.
f user_create(self, username, password, group=None) ...
Create a new user with the username, password and group name specified.
f user_exists(self, username) ...
Returns True if a user exists with the given username, False otherwise. Usernames are case insensitive.
f user_group(self, username) ...
Returns the group associated with the user or None if no group is associated. Raises an exception is the user doesn't exist.
f user_has_group(self, username, group) ...
Returns True if the user has the group specified, False otherwise. The value for group can be None to test that the user doesn't belong to a group. Raises an exception if the user doesn't exist.
f user_has_password(self, username, password) ...
Returns True if the user has the password specified, False otherwise. Passwords are case sensitive. Raises an exception if the user doesn't exist.
f user_has_role(self, username, role) ...
Returns True if the user has the role specified, False otherwise. Raises an exception if the user doesn't exist.
f user_password(self, username) ...
Returns the password associated with the user or None if no password exists. Raises an exception is the user doesn't exist.
f user_remove_group(self, username) ...
Sets the group to None for the user specified by username. Raises an exception if the user doesn't exist.
f user_remove_role(self, username, role) ...
Removes the role from the user specified by username. Raises an exception if the user doesn't exist.
f user_roles(self, username) ...
Returns a list of all the role names for the given username ordered alphabetically. Raises an exception if the username doesn't exist.
f user_set_group(self, username, group, add_if_necessary=False) ...
Sets the user's group to the lowercase of group or None. If the group doesn't exist and add_if_necessary is True the group will also be added. Otherwise an AuthKitNoSuchGroupError will be raised. Raises an exception if the user doesn't exist.
f user_set_username(self, username, new_username) ...
Sets the user's username to the lowercase of new_username. Raises an exception if the user doesn't exist or if there is already a user with the username specified by new_username.
See the source for more information.
