mirror/borg
1
0
Fork 0
mirror of https://github.com/borgbackup/borg.git synced 2025-02-12 17:35:44 +00:00
Code Issues Releases Wiki Activity

Merge pull request #5033 from fantasya-pbem/docs/4073_JSON-logging

Browse source 
[DOCS] #4073 – PlaceholderError not printed as JSON
This commit is contained in:
TW 2020-03-15 20:48:12 +01:00 committed by GitHub
commit 08496f8b95
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 4 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
docs/internals/frontends.rst
View file

@ -36,6 +36,10 @@ Especially for graphical frontends it is important to be able to convey and refo
in meaningful ways. The ``--log-json`` option turns the stderr stream of Borg into a stream of JSON lines,
where each line is a JSON object. The *type* key of the object determines its other contents.
.. warning:: JSON logging requires successful argument parsing. Even with ``--log-json`` specified, a
parsing error will be printed in plain text, because logging set-up happens after all arguments are
parsed.
Since JSON can only encode text, any string representing a file system path may miss non-text parts.
The following types are in use. Progress information is governed by the usual rules for progress information,