add script to generate config based on a gitlab group

[aschleifer]

As discussed in #334 this is a first version of a shell script to add a generator script.

It relies on the binaries curl and jq to be present.

Most likely there will be a future version of this written in python.

[CLAassistant]

All committers have signed the CLA.

[tony]

@aschleifer Thank you!

Are you okay with me adding this to the examples page? https://vcspull.git-pull.com/examples.html

If so, how to you prefer to be credited? (e.g. name, email, link, etc)

P.S. Do you have an example invocation? e.g. what it'd look like to run the command in bash?

[aschleifer]

I'm fine with it being added to the example page. For credit just mention the Name and/or reference my github account.

exmaple invocation:

export GITLAB_TOKEN=mySecretToken
/path/to/generate_gitlab.sh gitlab.mycompany.com desired_namespace

This has to be executed in the path where the repos should later be stored, as it takes the current working directory as "prefix" for the path in the config file.

Optionally you can pass a path to the config file as additional argument /path/to/generate_gitlab.sh gitlab.mycompany.com desired_namespace /path/to/config.yaml which will then be overwritten with the result.

[aschleifer]

@tony one limitation I just remember: The gitlab API is doing pagination for large outputs and in this case the maximum amount of entries per page is 100.

I didn't implement any logic to read subsequent pages, so if someone uses this on a namespace with more then 100 repos under it then it will only return 100 of them.

[tony]

@aschleifer This script is online here: https://vcspull.git-pull.com/config-generation.html#shell-script-version

Tested locally, works great (I included my result in demonstration)