awesome-wm-widgets/jira-widget
streetturtle 9045e67d18 add titles for error notifications 2019-12-17 21:37:03 -05:00
..
README.md various cosmetic readme improvements 2019-12-15 15:55:38 -05:00
jira-mark-gradient-blue.svg Update readme 2019-11-05 21:54:24 -05:00
jira.lua add titles for error notifications 2019-12-17 21:37:03 -05:00

README.md

Jira widget

The widget shows the number of assigned tickets to the user and when clicked shows them in the list with some additional information. When item in the list is clicked - it opens the issue in browser

How it works

Widget users cURL to query JIRA's REST API. In order to be authenticated, widget uses netrc feature of the cURL, which is basically to store basic auth credentials in a .netrc file in home folder.

Customization

It is possible to customize widget by providing a table with all or some of the following config parameters:

Name Default Description
host Required Ex: http://jira.tmnt.com
query jql=assignee=currentuser() AND resolution=Unresolved JQL query
icon ~/.config/awesome/awesome-wm-widgets/jira-widget/jira-mark-gradient-blue.svg Path to the icon

Installation

Clone/download repo and use widget in rc.lua:

local jira_widget = require("awesome-wm-widgets.jira-widget.jira")
...
s.mytasklist, -- Middle widget
	{ -- Right widgets
    	layout = wibox.layout.fixed.horizontal,
		...
		-- default
		jira_widget({host = 'http://jira.tmnt.com'}),
		...