tibhannover/gitlab-introspection

A groovy toolbox for inspecting gitlab servers via their API.

Gitlab Introspection

A groovy toolbox for extracting information from Gitlab servers via API.

Right now this tool/script extracts following information from a Gitlab server.

repo count: 77
with license: 37
without license: 40
with readme: 33`

Additionally this information is also provided per namespace:

name space               , with lic, w/o lic,  readme
abc                      ,        3 ,        3,        3
def                      ,        0 ,        1,        0
ghi                      ,        1 ,        3,        0
xyz                      ,        2 ,        0,        2

There might be gradle files missing. I don't know enough about gradle to be sure to include everything required.

Background

The question came up, of how to assess practises on a Gitlab Server. Raising awareness of (bad) practises was also an issue.

Something similar was done at University of Würzburg.

Usage

Run org.derse.gitlabintrospection.GitlabLicenses.main

Configuration

The main method has a string called configFile. Paste the file name of you config file in json format there.

Example config:

{
  "server":"https://gitlab.gwdg.de/",
  "token": ""
}

Use a token in order to access non public projects.

Limitations

• Hardcoded config file location.
• There is no content checking going on. The script does not care what the repo holds.

Software Licenses

There exists an [OSS review toolkit](TODO: https://github.com/heremaps/oss-review-toolkit ). This tool checks projects dependencies and highlights license conflicts.

Maintainer

• Stephan Janosch, [email protected]

Contributing

Feel free to add issues, fork and/or create merge requests.

License

This project is licensed under an adapted MIT License