Skip to content

Clarify LSP scope and Python-specific nature in README#11

Merged
samuelduchesne merged 1 commit into
mainfrom
claude/wizardly-hopper-7eJiD
May 27, 2026
Merged

Clarify LSP scope and Python-specific nature in README#11
samuelduchesne merged 1 commit into
mainfrom
claude/wizardly-hopper-7eJiD

Conversation

@samuelduchesne
Copy link
Copy Markdown
Contributor

Summary

Updated the README to clarify that idfkit-lsp is a language server for Python code that imports idfkit, not an IDF/epJSON language server. Added a note explaining its scope, registration behavior, and potential conflicts with other Python LSPs.

Changes

  • Refined the LSP feature description to explicitly state it provides "Python LSP for idfkit-based code (idfkit-lsp)"
  • Added a detailed note explaining:
    • idfkit-lsp targets Python code that imports idfkit, not IDF/epJSON files
    • It registers for .py files and attaches to all Python files in the project
    • It may coexist or compete with other Python LSPs (Pylance, pyright, ruff-lsp)
    • Recommendation to use editor scoping features to narrow activation to idfkit projects

Details

This clarification helps users understand the actual scope and limitations of the LSP implementation, preventing confusion about its capabilities and managing expectations around LSP conflicts in multi-LSP environments.

https://claude.ai/code/session_01BYBeYVxYHEv2rAC4TK9F8S

The README described the LSP as "EnergyPlus language support," but
idfkit-lsp registers only .py -> python and serves Python code that
imports idfkit, not the IDF/epJSON language. Reword the entry and add a
caveat that the server attaches to every .py file and may compete with
the user's primary Python LSP.

Closes #4

https://claude.ai/code/session_01BYBeYVxYHEv2rAC4TK9F8S
@samuelduchesne samuelduchesne merged commit c975893 into main May 27, 2026
4 checks passed
@samuelduchesne samuelduchesne deleted the claude/wizardly-hopper-7eJiD branch May 27, 2026 12:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants