[PATCH v1] dts: strip whitespaces from stdout and stderr

[Juraj Linkeš]

On Mon, Feb 12, 2024 at 5:49 PM Jeremy Spewock <jspewock at iol.unh.edu> wrote:
>
> On Wed, Feb 7, 2024 at 7:16 AM Juraj Linkeš <juraj.linkes at pantheon.tech> wrote:
> >
> > There could be a newline at the end of stdout or stderr of a remotely
> > executed command. These cause issues when used later, such as when
> > joining paths from such commands - a newline in the middle of a path is
> > not valid.
> >
> > Fixes: ad80f550dbc5 ("dts: add SSH command verification")
> > Signed-off-by: Juraj Linkeš <juraj.linkes at pantheon.tech>
> > ---
> >  .../remote_session/remote_session.py          | 24 +++++++++++++++----
> >  1 file changed, 20 insertions(+), 4 deletions(-)
> >
> > diff --git a/dts/framework/remote_session/remote_session.py b/dts/framework/remote_session/remote_session.py
> > index 2059f9a981..6bea1a2306 100644
> > --- a/dts/framework/remote_session/remote_session.py
> > +++ b/dts/framework/remote_session/remote_session.py
> > @@ -10,8 +10,8 @@
> >  """
> >
> >
> > -import dataclasses
> >  from abc import ABC, abstractmethod
> > +from dataclasses import InitVar, dataclass, field
> >  from pathlib import PurePath
> >
> >  from framework.config import NodeConfiguration
> > @@ -20,7 +20,7 @@
> >  from framework.settings import SETTINGS
> >
> >
> > - at dataclasses.dataclass(slots=True, frozen=True)
> > + at dataclass(slots=True, frozen=True)
> >  class CommandResult:
> >      """The result of remote execution of a command.
> >
> > @@ -34,9 +34,25 @@ class CommandResult:
> >
> >      name: str
> >      command: str
> > -    stdout: str
> > -    stderr: str
> > +    init_stdout: InitVar[str]
> > +    init_stderr: InitVar[str]
> >      return_code: int
> > +    stdout: str = field(init=False)
> > +    stderr: str = field(init=False)
> > +
> > +    def __post_init__(self, init_stdout, init_stderr):
>
> Are the typehints skipped deliberately here because it's redundant? We
> might want to include them anyway just for better typehint coverage.
>

It's a method defined by the dataclasses module so I guess I didn't
feel the need to include the typehints because of that. No harm in
adding them though, I'll send a new version.

> > +        """Strip the whitespaces from stdout and stderr.
> > +
> > +        The generated __init__ method uses object.__setattr__() when the dataclass is frozen,
> > +        so that's what we use here as well.
> > +
> > +        In order to get access to dataclass fields in the __post_init__ method,
> > +        we have to type them as InitVars. These InitVars are included in the __init__ method's
> > +        signature, so we have to exclude the actual stdout and stderr fields
> > +        from the __init__ method's signature, so that we have the proper number of arguments.
> > +        """
> > +        object.__setattr__(self, "stdout", init_stdout.strip())
> > +        object.__setattr__(self, "stderr", init_stderr.strip())
> >
> >      def __str__(self) -> str:
> >          """Format the command outputs."""
> > --
> > 2.34.1
> >