Document the switch to the logging and warning systems in the changelog
Marco Ricci commited on 2024-12-08 19:02:03
Zeige 1 geänderte Dateien mit 21 Einfügungen und 0 Löschungen.
- docs/changelog.d/20241208_175929_the-13th-letter_logging.md 0000000..5363519
| ... | ... |
@@ -0,0 +1,21 @@ |
| 1 |
+### Added |
|
| 2 |
+ |
|
| 3 |
+ - Both `derivepassphrase vault` and `derivepassphrase export vault` now |
|
| 4 |
+ support changing the amount of diagnostic output they emit via new |
|
| 5 |
+ command-line options `--debug`, `-v`/`--verbose` and `-q`/`--quiet`. |
|
| 6 |
+ Internally, this uses Python's standard [logging][] and [warnings][] |
|
| 7 |
+ systems. |
|
| 8 |
+ |
|
| 9 |
+### Changed |
|
| 10 |
+ |
|
| 11 |
+ - Calling [`derivepassphrase.cli.derivepassphrase_export`][], |
|
| 12 |
+ [`derivepassphrase.cli.derivepassphrase_export_vault`][] or |
|
| 13 |
+ [`derivepassphrase.cli.derivepassphrase_vault`][], or calling |
|
| 14 |
+ [`derivepassphrase.cli.derivepassphrase`][] via its |
|
| 15 |
+ [`.main`][click.BaseCommand.main] method, causes those functions to use |
|
| 16 |
+ the standard Python [logging][] and [warnings][] facilities to issue |
|
| 17 |
+ diagnostic messages, without output to standard error. (This includes |
|
| 18 |
+ using [`click.testing.CliRunner`][], which uses `.main` calls under the |
|
| 19 |
+ hood.) Calling [`derivepassphrase.cli.derivepassphrase`][] directly as |
|
| 20 |
+ a function diverts diagnostic messages to standard error. |
|
| 21 |
+ |
|
| 0 | 22 |