| #!/bin/bash |
| # ----------------------------------------------------------------------- |
| # Copyright 2024 Open Networking Foundation Contributors |
| # |
| # Licensed under the Apache License, Version 2.0 (the "License"); |
| # you may not use this file except in compliance with the License. |
| # You may obtain a copy of the License at |
| # |
| # http:#www.apache.org/licenses/LICENSE-2.0 |
| # |
| # Unless required by applicable law or agreed to in writing, software |
| # distributed under the License is distributed on an "AS IS" BASIS, |
| # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| # See the License for the specific language governing permissions and |
| # limitations under the License. |
| # ----------------------------------------------------------------------- |
| # SPDX-FileCopyrightText: 2024 Open Networking Foundation Contributors |
| # SPDX-License-Identifier: Apache-2.0 |
| # ----------------------------------------------------------------------- |
| # Intent: Display command help |
| # ----------------------------------------------------------------------- |
| |
| ## ----------------------------------------------------------------------- |
| ## ----------------------------------------------------------------------- |
| function usage() |
| { |
| cat <<EOH |
| Usage: $0 |
| --all r Load all metadata for a repository |
| |
| --access Display gerrit ACLs |
| --dash(boad) Display my patch dashboard |
| --branch Admin branch URL |
| |
| --crowd View crowd access roles for group |
| --crowd-all Group search (crowd) |
| |
| --groups [g] View access roles for group. |
| --groups-all Group search (gerrit) |
| |
| --me Alias for --user $USER |
| |
| --repo Repository name |
| --serv Gerrit server name |
| |
| --search |
| --unresolved Alias for --wip |
| --wip Query for open/unmerged patches. |
| |
| --admins a |
| a=branches View repository branches |
| a=tags View repository tags |
| |
| --patch [repo] Search for repository patches |
| --version v Artifact versions(s) to act on |
| v=master Mainline development |
| v=voltha-2.12 Artifact branch from a release |
| v=v2.12.0 Artifact tag derived from a release |
| v=v3.5.4 Artifact tag derived from VERSION file |
| |
| --view v View a code repository: |
| repo View top level gerrit repository page (w/branch & tag) |
| search Gerrit repo search page |
| master View a branch |
| voltha-2.12 View a branch |
| v2.3.3 View a tag |
| |
| [REVIEW] |
| --review Load pending code review requests |
| --review --me Load only my pending requests |
| --reviewer Load reviews by user |
| |
| [FILTER(s)] |
| --age |
| --before Change time modified before (alias: --until) |
| --after Change time modified after (alias: --since) |
| --status [s] Filter query results by status={open,merged,closed} |
| s=open (is:open) |
| s=merged |
| -- user [u] Filter results by a list of users |
| |
| [MODE(s)] |
| --debug |
| --help |
| |
| |
| [USAGE] |
| |
| # Display my unmerged patches |
| % gerrit.sh --wip |
| |
| # Display my unmerged patches |
| % gerrit.sh --wip --me |
| |
| % gerrit.sh --repo voltha-go --admin tags --admin branches |
| |
| # Search for umerged patches in repo:voltha-go |
| % gerrit.sh --repo voltha-go --search --wip |
| |
| # Display new patches created since 'yesterday' |
| % gerrit.sh --wip --since '2024-04-24' |
| |
| [HELP: Extended] |
| --help-status |
| |
| EOH |
| return |
| } |
| |
| ## ----------------------------------------------------------------------- |
| ## ----------------------------------------------------------------------- |
| function usage_verbose() |
| { |
| local switch="$1"; shift |
| |
| case "$switch" in |
| --help-status) usage_status ;; |
| *) usage ;; |
| esac |
| |
| return |
| } |
| |
| # [EOF] |