Command completion simplified and working for list, dummies for other cmds.

All the other commands currently use default_complete(), which has no
effect other than catching the --complete option and effectively
aborting execution.

This closes 8e1bbda4-35b6-4579-849d-117b1596ee99

Merged --commands and --options into --complete.  Simpler that way.

Basic bash completion is now supported.

I'm still working on a clean implementation though...

Fixed typo in becommands/comment help string.

Added --commands option to be to help with bash completion.

A'la ditz
  http://gitorious.org/projects/ditz

See also this good intro to bash completion
  http://www.debian-administration.org/articles/317

Added -a/n/m/r to becommands/diff.py.

added -u/uuids option to becommands/list

Added libbe/encoding.py to wrap input/output/file access appropriately.

I borrowed most of the code for this.

get_encoding() is from Trac
  http://trac.edgewall.org/browser/trunk/trac/util/datefmt.py
  format_datetime()
Trac has a BSD license
  http://trac.edgewall.org/wiki/TracLicense
I don't know if such a small snippet requires us to "reproduce the
above copyright" or where we need to reproduce it if it is needed.

The stdout/stdin replacement code follows
  http://wiki.python.org/moin/ShellRedirectionFails

Because of the stdout replacement, the doctests executes now need an
optional 'test' argument to turn off replacement during the doctests,
otherwise doctest flips out (since it had set up stdout to catch
output, and then we clobbered it's setup).

References:
  http://wiki.python.org/moin/Unicode
  http://www.amk.ca/python/howto/unicode
  http://www.python.org/dev/peps/pep-0100/

I also split libbe/editor.py off from libbe.utility.py and started
explaining the motivation for the BugDir init flags in it's docstring.

Oops, should be passing libbe.tree.Tree.sort() args to children.  Fixed.

Hack to fixe encoding bug in becommands/show

The situation really calls for a global encoding setting rather than
lots of hardcoded "utf-8"s.  See bug
  f7ccd916-b5c7-4890-a2e3-8c8ace17ae3a

Added becommands/merge to join duplicate bugs.

Adjusted becommands/set to handle user_id properly.

Added invalid-value checking to becommands/set.py.

Kindof a cludgy check, but there's currently no simpler way to find
valid entries for a given setting name (that I can think of).

Tweaked usage strings to increase consistency.  Also added README.dev.

I tried to stick to CAPS for argument placeholders.

Fixed broken doctest and inconsitent indentation from not wrapping comments.

Also emptied becommands/__init__.py.  I didn't understand the plugin
interface when I wrote it.

Marked c45e5ece-63e3-4fd2-b33f-0bfd06820cf4 as fixed.

It's been fixed for a while

Removed auto-wrapping from comment.Comment.string().

It makes tracebacks almost illegible.  I doubt markup/markdown systax
or auto-formatting is really useful, since bugs-reports are ususally a
short comment and a traceback.

I also closed a4d38ba7-ec28-4096-a4f3-eb8c9790ffb2 and
7bfc591e-584a-476e-8e11-b548f1afcaa6, which have probably been fixed
for a long time...

Added Bug.comments(), BugDir.has_bug() & cleaned up diff.diff().

+ some other minor fixes and cleanups.

Replaced direct filesystem read from bugdir.py with RCS mediated read.

Also replaced utility.FileString with StringIO() in cmdutil.py, which
allowed the removal of utility.FileString and utility.get_file.

The only remaining file().read() outside the RCS framework is the read
in utility.editor_string(), but should probably not go through the
RCS.

Added 'allow_no_rcs' flag to RCS file system access methods.

Now mapfile access has fewer special cases, and there is less
redundant rcs.add/update code.

Created bugdir.MultipleBugMatches so bugdir no longer imports cmdutil.

Removed outdated beuuid import from libbe/bugdir.py

libbe/diff.diff() was missing newly created bugs.  Fixed.

Also added blank lines to separate the new/modified/removed groups.

Go back to lazy bug loading to get execution speed back up.

Fixes bug b3c6da51-3a30-42c9-8c75-587c7a1705c5

Improved user-id saving/loading/caching & save user-id into duplicate bugdirs.

Fixes the duplicate bugs
  a403de79-8f39-41f2-b9ec-15053b175ee2
  c894f10f-197d-4b22-9c5b-19f394df40d4

Added bugdir user-id caching and save/load from settings file.

`be show` now supports showing multiple bugs with a single call.

Oops, dba25cfd-aa15-457c-903a-b53ecb5a3b2c was fixed with commit 253.

Oops, dac91856-cb6a-4f69-8c03-38ff0b29aab2 was fixed with commit 242.

Fixed "'NoneType' object is not callable" error in libbe/utility/Dir.__del__

Added archive/project init code for `./test_usage.sh arch`.

Also some minor cleanups.

Explicit rcs.cleanup() in bugdir test.

Don't use del(rcs), because if there was an error, there is still a
reference to rcs in the traceback, so it is never cleaned up.  This
can leave the external archive cluttering up your Arch install if
you're using the Arch backend.  See the __del__ documentation

  http://python.active-venture.com/ref/customization.html#l2h-175

for details.

Also fixed some out-of-date method names in libbe.diff

libbe.utility.Dir was complaining of a missing shutil in __del__().

Presumably the cleanup process removed shutil before cleaning up the Dir.
Now Dir keeps a local reference.

Oops, bug 8e83da06-26f1-4763-a972-dae7e7062233 was fixed by commit 254.

Created and fixed bug 496edad5-1484-413a-bc68-4b01274a65eb.

I figured out why Arch was complaining.  For non-Arch users, file
system access has been tweaked a bit see the BugDir doc string for
details.  Also, you should now set BugDir.rcs instead of .rcs_name.
.rcs_name automatically tracks changes in .rcs (the reverse of the
previous situation), so read from whichever you like.

Oops, these new submods are used by the new, classified Bug & BugDir.

I'd forgotten tell bzr...

Another major rewrite.  Now BugDir, Bug, and Comment are more distinct.

I pushed a lot of the little helper functions into the main classes,
which makes it easier for me to keep track of what's going on.  I'm
now at the point where I can run through `python test.py` with each of
the backends (by changing the search order in rcs.py
_get_matching_rcs) without any unexpected errors for each backend
(except Arch).  I can also run `test_usage.sh` without non-Arch errors
either.

However, don't consider this a stable commit yet.  The bzr backend is
*really*slow*, and the other's aren't blazingly fast either.  I think
I'm rewriting the entire database every time I save it :p.  Still, it
passes the checks. and I don't like it when zounds of changes build up.

Updated misc/gui/wxbe with wxPython -> wx changes.

I'd like to be able to sort the bugs by clicking on the various column
titles, but I don't know enough about wxPython to pull it off.  After
wrestling with it for a bit, I realized that I'll only be using the
command line interface anyway, and other people can use the web
interface.  Probably a common feeling, which would explain why the
GUIs feel so abandoned ;).

