lfidapi¶

                                                                                
 Usage: lftools-uv lfidapi [OPTIONS] COMMAND [ARGS]...                          
                                                                                
 LFID API tools for managing groups and members                                 
                                                                                
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help          Show this message and exit.                                  │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ search-members    List members of a group.                                   │
│ user              Add and remove users from groups.                          │
│ invite            Email invitation to join group.                            │
│ create-group      Create group.                                              │
│ match-ldap-info   Match LDAP information to INFO files.                      │
╰──────────────────────────────────────────────────────────────────────────────╯

Commands¶

create-group¶

                                                                                
 Usage: lftools-uv lfidapi create-group [OPTIONS] GROUP                         
                                                                                
 Create group.                                                                  
                                                                                
 Args: group: The name of the group to create                                   
                                                                                
 Examples: lftools-uv lfidapi create-group "new-group"                          
                                                                                
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ *    group      TEXT  Group name to create                                   │
│                       [required]                                             │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help          Show this message and exit.                                  │
╰──────────────────────────────────────────────────────────────────────────────╯

invite¶

                                                                                
 Usage: lftools-uv lfidapi invite [OPTIONS] EMAIL GROUP                         
                                                                                
 Email invitation to join group.                                                
                                                                                
 Args: email: The email address to send invitation to group: The group name to  
 invite to                                                                      
                                                                                
 Examples: lftools-uv lfidapi invite "user@example.com" "example-group"         
                                                                                
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ *    email      TEXT  Email address to invite                                │
│                       [required]                                             │
│ *    group      TEXT  Group name to invite to                                │
│                       [required]                                             │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help          Show this message and exit.                                  │
╰──────────────────────────────────────────────────────────────────────────────╯

search-members¶

                                                                                
 Usage: lftools-uv lfidapi search-members [OPTIONS] GROUP                       
                                                                                
 List members of a group.                                                       
                                                                                
 Args: group: The name of the group to search                                   
                                                                                
 Examples: lftools-uv lfidapi search-members "example-group"                    
                                                                                
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ *    group      TEXT  Group name to search for members                       │
│                       [required]                                             │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help          Show this message and exit.                                  │
╰──────────────────────────────────────────────────────────────────────────────╯

user¶

                                                                                
 Usage: lftools-uv lfidapi user [OPTIONS] USER GROUP                            
                                                                                
 Add and remove users from groups.                                              
                                                                                
 Args: user: The username to add or remove group: The group name delete: If     
 True, remove user from group instead of adding                                 
                                                                                
 Examples: lftools-uv lfidapi user "john.doe" "example-group" lftools-uv        
 lfidapi user "john.doe" "example-group" --delete                               
                                                                                
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ *    user       TEXT  Username to add or remove                              │
│                       [required]                                             │
│ *    group      TEXT  Group name                                             │
│                       [required]                                             │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --delete          Remove user from group instead of adding                   │
│ --help            Show this message and exit.                                │
╰──────────────────────────────────────────────────────────────────────────────╯

match-ldap-to-info¶

Usage: lftools-uv lfidapi [OPTIONS] COMMAND [ARGS]...
Try 'lftools-uv lfidapi --help' for help.
╭─ Error ──────────────────────────────────────────────────────────────────────╮
│ No such command 'match-ldap-to-info'. Did you mean 'match-ldap-info'?        │
╰──────────────────────────────────────────────────────────────────────────────╯

API requires an [lfid] section in ~/.config/lftools/lftools.ini:

[lfid]
clientid = lf-releng-jenkins
client_secret = REDACTED_SEE_SHARED_PASSWORD_STORAGE
refresh_token = REDACTED_SEE_SHARED_PASSWORD_STORAGE
token_uri = https://identity.linuxfoundation.org/oauth2/token
url = https://identity.linuxfoundation.org/rest/auth0/og/