Adjusted comment XML fields for consistency.

Renamed "name" -> "short-name" and "in_reply_to" -> "in-reply-to".
Reordered uuid before short-name.

Converted xml/grepm to xml/catmutt.

Now
  $ cat example.mbox | catmutt
works.  Onwards to be-xml-to-mbox!

Added grepm as a template for an output-mbox-to-mutt script.

The goal is to turn grepm into catmutt, and end up with
  $ be --xml list | be-xml-to-mbox | catmutt
to browse current bugs and comments in mutt.

Moritz has generously donated grepm under GPLv2.  Not GPLv>=2 yet, so
if the project decides to go to GLPv3 for example, this file will have
to stay behind.  Not that I see such a change coming, but I thought it
was worth commenting on, so we don't forget.

Added --xml option to becommands/list.py

Restored completion/be.bash.

Oops.  I seem to have removed it in my Thu 2008-11-27 19:35:55 -0500
commit.  Luckily, the version I removed was still sitting right were
it belongs as
 /etc/bash_completion.d/be
Now it will be back in the tree.

Touch missing userwide config file before read if it's missing.

Another bug introduced by James Rowe's user-config patch.  Obviously
it's hard to read a file if there's no file there.  I'm not sure how
it passed the unit tests earlier.  Maybe I forgot to install the
pre-commit version before running the test suite...  Anyhow, fixed
now.

Merge from Ben Finney's RCS unittest patch

This involved an `upgrade' of BE's bzr repo
Previous version (via `bzr info path/to/repo`): pack-0.92
Current version: rich-root-pack

The whole rich-root thing is a bzr features-vs-backwards-compatability
thing they've been wrestling with [1,2,3,4,...].  It seems that BE was
in some sort of unstable equilibrium [5], so I'll follow Ben's lead
and make the official switch.  Note that you'll need to use bzr>=1.5
to make the shift [6].  For the sake of completeness, the whole
rich-root thing was introduced here [7], but I don't understand enough
of bzr to make sense of the diff.  It just versions the repo's root
directory the same way it versions other directories [3].  The bzr
people seem to be planning to phase out non-rich-root formats in favor
of brisbane-core, aka 2.0beta [8], by bzr 2.0 [8], which is apparently
on the horizon [9,10,11].  What a headache.

Citations are all titles/X-List-Received-Date from
  https://lists.ubuntu.com/archives/bazaar/
with the exception of the URL [11].

[1] [RFC] rich root pack as default in 1.8 ?
  Sat, 06 Sep 2008 03:33:46 -0000
  (conclusion: none)
[2] Re: 1.9rc1 countdown
  Thu, 30 Oct 2008 08:44:53 -0000
  (conclusion: "primary" format should be rich-root next time we make a new format)
[3] So many repo formats
  Fri, 14 Nov 2008 08:41:33 -0000
  Mon, 17 Nov 2008 07:37:47 -0000  (explains rich-root format)
  Mon, 17 Nov 2008 22:37:39 -0000  (explains no-return policy)
  Mon, 17 Nov 2008 20:57:08 -0000  (explicitly lists non-svn reasons for rich-root)
[4] Branch fails from 'pack-0.92' repo to 'rich-root-pack' repo.
  Wed, 27 Aug 2008 11:31:11 -0000
  (we're not sure again)
[5] Branch fails from 'pack-0.92' repo to 'rich-root-pack' repo.
  Sun, 20 Apr 2008 12:58:09 -0000
[6] Branch fails from 'pack-0.92' repo to 'rich-root-pack' repo.
  Fri, 29 Aug 2008 13:23:52 -0000
[7] [RFC] Knit format 2
  Fri, 25 Aug 2006 22:55:36 -0000
[8] bazaar 2.0beta format for launchpad release
  Fri, 29 May 2009 06:00:03 -0000
[9] Upgrading loggerhead to 1.9-rich-root
  Mon, 11 May 2009 22:35:28 -0000
  (mentions eventual switch to rich-root in 2.0)
[10] bzr 1.16rc1 released!
  Fri, 12 Jun 2009 08:00:08 -0000
  (confirms eventual switch to rich-root in 2.0)
[11] https://launchpad.net/bzr/+announcement/2733
  (current outstanding releases: 1.17, 2.0)

Conform new docstrings to PEP 257.

Added comments-from-stdin, so we can add tracebacks, e.g. with

  $ be list --invalid-option | be comment <bug-id> -

Allow defaults for config.get_val() in case of missing user-config file.

Fixes bug introduced by James Rowe's previous patch:

  $ be list
  Traceback (most recent call last):
    ...
    File ".../libbe/rcs.py", line 34, in _get_matching_rcs
      import arch
    File ".../libbe/arch.py", line 29, in <module>
      client = config.get_val("arch_client")
    File ".../libbe/config.py", line 70, in get_val
    File "/usr/lib/python2.5/codecs.py", line 817, in open
      file = __builtin__.open(filename, mode, buffering)
  IOError: [Errno 2] No such file or directory: '/home/wking/.bugs_everywhere'

Merged James Rowe's arch-shouldn't-create-userwide-config-file patch.

From his email to the be-devel list:

From: James Rowe <jnrowe@ukfsn.org>
Date: Tue, 3 May 2009 11:44:41 +0000
Subject: [PATCH] Don't create config file unless we're using arch.

Hi,

  I find the current behaviour of creating a config file simply to set
a default for a revision control system I'm never going to use to be
a little annoying, the attached patch changes this behaviour to only
set the default in the config file if you're actually using arch.

Thanks,

James

Merged Thomas Habets 2009-01-07 XML output for "be show".

I rewrote a few of his routines, e.g. generalizing
Comment.string_thread to run a caller-specified method avoided the
need for some duplicate code in Comment.xml_thread.  There was also a
reasonable reorganization of libbe.settings_object.versioned_property
because the <in_reply_to> field of the Comment.xml output was giving
me `-1' (= old settings_object.EMPTY) instead of None, even after I
had set comm.in_reply_to to None.  The rewritten versioned_property
avoids the ambiguity of UNPRIMED vs EMPTY, and avoids the stupididy of
my using EMPTY=-1 ;).