At any rate, I think the effects of turning the RCSs into classes have
been passed through and stabilized, so my churning should decrease...

names.creator() replaced by rcs.get_user_id().

Some more fixes to get BE-Web working with libbe changes.

Added identity discussion to BE-Web README.txt & require login to edit bugs.

Added BE-Web repo-access warning to Bugs-Everywhere-Web/README.txt.

Updated Bugs-Everywhere-Web to work with new architecture.

Merged bug.new_comment into bug.Bug.new_comment.

Moved bug.new_bug code into bugdir.BugDir.new_bug.

Also removed explicit comparisons from beweb/controllers.py, since
they are now built into the Bug.__cmp__ method.

Added test_usage.sh pointer to the README.

Removed libbe/tests.py

Not needed with stronger test.py.  It's only use would be testing an
installed libbe in place...  Maybe that is useful enough?  If so, we
can bring it back.

One of my tests left my bzr name as John Doe.  Seems to be fixed now.

I checked with

$ python test.py
...
$ ./test_usage.py
...
$ hg showconfig | grep ui.username && bzr whoami
$ git config user.name && git config user.email && tla my-id

Major rewrite of RCS backends.  RCS now represented as a class.

Lots of changes and just one commit.  This started with bug
dac91856-cb6a-4f69-8c03-38ff0b29aab2, when I noticed that new bugs
were not being added appropriately with the Git backend.  I'd been
working with Git trouble before with bug
0cad2ac6-76ef-4a88-abdf-b2e02de76f5c, and decided things would be
better off if I just scrapped the current RCS architecture and went to
a more object oriented setup.  So I did.  It's not clear how to add
support for an RCS backend:
 * Create a new module that
   - defines an inheritor of rsc.RCS, overriding the _rcs_*() methods
   - provide a new() function for instantizating the new class
   - defines an inheritor of rcs.RCStestCase, overiding the Class attribute
   - defines 'suite' a unittest.TestSuite testing the module
 * Add your new module to the rest in rcs._get_matching_rcs()
 * Add your new module to the rest in libbe/tests.py
