# gitlab-contribution

Narzędzie do eksportu statystyk aktywności użytkowników z GitLab do pliku Excel.

## Co robi

- Pobiera dane z GitLab GraphQL API (Events) dla zadanej grupy i zakresu dat
- Agreguje: contributions, commity, merge requesty, komentarze
- Generuje plik `.xlsx` z podsumowaniem per użytkownik

## Wymagania

```
pip install -r requirements.txt
```

## Konfiguracja

Skopiuj `.env.example` do `.env` i uzupełnij:

```env
GITLAB_URL=https://gitlab.com
GITLAB_TOKEN=your_personal_access_token
GITLAB_GROUP=your-group-path
DATE_FROM=2024-01-01
DATE_TO=2024-12-31
OUTPUT_FILE=raport.xlsx
```

## Użycie

```bash
python main.py
```

Lub z parametrami CLI:

```bash
python main.py --group my-group --from 2024-01-01 --to 2024-12-31 --output raport.xlsx
```

## Struktura pliku Excel

| Użytkownik | Username | Contributions | Commity | Merge Requesty | Komentarze |
|------------|----------|---------------|---------|----------------|------------|
| Jan Kowalski | jkowalski | 142 | 89 | 23 | 30 |

## Jak działa

1. `gitlab_client.py` — klient GraphQL, pobiera events z GitLab API
2. `aggregator.py` — agreguje dane per użytkownik
3. `exporter.py` — generuje plik Excel (openpyxl)
4. `main.py` — punkt wejścia, CLI

## Limity GitLab API

GitLab Events API zwraca max 100 eventów na stronę. Klient automatycznie obsługuje paginację.