The list subcommand
The list subcommand is used to pull data from specific resources such as
pipelines and merge requests. Gitar implements best practices to avoid being
rate limited, caches responses and uses pagination to pull the required data
using the --from-page
and --to-page
flags.
Auto throttling
Gitar will automatically throttle the requests after three consecutive HTTP
calls have been made. The throttling is based on the rate limit headers plus a
jitter interval between 1 and 5 seconds. The user can also specify a fixed
throttle interval with --throttle
or a random one with --throttle-range
.
Max pages to fetch
If no configuration is provided, the default is a max of 10 pages. This can be
overridden with --to-page
where it will fetch up to the specified page or a
range of pages with --from-page
and --to-page
.