Class SigDatabaseSet

ReadonlybaseDir

Readonlymanifest

StaticopenManifest

• openManifest(
      manifestFile: string,
      opts?: SigDbSetOpenOptions,
  ): Promise<SigDatabaseSet>

  Parameters

  • manifestFile: string
  • opts: SigDbSetOpenOptions = {}

  Returns Promise<SigDatabaseSet>

StaticopenManifestSync

• openManifestSync(
      manifestFile: string,
      opts?: SigDbSetOpenOptions,
  ): SigDatabaseSet

  Synchronous openManifest -- needs every shard to embed its index (the default for the bundles flowR ships). Shards and dictionaries still decompress lazily.

  Parameters

  • manifestFile: string
  • opts: SigDbSetOpenOptions = {}

  Returns SigDatabaseSet

allShards

• allShards(): MountedShard[]

  open (blocking) and return every shard database with its manifest ref -- used for whole-set verification

  Returns MountedShard[]

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 every opened shard's file descriptor and drop the in-memory caches (opened shards + shared dictionaries), so the (potentially large) dictionary strings can be reclaimed by the GC. Idempotent.

  Returns void

coreVersions

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

  the R versions a base package was part of core (ascending); undefined if not a base package

  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

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 any active shard 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 (see SigDatabase.isBaseR); O(1) via the hoisted metadata

  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[]

preload

• preload(pkgs?: readonly string[]): Promise<void>

  Warm the shards (and their shared dictionaries) needed for pkgs, or everything when omitted. Afterward, the synchronous query methods, for the latest and historical versions, do no I/O or decompression.

  Parameters

  • Optionalpkgs: readonly string[]

  Returns Promise<void>

preloadShards

• preloadShards(include: (shard: SigDbShardRef) => boolean): Promise<void>

  Warm just the shards matching include, e.g., only the current-tier top shards (the base + most-downloaded packages) to speed up common lookups without paying for the long tail or the history shards. See preload.

  Parameters

  • include: (shard: SigDbShardRef) => boolean

  Returns Promise<void>

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 of a package (version + date), ascending -- read once from the most complete shard

  Parameters

  • pkg: string

  Returns VersionRelease[]

shardStatus

• shardStatus(): ShardStatus[]

  the on-demand load state (opened + unpacked) of every shard in this set

  Returns ShardStatus[]

sharedDictionary

• sharedDictionary(id: string): string[]

  load (and cache) a shared dictionary's strings by id -- for verification/inspection

  Parameters

  • id: string

  Returns string[]

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