1.2.3 • Published 6 years ago

@tlake/mozaik-ext-github v1.2.3

Weekly downloads
1
License
MIT
Repository
github
Last release
6 years ago

Mozaïk GitHub widgets

License Travis CI NPM version Dependencies Coverage Status widget count

Deploy

This repository contains some GitHub widgets to use with Mozaïk.

Demo

You can see a live demo of the widgets here

Github Client Configuration

In order to use the Mozaïk github widgets, you should configure its client. It's not required that you provide a token for authentication, but then you'll only be able to see public repos and the rate limit will apply.

parameters

keyenv keyrequireddefaultdescription
tokenGITHUB_API_TOKENno''github authentication token
baseUrlGITHUB_BASE_URLnohttps://api.github.comgithub api url (useful for enterprise)

usage

{
  //…
  api: {
    github: {
        baseUrl: ''
        token:   'MY_GITHUB_TOKEN'
    },
  }
}

Widgets

Github User badge

Show github user badge.

github user badge

parameters

keyrequireddescription
useryesgithub user identifier

usage

{
  type: 'github.user_badge',
  user: 'plouc',
  columns: 1, rows: 1, x: 0, y: 0
}

Github Repository Top committer

Show most active committer during current week|day

parameters

keyrequireddefaultdescription
repositoryyesgithub repository
frequencynodailysearch top committer for current day or week, possible values are: 'daily', 'weekly'

usage

{
  type: 'github.top_committer',
  repository: 'plouc/mozaik',
  frequency: 'daily',
  columns: 1, rows: 1, x: 0, y: 0
}

Github Repository Contributors Stats

Show github contributors stats.

github repository contributors stats

parameters

keyrequireddescription
repositoryyesgithub repository

usage

{
  type: 'github.repository_contributors_stats',
  repository: 'plouc/mozaik',
  columns: 1, rows: 1, x: 0, y: 0
}

Github Repository Branches

Show github branches with authors.

github repository branches

parameters

keyrequireddescription
repositoryyesgithub repository
titlenooverrides default title if provided

usage

{
  type: 'github.branches',
  repository: 'plouc/mozaik',
  columns: 1, rows: 1, x: 0, y: 0
}

Github issue labels donut

Show a donut chart with issue labels distribution

github repository issue labels donut

parameters

keyrequireddescription
repositoryyesgithub repository

usage

{
    type: 'github.issue_labels_donut',
    repository: 'plouc/mozaik',
    columns: 1, rows: 1,
    x: 0, y: 0
}

Github issue types treemap

Show a treemap of issue types.

github repository issue labels treemap

parameters

keyrequireddescription
repositoryyesgithub repository
labelsyesa list of labels with an associated color

usage

{
    type: 'github.issue_labels_treemap',
    repository: 'plouc/mozaik',
    labels: [
        { color: '#6bc2c8', count: 13, name: 'blocker'     },
        { color: '#5f8cc0', count: 3,  name: 'enhancement' },
        { color: '#525487', count: 7,  name: 'bug'         },
        { color: '#383b72', count: 16, name: 'help-wanted' }
    ],
    columns: 1, rows: 1,
    x: 0, y: 0
}

Github status

Shows the latest Github system status information from https://status.github.com/

Github Status

usage

{
    type: 'github.status',
    columns: 1, rows: 1,
    x: 0, y: 0
}

Github Organization badge

Show github organization badge.

github organization badge

parameters

keyrequireddescription
orgyesgithub organization identifier

usage

{
  type: 'github.organization_badge',
  organization: 'github',
  columns: 1, rows: 1, x: 0, y: 0
}