Infofile¶
Usage: lftools infofile [OPTIONS] COMMAND [ARGS]...
INFO.yaml TOOLS.
Options:
--help Show this message and exit.
Commands:
check-votes Check votes on an INFO.yaml change.
create-info-file Create an initial INFO file.
get-committers Extract Committer info from INFO.yaml or LDAP dump.
sync-committers Sync committer information from LDAP into INFO.yaml.
Commands¶
check-votes¶
Usage: lftools infofile check-votes [OPTIONS] INFO_FILE ENDPOINT CHANGE_NUMBER Check votes on an INFO.yaml change. Check for Majority of votes on a gerrit or github patchset which changes an INFO.yaml file. For Gerrit endpoint is the gerrit url For Github the enpoint is the organization name Examples: lftools infofile check-votes /tmp/test/INFO.yaml lfit-sandbox 18 --github_repo test lftools infofile check-votes ~/lf/allrepos/onosfw/INFO.yaml https://gerrit.opnfv.org/gerrit/ 67302 Options: --tsc TEXT path to TSC INFO file --github_repo TEXT Provide github repo to Check against a Github Change --help Show this message and exit.
get-committers¶
Usage: lftools infofile get-committers [OPTIONS] FILE Extract Committer info from INFO.yaml or LDAP dump. Options: --full BOOLEAN Output name email and id for all committers in an infofile --id TEXT Full output for a specific LFID --help Show this message and exit.
sync-committers¶
Usage: lftools infofile sync-committers [OPTIONS] INFO_FILE LDAP_FILE ID Sync committer information from LDAP into INFO.yaml. Options: --repo TEXT repo name --help Show this message and exit.
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¶
Usage: lftools infofile create-info-file [OPTIONS] GERRIT_URL GERRIT_PROJECT Create an initial INFO file. gerrit_project example: project/full-name gerrit_url example: gerrit.umbrella.com directory example: /gerrit/ (rather than most projects /r/) Options: --directory TEXT custom gerrit directory, eg not /r/ --empty Create info file for uncreated project. --tsc_approval TEXT optionally provde a tsc approval link --help Show this message and exit.
API for check votes requires a [github] section in ~/.config/lftools/lftools.ini:
[github]
token = REDACTED