{"canonical_url":"https://engineer.company/sv/glossary/ruff/","content_markdown":"# Ruff\n\n## Vad det är\n\nRuff är ett enda kommandoradsprogram, skrivet i Rust, som kontrollerar källkod i Python mot en\nkatalog med lintregler och skriver om dess layout till en och samma stil. Bakom det står Astral,\nföretaget bakom uv och ty, och två av underkommandona gör det dagliga arbetet: `ruff check` är\nlintern och `ruff format` är formateraren. Projektet uppger att det är 10 till 100 gånger snabbare\nän Flake8 och Black, håller en cache så att oförändrade filer inte analyseras igen och kan ersätta\nFlake8 med dussintals av dess insticksmoduler, Black, isort, pydocstyle, pyupgrade och autoflake.\n\nLintern levereras med mer än 900 regler, många av dem inbyggda omskrivningar av populära\ninsticksmoduler till Flake8. Varje regel har en kod som består av ett kort prefix och tre siffror,\noch prefixet säger var regeln kommer ifrån: F401, en oanvänd import, kommer från Pyflakes, och E501,\nen rad som är för lång, från pycodestyle. En konfiguration väljer regler efter de koderna, en i\ntaget eller per prefix, så `select = [\"E\", \"F\"]` slår på varje regel vars kod börjar med E eller F,\noch specialväljaren `ALL` slår på allt. Många regler har en automatisk rättning, uppdelad i säkra\nrättningar, som är tänkta att bevara beteendet vid körning, och osäkra, som kan ändra det. `ruff\ncheck --fix` tillämpar bara den säkra sorten, om inte `--unsafe-fixes` också anges.\n\nFormateraren är utformad som en direkt ersättare för Black. I kodbaser som Django och Zulip blir mer\nän 99,9 % av raderna identiska, men dokumentationen säger rakt ut att de två inte är tänkta att\nbytas fram och tillbaka på samma kod. Precis som Black hoppar den över områden som omges av `# fmt:\noff` och `# fmt: on`.\n\nBåda halvorna läser samma konfiguration, som ligger under `[tool.ruff]` i `pyproject.toml` eller i\nen fil som heter `ruff.toml` eller `.ruff.toml`. Varje Python-fil kontrolleras mot den närmaste\nkonfigurationsfilen ovanför den, och den filen används i sin helhet: Ruff slår inte ihop något från\növerordnade kataloger om inte den närmare filen pekar ut sin förälder med `extend`. Flaggor på\nkommandoraden går före alla filer. Som standard får rader vara upp till 88 tecken långa, som i\nBlack, och den Python-version som reglerna utgår från hämtas från projektets fält `requires-python`\nnär ingen konfiguration anger någon.\n\n## Varför det spelar roll\n\nHastigheten avgör var en kontroll får köras. En linter som är så långsam att den avbryter någon\nskjuts ut till CI, där den rapporterar först när författaren redan har gått vidare. En som svarar\nsnabbt kan köras i editorn och i en hook vid varje commit, medan ändringen fortfarande är färsk.\n\nAtt samla allt i ett verktyg tar bort tvister mellan verktyg. Ett projekt som lintar med Flake8 och\ninsticksmoduler, sorterar importer med isort och formaterar med Black måste hålla flera\nkonfigurationer och versionslåsningar överens. Ruff erbjuder en konfiguration, en version att låsa\noch en numrering av regler, och projektet publicerar listan över de lintregler som krockar med dess\negen formaterare, så att de två kan fås att stämma överens med avsikt.\n\nSlutkoderna gör Ruff till en kvalitetsgrind utan något omslag. `ruff check` avslutas med 0 när inga\növerträdelser återstår eller när varje överträdelse har rättats, med 1 när överträdelser finns kvar,\noch med 2 när konfigurationen eller kommandoraden är ogiltig eller när Ruff självt fallerar, precis\nsom ESLint och Prettier. `ruff format --check` avslutas med 1 när någon fil skulle formateras om. En\nregel är antingen vald eller avslagen, och varje vald regel som slår till sätter slutkoden till 1.\n\nKostnaden är att regeluppsättningen är ett beslut som någon måste äga. Ruffs eget råd är att lista\nregler uttryckligen med `select` i stället för att stapla `extend-select`, att börja med E och F och\nlägga till en grupp i taget, och att använda `ALL` med omdöme, eftersom den slår på nya regler vid\nvarje uppgradering.\n\n## Så ser det ut i praktiken\n\nRuff täckte Python när\n[ribban sattes vid noll varningar i sex språk](/sv/portfolio/set-a-zero-warnings-bar-across-six-languages/),\ndär varje språk hade en egen linter. Varje diagnostikmeddelande räknades som ett fel, och\nundertryckningar direkt i koden var förbjudna, vilket för Ruff utesluter kommentaren `# noqa`: ett\nfynd i Python kunde åtgärdas i koden och på inget annat sätt. Hookar för pre-commit och pre-push\nkörde linters och tester, så att kontrollerna gjordes innan en commit ens fanns.\n\nI den dokumenterade verktygsuppsättningen från oktober 2026 hade Ruff ett mindre\njobb på den här webbplatsen: de 22 hjälpskripten bredvid Hugo-bygget.\n[Kolofonen](/sv/credits/) räknar upp Ruff bland verktygen som ”håller källkoden\närlig”. Regeluppsättningen i `pyproject.toml` är uppmätt snarare än vald. Den 15\noktober 2026 kördes var och en av Ruffs 54 regelfamiljer mot de skripten, 39 av\ndem rapporterade ingenting, och de tysta familjer vars ämne är just den här\nkoden lades till de ursprungliga elva, så att urvalet nu omfattar 33 familjer.\nSäkerhetsfamiljen, S, är fortfarande påslagen, med fem regler ignorerade efter\nkod, var och en bredvid en kommentar som förklarar varför det flaggade mönstret\nhär är den säkra tvillingen till ett farligt, så att familjens övriga regler\nfortfarande spärrar. Tre Ruff-specifika regler om tvetydiga Unicode-tecken\nignoreras, eftersom webbplatsens text med avsikt använder riktiga långa och\nkorta tankstreck och danska bokstäver.\n\nPre-commit-konfigurationen kör `ruff check` och `ruff format --check` på varje Python-fil under\n`scripts/` som en commit rör, och projektets task för rättningar kör samma två kommandon i deras\nrättande form. Bredvid Ruff står basedpyright, en typkontrollerare, med en kommentar som markerar\ngränsen mellan dem: en linter följer inte ett värde över en funktionsgräns, och vid sin första\nkörning hittade typkontrolleraren två verkliga defekter som Ruff hade släppt igenom utan anmärkning.\n\n## Var det går fel\n\nDet mesta besväret med Ruff kommer av en konfiguration som är mer bokstavlig än de människor som\nskrev den.\n\n**En gren som ingen har rört fallerar efter en uppgradering.** Kod som klarade sig i går rapporterar\nnya överträdelser efter att Ruff har uppdaterats. Den vanliga orsaken är `select = [\"ALL\"]`, som tar\nin varje regel som en ny release lägger till, i kombination med en version som inte är låst. Lås\nRuffs version så att en uppgradering blir en granskad commit, och lista de familjer som projektet\nvill ha i stället för `ALL`, så att en ny familj bara kommer in när någon lägger till den.\n\n**En mapp slutar följa projektets regler.** Överträdelser som rotkonfigurationen förbjuder går\nigenom i en underkatalog, eller så slår en regel som teamet har stängt av till där. En `ruff.toml`,\neller en `pyproject.toml` med en tabell `[tool.ruff]`, ligger i den mappen, och eftersom Ruff\nanvänder den närmaste filen i sin helhet slutar varje inställning från roten att gälla under den.\n`ruff check --show-settings` på en fil där skriver ut sökvägen till de inställningar som Ruff\nlandade i. Ta bort den nästlade filen, eller låt den ärva med `extend = \"../pyproject.toml\"`.\n\n**En undertryckning överlever sitt skäl.** En kommentar `# noqa` lades till av goda skäl, koden\nändrades, och nu döljer kommentaren ingenting, eller döljer nästa problem på samma rad. En naken `#\nnoqa` är värre: den tystar varje regel på raden. Slå på RUF100, som rapporterar `noqa`-kommentarer\nsom inte längre undertrycker något, och PGH004, som kräver en specifik kod, och låt `--fix` ta bort\nde döda. Här har importen sedan dess kommit till användning, så kommentaren skyddar ingenting och\nRUF100 rapporterar den:\n\n```python\nimport json  # noqa: F401\n\nprint(json.dumps({\"ok\": True}))\n```\n\n**Formateraren och lintern är oense.** `ruff format` skriver om en fil, och `ruff check` flaggar\nsedan resultatet. Vissa lintregler vaktar det som formateraren bestämmer, som avslutande kommatecken\n(COM812), indrag (W191, E111) och stilen på citattecken (Q-reglerna), och formateraren försöker bara\nefter bästa förmåga hålla radlängden, så E501 kan fortfarande slå till på formaterad kod. Läs de\nvarningar som `ruff format` skriver ut, eftersom en körning helt utan dem är dokumentationens eget\ntest på att de två är överens, ignorera varje regel som en varning namnger och se E501 som en signal\natt strukturera om raden.\n\n**En massrättning ändrar beteendet.** Efter `ruff check --fix --unsafe-fixes` över hela trädet\nfallerar testerna, eller så slutar en felhanterare att fånga det den brukade fånga. Osäkra\nrättningar får ändra beteendet vid körning eller ta bort kommentarer, och dokumentationens eget\nexempel ändrar vilket undantag en kodbit kastar. Håll `--unsafe-fixes` borta från hookar och skript,\ntillämpa osäkra rättningar en regel i taget med `--select` och läs diffen, och befordra en regel med\n`extend-safe-fixes` först när teamet har granskat den.\n\n## Läs mer\n\n- [Ruff](https://docs.astral.sh/ruff/)\n  — vad Ruff ersätter, hur snabbt projektet säger att det är och vem som underhåller det.\n- [The Ruff Linter](https://docs.astral.sh/ruff/linter/)\n  — val av regler och deras företräde, säkra och osäkra rättningar, `noqa`-kommentarer och\n  slutkoder.\n- [The Ruff Formatter](https://docs.astral.sh/ruff/formatter/)\n  — kompatibiliteten med Black och de lintregler som krockar med formateringen.\n- [Rules](https://docs.astral.sh/ruff/rules/)\n  — varje regel efter kod, dess ursprung och om den går att rätta automatiskt.\n- [Configuring Ruff](https://docs.astral.sh/ruff/configuration/)\n  — hur konfigurationsfiler hittas, regeln om den närmaste filen, `extend` och kommandoradens\n  flaggor.\n\n\u003chttps://engineer.company/sv/glossary/ruff/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Ruff för dig som skriver Python: lintning och formatering i ett program, regler som väljs efter kod och en nästlad konfigurationsfil som tappar reglerna.","formats":{"gemtext":"https://engineer.company/sv/glossary/ruff/index.gmi","gopher":"https://engineer.company/sv/glossary/ruff/gophermap","html":"https://engineer.company/sv/glossary/ruff/","json":"https://engineer.company/sv/glossary/ruff/index.json","markdown":"https://engineer.company/sv/glossary/ruff/index.md","pdf":"https://engineer.company/sv/glossary/ruff/index.pdf"},"kind":"page","language":"sv","title":"Vad är Ruff?","url":"https://engineer.company/sv/glossary/ruff/","version":1}