Exceptions - libvcs.exc

Exceptions for libvcs.

exception libvcs.exc.LibVCSException

exception

Bases: Exception

Standard exception raised by libvcs.

exception libvcs.exc.CommandError

exception

Bases: LibVCSException

Raised on non-zero return codes.

__init__(output, returncode=None, cmd=None)

method

Parameters:

• output (str)

• returncode (int | None)

• cmd (str | list[str] | None)

Return type:

None

message = 'Command failed with code {returncode}: {cmd}'

attribute

exception libvcs.exc.CommandTimeoutError

exception

Bases: CommandError

CommandError raised when a subprocess exceeds its wall-clock timeout.

Carries the deadline used when the timeout fired so callers and human readers see the duration in the rendered message rather than the misleading "Command failed with code None: ..." produced by the bare CommandError template (the child is not necessarily reaped before the exception is raised, leaving returncode None).

Examples

>>> err = CommandTimeoutError(
...     output='partial output',
...     cmd='git fetch',
...     timeout=2.5,
... )
>>> print(str(err))
Command timed out after 2.5s: git fetch
partial output

__init__(output, returncode=None, cmd=None, timeout=None)

method

Parameters:

• output (str)

• returncode (int | None)

• cmd (str | list[str] | None)

• timeout (float | None)

Return type:

None

timeout

attribute

Wall-clock deadline (seconds) the subprocess exceeded, if known.

exception libvcs.exc.InvalidVCS

exception

Bases: LibVCSException

Invalid VCS.