385
385
We use 4 space indents for blocks, and never use tab characters. (In vim,
386
386
``set expandtab``.)
388
No trailing white space is allowed.
390
Unix style newlines (LF) are used.
392
Each file must have a newline at the end of it.
388
394
Lines should be no more than 79 characters if at all possible.
389
395
Lines that continue a long statement may be indented in either of
818
824
should be only in the command-line tool.
827
Progress and Activity Indications
828
---------------------------------
830
bzrlib has a way for code to display to the user that stuff is happening
831
during a long operation. There are two particular types: *activity* which
832
means that IO is happening on a Transport, and *progress* which means that
833
higher-level application work is occurring. Both are drawn together by
836
Transport objects are responsible for calling `report_transport_activity`
839
Progress uses a model/view pattern: application code acts on a
840
`ProgressTask` object, which notifies the UI when it needs to be
841
displayed. Progress tasks form a stack. To create a new progress task on
842
top of the stack, call `bzrlib.ui.ui_factory.nested_progress_bar()`, then
843
call `update()` on the returned ProgressTask. It can be updated with just
844
a text description, with a numeric count, or with a numeric count and
845
expected total count. If an expected total count is provided the view
846
can show the progress moving along towards the expected total.
848
The user should call `finish` on the `ProgressTask` when the logical
849
operation has finished, so it can be removed from the stack.
851
Progress tasks have a complex relatioship with generators: it's a very
852
good place to use them, but because python2.4 does not allow ``finally``
853
blocks in generators it's hard to clean them up properly. In this case
854
it's probably better to have the code calling the generator allocate a
855
progress task for its use and then call `finalize` when it's done, which
856
will close it if it was not already closed. The generator should also
857
finish the progress task when it exits, because it may otherwise be a long
858
time until the finally block runs.
1074
1113
Run ``bzr help global-options`` to see them all.
1115
These flags may also be set as a comma-separated list in the
1116
``debug_flags`` option in e.g. ``~/.bazaar/bazaar.conf``. (Note that it
1117
must be in this global file, not in the branch or location configuration,
1118
because it's currently only loaded at startup time.) For instance you may
1119
want to always record hpss traces and to see full error tracebacks::
1121
debug_flags = hpss, error