UserKit.RoleUserManagerToFile | index /usr/local/share/webware/UserKit/RoleUserManagerToFile.py

Classes

``

UserKit.RoleUserManagerMixIn.RoleUserManagerMixIn
  RoleUserManagerToFile(UserKit.UserManagerToFile.UserManagerToFile, UserKit.RoleUserManagerMixIn.RoleUserManagerMixIn)
UserKit.UserManagerToFile.UserManagerToFile(UserKit.UserManager.UserManager)
  RoleUserManagerToFile(UserKit.UserManagerToFile.UserManagerToFile, UserKit.RoleUserManagerMixIn.RoleUserManagerMixIn)

class RoleUserManagerToFile(UserKit.UserManagerToFile.UserManagerToFile, UserKit.RoleUserManagerMixIn.RoleUserManagerMixIn)
`` | `See the base classes for more information.`

Method resolution order:
  RoleUserManagerToFile
  UserKit.UserManagerToFile.UserManagerToFile
  UserKit.UserManager.UserManager
  UserKit.RoleUserManagerMixIn.RoleUserManagerMixIn

Methods defined here:

__init__(self, userClass=None)

Methods inherited from UserKit.UserManagerToFile.UserManagerToFile:

activeUsers(self)

addUser(self, user)

decoder(self)

encoder(self)

inactiveUsers(self)

initNextSerialNum(self)

loadUser(self, serialNum, default=<class MiscUtils.NoDefault>)
  `Loads the user with the given serial number from disk.
  If there is no such user, a KeyError will be raised unless a default value was passed, in which case that value is returned.`

nextSerialNum(self)

scanSerialNums(self)
  `Returns a list of all the serial numbers of users found on disk. Serial numbers are always integers.`

setEncoderDecoder(self, encoder, decoder)

setUserClass(self, userClass)
  `Overridden to mix in UserMixIn to the class that is passed in.`

setUserDir(self, userDir)
  `Sets the directory where user information is stored. You should strongly consider invoking initNextSerialNum() afterwards.`

userDir(self)

userForExternalId(self, externalId, default=<class MiscUtils.NoDefault>)

userForName(self, name, default=<class MiscUtils.NoDefault>)

userForSerialNum(self, serialNum, default=<class MiscUtils.NoDefault>)

users(self)

wasInstalled(self, owner)

Data and other attributes inherited from UserKit.UserManagerToFile.UserManagerToFile:

baseOfUserManagerToFile = <class UserKit.UserManager.UserManager>
  `A UserManager manages a set of users including authentication, indexing and persistence. Keep in mind that UserManager is abstract; you will always use one of the concrete subclasses (but please read the rest of this doc string):
  * UserManagerToFile
  * UserManagerToMiddleKit
  You can create a user through the manager (preferred):
  user = manager.createUser(name, password)
  Or directly through the user class:
  user = RoleUser(manager, name, password)
  manager.addUser(user)
  The manager tracks users by whether or not they are "active" (e.g., logged in) and indexes them by:
  * user serial number
  * external user id
  * user name
  These methods provide access to the users by these keys:
  def userForSerialNum(self, serialNum, default=NoDefault)
  def userForExternalId(self, extId, default=NoDefault)
  def userForName(self, name, default=NoDefault)
  UserManager provides convenient methods for iterating through the various users. Each method returns an object that can be used in a for loop and asked for its len():
  def users(self)
  def activeUsers(self)
  def inactiveUsers(self)
  You can authenticate a user by passing the user object and attempted password to login(). If the authentication is successful, then login() returns the User, otherwise it returns None:
  user = mgr.userForExternalId(externalId)
  if mgr.login(user, password):
  doSomething()
  As a convenience, you can authenticate by passing the serialNum, externalId or name of the user:
  def loginSerialNum(self, serialNum, password):
  def loginExternalId(self, externalId, password):
  def loginName(self, userName, password):
  The user will automatically log out after a period of inactivity (see below), or you can make it happen with:
  def logout(self, user):
  There are three user states that are important to the manager:
  * modified
  * cached
  * authenticated or "active"
  A modified user is one whose data has changed and eventually requires storage to a persistent location. A cached user is a user whose data resides in memory (regardless of the other states). An active user has been authenticated (e.g., their username and password were checked) and has not yet logged out or timed out.
  The manager keeps three timeouts, expressed in minutes, to:
  * save modified users after a period of time following the first unsaved modification
  * push users out of memory after a period of inactivity
  * deactive (e.g., log out) users after a period of inactivity
  The methods for managing these values deal with the timeouts as number-of-minutes. The default values and the methods are:
  * 20 modifiedUserTimeout() setModifiedUserTimeout()
  * 20 cachedUserTimeout() setCachedUserTimeout()
  * 20 activeUserTimeout() setActiveUserTimeout()
  @@ 2001-02-16 ce: Should we take out "User" in the names of the above 6 methods? Maybe it's redundant.
  Subclasses of UserManager provide persistence such as to the file system or a MiddleKit store. Subclasses must implement all methods that raise AbstractError's. Subclasses typically override (while still invoking super) addUser().
  Subclasses should ensure "uniqueness" of users. For example, invoking any of the userForSomething() methods repeatedly should always return the same user instance for a given key. Without uniqueness, consistency issues could arise with users that are modified.
  Please read the method doc strings and other class documentation to fully understand UserKit.`

Methods inherited from UserKit.UserManager.UserManager:

activeUserTimeout(self)

cachedUserTimeout(self)

clearCache(self)
  `Clears the cache of the manager. Use with extreme caution. If your program maintains a reference to a user object, but the manager loads in a new copy later on, then consistency problems could occur.
  The most popular use of this method is in the regression test suite.`

createUser(self, name, password, userClass=None)
  `Returns a newly created user that is added to the manager. If userClass is not specified, the manager's default user class is instantiated.
  This not imply that the user is logged in.
  This method invokes addUser().
  See also: userClass(), setUserClass()`

login(self, user, password)
  `Returns the user if the login is successful, otherwise returns None.`

loginExternalId(self, externalId, password)

loginName(self, userName, password)

loginSerialNum(self, serialNum, password)

logout(self, user)

modifiedUserTimeout(self)

numActiveUsers(self)
  `Returns the number of active users, e.g., users that are logged in.`

setActiveUserTimeout(self, value)

setCachedUserTimeout(self, value)

setModifiedUserTimeout(self, value)

shutDown(self)
  `Performs any tasks necessary to shut down the user manager. Subclasses may override and must invoke super as their *last* step.`

userClass(self)
  `Returns the userClass, which is used by createUser. The default value is UserKit.User.User.`

Methods inherited from UserKit.RoleUserManagerMixIn.RoleUserManagerMixIn:

addRole(self, role)

clearRoles(self)

delRole(self, name)

hasRole(self, name)

initUserClass(self)
  `Invoked by __init__ to set the default user class to
  RoleUser.`

role(self, name, default=<class MiscUtils.NoDefault>)

roles(self)