Class SigDatabase

Readonlycontent

Readonlyindex

Readonlystrings

StaticfromMemory

• fromMemory(db: SigDb): SigDatabase

  Use an already-built SigDb directly, without writing or reading a file: its blobs simply start out in the cache. It holds exactly what a bundle carries, so every query answers as it would from disk; the SigDbBuilder plus this is all a test needs.

  Parameters

  • db: SigDb

  Returns SigDatabase

Staticopen

• open(source: string, opts?: SigDbOpenOptions): Promise<SigDatabase>

  open a .sigs.ndjson, .br or .gz; compressed sources are decompressed into a hash-keyed cache once

  Parameters

  • source: string
  • opts: SigDbOpenOptions = {}

  Returns Promise<SigDatabase>

StaticopenSync

• openSync(plainFile: string, opts?: OpenSyncOptions): SigDatabase

  Open a plain, seekable .sigs.ndjson synchronously. Pass index to skip reading the .idx, and strings to use an already-loaded shared dictionary instead of the file's own d section (for a blob-only shard). One ranged read loads the dictionary, no readline overhead.

  Parameters

  • plainFile: string
  • opts: OpenSyncOptions = {}

  Returns SigDatabase

StaticopenSyncFrom

• openSyncFrom(source: string, opts: OpenSyncFromOptions): SigDatabase

  Like open but fully synchronous (blocking decompression); a hash keys the cache when source is compressed. Pass strings for a blob-only shard that shares an already-loaded dictionary.

  Parameters

  • source: string
  • opts: OpenSyncFromOptions

  Returns SigDatabase

allBlobs

• allBlobs(): PkgBlob[]

  read every unique package blob in index order (used to re-hash a whole shard during verification)

  Returns PkgBlob[]

blob

• blob(pkg: string): PkgBlob | undefined

  load a single package's blob by seeking to its line (undefined if absent); cached by blob index

  Parameters

  • pkg: string

  Returns PkgBlob | undefined

classOwner

• classOwner(className: string, version?: string): string | undefined

  The package that OWNS the class className: an S3 class (a same-named constructor plus a registered method, see LibraryExports.s3Classes) or an S4 class (exported via exportClasses, see LibraryExports.s4Classes); S3 ownership wins a tie. undefined if none does. Without version, backed by a reverse index over every package's latest version, built once and cached.

  Parameters

  • className: string
  • Optionalversion: string

  Returns string | undefined

close

• close(): void

  close the underlying file descriptor (idempotent; safe to call more than once)

  Returns void

contentHash

• contentHash(blobs?: PkgBlob[]): string

  recompute this bundle's self-contained content hash from its re-read data (matches writeSignatureDb)

  Parameters

  • blobs: PkgBlob[] = ...

  Returns string

coreVersions

• coreVersions(pkg: string): RVersion[] | undefined

  The R versions a base package was part of core, in ascending R-version order (exactly its stored versions). undefined for a non-base package. E.g. mva returns …1.9.1, parallel 2.14.0….

  Parameters

  • pkg: string

  Returns RVersion[] | undefined

dependencies

• dependencies(pkg: string, version?: string): ResolvedDependency[] | undefined

  declared dependencies (Depends/Imports/…) of a package version, with version qualifiers

  Parameters

  • pkg: string
  • Optionalversion: string

  Returns ResolvedDependency[] | undefined

downloads

• downloads(pkg: string): number

  the download count recorded for the package, 0 when this source does not carry it

  Parameters

  • pkg: string

  Returns number

functionByName

• functionByName(
      pkg: string,
      name: string,
      version?: string,
  ): DecodedFunction | undefined

  the rich view of a single function by name, decoding only it (unlike functions, which decodes the whole package)

  Parameters

  • pkg: string
  • name: string
  • Optionalversion: string

  Returns DecodedFunction | undefined

functions

• functions(pkg: string, version?: string): DecodedFunction[] | undefined

  rich per-function view (signatures + call graphs) of a package version

  Parameters

  • pkg: string
  • Optionalversion: string

  Returns DecodedFunction[] | undefined

has

• has(pkg: string): boolean

  whether the source can resolve the package at all

  Parameters

  • pkg: string

  Returns boolean

hasVersion

• hasVersion(pkg: string, version: string): boolean

  whether this bundle actually carries the given version of a package (not just the package)

  Parameters

  • pkg: string
  • version: string

  Returns boolean

isBaseR

• isBaseR(pkg: string): boolean

  whether this is an R-core / base package (its versions are the R releases it shipped with; see SigDbPkgMeta)

  Parameters

  • pkg: string

  Returns boolean

isCranVersion

• isCranVersion(pkg: string, version: string): boolean

  whether a version is a current CRAN release (not in the package's noncran/removed set)

  Parameters

  • pkg: string
  • version: string

  Returns boolean

latestVersion

• latestVersion(pkg: string): RVersion | undefined

  the newest version of a package by release date (falling back to the recorded latest, then SemVer order)

  Parameters

  • pkg: string

  Returns RVersion | undefined

lookup

• lookup(pkg: string, version?: string): LibraryExports | undefined

  the export view of a package version (defaults to its latest)

  Parameters

  • pkg: string
  • Optionalversion: string

  Returns LibraryExports | undefined

packageNames

• packageNames(): string[]

  every package name this source can resolve

  Returns string[]

releaseDate

• releaseDate(pkg: string, version?: string): Date | undefined

  the release date of a package version (defaulting to the newest release), or undefined if unknown

  Parameters

  • pkg: string
  • Optionalversion: string

  Returns Date | undefined

releaseDates

• releaseDates(pkg: string): VersionRelease[]

  every known release date of a package, in ascending R-version order (empty when no dates were stored)

  Parameters

  • pkg: string

  Returns VersionRelease[]

transitiveCallees

• transitiveCallees(
      pkg: string,
      name: string,
      version?: string,
  ): string[] | undefined

  the transitive callees of a function within one package version, expanding the stored local call graphs

  Parameters

  • pkg: string
  • name: string
  • Optionalversion: string

  Returns string[] | undefined