User Tools

  • Logged in as: anonymous (anonymous)
  • Log Out

Site Tools


mantisbt:source_control_integration_requirements

This is an old revision of the document!


Source Control Integration Requirements

Author: John Reese Status: Draft

Introduction

One of the major features that bug tracking software requires is direct integration with version control software. Mantis is currently in an odd position, because it does not have any ability to integrate with VCS systems, yet it offers a way for any VCS to pass a textual message to Mantis that will be attached to bugs as simple bugnotes. This process is useful, but very limited, and many users prefer tightly integrated systems such as Trac.

The goal with this feature is to provide a VCS-agnostic interface which will allow for direct integration with version control software, but will not favor a single system. This feature will attract many businesses and projects which need direct integration with their source control system, some of which may have multiple repositories in various VCS systems.

Current Approach

Currently, Mantis has a simple interface for receiving information from a VCS system, relying on the VCS's post-commit hooks to call the core/checkin.php script with a specific set of arguments. Mantis then parses the message from the VCS system, using a configurable regular expression to look for text patterns indicating which bugs were affected or resolved by the submission. The result is only a bugnote attached to the affected bugs with the entire message from the VCS, and maybe a partially-resolved issue. This is the full extent of Mantis' integration with version control software.

Limitations

  • Commit messages must include bug numbers in usually-unforgiving patterns of text to be properly recognized.
  • Bugnotes attached by checkin are associated with a special source control 'user' regardless of who committed changes.
  • Reverse integration is limited to what can be shoe-horned into the bugnote message by the source control post-commit hook.
  • Mantis knows nothing about the VCS system, or even the changeset itself once it is a bugnote.

Proposed Approach

Database Changes

Configuration Changes

Feedback

Please hold your feedback until this page is completed.

mantisbt/source_control_integration_requirements.1191008799.txt.gz · Last modified: 2008/10/29 04:32 (external edit)

Driven by DokuWiki