IndexStoreDB is a source code indexing library. It provides a composable and efficient query API for looking up source code symbols, symbol occurrences, and relations. IndexStoreDB uses the libIndexStore library, which lives in llvm-project, for reading raw index data. Raw index data can be produced by compilers such as Clang and Swift using the -index-store-path
option. IndexStoreDB enables efficiently querying this data by maintaining acceleration tables in a key-value database built with LMDB.
IndexStoreDB's data model is derived from libIndexStore. For more information about libIndexStore, and producing raw indexing data, see the Indexing While Building whitepaper.
IndexStoreDB is built using the Swift Package Manager.
For a standard debug build and test:
$ swift build
$ swift test
The C++ code in the index requires libdispatch
, but unlike Swift code, it cannot find it automatically on Linux. You can work around this by adding a search path manually.
$ swift build -Xcxx -I<path_to_swift_toolchain>/usr/lib/swift -Xcxx -I<path_to_swift_toolchain>/usr/lib/swift/Block
Pecker: a tool to detect unused code based on SwiftSyntax and IndexStoreDB.
For more information about developing IndexStoreDB, see Development.