mirror/borg
1
0
Fork 0
mirror of https://github.com/borgbackup/borg.git synced 2025-03-15 08:29:36 +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, 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. 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. 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, The following types are in use. Progress information is governed by the usual rules for progress information,