https://github.com/janl/gigan

Parse JIRA XML into CouchDB
https://github.com/janl/gigan

Last synced: 2 months ago
JSON representation

Parse JIRA XML into CouchDB

• Host: GitHub
• URL: https://github.com/janl/gigan
• Owner: janl
• License: mit
• Created: 2010-02-03T00:56:47.000Z (almost 15 years ago)
• Default Branch: master
• Last Pushed: 2011-09-13T21:21:24.000Z (over 13 years ago)
• Last Synced: 2024-10-02T09:54:59.256Z (3 months ago)
• Language: JavaScript
• Homepage:
• Size: 711 KB
• Stars: 11
• Watchers: 3
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGES.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Gigan

Easy browsing for JIRA issues.

## Requirements

Needs PHP 5. Yes, PHP. Get over it.

## Usage

First run:

Customise the top of gigan.php. Then run:

    $ GIGAN_BOOT=true php lib/gigan.php

After that, create a cronjob running `php lib/gigan.php` every X minutes (I default

to 15) to fetch the latest changes from JIRA.

If you don't feel like running that cronjob, get in touch, I'm happy to host

your JIRA's importer publicly.

## Browsing Issues

Gigan comes with a little [CouchApp](http://github.com/couchapp/couchapp) that

lets you browse your issues by a few predefined filters as well as allows you

to create your own filters.

1. Install CouchApp. Usually, that is just a `sudo easy_install -U couchapp`

2. `$ cd gigan/gigan-view`

3. `$ couchapp push . gigan`

4. Go to 

### Creating New Filters

Create a new filter by creating a new view.

    $ cd gigan/gigan-view/views

    $ mkdir by-type

    $ mate by-type/map.js

    function(doc) {

      if(doc.type && doc.title && doc.jira_key) {

        emit(doc.type, {

          title: doc.type + ": " + doc.title,

          jira_key: doc.jira_key

        });

      }

    }

    $ couchapp push . gigan

This creates a new filter that sorts all issues by type and displays the type

along with the issue title. The important part is the call to `emit()`. The

first argument is the key to sort your issues by the second is an object that

needs to have a `title` and a `jira_key` attribute. The former is for display

the latter is for linking.

Your new filter should show up on

 automatically.

## Name

Gigan is Godzilla's archenemy. Jira is the Japanese name for Godzilla. 

Fuck JIRA.

“Gigan was the first monster to cause Godzilla to visibly bleed.” 

  — http://en.wikipedia.org/wiki/Gigan