deps-core

Core abstractions for deps-lsp: traits, caching, and generic LSP handlers.

This crate provides the shared infrastructure used by all ecosystem-specific crates in the deps-lsp workspace. Every ecosystem crate depends on deps-core and implements its Ecosystem trait.

What this crate provides

• Ecosystem trait — Unified interface for all package ecosystems (parse, registry, format)
• EcosystemId enum — Exhaustive, typed identifier for every registered ecosystem, with Display/FromStr interop with Ecosystem::id(). Downstream code should match on this instead of the raw id string so a new ecosystem forces every relevant match to be updated at compile time
• Registry trait — Abstraction over package registries with version lookup
• LockFileProvider trait — Abstract lock file parsing for resolved versions
• Generic LSP handlers — generate_inlay_hints, generate_hover, generate_code_actions, generate_diagnostics, taking a bundled VersionData (cached + resolved version maps) to avoid swapping same-typed arguments at call sites
• HttpCache — ETag/Last-Modified caching for registry HTTP requests, with a streaming 32 MiB response-size cap
• check_toml_nesting_depth — single-pass structural guard rejecting pathologically nested TOML (bracket depth and dotted-key/header segment count) before it reaches the recursive-descent toml_span parser
• lockfile::read_lockfile_content — shared read-and-error-wrap helper for lock file parsers
• Error types — Unified error handling with thiserror

Installation

[dependencies]
deps-core = "0.10"

[!IMPORTANT] Requires Rust 1.91 or later.

Implementing a new ecosystem

use deps_core::{Ecosystem, Registry, ParseResult};

pub struct MyEcosystem {
    registry: Arc<MyRegistry>,
}

impl Ecosystem for MyEcosystem {
    fn id(&self) -> &'static str { "my-ecosystem" }
    fn display_name(&self) -> &'static str { "My Ecosystem" }

    fn matches_uri(&self, uri: &Uri) -> bool {
        uri.path().ends_with("my-manifest.json")
    }

    async fn parse_manifest(&self, content: &str, uri: &Uri) -> Result<ParseResult> {
        // Parse the manifest and return dependencies with source positions
        todo!()
    }
}

License

MIT