Skip to main content

Bugtracker supporting distributed revision control

Project description

Bugs Everywhere
===============

This is Bugs Everywhere (BE), a bugtracker built on distributed version
control. It works with Arch, Bazaar, Darcs, Git, Mercurial, and Monotone
at the moment, but is easily extensible. It can also function with no
VCS at all.

The idea is to package the bug information with the source code, so that
bugs can be marked "fixed" in the branches that fix them. So, instead of
numbers, bugs have globally unique ids.


Getting BE
==========

BE is available as a Git repository::

$ git clone git://gitorious.org/be/be.git be

See the homepage_ for details. If you do branch the Git repo, you'll
need to run::

$ make

to build some auto-generated files (e.g. ``libbe/_version.py``), and::

$ make install

to install BE. By default BE will install into your home directory,
but you can tweak the ``PREFIX`` variable in ``Makefile`` to install
to another location.

.. _homepage: http://bugseverywhere.org/


Getting started
===============

To get started, you must set the bugtracker root. Typically, you will want to
set the bug root to your project root, so that Bugs Everywhere works in any
part of your project tree.::

$ be init -r $PROJECT_ROOT

To create bugs, use ``be new $DESCRIPTION``. To comment on bugs, you
can can use ``be comment $BUG_ID``. To close a bug, use
``be close $BUG_ID`` or ``be status $BUG_ID fixed``. For more
commands, see ``be help``. You can also look at the usage examples in
``test_usage.sh``.


Documentation
=============

If ``be help`` isn't scratching your itch, the full documentation is
available in the doc directory as reStructuredText_ . You can build
the full documentation with Sphinx_ , convert single files with
docutils_ , or browse through the doc directory by hand.
``doc/index.txt`` is a good place to start. If you do use Sphinx,
you'll need to install numpydoc_ for automatically generating API
documentation. See the ``NumPy/SciPy documentation guide``_ for an
introduction to the syntax.

.. _reStructuredText:
http://docutils.sourceforge.net/docs/user/rst/quickref.html
.. _Sphinx: http://sphinx.pocoo.org/
.. _docutils: http://docutils.sourceforge.net/
.. _numpydoc: http://pypi.python.org/pypi/numpydoc
.. _NumPy/SciPy documentation guide:
https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bugs-everywhere-1.1.1.tar.gz (172.4 kB view details)

Uploaded Source

File details

Details for the file bugs-everywhere-1.1.1.tar.gz.

File metadata

File hashes

Hashes for bugs-everywhere-1.1.1.tar.gz
Algorithm Hash digest
SHA256 4d7cd5c64b49e66d4fa8478c214139f8dcf50a7cc76f31fa66bcc6cb271b75c6
MD5 7d17c6d6475419be424ce78259592fac
BLAKE2b-256 a35fc90a3c9ca9a522dc1fa61f03915631d151c9e1963437e81448939ae23fd6

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page