divekit members filter

Filter the configured members file

Synopsis

Filter members in a distribution before creating or updating repositories.

Use –include to keep only listed users. Use –exclude to remove listed users. The aliases retain, keep, and intersect use –include semantics.

Input Sources

  Interactive (default):
    Opens the multiline member input prompt when no arguments, --members-file,
    or stdin input are provided.

  Arguments:
    Provide one or more usernames as positional arguments.

  File:
    Use --members-file to read usernames from a file.

  Stdin:
    Pipe usernames into the command.

Usage

divekit members filter [member...] [flags]

Examples

# Keep only users listed in a file
divekit members filter -d ST2M5 --include --members-file passed-members.txt

# Equivalent include aliases
divekit members keep -d ST2M5 --members-file passed-members.txt
divekit members retain -d ST2M5 --members-file passed-members.txt

# Remove listed users
divekit members filter -d ST2M5 --exclude --members-file skipped-members.txt

# Preview filtering without changing config.json or members files
divekit members filter -d ST2M5 --include --members-file passed-members.txt --dry-run

Flags

--dry-run               Preview filtered members without writing a new members file
      --exclude               Remove listed members
      --include               Keep only listed members
      --members-file string   Path to a file with member names to filter (one per line)
  -r, --remote string         Remote repository URL (e.g. GitLab instance)
  -t, --token string          GitLab token or token file path (file:///...)

Inherited Flags

-d, --distribution string   Distribution name (required or prompted)
  -l, --loglevel string       log level (debug, info, warn, error, fatal) (default "info")
      --no-index              skip project index update
      --non-interactive       run in non-interactive mode (fails if interactive input is required)
  -y, --yes                   assume yes/default for all prompts (non-interactive with automatic defaults)

Parent Command