github_team_members - new module for managing team membership

[john-westcott-iv]

SUMMARY

New module github_team_members for managing team membership in GitHub organizations.

Features:

• Three state modes:
  • present — ensure listed members are on the team (additive, does not remove others)
  • absent — ensure listed members are NOT on the team (subtractive)
  • exact — make team membership exactly match the provided list (adds missing, removes extras, corrects roles)
• Members can be specified as bare strings (default role: member) or dicts with username and role
• Supports member and maintainer roles
• Returns added, removed, updated, and final members lists
• Full check mode support
• Uses PyGithub

ISSUE TYPE

• New Module Pull Request

COMPONENT NAME

github_team_members

ADDITIONAL INFORMATION

• Unit tests covering all three state modes, idempotency, role updates, and the normalize helper
• BOTMETA entry added
• Companion to github_team module (manages team CRUD)

🤖 Generated with Claude Code

[ansibullbot]

The test ansible-test sanity --test validate-modules [explain] failed with 3 errors:

plugins/modules/github_team_members.py:0:0: invalid-documentation-markup: Directive "O(members[].role)" contains a non-existing option "members[].role"
plugins/modules/github_team_members.py:0:0: invalid-documentation-markup: Directive "O(members[].username)" contains a non-existing option "members[].username"
plugins/modules/github_team_members.py:0:0: module-invalid-version-added: DOCUMENTATION: version_added ('NEXT_PATCH') is not a valid collection version (see specification at https://semver.org/): invalid semantic version 'NEXT_PATCH'. Got {'module': 'github_team_members', 'short_description': 'Manage team membership on Github organizations', 'version_added': 'NEXT_PATCH', 'description': ['Manage the members of a team in a Github organization using the PyGithub library.', 'Supports adding, removing, and synchronizing team members with three state modes.', 'Authentication can be done with O(access_token) or with O(username) and O(password).'], 'attributes': {'check_mode': {'description': 'Can run in C(check_mode) and return chan...

The test ansible-test sanity --test validate-modules [explain] failed with 3 errors:

plugins/modules/github_team_members.py:0:0: invalid-documentation-markup: Directive "O(members[].role)" contains a non-existing option "members[].role"
plugins/modules/github_team_members.py:0:0: invalid-documentation-markup: Directive "O(members[].username)" contains a non-existing option "members[].username"
plugins/modules/github_team_members.py:0:0: module-invalid-version-added: DOCUMENTATION: version_added ('NEXT_PATCH') is not a valid collection version (see specification at https://semver.org/): invalid semantic version 'NEXT_PATCH'. Got {'module': 'github_team_members', 'short_description': 'Manage team membership on Github organizations', 'version_added': 'NEXT_PATCH', 'description': ['Manage the members of a team in a Github organization using the PyGithub library.', 'Supports adding, removing, and synchronizing team members with three state modes.', 'Authentication can be done with O(access_token) or with O(username) and O(password).'], 'attributes': {'check_mode': {'description': 'Can run in C(check_mode) and return chan...

The test ansible-test sanity --test validate-modules [explain] failed with 3 errors:

plugins/modules/github_team_members.py:0:0: invalid-documentation-markup: Directive "O(members[].role)" contains a non-existing option "members[].role"
plugins/modules/github_team_members.py:0:0: invalid-documentation-markup: Directive "O(members[].username)" contains a non-existing option "members[].username"
plugins/modules/github_team_members.py:0:0: module-invalid-version-added: DOCUMENTATION: version_added ('NEXT_PATCH') is not a valid collection version (see specification at https://semver.org/): invalid semantic version 'NEXT_PATCH'. Got {'module': 'github_team_members', 'short_description': 'Manage team membership on Github organizations', 'version_added': 'NEXT_PATCH', 'description': ['Manage the members of a team in a Github organization using the PyGithub library.', 'Supports adding, removing, and synchronizing team members with three state modes.', 'Authentication can be done with O(access_token) or with O(username) and O(password).'], 'attributes': {'check_mode': {'description': 'Can run in C(check_mode) and return chan...

The test ansible-test sanity --test validate-modules [explain] failed with 3 errors:

plugins/modules/github_team_members.py:0:0: invalid-documentation-markup: Directive "O(members[].role)" contains a non-existing option "members[].role"
plugins/modules/github_team_members.py:0:0: invalid-documentation-markup: Directive "O(members[].username)" contains a non-existing option "members[].username"
plugins/modules/github_team_members.py:0:0: module-invalid-version-added: DOCUMENTATION: version_added ('NEXT_PATCH') is not a valid collection version (see specification at https://semver.org/): invalid semantic version 'NEXT_PATCH'. Got {'module': 'github_team_members', 'short_description': 'Manage team membership on Github organizations', 'version_added': 'NEXT_PATCH', 'description': ['Manage the members of a team in a Github organization using the PyGithub library.', 'Supports adding, removing, and synchronizing team members with three state modes.', 'Authentication can be done with O(access_token) or with O(username) and O(password).'], 'attributes': {'check_mode': {'description': 'Can run in C(check_mode) and return chan...

click here for bot help

[ansibullbot]

cc @stpierre
click here for bot help

[russoz]

Same as in previous PR.