https://github.com/glogiotatidis/gitissius

Distributed Issue Tracking for GIT
https://github.com/glogiotatidis/gitissius

Last synced: 25 days ago
JSON representation

Distributed Issue Tracking for GIT

• Host: GitHub
• URL: https://github.com/glogiotatidis/gitissius
• Owner: glogiotatidis
• License: other
• Created: 2011-10-13T12:59:50.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2013-11-03T13:05:24.000Z (over 11 years ago)
• Last Synced: 2024-04-16T04:06:33.078Z (about 1 year ago)
• Language: Python
• Homepage: http://www.gitissius.org
• Size: 344 KB
• Stars: 49
• Watchers: 6
• Forks: 8
• Open Issues: 1
• Metadata Files:
  • Readme: README.org
  • License: LICENSE

Awesome Lists containing this project

• awesome-distributed-computing-projects - Glogiotatidis/Gitissius

README

        
* GitIssius

** About

GitIssius is an issue tracker intergrated in your git repository. In

other words a distributed bug tracker.

*** Why bother?

Your code lives in your git repo. Your documentation lives in your git

repo. Why aren't your bugs in your git repo?

Git provides a really great version control system. Unlike other

systems though it does not provide any functionality related to

issue / bug tracking. You have to rely on 3rd party systems like

[[http://www.bugzilla.org][Bugzilla]] or GitHub issue tracker to track your bugs.

This is fundamentally wrong!

 - Because you quit your programming enviroment to visit webpages to add

   / view bugs.

 - Because the bugs are not stored in the same place as your code

   and / or documentation.

 - Because you cannot edit / view your bugs offline.

*GitIssius comes in action*

GitIssius stores your bugs in the same repo where your code lives. It

creates another branch named 'gitissius' which you don't have to

checkout ever. Provides a git command named 'issius' to control you

issues.

It was inspired by other distributed bug tracking systems like [[http://fossil-scm.org/][Fossil]],

[[http://bugseverywhere.org/][BugsEverywhere]] and [[http://ditz.rubyforge.org/][Ditz]]. Started as a fork of [[https://github.com/jwiegley/git-issues][git-issues]] but then

realized that I wanted a completelly different code base, so I wrote

most things from scratch.

Features

 - Stores your issues along with your repo

 - No server required

 - Simple operation

 - Tab completion

 - Data is stored in JSON

 - Easilly Extensible

 - Python, no extra libraries required

 - Cross Platform

 - Create and edit bugs offline

 - Distributed

** Installation

*** PyPI (recommended)

~$ sudo pip install gitissius

*** Bleeding Edge

1. ~$ git clone http://github.com/glogiotatidis/gitissius

2. ~$ cd gitissius && sudo python setup.py install

** Use

1. After you finish GitIssius installation go to a git repository.

   ~$ cd /my/git/repo

2. Start using GitIssius immediatelly!

   - *Add a new issue*

     - ~$ git issius new

   - *List issues*

     - ~$ git issius list

   - *List issues assigned to you*

     - ~$ git issius myissues

   - *List issues sorted*

     - ~$ git issius list --sort=status

     - ~$ git issius list --sort=assigned_to

   - *List issues assigned to '[email protected]', sort by status*

     - ~$ git issius list --filter=assigned_to:[email protected] --sort=status

   - *List issues assigned everyone but '[email protected]'*

     - ~$ git issius list --filter=assigned__not:[email protected]

   - *List all issues but new or assigned*

     - ~$ git issius list --all --filter=status__not:new,status__not:assigned

   - *Show an issue*

     - ~$ git issius show [issue id]

   - *Comment on an issues*

     - ~$ git issius comment [issue id]

   - *Close an issue*

     - ~$ git issius close [issue id]

   - *Push GitIssius changes*

     - ~$ git issius push

   - *Get help*

     - ~$ git issius help

*** Tips and tricks

 - Use 'TAB' for completion in fields.

 - Install 'colorama' package for colors

 - Sorting and Filtering actions can refer to the following fields:

   assigned_to, created_on, updated_to, reported_from, status, id,

   title

 - Filtering supports '__not', '__exact' and '__startswith' on text

   properties.

** Community

 - Bug Tracking: GitIssius eats its own food. So to report bugs please use gitissius ;)

 - Tweet at [[http://twitter.com/glogiotatidis/][@glogiotatidis]]

** Future

A companion web service comes soon! Write down http://www.gitissius.org