idm

Base module IDM related classes and functions.

exception wmflib.idm.IdmValueError[source]

Bases: wmflib.exceptions.WmflibError

Raised by the IDM module value errors.

wmflib.idm.logoutd_args(description: Optional[str] = None, args: Optional[List] = None) argparse.Namespace[source]

Logout scripts common CLI for parsing the command line arguments.

When not using the higher level API wmflib.idm.LogoutdBase, a user could just implement their own script still using the same command line arguments processing, of the form:

from wmflib.idm import logoutd_args
args = logoutd_args('Some description')
# write your own script
Parameters
  • description (str) – the description to use

  • args (list) – A list of arguments to use (used for testing)

Returns

The parsed argparser Namespace

Return type

argparse.Namespace

class wmflib.idm.LogoutdBase(args: Optional[List] = None)[source]

Bases: abc.ABC

abstract Base class for a standardized API for logout scripts.

A simple logout.d python script would then be of the form:

from wmflib.idm import LogoutdBase

class MyLogoutd(LogoutdBase):
    """Some description."""

    def logout_user(self, user):
        # logout the given user

    def query_user(self, user):
        # check the login status of a given user

    def list(self):
        # list all active login sessions

logoutd = MyLogoutd()
raise SystemExit(logoutd.run())  # This includes the parsing of command line arguments.

abstract Init function.

Parameters

args (list) – A list of arguments to use (used for testing)

property user: str

Return either common_name or uid with a preference for common_name.

Returns

representing the user

Return type

(str)

abstract logout_user(user: str) int[source]

abstract Log out the specified user.

Parameters

user (User) – object representing the user

Returns

0 if the users session was successfully cleared otherwise 1

Return type

(int)

abstract query_user(user: str) int[source]

abstract Return status of logged in user.

Parameters

user (User) – object representing the user

Returns

1 if the user is logged in otherwise 0

Return type

(int)

abstract list() int[source]

abstract Return data of all logged in users.

Returns

0 on success non-zero on fail

Return type

(int)

run() int[source]

Execute the correct action.

Returns

exit code depends on command

Return type

(int)