UsersFromString
A Users class which cbtains user information from a string with lines formatted as` username1:password1:group role1, role2 etc where group is optional and zero or more roles can exist.
The UsersFromString class is accessible via the authkit.users module.
One set of user information should be on each line and extra whitespace is stripped.
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. Raises an exception if the user doesn't exist.
f user_has_password(self, username, password) ...
Passwords are case sensitive. Returns True if the user has the password specified, False otherwise. 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.
