robotframework-robocop 9.1.0__tar.gz → 9.2.0__tar.gz

robotframework_robocop-9.2.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "9.2.0"
+}

{robotframework_robocop-9.1.0 → robotframework_robocop-9.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: robotframework-robocop
-Version: 9.1.0
+Version: 9.2.0
 Summary: Static code analysis tool (linter) and code formatter for Robot Framework
 Project-URL: Bug tracker, https://github.com/MarketSquare/robotframework-robocop/issues
 Project-URL: Source code, https://github.com/MarketSquare/robotframework-robocop

robotframework_robocop-9.2.0/docs/images/robocop_logo.svg

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN" "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd">
+<svg version="1.0" xmlns="http://www.w3.org/2000/svg" width="400px" height="400px" viewBox="0 0 400 400" preserveAspectRatio="xMidYMid meet">
+ <g fill="#000000">
+  <path d="M121.5 399.1 c-1.6 -0.4 -4.8 -1.7 -7 -2.9 -5.4 -2.7 -35.6 -33.5 -38.6 -39.2 l-2.4 -4.5 -0.3 -76.5 -0.3 -76.5 -3.3 -3.5 c-9.4 -9.9 -10.6 -15.4 -10.6 -46.3 l0 -25 -6.6 -24.6 c-6.2 -22.8 -6.6 -25.1 -6.2 -32.6 0.7 -12.9 7.6 -24.2 18.9 -30.8 6.6 -3.9 126.4 -36 134.4 -36 4.7 -0.1 19.4 3.5 66.5 16.2 33.3 8.9 62.8 17.3 65.7 18.6 10.3 4.7 17.9 14 20.9 25.7 2.2 8.5 1.5 13.3 -5.3 37.8 l-5.7 20.5 -0.5 29.5 -0.6 29.5 -3.2 6.7 c-1.7 3.7 -5 8.6 -7.2 11.1 l-4.1 4.4 -0.2 76.4 -0.3 76.4 -2.7 4.5 c-3.7 6.3 -35.4 37.5 -40.3 39.7 -3.7 1.7 -9.3 1.8 -81 2 -42.3 0.1 -78.3 -0.2 -80 -0.6z m148.6 -25.8 c2.5 -0.5 6.4 -3.6 15.6 -12.8 6.7 -6.7 12.7 -13.4 13.3 -14.9 0.6 -1.8 1 -26.1 1 -69.7 l0 -66.9 -100.5 0 -100.5 0 0 66.4 c0 44 0.4 67.4 1.1 69.3 1.3 3.6 23.4 26.1 27.4 27.9 2.4 1.1 15.9 1.3 71.1 1.4 37.5 0 69.7 -0.3 71.5 -0.7z m38.2 -191.6 c5.7 -3.7 6.7 -6.9 6.7 -20.9 l0 -12.8 -40.1 0 -40.1 0 -6.6 5.5 c-3.6 3 -9.8 7.1 -13.6 9.2 -6.3 3.3 -7.9 3.8 -14.1 3.8 -8.5 -0.1 -15.1 -3.1 -26.9 -12.4 l-7.6 -6.1 -41 0 -41 0 0 10.3 c0 5.6 0.5 11.9 0.9 14.1 1.1 4.6 5.4 9.3 9.6 10.5 1.7 0.5 48.4 0.9 107 0.8 98.5 -0.2 104.2 -0.3 106.8 -2z m-100.4 -44.8 c6.2 -4.1 9.5 -7.8 12.5 -13.6 1.8 -3.5 3.2 -18.6 2.2 -22.7 l-0.6 -2.6 -21.5 0 -21.4 0 -0.7 3.5 c-1 5.4 0.6 18.5 2.7 22.7 3.2 6.2 15.5 16.8 19.5 16.8 0.6 0 3.9 -1.8 7.3 -4.1z m-54.4 -30.2 c0 -13.7 0.2 -15.6 2.2 -19.3 3.4 -6.3 6.6 -9.7 11.9 -12.4 4.8 -2.4 5.5 -2.5 30.7 -2.8 28.9 -0.4 33.2 0.3 40 5.9 2.1 1.7 5 5.4 6.5 8.3 2.6 4.9 2.7 5.7 2.7 20.3 l0 15.3 33.7 0 33.7 0 1 -3.7 c0.5 -2.1 3.5 -13.2 6.5 -24.6 3.1 -11.5 5.6 -22.3 5.6 -24 0 -4 -1.8 -7.5 -5 -9.8 -3.5 -2.6 -117.1 -32.9 -123.3 -32.9 -5.3 0 -119.8 30.2 -123 32.5 -1 0.7 -2.5 2.1 -3.2 3.2 -3 4.3 -2.6 7.4 4 32.3 3.6 13.5 6.7 25.1 7 25.8 0.3 0.9 8.2 1.2 34.7 1.2 l34.3 0 0 -15.3z"/>
+  <path d="M134.3 325.9 c-4.3 -2.1 -7.3 -6.6 -7.3 -10.9 0 -4.4 3.2 -9.2 7.4 -11.1 3.8 -1.7 7.9 -1.9 66.4 -1.9 70.9 0 67.8 -0.3 71.4 7.7 3.2 7.3 0.7 13.9 -6.3 16.7 -3.4 1.4 -11.7 1.6 -65.7 1.6 -60.3 0 -61.8 0 -65.9 -2.1z"/>
+  <path d="M133.3 266.5 c-4.6 -2 -7.3 -6.9 -7.3 -13.2 0 -24.4 27.7 -41.5 50.1 -30.9 6.8 3.2 15.1 11.7 18 18.3 2.9 6.9 3.5 15.9 1.2 20.3 -4 7.7 -14.1 9.1 -20 2.6 -1.8 -1.9 -3.5 -4.6 -3.8 -6.1 -0.3 -1.4 -0.7 -3.6 -1 -4.9 -1 -4.8 -3.9 -7.1 -9 -7.1 -3.9 0 -5.1 0.5 -7 2.8 -1.3 1.5 -2.7 4.4 -3.1 6.5 -1 5.5 -3.1 9 -6.7 11.2 -3.7 2.3 -7 2.5 -11.4 0.5z"/>
+  <path d="M223.4 266.6 c-6.2 -2.7 -9.5 -9.8 -7.4 -16 1.1 -3.5 7.9 -8.8 28.7 -22.3 11.3 -7.4 13.2 -8 18.7 -5.4 4.9 2.4 7.6 6.5 7.6 11.5 0 6.4 -1.7 8.2 -18.8 19.9 -21.6 14.7 -22.4 15 -28.8 12.3z"/>
+ </g>
+</svg>

robotframework_robocop-9.2.0/docs/images/robocop_logo_small.svg

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN" "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd">
+<svg version="1.0" xmlns="http://www.w3.org/2000/svg" width="150px" height="150px" viewBox="0 0 150 150" preserveAspectRatio="xMidYMid meet">
+ <g fill="#000000">
+  <path d="M45.56 149.66 c-0.6 -0.15 -1.8 -0.64 -2.62 -1.09 -2.03 -1.01 -13.35 -12.56 -14.48 -14.7 l-0.9 -1.69 -0.11 -28.69 -0.11 -28.69 -1.24 -1.31 c-3.53 -3.71 -3.97 -5.78 -3.97 -17.36 l0 -9.38 -2.47 -9.23 c-2.33 -8.55 -2.47 -9.41 -2.33 -12.23 0.26 -4.84 2.85 -9.07 7.09 -11.55 2.47 -1.46 47.4 -13.5 50.4 -13.5 1.76 -0.04 7.27 1.31 24.94 6.07 12.49 3.34 23.55 6.49 24.64 6.98 3.86 1.76 6.71 5.25 7.84 9.64 0.83 3.19 0.56 4.99 -1.99 14.17 l-2.14 7.69 -0.19 11.06 -0.22 11.06 -1.2 2.51 c-0.64 1.39 -1.88 3.22 -2.7 4.16 l-1.54 1.65 -0.08 28.65 -0.11 28.65 -1.01 1.69 c-1.39 2.36 -13.27 14.06 -15.11 14.89 -1.39 0.64 -3.49 0.68 -30.38 0.75 -15.86 0.04 -29.36 -0.08 -30 -0.22z m55.72 -9.68 c0.94 -0.19 2.4 -1.35 5.85 -4.8 2.51 -2.51 4.76 -5.03 4.99 -5.59 0.22 -0.68 0.38 -9.79 0.38 -26.14 l0 -25.09 -37.69 0 -37.69 0 0 24.9 c0 16.5 0.15 25.28 0.41 25.99 0.49 1.35 8.77 9.79 10.27 10.46 0.9 0.41 5.96 0.49 26.66 0.52 14.06 0 26.14 -0.11 26.81 -0.26z m14.33 -71.85 c2.14 -1.39 2.51 -2.59 2.51 -7.84 l0 -4.8 -15.04 0 -15.04 0 -2.47 2.06 c-1.35 1.12 -3.68 2.66 -5.1 3.45 -2.36 1.24 -2.96 1.42 -5.29 1.42 -3.19 -0.04 -5.66 -1.16 -10.09 -4.65 l-2.85 -2.29 -15.38 0 -15.38 0 0 3.86 c0 2.1 0.19 4.46 0.34 5.29 0.41 1.72 2.03 3.49 3.6 3.94 0.64 0.19 18.15 0.34 40.12 0.3 36.94 -0.08 39.08 -0.11 40.05 -0.75z m-37.65 -16.8 c2.33 -1.54 3.56 -2.92 4.69 -5.1 0.68 -1.31 1.2 -6.98 0.83 -8.51 l-0.22 -0.98 -8.06 0 -8.02 0 -0.26 1.31 c-0.38 2.03 0.22 6.94 1.01 8.51 1.2 2.33 5.81 6.3 7.31 6.3 0.22 0 1.46 -0.68 2.74 -1.54z m-20.4 -11.32 c0 -5.14 0.08 -5.85 0.83 -7.24 1.27 -2.36 2.47 -3.64 4.46 -4.65 1.8 -0.9 2.06 -0.94 11.51 -1.05 10.84 -0.15 12.45 0.11 15 2.21 0.79 0.64 1.88 2.03 2.44 3.11 0.98 1.84 1.01 2.14 1.01 7.61 l0 5.74 12.64 0 12.64 0 0.38 -1.39 c0.19 -0.79 1.31 -4.95 2.44 -9.23 1.16 -4.31 2.1 -8.36 2.1 -9 0 -1.5 -0.68 -2.81 -1.88 -3.68 -1.31 -0.98 -43.91 -12.34 -46.24 -12.34 -1.99 0 -44.92 11.32 -46.12 12.19 -0.38 0.26 -0.94 0.79 -1.2 1.2 -1.12 1.61 -0.98 2.78 1.5 12.11 1.35 5.06 2.51 9.41 2.62 9.68 0.11 0.34 3.07 0.45 13.01 0.45 l12.86 0 0 -5.74z"/>
+  <path d="M50.36 122.21 c-1.61 -0.79 -2.74 -2.47 -2.74 -4.09 0 -1.65 1.2 -3.45 2.78 -4.16 1.42 -0.64 2.96 -0.71 24.9 -0.71 26.59 0 25.42 -0.11 26.78 2.89 1.2 2.74 0.26 5.21 -2.36 6.26 -1.27 0.52 -4.39 0.6 -24.64 0.6 -22.61 0 -23.17 0 -24.71 -0.79z"/>
+  <path d="M49.99 99.94 c-1.72 -0.75 -2.74 -2.59 -2.74 -4.95 0 -9.15 10.39 -15.56 18.79 -11.59 2.55 1.2 5.66 4.39 6.75 6.86 1.09 2.59 1.31 5.96 0.45 7.61 -1.5 2.89 -5.29 3.41 -7.5 0.98 -0.68 -0.71 -1.31 -1.72 -1.42 -2.29 -0.11 -0.52 -0.26 -1.35 -0.38 -1.84 -0.38 -1.8 -1.46 -2.66 -3.38 -2.66 -1.46 0 -1.91 0.19 -2.62 1.05 -0.49 0.56 -1.01 1.65 -1.16 2.44 -0.38 2.06 -1.16 3.38 -2.51 4.2 -1.39 0.86 -2.62 0.94 -4.28 0.19z"/>
+  <path d="M83.78 99.98 c-2.33 -1.01 -3.56 -3.68 -2.78 -6 0.41 -1.31 2.96 -3.3 10.76 -8.36 4.24 -2.78 4.95 -3 7.01 -2.03 1.84 0.9 2.85 2.44 2.85 4.31 0 2.4 -0.64 3.07 -7.05 7.46 -8.1 5.51 -8.4 5.62 -10.8 4.61z"/>
+ </g>
+</svg>

robotframework_robocop-9.2.0/docs/images/robocop_logo_small_dark.svg

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN" "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd">
+<svg version="1.0" xmlns="http://www.w3.org/2000/svg" width="150px" height="150px" viewBox="0 0 150 150" preserveAspectRatio="xMidYMid meet">
+ <g fill="#ffffff">
+  <path d="M45.56 149.66 c-0.6 -0.15 -1.8 -0.64 -2.62 -1.09 -2.03 -1.01 -13.35 -12.56 -14.48 -14.7 l-0.9 -1.69 -0.11 -28.69 -0.11 -28.69 -1.24 -1.31 c-3.53 -3.71 -3.97 -5.78 -3.97 -17.36 l0 -9.38 -2.47 -9.23 c-2.33 -8.55 -2.47 -9.41 -2.33 -12.23 0.26 -4.84 2.85 -9.07 7.09 -11.55 2.47 -1.46 47.4 -13.5 50.4 -13.5 1.76 -0.04 7.27 1.31 24.94 6.07 12.49 3.34 23.55 6.49 24.64 6.98 3.86 1.76 6.71 5.25 7.84 9.64 0.83 3.19 0.56 4.99 -1.99 14.17 l-2.14 7.69 -0.19 11.06 -0.22 11.06 -1.2 2.51 c-0.64 1.39 -1.88 3.22 -2.7 4.16 l-1.54 1.65 -0.08 28.65 -0.11 28.65 -1.01 1.69 c-1.39 2.36 -13.27 14.06 -15.11 14.89 -1.39 0.64 -3.49 0.68 -30.38 0.75 -15.86 0.04 -29.36 -0.08 -30 -0.22z m55.72 -9.68 c0.94 -0.19 2.4 -1.35 5.85 -4.8 2.51 -2.51 4.76 -5.03 4.99 -5.59 0.22 -0.68 0.38 -9.79 0.38 -26.14 l0 -25.09 -37.69 0 -37.69 0 0 24.9 c0 16.5 0.15 25.28 0.41 25.99 0.49 1.35 8.77 9.79 10.27 10.46 0.9 0.41 5.96 0.49 26.66 0.52 14.06 0 26.14 -0.11 26.81 -0.26z m14.33 -71.85 c2.14 -1.39 2.51 -2.59 2.51 -7.84 l0 -4.8 -15.04 0 -15.04 0 -2.47 2.06 c-1.35 1.12 -3.68 2.66 -5.1 3.45 -2.36 1.24 -2.96 1.42 -5.29 1.42 -3.19 -0.04 -5.66 -1.16 -10.09 -4.65 l-2.85 -2.29 -15.38 0 -15.38 0 0 3.86 c0 2.1 0.19 4.46 0.34 5.29 0.41 1.72 2.03 3.49 3.6 3.94 0.64 0.19 18.15 0.34 40.12 0.3 36.94 -0.08 39.08 -0.11 40.05 -0.75z m-37.65 -16.8 c2.33 -1.54 3.56 -2.92 4.69 -5.1 0.68 -1.31 1.2 -6.98 0.83 -8.51 l-0.22 -0.98 -8.06 0 -8.02 0 -0.26 1.31 c-0.38 2.03 0.22 6.94 1.01 8.51 1.2 2.33 5.81 6.3 7.31 6.3 0.22 0 1.46 -0.68 2.74 -1.54z m-20.4 -11.32 c0 -5.14 0.08 -5.85 0.83 -7.24 1.27 -2.36 2.47 -3.64 4.46 -4.65 1.8 -0.9 2.06 -0.94 11.51 -1.05 10.84 -0.15 12.45 0.11 15 2.21 0.79 0.64 1.88 2.03 2.44 3.11 0.98 1.84 1.01 2.14 1.01 7.61 l0 5.74 12.64 0 12.64 0 0.38 -1.39 c0.19 -0.79 1.31 -4.95 2.44 -9.23 1.16 -4.31 2.1 -8.36 2.1 -9 0 -1.5 -0.68 -2.81 -1.88 -3.68 -1.31 -0.98 -43.91 -12.34 -46.24 -12.34 -1.99 0 -44.92 11.32 -46.12 12.19 -0.38 0.26 -0.94 0.79 -1.2 1.2 -1.12 1.61 -0.98 2.78 1.5 12.11 1.35 5.06 2.51 9.41 2.62 9.68 0.11 0.34 3.07 0.45 13.01 0.45 l12.86 0 0 -5.74z"/>
+  <path d="M50.36 122.21 c-1.61 -0.79 -2.74 -2.47 -2.74 -4.09 0 -1.65 1.2 -3.45 2.78 -4.16 1.42 -0.64 2.96 -0.71 24.9 -0.71 26.59 0 25.42 -0.11 26.78 2.89 1.2 2.74 0.26 5.21 -2.36 6.26 -1.27 0.52 -4.39 0.6 -24.64 0.6 -22.61 0 -23.17 0 -24.71 -0.79z"/>
+  <path d="M49.99 99.94 c-1.72 -0.75 -2.74 -2.59 -2.74 -4.95 0 -9.15 10.39 -15.56 18.79 -11.59 2.55 1.2 5.66 4.39 6.75 6.86 1.09 2.59 1.31 5.96 0.45 7.61 -1.5 2.89 -5.29 3.41 -7.5 0.98 -0.68 -0.71 -1.31 -1.72 -1.42 -2.29 -0.11 -0.52 -0.26 -1.35 -0.38 -1.84 -0.38 -1.8 -1.46 -2.66 -3.38 -2.66 -1.46 0 -1.91 0.19 -2.62 1.05 -0.49 0.56 -1.01 1.65 -1.16 2.44 -0.38 2.06 -1.16 3.38 -2.51 4.2 -1.39 0.86 -2.62 0.94 -4.28 0.19z"/>
+  <path d="M83.78 99.98 c-2.33 -1.01 -3.56 -3.68 -2.78 -6 0.41 -1.31 2.96 -3.3 10.76 -8.36 4.24 -2.78 4.95 -3 7.01 -2.03 1.84 0.9 2.85 2.44 2.85 4.31 0 2.4 -0.64 3.07 -7.05 7.46 -8.1 5.51 -8.4 5.62 -10.8 4.61z"/>
+ </g>
+</svg>

{robotframework_robocop-9.1.0 → robotframework_robocop-9.2.0}/docs/releasenotes/changelog.md

@@ -1,5 +1,39 @@
 # Release notes
 
+## [9.2.0](https://github.com/MarketSquare/robotframework-robocop/compare/v9.1.2...v9.2.0) (2026-11-06)
+
+
+### Features
+
+* support embedded robot code in markdown and python files ([#1932](https://github.com/MarketSquare/robotframework-robocop/issues/1932)) ([6e81470](https://github.com/MarketSquare/robotframework-robocop/commit/6e81470b16e07942dc4ad062cade954b6c2c77c2))
+
+
+### Bug Fixes
+
+* handle Set Local Variable in variable naming rules ([#1953](https://github.com/MarketSquare/robotframework-robocop/issues/1953)) ([57f1cce](https://github.com/MarketSquare/robotframework-robocop/commit/57f1cce9ac48138b016113d6b353a39135cfc564))
+* remove jinja syntax from unused-resource rule docs ([#1960](https://github.com/MarketSquare/robotframework-robocop/issues/1960)) ([d98afa6](https://github.com/MarketSquare/robotframework-robocop/commit/d98afa69f2977df3fdb46220f73c7f2a92538346))
+
+## [9.1.2](https://github.com/MarketSquare/robotframework-robocop/compare/v9.1.1...v9.1.2) (2026-10-23)
+
+
+### Bug Fixes
+
+* detect extended variable syntax usage in project rules ([#1948](https://github.com/MarketSquare/robotframework-robocop/issues/1948)) ([49fd2ec](https://github.com/MarketSquare/robotframework-robocop/commit/49fd2eccb9619ca0485ec7b363980666e39d883b)), closes [#1947](https://github.com/MarketSquare/robotframework-robocop/issues/1947)
+
+## [9.1.1](https://github.com/MarketSquare/robotframework-robocop/compare/v9.1.0...v9.1.1) (2026-10-10)
+
+
+### Bug Fixes
+
+* derive source lines from provided model to keep fixes consistent ([#1944](https://github.com/MarketSquare/robotframework-robocop/issues/1944)) ([b34b5f1](https://github.com/MarketSquare/robotframework-robocop/commit/b34b5f178dac7f4900c83d01e9015485a2e38654))
+* **formatter:** keep inline comment cells together in ReplaceWithVAR ([#1788](https://github.com/MarketSquare/robotframework-robocop/issues/1788)) ([4d704e8](https://github.com/MarketSquare/robotframework-robocop/commit/4d704e87d439c4945db8aa98baf4018da4ab97d0))
+* ignore tzdata in deptry unused dependency check ([#1945](https://github.com/MarketSquare/robotframework-robocop/issues/1945)) ([129c834](https://github.com/MarketSquare/robotframework-robocop/commit/129c8345047d93188a05b95756a7d27434f355e6))
+
+
+### Documentation
+
+* add SVG versions of Robocop logos ([#1941](https://github.com/MarketSquare/robotframework-robocop/issues/1941)) ([4db4000](https://github.com/MarketSquare/robotframework-robocop/commit/4db400059c2371a84fbfeb16b20770b5cd2a0104))
+
 ## [9.1.0](https://github.com/MarketSquare/robotframework-robocop/compare/v9.0.0...v9.1.0) (2026-09-25)
 
 

{robotframework_robocop-9.1.0 → robotframework_robocop-9.2.0}/docs/rules_list.md

@@ -3919,7 +3919,9 @@ Example of rule violation:
         Keyword From Other Resource
 
 A resource is considered used when the file uses any keyword or variable defined in it, or in any resource it
-imports itself, since resource imports are transitive in Robot Framework.
+imports itself, since resource imports are transitive in Robot Framework. Variables are also recognized when
+used with the extended variable syntax (``${var.attr}``, ``${var['key']}``), item access (``${var}[key]``) or in
+Python expressions (``$var`` in ``IF`` conditions, ``Evaluate`` or inline Python evaluation in variables).
 
 To avoid false positives, imports are not reported when:
 

robotframework_robocop-9.2.0/docs/user_guide/embedded_code.md

@@ -0,0 +1,62 @@
+# Embedded Robot Framework code
+
+Robocop can lint and format Robot Framework code that is embedded in other files:
+
+- **Markdown** files (`.md`, `.markdown`) – fenced code blocks tagged with ` ```robotframework ` (or ` ```robot `).
+- **Python** files (`.py`) – the same fenced blocks placed inside docstrings, as used for runnable examples in
+  library documentation.
+
+This mirrors the embedded execution support that Robot Framework added in version 7.5, but Robocop does its own
+parsing, so it works regardless of the installed Robot Framework version.
+
+A single file may contain zero, one, or many code blocks. **Each block is treated as an independent suite** – it is
+linted and formatted on its own, and the surrounding prose, fences and indentation are left untouched.
+
+````markdown
+# Example
+
+Some documentation describing the test below.
+
+```robotframework
+*** Test Cases ***
+Example Test
+    Log    message
+```
+````
+
+## Opting in
+
+Embedded files are **not** analyzed by default. There are two ways to opt in:
+
+1. **Pass the file directly** on the command line:
+
+    ```bash
+    robocop check docs/example.md
+    robocop format library.py
+    ```
+
+2. **Add the extension to the include patterns** so the files are picked up during directory scans:
+
+    ```bash
+    robocop check --include "*.md" --include "*.py" .
+    ```
+
+    or in the configuration file:
+
+    ```toml
+    [tool.robocop]
+    include = ["*.robot", "*.resource", "*.md"]
+    ```
+
+## Positions and fixes
+
+Reported issues point at the **exact physical line and column** of the code inside the original file, not at a
+position within an extracted block. Automatic fixes (`--fix`) and formatting are written back in place, preserving
+the block indentation (for example the indentation of a fenced block inside a Python docstring) and the file's line
+endings.
+
+## Notes
+
+- Because every block is an independent suite, suite-level rules (such as *missing documentation in suite*) are
+  reported once per block.
+- Blocks tagged with any language other than `robotframework`/`robot` are ignored.

{robotframework_robocop-9.1.0 → robotframework_robocop-9.2.0}/mkdocs.yml

@@ -37,6 +37,7 @@ nav:
   - Robocop: index.md
   - User Guide:
       - "Getting started": user_guide/intro.md
+      - "Embedded code (Markdown, Python)": user_guide/embedded_code.md
       - "Migrate to Robocop 6.0": user_guide/migrate_to_robocop6.md
       - "Python API Reference": user_guide/python_api.md
   - Linter:

{robotframework_robocop-9.1.0 → robotframework_robocop-9.2.0}/pyproject.toml

@@ -112,6 +112,12 @@ extend_exclude = [
     "noxfile.py",
 ]
 
+[tool.deptry.per_rule_ignores]
+# tzdata provides the IANA time zone database for zoneinfo on Windows (used by the
+# timestamp report). It is a data-only package with no importable module, so it is
+# never imported directly.
+DEP002 = ["tzdata"]
+
 [tool.ruff]
 line-length = 120
 show-fixes = true
@@ -182,6 +188,7 @@ lint.unfixable = [
 ]
 extend-exclude = [
     "tests/linter/test_data/",
+    "tests/embedded/test_data/",
     "docs/"
 ]
 [tool.ruff.lint.extend-per-file-ignores]

robotframework_robocop-9.2.0/src/robocop/__init__.py

@@ -0,0 +1 @@
+__version__ = "9.2.0"  # x-release-please-version

{robotframework_robocop-9.1.0 → robotframework_robocop-9.2.0}/src/robocop/config/manager.py

@@ -11,7 +11,7 @@ from robocop.cache import RobocopCache
 from robocop.config.builder import ConfigBuilder
 from robocop.config.parser import read_toml_config
 from robocop.config.schema import Config, RawConfig
-from robocop.source_file import SourceFile
+from robocop.source_file import SourceFile, build_source_file
 
 if TYPE_CHECKING:
     from collections.abc import Generator, Sequence
@@ -291,4 +291,4 @@ class ConfigManager:
             if source.is_dir():
                 self.resolve_paths(list(source.iterdir()), target=target)
             elif source.is_file():
-                target[source] = self._paths.get(source) or SourceFile(path=source, config=config)
+                target[source] = self._paths.get(source) or build_source_file(source, config)

robotframework_robocop-9.2.0/src/robocop/embedded.py

@@ -0,0 +1,220 @@
+"""
+Extraction of embedded Robot Framework code blocks from Markdown and Python files.
+
+Robot Framework 7.5 added support for executing Robot code embedded in Markdown files. The code lives in fenced
+code blocks tagged with ``robotframework`` (or ``robot``)::
+
+    ```robotframework
+    *** Test Cases ***
+    Example
+        Log    message
+    ```
+
+The same convention is used to embed runnable examples in Python docstrings (see Robot Framework's own
+``Collections`` library). Robocop supports both sources.
+
+Unlike Robot Framework -- which concatenates every block and throws away line positions -- Robocop needs to keep
+the exact physical position (line and column) of each block so that reported issues and applied fixes point at the
+right place in the original file. This module extracts blocks while preserving that information.
+
+The extraction is intentionally line based (it does not parse Python syntax). A fenced ``robotframework`` block is
+recognized wherever it appears, which covers both Markdown prose and Python docstrings. Blocks nested inside
+indented docstrings keep their common indentation, which is stripped when the block is turned into a Robot model
+and re-applied when the file is written back.
+"""
+
+from __future__ import annotations
+
+import re
+from dataclasses import dataclass
+from typing import TYPE_CHECKING
+
+from robot.api.parsing import ModelVisitor
+
+if TYPE_CHECKING:
+    from robot.parsing.model import File
+    from robot.parsing.model.statements import Statement
+
+# Supported code block languages (case-insensitive), mirroring Robot Framework's Markdown parser.
+ROBOT_BLOCK_LANGUAGES = frozenset({"robotframework", "robot"})
+
+# File extensions that may contain embedded Robot Framework code blocks.
+MARKDOWN_EXTENSIONS = frozenset({".md", ".markdown"})
+PYTHON_EXTENSIONS = frozenset({".py"})
+EMBEDDED_EXTENSIONS = MARKDOWN_EXTENSIONS | PYTHON_EXTENSIONS
+
+# Opening fence: optional indentation, at least three backticks or tildes, then the language token.
+_FENCE_OPEN = re.compile(r"(?P<indent>[ \t]*)(?P<fence>`{3,}|~{3,})[ \t]*(?P<lang>\S+)")
+
+
+@dataclass
+class RobotCodeBlock:
+    """
+    A single embedded Robot Framework code block located inside a Markdown or Python file.
+
+    Attributes:
+        start_line: 1-indexed physical line number of the first code line (line just after the opening fence).
+        end_line: 1-indexed physical line number of the last code line (inclusive). For an empty block this is
+            ``start_line - 1`` so that ``range(start_line, end_line + 1)`` is empty.
+        indent: Common leading whitespace shared by every non-blank code line. It is stripped when building the
+            Robot model and re-applied when writing changes back to the file.
+        fence_open_line: 1-indexed physical line number of the opening fence.
+        fence_close_line: 1-indexed physical line number of the closing fence, or ``None`` if the block is closed
+            implicitly by the end of the file.
+
+    """
+
+    start_line: int
+    end_line: int
+    indent: str
+    fence_open_line: int
+    fence_close_line: int | None
+
+    @property
+    def is_empty(self) -> bool:
+        return self.end_line < self.start_line
+
+    def contains(self, lineno: int) -> bool:
+        """Return whether the given 1-indexed physical line is a code line of this block."""
+        return self.start_line <= lineno <= self.end_line
+
+
+def is_embedded_extension(suffix: str) -> bool:
+    """Return whether files with the given suffix may contain embedded Robot Framework code blocks."""
+    return suffix.lower() in EMBEDDED_EXTENSIONS
+
+
+def _common_indent(lines: list[str]) -> str:
+    """
+    Return the longest leading whitespace shared by every non-blank line.
+
+    Blank lines (only whitespace or empty) are ignored, mirroring :func:`textwrap.dedent`.
+    """
+    common: str | None = None
+    for line in lines:
+        stripped = line.lstrip(" \t")
+        if not stripped or stripped in ("\n", "\r\n", "\r"):
+            continue
+        indent = line[: len(line) - len(stripped)]
+        if common is None:
+            common = indent
+            continue
+        # Shrink the common prefix to the shared portion.
+        shared_len = 0
+        for a, b in zip(common, indent, strict=False):
+            if a != b:
+                break
+            shared_len += 1
+        common = common[:shared_len]
+        if not common:
+            break
+    return common or ""
+
+
+def extract_robot_blocks(lines: list[str]) -> list[RobotCodeBlock]:
+    """
+    Find all embedded Robot Framework code blocks in the given file lines.
+
+    Args:
+        lines: The physical file lines, including line endings (as returned by ``file.readlines()``).
+
+    Returns:
+        List of :class:`RobotCodeBlock`, in file order. Empty if the file has no Robot code blocks.
+
+    """
+    blocks: list[RobotCodeBlock] = []
+    total = len(lines)
+    index = 0
+    while index < total:
+        match = _FENCE_OPEN.match(lines[index])
+        if not match or match.group("lang").lower() not in ROBOT_BLOCK_LANGUAGES:
+            index += 1
+            continue
+        fence = match.group("fence")
+        fence_char = re.escape(fence[0])
+        # Closing fence: at least as many of the same fence character, optionally surrounded by whitespace.
+        close_re = re.compile(rf"[ \t]*{fence_char}{{{len(fence)},}}[ \t]*$")
+        fence_open_line = index + 1
+        code_lines: list[str] = []
+        cursor = index + 1
+        while cursor < total and not close_re.match(lines[cursor].rstrip("\r\n")):
+            code_lines.append(lines[cursor])
+            cursor += 1
+        start_line = index + 2
+        end_line = cursor  # cursor is the closing fence (or EOF); last code line is cursor - 1 (0-indexed) -> cursor
+        fence_close_line = cursor + 1 if cursor < total else None
+        blocks.append(
+            RobotCodeBlock(
+                start_line=start_line,
+                end_line=end_line,
+                indent=_common_indent(code_lines),
+                fence_open_line=fence_open_line,
+                fence_close_line=fence_close_line,
+            )
+        )
+        index = cursor + 1
+    return blocks
+
+
+def strip_indent(line: str, indent: str) -> str:
+    """Remove up to ``indent`` leading characters from ``line`` (only if the line starts with that indentation)."""
+    if indent and line.startswith(indent):
+        return line[len(indent) :]
+    # Blank or shorter-indented lines: drop whatever leading whitespace overlaps the common indent.
+    stripped = line.lstrip(" \t")
+    leading = line[: len(line) - len(stripped)]
+    keep = leading[len(indent) :] if len(leading) > len(indent) else ""
+    return keep + stripped
+
+
+def reconstruct_source(lines: list[str], blocks: list[RobotCodeBlock]) -> str:
+    """
+    Build a Robot Framework source string that preserves physical line numbers.
+
+    Non-code lines (prose, fences, Python code) are replaced with blank lines and code lines are dedented by their
+    block indentation. The resulting model therefore has line numbers matching the original file, while section
+    headers and statements start at column 0 as Robot Framework requires.
+
+    Args:
+        lines: The physical file lines, including line endings.
+        blocks: Blocks extracted from ``lines`` via :func:`extract_robot_blocks`.
+
+    Returns:
+        Robot Framework source text with one entry per physical line.
+
+    """
+    reconstructed = ["\n"] * len(lines)
+    for block in blocks:
+        for lineno in range(block.start_line, block.end_line + 1):
+            original = lines[lineno - 1]
+            newline = _line_ending(original)
+            reconstructed[lineno - 1] = strip_indent(original.rstrip("\r\n"), block.indent) + newline
+    return "".join(reconstructed)
+
+
+def _line_ending(line: str) -> str:
+    if line.endswith("\r\n"):
+        return "\r\n"
+    if line.endswith("\n"):
+        return "\n"
+    if line.endswith("\r"):
+        return "\r"
+    return ""
+
+
+class _LineShifter(ModelVisitor):  # type: ignore[misc]
+    """Shift every token line number by a fixed offset, turning block-local lines into physical file lines."""
+
+    def __init__(self, offset: int) -> None:
+        self.offset = offset
+
+    def visit_Statement(self, node: Statement) -> None:  # noqa: N802
+        for token in node.tokens:
+            token.lineno += self.offset
+
+
+def shift_model_lines(model: File, offset: int) -> File:
+    """Add ``offset`` to every token line number in the model (in place) and return it."""
+    if offset:
+        _LineShifter(offset).visit(model)
+    return model

{robotframework_robocop-9.1.0 → robotframework_robocop-9.2.0}/src/robocop/formatter/formatters/ReplaceWithVAR.py

@@ -191,9 +191,27 @@ class ReplaceWithVAR(Formatter):
             else:
                 node.tokens = [*node.tokens[:-1], Token(Token.SEPARATOR, "  "), comments[0], node.tokens[-1]]  # type: ignore[union-attr]
             return node
-        comment_nodes = [Comment.from_params(comment=comment.value, indent=indent) for comment in comments]
+        comment_nodes = [
+            Comment.from_params(comment=comment, indent=indent) for comment in self.merge_comment_values(comments)
+        ]
         return *comment_nodes, node
 
+    @staticmethod
+    def merge_comment_values(comments: list[Token]) -> list[str]:
+        """
+        Merge comment tokens that belong to the same comment.
+
+        A single inline comment is tokenized into one token per cell, and only the first one starts with ``#``.
+        Emitting the remaining cells as separate comments would turn them into executable lines.
+        """
+        merged: list[str] = []
+        for comment in comments:
+            if merged and not comment.value.startswith("#"):
+                merged[-1] = f"{merged[-1]}    {comment.value}"
+            else:
+                merged.append(comment.value)
+        return merged
+
     @staticmethod
     def resolve_variable_name(name: str) -> str | None:
         name = name.removeprefix("\\")

{robotframework_robocop-9.1.0 → robotframework_robocop-9.2.0}/src/robocop/formatter/runner.py

@@ -68,6 +68,18 @@ class RobocopFormatter:
                         cached_files += 1
                         continue
                 previous_changed_files = changed_files
+                if source_file.is_embedded:
+                    diff, old_text, new_text = self.format_embedded(source_file)
+                    if diff:
+                        self.save_text(source_file.path, new_text)
+                        self.log_formatted_source(source_file.path, stdin)
+                        self.output_diff_text(source_file.path, old_text, new_text)
+                        changed_files += 1
+                    if not diff or self.config.formatter.overwrite:
+                        self.config_manager.cache.set_formatter_entry(
+                            source_file.path, source_file.config.hash, needs_formatting=False
+                        )
+                    continue
                 diff, old_model, new_model, model = self.format_until_stable(source_file)
                 # if stdin:
                 #     self.print_to_stdout(new_model)
@@ -150,6 +162,87 @@ class RobocopFormatter:
         new_model = StatementLinesCollector(model)
         return new_model != old_model, old_model, new_model
 
+    def format_embedded(self, source_file: SourceFile) -> tuple[bool, str, str]:
+        """
+        Format every Robot code block embedded in a Markdown or Python file independently.
+
+        Each block is formatted on its own, re-indented to its original position and spliced back into the physical
+        file, leaving prose, fences and indentation of the surrounding document untouched.
+
+        Returns:
+            Tuple of (changed, original_text, new_text) with the full physical file contents.
+
+        """
+        resolved_config = self.config_resolver.resolve_config(source_file.config)
+        original = list(source_file.source_lines)
+        physical = list(original)
+        newline = self._detect_newline(original)
+        # Blocks are spliced bottom-to-top so that changing the length of one block does not shift the others.
+        for block, model in reversed(source_file.format_blocks()):  # type: ignore[attr-defined]
+            formatted = self.format_block(model, resolved_config)
+            if formatted is None:
+                continue
+            physical[block.start_line - 1 : block.end_line] = self._reindent_block(formatted, block.indent, newline)
+        new_text = "".join(physical)
+        old_text = "".join(original)
+        return new_text != old_text, old_text, new_text
+
+    def format_block(self, model: File, resolved_config: ResolvedConfig) -> str | None:
+        """
+        Run the configured formatters on a single block model.
+
+        Returns:
+            The formatted block text, or ``None`` if the block is unchanged or fully disabled.
+
+        """
+        disabler_finder = disablers.RegisterDisablers(self.config.formatter.start_line, self.config.formatter.end_line)
+        disabler_finder.visit(model)
+        if disabler_finder.is_disabled_in_file(disablers.ALL_FORMATTERS):
+            return None
+        original_text = StatementLinesCollector(model).text
+        formatted = self._apply_formatters(model, disabler_finder.disablers, resolved_config)
+        reruns = self.config.formatter.reruns
+        while formatted != original_text and reruns:
+            rerun_model = get_model(formatted)
+            rerun_disablers = disablers.RegisterDisablers(
+                self.config.formatter.start_line, self.config.formatter.end_line
+            )
+            rerun_disablers.visit(rerun_model)
+            new_formatted = self._apply_formatters(rerun_model, rerun_disablers.disablers, resolved_config)
+            if new_formatted == formatted:
+                break
+            formatted = new_formatted
+            reruns -= 1
+        return formatted if formatted != original_text else None
+
+    @staticmethod
+    def _apply_formatters(
+        model: File, disablers_in_file: disablers.DisablersInFile, resolved_config: ResolvedConfig
+    ) -> str:
+        for name, formatter in resolved_config.formatters.items():
+            formatter.disablers = disablers_in_file
+            if disablers_in_file.is_disabled_in_file(name):
+                continue
+            formatter.visit(model)
+        return StatementLinesCollector(model).text
+
+    @staticmethod
+    def _detect_newline(lines: list[str]) -> str:
+        """Return the line ending used by the physical file so formatted blocks keep the surrounding style."""
+        for line in lines:
+            if line.endswith("\r\n"):
+                return "\r\n"
+            if line.endswith("\n"):
+                return "\n"
+            if line.endswith("\r"):
+                return "\r"
+        return os.linesep
+
+    @staticmethod
+    def _reindent_block(text: str, indent: str, newline: str) -> list[str]:
+        """Re-apply the block indentation and the file's line ending to formatted lines, leaving blanks unindented."""
+        return [f"{indent}{line}{newline}" if line.strip() else f"{line}{newline}" for line in text.splitlines()]
+
     def log_formatted_source(self, source: Path, stdin: bool) -> None:
         if stdin or self.config.silent:
             return
@@ -171,6 +264,28 @@ class RobocopFormatter:
             output = self.config.formatter.output or source
             misc.ModelWriter(output=str(output), newline=self.get_line_ending(str(source))).write(model)
 
+    def save_text(self, source: Path, text: str) -> None:
+        """Write the full physical file content of an embedded file, preserving its original line endings."""
+        if self.config.formatter.overwrite:
+            output = self.config.formatter.output or source
+            with open(output, "w", encoding="utf-8", newline="") as f:
+                f.write(text)
+
+    def output_diff_text(self, path: Path, old_text: str, new_text: str) -> None:
+        if not self.config.formatter.diff:
+            return
+        old = [line + "\n" for line in old_text.splitlines()]
+        new = [line + "\n" for line in new_text.splitlines()]
+        lines = list(unified_diff(old, new, fromfile=f"{path}\tbefore", tofile=f"{path}\tafter"))
+        if not lines:
+            return
+        if self.config.formatter.color:
+            output = misc.decorate_diff_with_color(lines)
+        else:
+            output = misc.escape_rich_markup(lines)
+        for line in output:
+            console.print(line, end="", highlight=False, soft_wrap=True)
+
     def get_line_ending(self, path: str) -> str:
         if self.config.formatter.whitespace_config.line_ending == "auto":
             with open(path) as f:

{robotframework_robocop-9.1.0 → robotframework_robocop-9.2.0}/src/robocop/linter/checkers/names.py

@@ -131,7 +131,9 @@ class NamesChecker(VisitorChecker):
         """Check the name of a variable assigned with one of the ``Set * Variable`` keywords."""
         if not node.keyword:
             return
-        if utils.normalize_robot_name(node.keyword, remove_prefix="builtin.") not in naming.SET_VARIABLE_VARIANTS:
+        if utils.normalize_robot_name(node.keyword, remove_prefix="builtin.") not in (
+            naming.NON_LOCAL_SET_VARIABLE_VARIANTS
+        ):
             return
         if len(node.data_tokens) < 2:
             return