Task 32 / Add pagination to list commands

[grananda]

Closes #32

[grananda]

We need members and collaborators

[jordeu]

It will be nice to show that there are more items when you are not showing all the rows. But, if I'm not wrong, this is not possible because the API paginated response do not includes the total number of available rows. If this is the case, maybe it is worth to open an issue to track this problem at Tower API.

[swampie]

Can we please add some tests about pagination? We could check that the urls are built correctly

[jordeu]

Ok, I've seen that to add the validate = false to the ArgGroup is not the solution.

If you don't set the validate = false the help shows this:

Options:
  -f, --filter=<startsWith>   Show only pipeline's runs that it's name starts with the given word
*     --page=<page>           Page to display to display (default is 1)
*     --offset=<offset>       Rows record's offset (default is 0)
*     --max=<max>             Maximum number of records to display (default is 100)
*     --no-max                Show all records
  -h, --help                  Show this help message and exit.
  -V, --version               Print version information and exit.

Which is not correct because the ArgGroup arity by default is 0..1 that means optional. And in fact they're optional, so it's only a visualization problem of the help usage.

If we set validate = false then the help usage is correct and all the * disappear, but then picocli is not checking that you only enter one option of the mutually exclusive group.

We've hit this bug: remkop/picocli#1380

Maybe for now the solution can be to keep the validate = false and "manually" check the mutually exclusivity and throw an exception. What do you think?

[swampie]

Let's implement the manual check to overcome the validate=false issue and then we are good to go for me