File: group.py

package info (click to toggle)
pytest-testinfra 10.2.2-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 676 kB
  • sloc: python: 4,951; makefile: 152; sh: 2
file content (73 lines) | stat: -rw-r--r-- 2,168 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

from testinfra.modules.base import Module


class Group(Module):
    """Test unix group"""

    def __init__(self, name):
        self.name = name
        super().__init__()

    @property
    def exists(self):
        """Test if group exists

        >>> host.group("wheel").exists
        True
        >>> host.group("nosuchgroup").exists
        False
        """
        return self.run_expect([0, 2], "getent group %s", self.name).rc == 0

    @property
    def get_all_groups(self):
        """Returns a list of local and remote group names

        >>> host.group("anyname").get_all_groups
        ["root", "wheel", "man", "tty", <...>]
        """
        all_groups = [
            line.split(":")[0]
            for line in self.check_output("getent group").splitlines()
        ]
        return all_groups

    @property
    def get_local_groups(self):
        """Returns a list of local group names

        >>> host.group("anyname").get_local_groups
        ["root", "wheel", "man", "tty", <...>]
        """
        local_groups = [
            line.split(":")[0]
            for line in self.check_output("cat /etc/group").splitlines()
        ]
        return local_groups

    @property
    def gid(self):
        return int(self.check_output("getent group %s | cut -d':' -f3", self.name))

    @property
    def members(self):
        """Return all users that are members of this group."""
        users = self.check_output("getent group %s | cut -d':' -f4", self.name)
        if users:
            return users.split(",")
        return []

    def __repr__(self):
        return f"<group {self.name}>"