Although I'm not sure libbe/tests.py is still usefull.

The new framework clears out a bunch of hackery that used to be
involved with supporting becommands/diff.py.  There's still room for
progress though.  While implementing the new verision, I moved the
testing framework over from doctest to a doctest/unittest combination.
Longer tests that don't demonstrate a function's usage should be moved
to unittests at the end of the module, since unittest has better
support for setup/teardown, etc.

The new framework also revealed some underimplented backends, most
notably arch.  These backends have now been fixed.

I also tweaked the test_usage.sh script to run through all the backends
if it is called with no arguments.

The fix for the dac bug turned out to be an unflushed file write :p.

Added 'hg', 'arch', and 'none' RCS modes to test_usage.sh.

Fixed another bug in git.strip_git() (bug 0cad).

Also added git mode to test_usage.sh.
I'll go through and add modes for the other RCSs...

Oops, I'd forgotten to tell bzr about my becommands/remove.py.

Merged in my git.py changed fixing Hubert Chathi's git set-root bug (0cad).

Added ./test_usage.sh as an example usage scenario.

It is also a good integration test.

Removed dud bug 11e.  Moved several bugs from 'closed' to 'fixed'.

Fix Bug.string() handling of None times.

Removed the empty bugs 14c and 38b.  Fixed bug.string() call in libbe/diff.py.

Added 'remove' command to remove bugs.  Use __desc__ for command help.

Using the __desc__ reduces documentation duplication.  It's also better
than using __doc__, because __doc__ could (should?) be more than one-line
long, and we just want a short description to jog our memories in the
complete command list.

Also moved unique_name from cmdutil.py to names.py to avoid the
  bug->cmdutil->bugdir->bug
cyclic include.

Fixed '-' parsing bug for list --assigned option.

Fixed some errors produced while moving bug_summary to Bug.string().

Moved libbe.cmdutil.bug_summary() to libbe.bug.Bug.string().

This seems like a natual place for a function that only operates on Bugs.

Removed libbe/template.

This file is not used anywhere, and appears to be an outdated version
of libbe/diff.py.

becommands/show.py gives more specific bug information.

Generalized becommands/list.py to allow more specific bug searches.

Fixed a few more Comment.date->time calls.

Bug keeps timestamps in Bug.time, so working towards consitency for
Comment.

Removerd the diff3 functions from mapfile.py.

They don't seem to be used anywhere...

Fixed some bug.py split effects in diff.py

Also added 'disabled' status back in so diff doesn't choke trying to
load the older versions...  Ugly hack, but I don't want to change the
past ;).

Split Bug and Comment class out to bug.py from bugdir.py

Comment should probably have it's own file too...

I also tried to clean up the interface for setting status and
severity.  Both attributes involve selecting strings from predefined
lists.  The lists of valid strings (and descriptions of each string)
are now defined in bug.py.  The bug.py lists are then used to generate
appropriate help strings in becommands/status.py and severity.py.
This should make it easier to keep the help strings in synch with the
validation information.

The original status strings weren't documented, and I didn't know what
they all ment, so I elimanted some of them.  'in-progress' and
'disabled' are no longer with us.  Of course, it would be simple to
add them back in if people don't agree with me on that.  Due to the
loss of 'disabled' I had to change the status of two bugs (11e and
597) to 'closed'.  I removed becommands/inprogress.py as well.  It's
functionality was replaced by the more general status.py command,
which mimics the severity.py command.

