Djls Workspace Conventions

Use when adding or editing crates, Cargo.toml files, workspace dependencies, crate manifests, lints, versions, or project structure in django-language-server. Handles Rust workspace layout, dependency grouping, and new crate setup.

joshuadavidthomas Updated 63 repo stars
Completions

File contents

DJLS Workspace Conventions

Use this before changing Cargo.toml, adding crates, or reorganizing workspace structure.

Rules

  • Crates live in crates/ and are auto-discovered by members = ["crates/*"].
  • Put all dependency versions in root [workspace.dependencies]; crates use dep.workspace = true.
  • Root dependency groups, in order:
    1. internal path crates
    2. pinned core deps: salsa, tower-lsp-server
    3. crates.io deps
    4. git deps: ruff_*
  • Alphabetize within each root dependency group.
  • In crate manifests, list internal deps before third-party deps, separated by a blank line.
  • Every crate uses [lints] workspace = true.
  • Only djls carries the release version. Library crates use version = "0.0.0".

Adding a crate

  1. Add the crate under crates/<name>/.
  2. Add it to root [workspace.dependencies] as an internal path dependency.
  3. In crates/<name>/Cargo.toml, use workspace dependencies and [lints] workspace = true.
  4. Keep module files as folder.rs, not folder/mod.rs.

joshuadavidthomas/django-language-server commit 6a4f5aa82f

Frequently asked questions

npx get-skill add joshuadavidthomas/djls-workspace-conventions