Utilities¶
Data sets¶
- guidata.utils.update_dataset(dest: gdt.DataSet, source: Any | dict[str, Any], visible_only: bool = False) None ¶
Update dest dataset items from source dataset.
- Parameters:
For each DataSet item, the function will try to get the attribute of the same name from the source.
If the attribute exists in the source object or the key exists in the dictionary, it will be set as the corresponding attribute in the destination dataset.
- Returns:
None
- guidata.utils.restore_dataset(source: gdt.DataSet, dest: Any | dict[str, Any]) None ¶
Restore dest dataset items from source dataset.
- Parameters:
This function is almost the same as update_dataset but requires the source to be a DataSet instead of the destination.
Symmetrically from update_dataset, dest may also be a dictionary.
- Returns:
None
Miscellaneous utility functions¶
Running programs¶
- guidata.utils.misc.run_program(name, args: str = '', cwd: str = None, shell: bool = True, wait: bool = False) None ¶
Run program in a separate process.
- Parameters:
- Raises:
RuntimeError – If program is not installed.
- guidata.utils.misc.is_program_installed(basename: str) str | None ¶
Return program absolute path if installed in PATH, otherwise None.
- guidata.utils.misc.run_shell_command(cmdstr, **subprocess_kwargs)¶
Execute the given shell command.
Note that *args and **kwargs will be passed to the subprocess call.
If ‘shell’ is given in subprocess_kwargs it must be True, otherwise ProgramError will be raised.
If ‘executable’ is not given in subprocess_kwargs, it will be set to the value of the SHELL environment variable.
Note that stdin, stdout and stderr will be set by default to PIPE unless specified in subprocess_kwargs.
- Str cmdstr:
The string run as a shell command.
- Subprocess_kwargs:
These will be passed to subprocess.Popen.