Roundup Issue Tracker
=====================

.. meta::
   :title: Roundup Issue Tracker
   :description: A simple-to-use and -install issue-tracking system
       with command-line, web, REST, XML-RPC and e-mail interfaces.
       Adaptable to many uses cases. Allows you to customise the look
       and feel and implement different workflows.
   :og\:type: website
   :og\:url: https://www.roundup-tracker.org/
   :og\:title: Roundup Issue Tracker
   :og\:description: A simple-to-use and -install issue-tracking system
       with command-line, web, REST, XML-RPC and e-mail interfaces.
       Adaptable to many uses cases. Allows you to customise the look
       and feel and implement different workflows.
   :og\:image: https://www.roundup-tracker.org/_images/index_logged_out.png

.. raw:: html

   <div class="release_info note">
     <!-- package version/pypi download -->
     <a
	  href="https://pypi.org/project/roundup/#files">
       <span style="padding-inline-end: 1.75ch">Download:</span>
       <img style="vertical-align: text-top"
	   src="https://img.shields.io/pypi/v/roundup?color=blue&label=Current%20Version&cacheSeconds=86400"
	   alt="Display current version of Roundup on PyPI."
	   height="18" width="127">
     </a>

     <!-- supported python versions: <img src="https://shields.io/pypi/pyversions/roundup"> -->
     <!-- license: <img src="https://img.shields.io/pypi/l/roundup"> -->
     <!-- changes since 2.2.0 <img src="https://img.shields.io/github/commits-since/roundup-tracker/roundup/2.2.0/master?sort=semver"> -->
     <!-- status beta, stable, mature.... <img src="https://img.shields.io/pypi/status/roundup"> -->
     <!-- mozilla observatory <img src="https://img.shields.io/mozilla-observatory/grade/www.roundup-tracker.org?publish"> -->

     <!-- downloads/month -->
     <a style="display:block; margin-block-start: 1em;"
	  href="https://pypistats.org/packages/roundup">
       <span style="padding-inline-start: 10.75ch"></span>
       <img
	 src="https://img.shields.io/badge/dynamic/json?color=blue&label=downloads%2Fmonth&cacheSeconds=86400&query=data.last_month&url=https%3A%2F%2Fpypistats.org%2Fapi%2Fpackages%2Froundup%2Frecent"
	 alt="Badge displaying downloads per month."
	 height="18" width="127">
     </a>

     <!-- build status -->
     <a 
	 style="display:block; margin-block-start: 1em;"
	 href="https://github.com/roundup-tracker/roundup/actions?query=workflow%3Aroundup-ci++">
       <span>Build Status:</span>
       <img
	   src="https://img.shields.io/github/workflow/status/roundup-tracker/roundup/roundup-ci?label=roundup-ci&logo=github"
	   alt="Current build status on GitHub."
           height="18" width="127">
     </a>
   </div>

Roundup is a simple-to-use and -install issue-tracking system with
command-line, web, REST, XML-RPC and e-mail interfaces.  It is based
on the winning design from Ka-Ping Yee in the Software Carpentry
"Track" design competition.

The current stable version of Roundup is 2.2.0. It is a bug fix
and feature release for the 2.1.0 release 

Some improvements from the 2.1.0 release are:

    * Roundup supports dynamic and static compression of http
      responses. This improves performance when a front end web
      server isn't serving compressed assets.

    * REST interface: supports CORS allowing Roundup to be
      used by third party web sites. Origins allowed to use
      REST can be specified. OpenAPI (Swagger) docs can be
      added. Error handling/reporting improved.

    * Dockerfile support. Docker-compose for a mysql based
      tracker.

    * New full text search methods. SQLite FTS and PostgreSQL
      full text search are supported. These allow search
      expressions in addition to simple word based searches.

    * Secret values in config.ini can be stored in external
      files. This allows config.ini to be stored in a VCS
      without exposing secrets.

    * Translation object added to internal database handle. This
      allows auditors and extensions to provide efficient
      translations.

    * MySQL database creation uses COLLATE utf8_general_ci

    * Wsgi startup improvements (must be enabled by setting
      feature flag).

    * Fix crash when importing legacy Roundup tracker with long
      integers.

    * Fix issues with Roundup unable to find supporting files
      when installed via pip.

More info on the 57 changes can be found in the `change note`_.

For more information on Roundup see the :doc:`design overview
<docs/design>`, and all the other :doc:`documentation <docs>`. Roundup
has been deployed for:

    * bug tracking and TODO list management (the classic
      installation)
    * customer help desk support (with a wizard for the phone
      answerers, linking to networking, system and development
      issue trackers)
    * issue management for IETF working groups
    * sales lead tracking
    * conference paper submission and double-blind referee
      management
    * weblogging (well, almost :) 

...and so on. It's been designed with :doc:`flexibility
<docs/customizing>` in mind - it's not just another bug
tracker. Roundup ships with a *demo tracker* to play with - after
you've unpacked the source, just run "python demo.py" and load up the
URL it prints out!

Roundup was originally released as version 0.1.1 in late August, 2001.
The first `change note`_ written said:

    Needed a bug tracking system. Looked around. Tried to install many Perl-based systems, to no avail.
    Got tired of waiting for Roundup to be released. Had just finished major product project, so needed
    something different for a while. Roundup here I come... 

.. _`download`: https://pypi.org/project/roundup/
.. _`change note`: https://sourceforge.net/p/roundup/code/ci/tip/tree/CHANGES.txt
.. _`its own set of docs`: https://www.roundup-tracker.org/dev-docs/docs.html