ToolChain.GTKWave

Exceptions

Classes

Functions

exception ToolChain.GTKWave.GTKWaveException(message='')[source]

Inheritance

Inheritance diagram of GTKWaveException

Members

__init__(message='')

Exception initializer

Parameters:message (str) – The exception message.
__str__()

Returns the exception’s message text.

args
class ToolChain.GTKWave.Configuration(host: Base.IHost)[source]

Inheritance

Inheritance diagram of Configuration

Members

_vendor = 'TonyBybell'

The name of the tools vendor.

_toolName = 'GTKWave'

The name of the tool.

_section = 'INSTALL.GTKWave'

The name of the configuration section. Pattern: INSTALL.Vendor.ToolName.

_multiVersionSupport = True

GTKWave supports multiple versions installed on the same system.

_template = {'Windows': {'INSTALL.GTKWave': {'Version': '3.3.78', 'SectionName': ('%{PathWithRoot}#${Version}', None), 'InstallationDirectory': ('${${SectionName}:InstallationDirectory}', 'C:/Program Files (x86)/GTKWave'), 'BinaryDirectory': ('${${SectionName}:BinaryDirectory}', '${InstallationDirectory}/bin')}}, 'Linux': {'INSTALL.GTKWave': {'Version': '3.3.78', 'SectionName': ('%{PathWithRoot}#${Version}', None), 'InstallationDirectory': ('${${SectionName}:InstallationDirectory}', '/usr/bin'), 'BinaryDirectory': ('${${SectionName}:BinaryDirectory}', '${InstallationDirectory}')}}, 'Darwin': {'INSTALL.GTKWave': {'Version': '3.3.78', 'SectionName': ('%{PathWithRoot}#${Version}', None), 'InstallationDirectory': ('${${SectionName}:InstallationDirectory}', '/usr/bin'), 'BinaryDirectory': ('${${SectionName}:BinaryDirectory}', '${InstallationDirectory}')}}}

The template for the configuration sections represented as nested dictionaries.

CheckDependency()[source]
ConfigureForAll()[source]
_GetDefaultInstallationDirectory()[source]
ClearSection(writeWarnings=False)[source]

Clear the configuration section associated to this Configuration class.

ConfigureForDarwin()[source]

Start the configuration procedure for Darwin.

This method is a wrapper for ConfigureForAll(). Overwrite this method to implement a Darwin specific configuration routine.

ConfigureForLinux()[source]

Start the configuration procedure for Linux.

This method is a wrapper for ConfigureForAll(). Overwrite this method to implement a Linux specific configuration routine.

ConfigureForWindows()[source]

Start the configuration procedure for Windows.

This method is a wrapper for ConfigureForAll(). Overwrite this method to implement a Windows specific configuration routine.

GetSections(platform)[source]

Return all section names for this configuration.

Host

Return the hosting object.

IsConfigured()[source]

Return true if the configurations section is configured

IsSupportedPlatform()[source]

Return true if the given platform is supported by this configuration routine.

Log(entry, condition=True)

Write an entry to the local logger.

LogDebug(*args, condition=True, **kwargs)
LogDryRun(*args, condition=True, **kwargs)
LogError(*args, condition=True, **kwargs)
LogFatal(*args, condition=True, **kwargs)
LogInfo(*args, condition=True, **kwargs)
LogNormal(*args, condition=True, **kwargs)
LogQuiet(*args, condition=True, **kwargs)
LogVerbose(*args, condition=True, **kwargs)
LogWarning(*args, condition=True, **kwargs)
Logger

Return the local logger instance.

PrepareOptions(writeWarnings=True)[source]
PrepareSections(warningWasWritten, writeWarnings=True)[source]
PrepareVersionedSections(writeWarnings=False)
RunPostConfigurationTasks()[source]

Virtual method. Overwrite to execute post-configuration tasks.

SectionName

Return the configuration’s section name.

State

Return the configuration state.

_Ask(question, default, beforeDefault='', afterDefault='', indent=1)
_AskInstalled(question)[source]

Ask a Yes/No/Pass question.

_AskYes_NoPass(question, indent=1)

Ask a yes/NO/pass question.

_Ask_YesNoPass(question, indent=1)

Ask a YES/no/pass question.

_Configuration__WriteGtkWaveSection(binPath)
_ConfigureBinaryDirectory()

Updates section with value from _template and returns directory as Path object.

_ConfigureEdition(editions, defaultEdition)
_ConfigureInstallationDirectory()[source]

Asks for installation directory and updates section. Checks if entered directory exists and returns Path object. If no installation directory was configured before, then _GetDefaultInstallationDir is called.

_ConfigureVersion()

If no version was configured before, then _GetDefaultVersion is called. Asks for version and updates section. Returns version as string.

_GetDefaultEdition()

Returns unresolved default edition (str) from template.

Overwrite this method in a sub-class for automatic search of editions.

_GetDefaultOptionValue(optionName)[source]
_GetDefaultVersion()

Returns unresolved default version (str) from template.

Overwrite this method in a sub-class for automatic search of version.

_PrintAvailableEditions(editions, selectedEdition)

Print all available editions and return the selected index.

_TestDefaultInstallPath(defaults)[source]

Helper function for automatic search of installation directory.

_TryLog(*args, condition=True, **kwargs)
class ToolChain.GTKWave.GTKWave(platform, dryrun, binaryDirectoryPath, version, logger=None)[source]

Inheritance

Inheritance diagram of GTKWave

Members

BinaryDirectoryPath
Version
class Executable[source]
class GTKWave.SwitchDumpFile[source]
_name = 'dump'
class GTKWave.SwitchSaveFile[source]
_name = 'save'
GTKWave.Parameters = [<class 'ToolChain.GTKWave.GTKWave.Executable'>, <class 'ToolChain.GTKWave.GTKWave.SwitchDumpFile'>, <class 'ToolChain.GTKWave.GTKWave.SwitchSaveFile'>]
GTKWave.GetReader()
GTKWave.HasErrors

True if errors or fatals errors were found while processing the output stream.

GTKWave.HasWarnings

True if errors or fatals errors were found while processing the output stream.

GTKWave.Log(entry, condition=True)

Write an entry to the local logger.

GTKWave.LogDebug(*args, condition=True, **kwargs)
GTKWave.LogDryRun(*args, condition=True, **kwargs)
GTKWave.LogError(*args, condition=True, **kwargs)
GTKWave.LogFatal(*args, condition=True, **kwargs)
GTKWave.LogInfo(*args, condition=True, **kwargs)
GTKWave.LogNormal(*args, condition=True, **kwargs)
GTKWave.LogQuiet(*args, condition=True, **kwargs)
GTKWave.LogVerbose(*args, condition=True, **kwargs)
GTKWave.LogWarning(*args, condition=True, **kwargs)
GTKWave.Logger

Return the local logger instance.

GTKWave.Path
GTKWave.ReadUntilBoundary(indent=0)
GTKWave.Send(line, end='\n')
GTKWave.SendBoundary()
GTKWave.StartProcess(parameterList)
GTKWave.Terminate()
GTKWave.View()[source]
GTKWave._POC_BOUNDARY = '====== POC BOUNDARY ======'
GTKWave._TryLog(*args, condition=True, **kwargs)

Functions

ToolChain.GTKWave.GTKWaveFilter(gen)[source]