swh.provenance.backend.graph module

class swh.provenance.backend.graph.GraphProvenance(url, max_edges=10000)

Bases: object

Provenance instance using a swh-graph GRPC backend

Parameters:

• url – the location of the GRPC server; should be of the form: “<host>:<port>”

• max_edges – maximum number of edges that can be fetched by a traversal query; for more details, see: https://docs.softwareheritage.org/devel/swh-graph/grpc-api.html#limiting-the-traversal

check_config() → bool

whereis(*, swhid: CoreSWHID) → QualifiedSWHID | None

Given a SWHID return a QualifiedSWHID with some provenance info:

• the release or revision containing that content or directory

• the url of the origin containing that content or directory

This can also be called for revision, release or snapshot to retrieve origin url information if any. When using a revision, the anchor will be an association release if any.

whereare(*, swhids: List[CoreSWHID]) → List[QualifiedSWHID | None]

Given a SWHID list return a list of provenance info:

See whereis documentation for details on the provenance info.