Changed __get/setattribute__ calls to get/setattr() calls.

See
  http://www.python.org/doc/2.5.2/lib/built-in-funcs.html#l2h-33
  http://www.python.org/doc/2.5.2/lib/built-in-funcs.html#l2h-66

Replaced libbe.arch.invoke() with general rcs.invoke()

Added caveat about using short bug names to unique_name().

Cleaned up and docstringed libbe.cmdutil.unique_name().

Now the first bug will have a 3 char short name (used to be one char,
with the second bug having a 3 char name).

Remove blank lines from `be list' output

Closed bug 210 (target options not parsed).

I imagine this has been fixed for a while...

Oops... *Now* I've fixed 0cad

Fixed 0cad bug with smaller fix.

Hubert Chathi's fix was confusing for me, so I made a simpler change.
Seems to work so far.  The problem was that

os.path.dirname('filename')

returns an empty string ('') if there are no directories in the
filename.  So when `git rev-parse --git-dir` returned '.git', os
returned ''.  Later programs didn't recognize '' as a valid directory
and crashed.  My fix returns '.' in this case, so we don't crash,
and avoid having to use full paths.  I'm not sure why I don't want
to use full paths; they just give me bad vibes...

Added Hubert Chathi's git set-root bug report.

Bug report patch from
http://void.printf.net/pipermail/be-devel/attachments/20080623/49500aaf/0cad.bin

Reporting thread
[Be-devel] Re: set-root in git repository fails
Hubert Chathi hubert at uhoreg.ca
Tue Jun 24 03:49:23 BST 2008
http://void.printf.net/pipermail/be-devel/2008-June/000038.html

Merge from main branch

* use python2.4/2.5 compatible import of ElementTree
* catch Popen() calls to missing VCS binaries
* test.py should only test installed backends

Updated imports to handle Python 2.5 ElementTree module.

Opened, fixed, and closed as bug 31c.

Created bug c4e.  Wrote a simple (an hopefully correct) be/test.py docstring.

Created late bug report for Popen OSError catches

Catch OSErrors from Popen()s

From the subprocess module documentation:
http://www.python.org/doc/2.5.2/lib/node530.html

"The most common exception raised is OSError. This occurs, for example,
when trying to execute a non-existent file.  Applications should prepare
for OSError exceptions."

And from the os module documentation:
http://www.python.org/doc/2.5.2/lib/module-os.html

"exception error
    This exception is raised when a function returns a system-related
    error (not for illegal argument types or other incidental
    errors). This is also known as the built-in exception OSError. The
    accompanying value is a pair containing the numeric error code
    from errno and the corresponding string, as would be printed by
    the C function perror(). See the module errno, which contains
    names for the error codes defined by the underlying operating
    system.
    When exceptions are classes, this exception carries two
    attributes, errno and strerror. The first holds the value of the C
    errno variable, and the latter holds the corresponding error
    message from strerror(). For exceptions that involve a file system
    path (such as chdir() or unlink()), the exception instance will
    contain a third attribute, filename, which is the file name passed
    to the function."

I turned this up running be/test.py, when it defaulted to the tla client
which I didn't have installed.  I don't have things working yet, so I
can't create a bug at the moment...

Don't require python2.4 for "be".

Require editbugs permission to edit bugs.  Patch from j@oil21.org.

Apply patches from j@oil21.org, Ben Finney, Jelmer Vernooij.

Add GIT support, from Chris Ball and Michael Stone.

Fix branding: Bazaar-NG -> Bazaar.

Make setup.py executable.

Makefile: Add with 'clean' target.

Bugs-Everywhere-Web works with python2.5 do not hardcode python2.4

Assume commit messages are in utf-8 for now...

Add support for VISUAL

Ensure that Arch tests have a user id set

Clarify VISUAL meaning

Add setup-tables script

Add bug report from Jelmer

Merge from panometrics

New bug.

Fix long lines