users Package

users Package

Roles in this namespace are meant to enable user management in CentOS distributions.

user Module

Roles in this namespace are meant to provide user management operations for CentOS distributions.

class provy.more.centos.users.user.UserRole(prov, context)

Bases: provy.core.roles.Role

This role provides many utility methods for user management operations within CentOS distributions.

Example:

from provy.core import Role
from provy.more.centos import UserRole

class MySampleRole(Role):
    def provision(self):
        with self.using(UserRole) as role:
            role.ensure_user('myuser', identified_by='mypass', is_admin=True)

ensure_group(group_name, group_id=None)

Ensures that a given user group is present in the remote server.

Parameters:

• group_name (str) – Name of the group to create.
• group_id (int) – GID of the group. Defaults to None, which assigns the next available GID.

Example:

from provy.core import Role
from provy.more.centos import UserRole

class MySampleRole(Role):
    def provision(self):
        with self.using(UserRole) as role:
            role.ensure_group('users-group')

ensure_user(username, identified_by=None, home_folder=None, default_script='/bin/bash', groups=[], is_admin=False)

Ensures that a given user is present in the remote server.

Parameters:

• username (str) – Name of the user.
• identified_by (str) – Password that the user will use to login to the remote server. If set to None, the user will not have a password.
• user_id (str) – UID of the user. Defaults to None, which assigns the next available UID.
• home_folder (str) – Specifies the user’s home folder. Defaults to /home/<username>.
• default_script (str) – Sets the user’s default script, the one that will execute commands per default when logging in. Defaults to /bin/sh.
• groups (iterable) – Groups that this user belongs to. If the groups do not exist they are created prior to user creation. Defaults to the name of the user.
• is_admin (bool) – If set to True the user is added to the ‘wheel’ user group as well. Defaults to False.

Example:

from provy.core import Role
from provy.more.centos import UserRole

class MySampleRole(Role):
    def provision(self):
        with self.using(UserRole) as role:
            role.ensure_user('myuser', identified_by='mypass', is_admin=True)

ensure_user_groups(username, groups=[])

group_exists(group_name)

Returns True if the given group exist, False otherwise.

Parameters:group_name (str) – Name of the group to verify. Returns:Whether the group exists or not. Return type:bool

Example:

class MySampleRole(Role):
    def provision(self):
        with self.using(UserRole) as role:
            if role.group_exists('usersgroup'):
                pass

user_exists(username)

Returns True if the given user exist, False otherwise.

Parameters:username (str) – Name of the user to verify. Returns:Whether the user exists or not. Return type:bool

Example:

class MySampleRole(Role):
    def provision(self):
        with self.using(UserRole) as role:
            if role.user_exists('myuser'):
                pass

user_in_group(username, group_name)

Returns True if the given user is in the given group, False otherwise.

Parameters:

• username (str) – Name of the user to verify.
• group_name (str) – Name of the group to verify.

Returns:

Whether the user pertains to the group or not.

Return type:

bool

Example:

from provy.core import Role
from provy.more.centos import UserRole

class MySampleRole(Role):
    def provision(self):
        with self.using(UserRole) as role:
            if role.user_in_group('myuser', 'mygroup'):
                pass