Expand description
High-level client bindings for the Corsa stdio API.
This crate wraps the raw transports and endpoint naming used by Corsa behind typed request/response helpers. In practice it is the main entry point when you want to:
- spawn a Corsa worker process
- initialize it once and reuse the session
- create and reuse snapshots
- ask type, symbol, and syntax questions through strongly typed helpers
- attach filesystem callbacks for overlay-like workflows
§Main Building Blocks
ApiClientmanages a single worker process or pipe connection.ApiSpawnConfigdescribes how that worker should be started.ManagedSnapshotkeeps snapshot handles alive and releases them on drop.ApiProfilegives orchestrators a stable name for a spawn configuration.
§Performance Model
corsa does not try to out-compile Corsa itself. The win comes from
session reuse, snapshot reuse, and cheaper transports such as sync msgpack.
For docs and benchmarks around that trade-off, see the workspace guides.
Re-exports§
pub use api::*;
Modules§
- api
- Typed bindings for the Corsa stdio API surface. Typed request/response layer for the Corsa stdio API.
- error
- Re-exports shared error types used by the client APIs.
- jsonrpc
- Re-exports low-level JSON-RPC helpers used by the stdio client transport.
- lsp_
types - Re-exports shared LSP model types used by editor-style API responses.
- observability
- Re-exports structured operational events used by the client configs.
- process
- Re-exports process-spawning primitives used to launch Corsa.
Enums§
- Corsa
Error - Workspace-wide error type for process, transport, and protocol failures.
- Corsa
Event - Structured runtime events that embedders can observe.
Traits§
- Corsa
Observer - Sink for structured operational events emitted by the workspace.
Type Aliases§
- Result
- Standard result alias used across the workspace.
- Shared
Observer - Shared observer handle used across configs and transports.