🦝 dalec-gitlab

Django Aggregate a Lot of External Content -- Gitlab

Aggregate last gitlab issue or event from a given gitlab instance.

Plugin of 🤖 dalec.

Installation

pip install dalec_gitlab

In django settings INSTALLED_APPS, add:

INSTALLED_APPS = [
    ...
    "dalec",
    "dalec_prime",
    "dalec_gitlab",
    ...
    ]

Usage

General usage: in a template

{% load dalec %}

{% dalec "gitlab" content_type [channel=None] [channel_object=None] [channel_objects=None] [template=None] [ordered_by=None] %}

Real examples

content_type "issue"

• Available channel: group, project.
• Available channel_object: group or project id or public_id
• Available channel_objects: list of group or project id or public_id

Retrieves recent gitlab issues for a project:

{% dalec "gitlab" "issue" channel="project" channel_object="14" %}

Or for multiple projects at once:

{% dalec "gitlab" "issue" channel="project" channel_objects=["14", "42"] %}

content_type "event"

• Available channel: group, project, user.
• Available channel_object: group or project id or public_id, or user username
• Available channel_objects: list of group or project id or public_id, or user username

Retrieves recent gitlab activity for a user:

{% dalec "gitlab" "event" channel="user" channel_object="doctor-who" %}

Retrieves recent gitlab activity for a group:

{% dalec "gitlab" "event" channel="group" channel_object="42" %}

Retrieves recent gitlab activity for a project:

{% dalec "gitlab" "event" channel="project" channel_object="512" %}

content_type "milestone"

• Available channel: group, project.
• Available channel_object: group or project id or public_id
• Available channel_objects: list of group or project id or public_id

Milestone are retrieve by descending updated date.

Retrieves gitlab milestone for a project or group:

{% dalec "gitlab" "milestone" channel="project" channel_object="14" %}

{% dalec "gitlab" "milestone" channel="group" channel_object="42" %}

Settings

Django settings must define:

• DALEC_GITLAB_BASE_URL : gitlab instance url (ex: https://gitlab.com/)
• DALEC_GITLAB_API_TOKEN : gitlab api token (ex: azeazeaezdfqsmlkrjzr)