polytracker.build

build classes

Build

class polytracker.build.Build(argument_parser: ArgumentParser)

Bases: Command

__init__(argument_parser: ArgumentParser)

extension_types: List[Type[CommandExtension]] | None = None

An auto-populated list of eny extensions to this command.

property full_name: str

help: str = 'runs a build command with blight instrumentation'

Help string for this command.

name: str = 'build'

The name of this plugin.

parent: 'Plugin' | None

The parent of this plugin, if it is a sub-plugin.

parent_parsers: Tuple[ArgumentParser, ...] = ()

An optional sequence of parent argument parsers from which to parse options.

run(args: Namespace)

Callback for when the command is run.

Parameters:

args – The result of parsing the commandline arguments set up by Command.__init_arguments__().

subcommand_types: List[Type[Subcommand]] | None = None

An auto-populated list of subcommands of this command.

subparser: Any | None = None

A subparser, auto-populated if subcommand_types is not None.

ExtractBitcode

class polytracker.build.ExtractBitcode(argument_parser: ArgumentParser)

Bases: Command

__init__(argument_parser: ArgumentParser)

extension_types: List[Type[CommandExtension]] | None = None

An auto-populated list of eny extensions to this command.

property full_name: str

help: str = 'extracts LLVM bitcode from a binary (executable, library, object file, ...)'

Help string for this command.

name: str = 'extract-bc'

The name of this plugin.

parent: 'Plugin' | None

The parent of this plugin, if it is a sub-plugin.

parent_parsers: Tuple[ArgumentParser, ...] = ()

An optional sequence of parent argument parsers from which to parse options.

run(args: Namespace)

Callback for when the command is run.

Parameters:

args – The result of parsing the commandline arguments set up by Command.__init_arguments__().

subcommand_types: List[Type[Subcommand]] | None = None

An auto-populated list of subcommands of this command.

subparser: Any | None = None

A subparser, auto-populated if subcommand_types is not None.

InstrumentBitcode

class polytracker.build.InstrumentBitcode(argument_parser: ArgumentParser)

Bases: Command

__init__(argument_parser: ArgumentParser)

extension_types: List[Type[CommandExtension]] | None = None

An auto-populated list of eny extensions to this command.

property full_name: str

help: str = 'instruments LLVM bitcode with polytracker passes'

Help string for this command.

name: str = 'instrument-bc'

The name of this plugin.

parent: 'Plugin' | None

The parent of this plugin, if it is a sub-plugin.

parent_parsers: Tuple[ArgumentParser, ...] = ()

An optional sequence of parent argument parsers from which to parse options.

run(args: Namespace)

Callback for when the command is run.

Parameters:

args – The result of parsing the commandline arguments set up by Command.__init_arguments__().

subcommand_types: List[Type[Subcommand]] | None = None

An auto-populated list of subcommands of this command.

subparser: Any | None = None

A subparser, auto-populated if subcommand_types is not None.

InstrumentTargets

class polytracker.build.InstrumentTargets(argument_parser: ArgumentParser)

Bases: Command

__init__(argument_parser: ArgumentParser)

extension_types: List[Type[CommandExtension]] | None = None

An auto-populated list of eny extensions to this command.

property full_name: str

help: str = 'instruments blight journal build targets with polytracker'

Help string for this command.

name: str = 'instrument-targets'

The name of this plugin.

parent: 'Plugin' | None

The parent of this plugin, if it is a sub-plugin.

parent_parsers: Tuple[ArgumentParser, ...] = ()

An optional sequence of parent argument parsers from which to parse options.

run(args: Namespace)

Callback for when the command is run.

Parameters:

args – The result of parsing the commandline arguments set up by Command.__init_arguments__().

subcommand_types: List[Type[Subcommand]] | None = None

An auto-populated list of subcommands of this command.

subparser: Any | None = None

A subparser, auto-populated if subcommand_types is not None.

LowerBitcode

class polytracker.build.LowerBitcode(argument_parser: ArgumentParser)

Bases: Command

__init__(argument_parser: ArgumentParser)

extension_types: List[Type[CommandExtension]] | None = None

An auto-populated list of eny extensions to this command.

property full_name: str

help: str = 'lowers an LLVM bitcode file to an executable according to a blight journal file'

Help string for this command.

name: str = 'lower-bc'

The name of this plugin.

parent: 'Plugin' | None

The parent of this plugin, if it is a sub-plugin.

parent_parsers: Tuple[ArgumentParser, ...] = ()

An optional sequence of parent argument parsers from which to parse options.

run(args: Namespace)

Callback for when the command is run.

Parameters:

args – The result of parsing the commandline arguments set up by Command.__init_arguments__().

subcommand_types: List[Type[Subcommand]] | None = None

An auto-populated list of subcommands of this command.

subparser: Any | None = None

A subparser, auto-populated if subcommand_types is not None.

OptimizeBitcode

class polytracker.build.OptimizeBitcode(argument_parser: ArgumentParser)

Bases: Command

__init__(argument_parser: ArgumentParser)

extension_types: List[Type[CommandExtension]] | None = None

An auto-populated list of eny extensions to this command.

property full_name: str

help: str = 'optimizes LLVM bitcode with O3'

Help string for this command.

name: str = 'opt-bc'

The name of this plugin.

parent: 'Plugin' | None

The parent of this plugin, if it is a sub-plugin.

parent_parsers: Tuple[ArgumentParser, ...] = ()

An optional sequence of parent argument parsers from which to parse options.

run(args: Namespace)

Callback for when the command is run.

Parameters:

args – The result of parsing the commandline arguments set up by Command.__init_arguments__().

subcommand_types: List[Type[Subcommand]] | None = None

An auto-populated list of subcommands of this command.

subparser: Any | None = None

A subparser, auto-populated if subcommand_types is not None.