Skip to main content

robotframework-lint-lsp

Extra Robocop rules for Robot Framework 7.5. When Robocop and the Robot Framework docs disagree, these rules follow Robot Framework.

Install

python -m venv .venv
.venv/Scripts/python -m pip install -e ".[dev]"   # Windows
.venv/bin/python -m pip install -e ".[dev]"       # Linux, macOS

Pinned: robotframework 7.5.1, robotframework-robocop 9.4.0, pytest 9.2.0.

Run

robocop check --custom-rules robotframework_lint path/to/tests

The installed package registers the robotframework_lint Robocop plugin, so the rules load by plugin name, no path needed. Run only these rules with --select RFL001 --select RFL002.

Rules

ID Name Source
RFL001 for-in-zip-without-mode RF 7.0 release notes
RFL002 deprecated-standard-library (Telnet) RF 7.5 release notes
RFL003 deprecated-tag-pattern (XORY, &) RF 7.5 release notes
RFL004 deprecated-translation (French Unités de test, Finnish Tagit) RF 7.5 release notes
RFL005 doc-tags-without-empty-row (Tags: in keyword docs) RF 7.5 release notes
RFL006 deprecated-argument-name (list_=, time_=) RF 7.5 release notes

RFL003 asks Robot Framework's own TagPatterns whether a pattern is deprecated, so it reports exactly what RF 7.5.1 warns about. That includes all-caps tags holding an operator word, such as -DONOTX or -ORANGE: RF reads them as DO NOT X and OR ANGE. Write such tags in lower case.

RFL004 reads the deprecated terms from Robot Framework's own language definitions. It reports a term only when RF parsed it as a header or setting, that is, when the file's language is French or Finnish (language: fr or language: fi in the file, or --language).

LSP server (Claude Code and other agents)

robotframework-lint-lsp is a stdio language server. It lints the open buffer in process with the robocop defaults plus these rules, on open, save and change (debounced 0.4 s). Output is kept small for AI agents:

  • one line per finding: RULEID message, at most 120 characters

  • at most 20 findings per file (maxDiagnostics), then one overflow line that says how many more were cut

  • at most 50 symbols or references per answer

  • warnings and errors only by default (minSeverity: info, warning, error)

  • identical findings on one line reported once; no related information

  • a finding robocop can fix ends with fix all: <command>; fixable Info rules are raised to warning

Settings go in initializationOptions: maxDiagnostics, minSeverity, select, ignore, groupFindings (default off). For Claude Code, copy .lsp.json from this repo into your plugin; it maps .robot and .resource to robotframework.

The plugin also ships a PostToolUse hook, robotframework-lint-autofix (hooks/hooks.json): after each Edit or Write of a .robot or .resource file it applies robocop's safe fixes, so the agent only sees what is left.

Setup for Claude Code, opencode, Crush, Codex and GLM: docs/agents.md. Measured results (cost, turns and issues left, with and without the LSP, per model): docs/benchmarks.html and docs/benchmarks.

The server also answers code navigation for user keywords:

  • document symbols: tests, keywords and variables in a file
  • definition and references: matched the way Robot matches names, so say_hello finds Say Hello
  • workspace symbols: find a keyword by name, exact matches first, then prefix, then substring
  • hover: the keyword signature and the first doc line, at most 200 characters

On start it indexes every .robot and .resource file under the workspace root, up to 2000 files. It skips .git, .venv, node_modules and results. Open files are indexed again on every change. Library keywords such as Log and keywords with embedded arguments aren't indexed.

Tests

python -m pytest

License

MIT

Metadata

Release files for robotframework-lint-lsp 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for robotframework-lint-lsp 1.0.0
File Size Uploaded Provenance Actions
robotframework_lint_lsp-1.0.0.tar.gz 26.7 kB With provenance Details for robotframework_lint_lsp-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for robotframework-lint-lsp 1.0.0
File Interpreter ABI Platform Actions
robotframework_lint_lsp-1.0.0-py3-none-any.whl Python 3 none any Details for robotframework_lint_lsp-1.0.0-py3-none-any.whl

Total release size: 49.1 kB

Release files / robotframework_lint_lsp-1.0.0.tar.gz

Download URL robotframework_lint_lsp-1.0.0.tar.gz
Size 26.7 kB
Tags Source
SHA-256 checksum
How to use checksums
2f490fd78cd963baa14153cfba198aa43d66ddc7739e6f28fdefb69f943d121b
BLAKE2b-256 checksum
How to use checksums
9bc2e7504fa8ef70f7de08d16b17feed380437d03737e0b54af74f3aac8d04d7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

Release files / robotframework_lint_lsp-1.0.0-py3-none-any.whl

Download URL robotframework_lint_lsp-1.0.0-py3-none-any.whl
Size 22.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7d965b01ed2828134b1155672e0ebacbe264e0ee2e476114c853870a491ff7ba
BLAKE2b-256 checksum
How to use checksums
f84d1569c361818efcf9ebd20e9349631cd4c08d10a4d78f5d894ca2c8920240
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

Security for robotframework-lint-lsp 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for robotframework_lint_lsp-1.0.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page