infofile¶
[1m [0m
[1m [0m[1;33mUsage: [0m[1mlftools-uv infofile [OPTIONS] COMMAND [ARGS]...[0m[1m [0m[1m [0m
[1m [0m
INFO.yaml file management tools
[2mâ•â”€[0m[2m Options [0m[2m───────────────────────────────────────────────────────────────────[0m[2m─╮[0m
[2m│[0m [1;36m-[0m[1;36m-help[0m Show this message and exit. [2m│[0m
[2m╰──────────────────────────────────────────────────────────────────────────────╯[0m
[2mâ•â”€[0m[2m Commands [0m[2m──────────────────────────────────────────────────────────────────[0m[2m─╮[0m
[2m│[0m [1;36mcreate-info-file [0m[1;36m [0m Create an initial INFO file. [2m│[0m
[2m│[0m [1;36mget-committers [0m[1;36m [0m Get committers from LDAP and update INFO file. [2m│[0m
[2m│[0m [1;36mvalidate-info-file [0m[1;36m [0m Validate INFO.yaml file format and content. [2m│[0m
[2m│[0m [1;36mcheck-committers [0m[1;36m [0m Check committers in INFO file against LDAP. [2m│[0m
[2m│[0m [1;36mmatch-ldap [0m[1;36m [0m Match LDAP information to INFO file. [2m│[0m
[2m╰──────────────────────────────────────────────────────────────────────────────╯[0m
Commands¶
check-votes¶
[1;33mUsage: [0m[1mlftools-uv infofile [OPTIONS] COMMAND [ARGS]...[0m [2mTry [0m[2;34m'lftools-uv infofile [0m[1;2;34m-[0m[1;2;34m-help[0m[2;34m'[0m[2m for help.[0m [31mâ•â”€[0m[31m Error [0m[31m─────────────────────────────────────────────────────────────────────[0m[31m─╮[0m [31m│[0m No such command 'check-votes'. Did you mean 'check-committers'? [31m│[0m [31m╰──────────────────────────────────────────────────────────────────────────────╯[0m
get-committers¶
[1m [0m [1m [0m[1;33mUsage: [0m[1mlftools-uv infofile get-committers [OPTIONS] {gerrit_url}[0m[1m [0m[1m [0m [1m [0m[1m {gerrit_project} {ldap_group}[0m[1m [0m[1m [0m [1m [0m[1m {info_file}[0m[1m [0m[1m [0m [1m [0m Get committers from LDAP and update INFO file. [2mArgs:[0m[2m [0m[2mgerrit_url: Gerrit URL[0m[2m [0m[2mgerrit_project: Gerrit project path[0m[2m [0m[2mldap_group: [0m [2mLDAP group name[0m[2m [0m[2minfo_file: Path to INFO.yaml file[0m[2m [0m[2mdirectory: Custom gerrit [0m [2mdirectory[0m [2mExamples:[0m[2m [0m[2mlftools-uv infofile get-committers gerrit.example.com project/name [0m [2mldap-group INFO.yaml[0m [2mâ•â”€[0m[2m Arguments [0m[2m─────────────────────────────────────────────────────────────────[0m[2m─╮[0m [2m│[0m [31m*[0m gerrit_url [1;2;33m<[0m[1;33mstr[0m[1;2;33m>[0m Gerrit URL [2m│[0m [2m│[0m [2;31m[required] [0m [2m│[0m [2m│[0m [31m*[0m gerrit_project [1;2;33m<[0m[1;33mstr[0m[1;2;33m>[0m Gerrit project path [2m│[0m [2m│[0m [2;31m[required] [0m [2m│[0m [2m│[0m [31m*[0m ldap_group [1;2;33m<[0m[1;33mstr[0m[1;2;33m>[0m LDAP group name [2m│[0m [2m│[0m [2;31m[required] [0m [2m│[0m [2m│[0m [31m*[0m info_file [1;2;33m<[0m[1;33mstr[0m[1;2;33m>[0m Path to INFO.yaml file [2m│[0m [2m│[0m [2;31m[required] [0m [2m│[0m [2m╰──────────────────────────────────────────────────────────────────────────────╯[0m [2mâ•â”€[0m[2m Options [0m[2m───────────────────────────────────────────────────────────────────[0m[2m─╮[0m [2m│[0m [1;36m-[0m[1;36m-directory[0m [1;2;33m<[0m[1;33mstr[0m[1;2;33m>[0m Custom gerrit directory [2m│[0m [2m│[0m [2m[default: r] [0m [2m│[0m [2m│[0m [1;36m-[0m[1;36m-help[0m [1;33m [0m Show this message and exit. [2m│[0m [2m╰──────────────────────────────────────────────────────────────────────────────╯[0m
sync-committers¶
[1;33mUsage: [0m[1mlftools-uv infofile [OPTIONS] COMMAND [ARGS]...[0m [2mTry [0m[2;34m'lftools-uv infofile [0m[1;2;34m-[0m[1;2;34m-help[0m[2;34m'[0m[2m for help.[0m [31mâ•â”€[0m[31m Error [0m[31m─────────────────────────────────────────────────────────────────────[0m[31m─╮[0m [31m│[0m No such command 'sync-committers'. Did you mean 'check-committers', [31m│[0m [31m│[0m 'get-committers'? [31m│[0m [31m╰──────────────────────────────────────────────────────────────────────────────╯[0m
Creating an info file requires a connection to the VPN and a working openldap configuration
$ cat /etc/openldap/ldap.conf
TLS_REQCERT never
or
prereqs: For ldap lookups to work you must be on the VPN and have the cert to get the cert: log in to any collab system and grab /etc/ipa/ca.crt in /etc/openldap/ldap.conf, add 'TLS_CACERT /path/to/ipa.ca'
create-info-file¶
[1m [0m [1m [0m[1;33mUsage: [0m[1mlftools-uv infofile create-info-file [OPTIONS] {gerrit_url}[0m[1m [0m[1m [0m [1m [0m[1m {gerrit_project}[0m[1m [0m[1m [0m [1m [0m Create an initial INFO file. [2mArgs:[0m[2m [0m[2mgerrit_url: Gerrit URL (e.g., gerrit.umbrella.com)[0m[2m [0m[2mgerrit_project: [0m [2mGerrit project path (e.g., project/full-name)[0m[2m [0m[2mdirectory: Custom gerrit [0m [2mdirectory (e.g., /gerrit/ rather than /r/)[0m[2m [0m[2mempty: Create info file for [0m [2muncreated project[0m[2m [0m[2mtsc_approval: TSC approval link[0m [2mExamples:[0m[2m [0m[2mlftools-uv infofile create-info-file gerrit.example.com project/name[0m [2mlftools-uv infofile create-info-file gerrit.example.com project/name --empty[0m [2mâ•â”€[0m[2m Arguments [0m[2m─────────────────────────────────────────────────────────────────[0m[2m─╮[0m [2m│[0m [31m*[0m gerrit_url [1;2;33m<[0m[1;33mstr[0m[1;2;33m>[0m Gerrit URL (e.g., gerrit.example.com) [2m│[0m [2m│[0m [2;31m[required] [0m [2m│[0m [2m│[0m [31m*[0m gerrit_project [1;2;33m<[0m[1;33mstr[0m[1;2;33m>[0m Gerrit project path (e.g., [2m│[0m [2m│[0m project/full-name) [2m│[0m [2m│[0m [2;31m[required] [0m [2m│[0m [2m╰──────────────────────────────────────────────────────────────────────────────╯[0m [2mâ•â”€[0m[2m Options [0m[2m───────────────────────────────────────────────────────────────────[0m[2m─╮[0m [2m│[0m [1;36m-[0m[1;36m-directory[0m [1;2;33m<[0m[1;33mstr[0m[1;2;33m>[0m Custom gerrit directory, e.g. not /r/ [2m│[0m [2m│[0m [2m[default: r] [0m [2m│[0m [2m│[0m [1;36m-[0m[1;36m-empty[0m [1;33m [0m Create info file for uncreated project [2m│[0m [2m│[0m [1;36m-[0m[1;36m-tsc[0m[1;36m-approval[0m [1;2;33m<[0m[1;33mstr[0m[1;2;33m>[0m Optionally provide a TSC approval link [2m│[0m [2m│[0m [2m[default: missing] [0m [2m│[0m [2m│[0m [1;36m-[0m[1;36m-help[0m [1;33m [0m Show this message and exit. [2m│[0m [2m╰──────────────────────────────────────────────────────────────────────────────╯[0m
API for check votes requires a [github] section in ~/.config/lftools-uv/lftools-uv.ini:
[github]
token = REDACTED