Removed unused libbe/restconvert.py and fixed a typo in README.dev

Merge from main branch.

libbe/encoding.py

Follow existing docstring whitespace convention.

Distinguish tests for VCS which can't handle an uninitialised identity.

Refactor mega-testcases into separate true-or-false testcases.

Make RCS testcase subclasses dynamically.

Use a more general regex to test GIT commits; GIT's output has changed.

XML output for "be show"

Fixed spelling mistake in test_usage.sh

Fixed lack of user_id caching in bugdir.BugDir

Closed search bug

9a942b1d-a3b5-441d-8aef-b844700e1efa

Aaron says it's already implemented in the Bugs-Everywhere-Web, and
  $ be show `be list --status all --uuids` | grep -A5 -B5 XYZ
works pretty well for me on the command line.

Merged in the successful per-tree-config branch.

Added per-tree default assignee option.

The new setting is currently only used when creating new bugs with
becommand/new.

Closed a few old bugs that seem outdated/dealt with.

Fixed missing directory error when merging comments onto a bare bug.

If bug_A had no comments (and so, no comment directory), changing
comment settings before saving raised missing directory errors.
save_settings had previously assumed the
 .be/bugs/XYZ/comments/
directory existed, which wasn't true for comment-less bugs.  Now it
checks, and creates the directory if necessary.

becommands/severity and status now handle --complete appropriately.

I also disabled interspersed options and arguments in
cmdutils.CmdOptionParser.  See
  http://docs.python.org/library/optparse.html
Now
  $ be severity xyz --complete
returns available severities.  It had previously returned
  --help --complete

Per-tree status levels working.

Closed 4a4609c8-1882-47de-9d30-fee410b8a802

Per-tree severity levels working.

Adjusted becommands/list.py to use current bug severities levels.

bug severity verification now works with per-tree severities.

I adjusted the YAML format following
  http://pyyaml.org/ticket/11
  Unicode support
To remove '!!python/unicode' escapes and allow unicode in the output.
We can always have unicode in the output because the output is encoded
(as per the BugFile.encoding setting) before being sent to the outside
world.

Per-tree settings now passed into bug module.

becommands/severity gets the configured settings appropriately.

Todo:
  adjust setting-validation to compare against the current values.
  setup becommands/severity to --complete severities.

Added per-tree configurable severities.

They currently have no effect, but you can see them with
  $ be set
There's a lot of information in this one 'settings' variable.  I think
set will have to be specialized to handle arrays smoothly...

Cleaned up some older bugs.

Added support for bug reporter field.

Closes e2f6514c-5f9f-4734-a537-daf3fbe7e9a0

Merged decorator branch.

Fixed comparison bug in Bug._get_time.

Added auto-completion for becommands/set property names.

Converted Comment to the settings_object system.

Bug moved to the settings_object system.

Added decorator-style properties to bugdir.  Created settings_object module.

settings_object.SavedSettingsObject encapsulates some of the common
settings functionality in the BE BugDir, Bug, and Comment classes.
It's a bit awkward due to the nature of scoping in python subclasses,
but it's better than reproducing this code in each of the above classes.
Now I need to move Bug and Comment over to *this* system ;).

Added decorator-style properties to libbe/comment.py.

Also some typo corrections and some reworking of bug/bugdir to better
support the lazier loading.

Fixed some erroneous "no test suite" messages in test.py.

Added libbe/properties to make property management easier.

libbe/bug has been moved over to the new system.
comment and bugdir still to go.

Added more helpful error message for libbe modules missing test suites.

Optimized bug loading from becommands/comment with partial-uuid matching.

The code is a bit uglier now, but it's a good deal faster :).

Added becommands/comment completion.

Completion support added to becommands/help

Added bugid_args option to cmdutil.default_complete.

Now most of the bug-id arguments support Bash completion.  Since there
will hopefully be lots of bugs in the database, I decided to filter
the list of available bugs.  Currently, we just auto-complete active
bugs for most commands, with the exceptions of open (obviously) and
status (which needs to work on all types of bugs).

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).

Merge from W. Trevor King's tree.

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