Roundup (issue tracker)

{{Infobox software

| name = Roundup

| author = Ka-Ping Yee

| developer = Richard Jones, Roundup Initiative

| released = {{Start date and age|2001|08|18|df=yes/no}}

| qid = Q2169298

| latest_release_version = {{wikidata |property|preferred |references|edit |Q2169298|P348|P548=Q2804309}}

| latest_release_date = {{Start date and age|2024|07|13|df=yes/no}}

| programming language = Python

| operating system = Cross-platform

| genre = Issue tracking system

| license = {{wikidata |property|linked |references|edit |Q2169298|P275}}

}}

Roundup is an open-source issue or bug tracking system featuring a command-line, web and e-mail interface. It is written in Python and designed to be highly customizable.The primary user interface is the web interface. A so-called classic tracker template is distributed as the standard template and data structure set, but can be used as a starting point for customization

History

Roundup was designed by Ka-Ping Yee for the Software Carpentry project and was developed from 2001 to 2016 under the direction of Richard Jones. Since then, it has been developed by the Roundup community. It was the issue tracker for the Python programming language for 17 years before migrating to GitHub.[http://bugs.python.org/ Python Bug Tracker] It was once described as "like Bugzilla without the six years of training, or RT without that tedious MySQL rubbish."[http://www.ntk.net/2002/07/05/#TRACKING NTKnow 2002/07/05 - TRACKING]

Features

The standard configuration of Roundup features:

a web interface for viewing, editing and searching issues
REST[https://www.roundup-tracker.org/docs/rest.html REST documentation] and XMLRPC interfaces for remote automation and web applications
a Mail gateway allowing creation and changing of issues[https://www.roundup-tracker.org/docs/user_guide.html#e-mail-gateway E-Mail User Interface], Roundup user's guide
a database abstraction layer, currently supporting (among others) Python's built-in "anydbm" module, PostgreSQL, MySQL and SQLite
issue-specific "nosy lists", used for e-mail notifications and conversation (each issue effectively becoming a mini mailing list) [https://www.roundup-tracker.org/docs/design.html#nosy-lists Design of Nosy Lists]
an authorization system,[https://www.roundup-tracker.org/docs/design.html#access-control access control], Roundup design description based on roles (of users), classes and objects
an interactive shell for backup and restore tasks and for manipulation of objects

Roundup supports several web backends.{{cite web | url=https://www.roundup-tracker.org/docs/installation.html#configure-a-web-interface | title=Installing Roundup - Roundup 2.2.0 documentation }} It can be run standalone, as a background daemon process, as a CGI scriptusage via CGI is rare and not recommended, for performance reasons or as WSGI application.

Concepts

Roundup is customized by changing the contents of the tracker instance directory:

= Database schema =

The database schema is defined in a Python file in the tracker instance's root directory; it is

re-read whenever the server is started anew. When changes are found (e.g. new attributes), the tables of the underlying RDBS are altered accordingly.

= Page templates =

Roundup uses the Template Attribute Language (TAL) to create HTML or XHTML output. Version 1.5.0 adds experimental support for alternative template engines, such as Jinja2.{{cite web | url=https://pypi.python.org/pypi/roundup/1.5.0 | title=Roundup: A simple-to-use and -install issue-tracking system with command-line, web and e-mail interfaces. Highly customisable }}

Templates are named after the classes in database. Roundup automatically chooses template based on class name requested from URL. Some templates are used for several classes, e.g. _generic.index.html, which allows (authorized) users to change the objects of all classes which lack an own index template.

When an "issue123" is requested, this designator is split in the issue class and the id "123".[https://www.roundup-tracker.org/docs/design.html#identifiers-and-designators identifiers and designators], Roundup design description By default an "item" template is chosen: First, an issue.item.html template file is looked for; if it can't be found, _generic.item.html is used as a fallback option. If this is missing equally, an error occurs.

= Detectors =

Many Roundup functions, including some of the standard functionality, are implemented using so-called detectors,[https://www.roundup-tracker.org/docs/design.html#detector-interface detector interface], Roundup design description which are located in the "detectors" sub-directory of the tracker instance. They are Python subroutines which have access to the object to change (if already created) and the requested attribute changes.

Detectors are distinguished between auditors and reactors. Auditors are used primarily for several automatic changes (in the standard configuration, the assignedto user is automatically added to the nosy list of the issue), and to refuse un-allowed changes; reactors are executed thereafter and used e.g. for the e-mail notification feature, sending notification mails to all users interested in a certain issue when a comment is added to it.

Detectors are triggered whenever one of the actions

create
set (change of attributes)
retire
restore

is requested. They can be used to create an elaborated custom workflow.

= Extensions =

The instance subdirectory "extensions" can hold additional files which are needed for extended functionalities which can't (conveniently) be done with TAL; even totally new actions are possible.

Python modules which are used by both detectors and extensions can be put in the "lib" subdirectory