* [pbs-devel] [PATCH proxmox] schema: removed excessive newlines in error messages
@ 2023-09-01 8:12 Gabriel Goller
2023-10-11 11:06 ` Gabriel Goller
2023-10-18 17:22 ` Thomas Lamprecht
0 siblings, 2 replies; 4+ messages in thread
From: Gabriel Goller @ 2023-09-01 8:12 UTC (permalink / raw)
To: pbs-devel
The output does not look good on console/task view when there is an
empty line after the first error and trailing newlines after
the last error. Removed the newlines.
Example:
before:
```
$ proxmox-backup-client ...
Error: parameter verification errors
parameter 'file-name': value does not match the regex pattern
$
```
now:
```
$ proxmox-backup-client ...
Error: parameter verification errors
parameter 'file-name': value does not match the regex pattern
$
```
Signed-off-by: Gabriel Goller <g.goller@proxmox.com>
---
proxmox-schema/src/schema.rs | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/proxmox-schema/src/schema.rs b/proxmox-schema/src/schema.rs
index f087706..596adee 100644
--- a/proxmox-schema/src/schema.rs
+++ b/proxmox-schema/src/schema.rs
@@ -101,14 +101,14 @@ impl fmt::Display for ParameterError {
let mut msg = String::new();
if !self.is_empty() {
- msg.push_str("parameter verification errors\n\n");
+ msg.push_str("parameter verification errors\n");
}
for (name, err) in self.error_list.iter() {
let _ = writeln!(msg, "parameter '{}': {}", name, err);
}
- write!(f, "{}", msg)
+ write!(f, "{}", msg.trim())
}
}
--
2.39.2
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [pbs-devel] [PATCH proxmox] schema: removed excessive newlines in error messages
2023-09-01 8:12 [pbs-devel] [PATCH proxmox] schema: removed excessive newlines in error messages Gabriel Goller
@ 2023-10-11 11:06 ` Gabriel Goller
2023-10-18 17:22 ` Thomas Lamprecht
1 sibling, 0 replies; 4+ messages in thread
From: Gabriel Goller @ 2023-10-11 11:06 UTC (permalink / raw)
To: pbs-devel
bump
On 9/1/23 10:12, Gabriel Goller wrote:
> The output does not look good on console/task view when there is an
> empty line after the first error and trailing newlines after
> the last error. Removed the newlines.
>
> Example:
> before:
> ```
> $ proxmox-backup-client ...
> Error: parameter verification errors
>
> parameter 'file-name': value does not match the regex pattern
>
> $
> ```
> now:
> ```
> $ proxmox-backup-client ...
> Error: parameter verification errors
> parameter 'file-name': value does not match the regex pattern
> $
> ```
>
> Signed-off-by: Gabriel Goller <g.goller@proxmox.com>
> ---
> proxmox-schema/src/schema.rs | 4 ++--
> 1 file changed, 2 insertions(+), 2 deletions(-)
>
> diff --git a/proxmox-schema/src/schema.rs b/proxmox-schema/src/schema.rs
> index f087706..596adee 100644
> --- a/proxmox-schema/src/schema.rs
> +++ b/proxmox-schema/src/schema.rs
> @@ -101,14 +101,14 @@ impl fmt::Display for ParameterError {
> let mut msg = String::new();
>
> if !self.is_empty() {
> - msg.push_str("parameter verification errors\n\n");
> + msg.push_str("parameter verification errors\n");
> }
>
> for (name, err) in self.error_list.iter() {
> let _ = writeln!(msg, "parameter '{}': {}", name, err);
> }
>
> - write!(f, "{}", msg)
> + write!(f, "{}", msg.trim())
> }
> }
>
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [pbs-devel] [PATCH proxmox] schema: removed excessive newlines in error messages
2023-09-01 8:12 [pbs-devel] [PATCH proxmox] schema: removed excessive newlines in error messages Gabriel Goller
2023-10-11 11:06 ` Gabriel Goller
@ 2023-10-18 17:22 ` Thomas Lamprecht
2023-10-23 7:51 ` Gabriel Goller
1 sibling, 1 reply; 4+ messages in thread
From: Thomas Lamprecht @ 2023-10-18 17:22 UTC (permalink / raw)
To: Proxmox Backup Server development discussion, Gabriel Goller
nit: s/removed/remove/, commit message should describe what they
change in the commit itself, so they make most sense if written in
the imperative.
Am 01/09/2023 um 10:12 schrieb Gabriel Goller:
> The output does not look good on console/task view when there is an
> empty line after the first error and trailing newlines after
> the last error. Removed the newlines.
I mean, as there are explicitly two newlines in a literal before
you patch it seems like somebody though it looks better that way
;-)
But sure, being more concise and providing less output, while keeping
a good readability, has definitively its merits!
The double occurrence of "error" is also something we could try to
avoid.
> Signed-off-by: Gabriel Goller <g.goller@proxmox.com>
> ---
> proxmox-schema/src/schema.rs | 4 ++--
> 1 file changed, 2 insertions(+), 2 deletions(-)
>
> diff --git a/proxmox-schema/src/schema.rs b/proxmox-schema/src/schema.rs
> index f087706..596adee 100644
> --- a/proxmox-schema/src/schema.rs
> +++ b/proxmox-schema/src/schema.rs
> @@ -101,14 +101,14 @@ impl fmt::Display for ParameterError {
> let mut msg = String::new();
>
> if !self.is_empty() {
> - msg.push_str("parameter verification errors\n\n");
> + msg.push_str("parameter verification errors\n");
This is debatable, maybe we could do the following:
1. If there's exactly one parameter error collapse it to a single line, e.g.:
```
Error: parameter verification failed - 'file-name': value does not match the regex pattern
```
Or even more condensed:
```
Error: parameter 'file-name' - value does not match the regex pattern
```
2. if there are more than one error use a line by error but also use
bulletin point to keep a higher readability, e.g.:
```
Error: parameter verification failed:
- 'file-name': value does not match the regex pattern
- 'some-number': value is not in range X to Y
- 'foo-bar': value is to common
```
The only thing, from top of my head, speaking against doing 1. at all would
be that it's making parsing a bit harder, but tbh., we never guaranteed
error message stability, and if one depends on such stuff they should use
the API – so not seeing that as a blocker.
What do you think?
> }
>
> for (name, err) in self.error_list.iter() {
> let _ = writeln!(msg, "parameter '{}': {}", name, err);
> }
>
> - write!(f, "{}", msg)
> + write!(f, "{}", msg.trim())
this I'm fine with doing unconditionally.
> }
> }
>
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [pbs-devel] [PATCH proxmox] schema: removed excessive newlines in error messages
2023-10-18 17:22 ` Thomas Lamprecht
@ 2023-10-23 7:51 ` Gabriel Goller
0 siblings, 0 replies; 4+ messages in thread
From: Gabriel Goller @ 2023-10-23 7:51 UTC (permalink / raw)
To: Thomas Lamprecht, Proxmox Backup Server development discussion
[-- Attachment #1: Type: text/plain, Size: 441 bytes --]
On 10/18/23 19:22, Thomas Lamprecht wrote:
> [..]
> The only thing, from top of my head, speaking against doing 1. at all would
> be that it's making parsing a bit harder, but tbh., we never guaranteed
> error message stability, and if one depends on such stuff they should use
> the API – so not seeing that as a blocker.
>
> What do you think?
Yes, sounds good, I'll send a patch right now (+ I don't think parsing is a problem here).
[-- Attachment #2: Type: text/html, Size: 871 bytes --]
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2023-10-23 7:51 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2023-09-01 8:12 [pbs-devel] [PATCH proxmox] schema: removed excessive newlines in error messages Gabriel Goller
2023-10-11 11:06 ` Gabriel Goller
2023-10-18 17:22 ` Thomas Lamprecht
2023-10-23 7:51 ` Gabriel Goller
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox