spliced.predict package

Subpackages

• spliced.predict.smeagle package
  • Submodules
  • spliced.predict.smeagle.asp module
  • spliced.predict.smeagle.smeagle module
  • spliced.predict.smeagle.solver module
  • Module contents

Submodules

spliced.predict.abi_laboratory module

class spliced.predict.abi_laboratory.AbiLaboratoryPrediction

Bases: Prediction

container = 'docker://ghcr.io/buildsi/abi-laboratory-docker'

predict(splice, predict_type=None)

Run the ABI laboratory to add to the predictions

run_abi_laboratory(original_lib, replace_lib, name)

Run abi-dumper + abi-compliance-checker with original and comparison library. This assumes we are in the container, and falls back to running a container.

run_containerized_abi_laboratory(original_lib, replace_lib, name)

Run containerized abi laboratory with singularity

run_diff(splice)

Run pairwise diffs for libs we need.

run_local_abi_laboratory(original_lib, replace_lib, name)

Run containerized abi laboratory with singularity

set_cache()

Set the cache directory.

splice_different_libs(splice)

In the case of splicing “the same lib” into itself (a different version) we can do matching based on names.

splice_equivalent_libs(splice)

In the case of splicing “the same lib” into itself (a different version) we can do matching based on names. We can use abicomat with binaries, and abidiff for just between the libs.

spliced.predict.base module

class spliced.predict.base.Prediction

Bases: object

A prediction is a base for assessing a Splice and making predictions.

create_elfcall_deps_lookup(splice, libs)

This is subbing in a library with a version of itself, and requires binaries

find_elfcall_deps_for(splice, lib)

Given a library (that is assumed to be in metadata, from elfcall) find libraries that the linker is assumed to hit and find symbols.

predict(splice, predict_type=None)

spliced.predict.base.get_prefix(lib)

spliced.predict.base.match_by_prefix(meta, spliced_meta)

Given an iterable of two things, match based on library prefix. E.g., basename -> split at . -> match first piece

spliced.predict.base.time_run_decorator(func)

Decorator to add run seconds to result

spliced.predict.base.timed_run(*args, **kwargs)

spliced.predict.libabigail module

class spliced.predict.libabigail.LibabigailPrediction

Bases: Prediction

abicompat = None

abidiff = None

diff_prediction(splice)

Only do pairwise diffs between libs

find_tool(name)

Find a specific named tool (abidiff or abicompat)

find_tooling()

Find abicompat and abidiff and add to class

full_prediction(splice)

A full prediction is run with spliced splice, includes libs and binaries.

predict(splice, predict_type=None)

Run libabigail to add to the predictions

run_abicompat(binary, original, lib)

Run abicompat against two libraries

run_abidiff(original_lib, replace_lib)

Run abi diff with an original and comparison library

debuginfo files:

By default, libabigail will look in /usr/lib/debug for separate debug files (.debug) generated by gcc. Alternate locations can be specified by using the environment variables LIBABIGAIL_DEBUGINFO_DIR{1,2} for the original and comparison libraries, respectively.

splice_different_libs(splice)

In the case of splicing “the same lib” into itself (a different version) we can do matching based on names.

splice_equivalent_libs(splice)

In the case of splicing “the same lib” into itself (a different version) we can do matching based on names. We can use abicomat with binaries, and abidiff for just between the libs.

spliced.predict.libabigail.add_to_path(path)

spliced.predict.spack module

class spliced.predict.spack.SpackTest

Bases: Prediction

If we find this is a spack package (e.g, installed in a spack root) run spack test for the splice.

predict(splice, predict_type=None)

The spack predictor runs spack test for the original and splice.

spack_test(identifier)

Run spack tests for original and spliced

spliced.predict.symbols module

class spliced.predict.symbols.SymbolsPrediction

Bases: Prediction

diff_libs(splice)

Only do A vs B comparisons between two libs.

predict(splice, predict_type=None)

Run symbolator to add to the predictions

splice_different_libs(splice)

This is subbing in a library with a version of itself, and requires binaries

splice_equivalent_libs(splice)

This is subbing in a library with a version of itself, and requires binaries

spliced.predict.symbols.compress_symbol_set(symbols)

Write symbol:prefix into set to compare to.

Module contents

spliced.predict.get_predictors(names=None)

Get a lookup of predictors for an experiment to run.