{"canonical_url":"https://engineer.company/nb/glossary/ruff/","content_markdown":"# Ruff\n\n## Hva det er\n\nRuff er ett enkelt kommandolinjeprogram, skrevet i Rust, som sjekker\nPython-kildekode mot en katalog av lintregler og skriver om oppsettet av koden\ntil én konsekvent stil. Det støttes av Astral, selskapet bak uv og ty, og to av\nunderkommandoene gjør det daglige arbeidet: `ruff check` er linteren og\n`ruff format` er formatereren. Prosjektet hevder at Ruff kjører 10 til 100\nganger raskere enn Flake8 og Black, programmet husker resultatene sine slik at\nuendrede filer ikke analyseres på nytt, og det kan tre inn i stedet for Flake8\nmed dusinvis av programtilleggene dens, Black, isort, pydocstyle, pyupgrade og\nautoflake.\n\nLinteren leveres med mer enn 900 regler, mange av dem egne omskrivninger av\npopulære Flake8-tillegg. Hver regel har en kode laget av et kort prefiks og tre\nsifre, og prefikset sier hvor regelen kom fra: F401, en import som ikke brukes,\nkommer fra Pyflakes, og E501, en linje som er for lang, fra pycodestyle. En\nkonfigurasjon velger regler etter disse kodene, én om gangen eller etter\nprefiks, så `select = [\"E\", \"F\"]` slår på hver regel med en kode som begynner på\nE eller F, og den spesielle velgeren `ALL` slår på alt. Mange regler har en\nretting, sortert i trygge rettinger, som skal bevare oppførselen under kjøring,\nog utrygge, som kan endre den; `ruff check --fix` bruker bare den trygge typen\nmed mindre `--unsafe-fixes` også er gitt.\n\nFormatereren er laget for å kunne erstatte Black direkte. På kodebaser som de\ntil Django og Zulip kommer mer enn 99,9 % av linjene ut identiske, selv om\ndokumentasjonen sier rett ut at de to ikke er ment å byttes fram og tilbake på\nden samme koden. I likhet med Black hopper den over områder som er avgrenset med\n`# fmt: off` og `# fmt: on`.\n\nBegge halvdelene leser den samme konfigurasjonen, som ligger under\n`[tool.ruff]` i `pyproject.toml`, eller i en fil som heter `ruff.toml` eller\n`.ruff.toml`. Hver Python-fil sjekkes mot den nærmeste konfigurasjonsfilen over\nden, og den filen brukes i sin helhet: Ruff slår ikke sammen noe fra\noverordnede kataloger med mindre den nærmeste filen navngir forelderen sin med\n`extend`. Valg som gis på kommandolinjen, overstyrer hver fil. Står ingenting\noppgitt, kan linjer være opptil 88 tegn lange, som i Black, og Python-versjonen\nreglene forutsetter, hentes fra feltet `requires-python` i prosjektet når ingen\nkonfigurasjon navngir en.\n\n## Hvorfor det er viktig\n\nHastighet avgjør hvor en sjekk får lov til å kjøre. En linter som er treg nok\ntil å avbryte noen, blir skjøvet ut til kontinuerlig integrasjon, der den\nrapporterer etter at forfatteren har gått videre. En som svarer raskt, kan kjøre\ni editoren og i en hook ved commit, mens endringen fortsatt er fersk.\n\nÅ samle alt i ett verktøy fjerner krangel mellom verktøy. Et prosjekt som linter\nmed Flake8 og programtillegg, sorterer importer med isort og formaterer med\nBlack, må holde flere konfigurasjoner og versjonslåser i takt. Ruff tilbyr én\nkonfigurasjon, én versjon å låse og én nummerering av regler, og publiserer\nlisten over lintregler som kommer i konflikt med Ruffs egen formaterer, slik at\nde to kan bringes i samsvar med vilje.\n\nAvslutningskodene gjør Ruff til en kvalitetsport uten noe skript rundt.\n`ruff check` avslutter med 0 når det ikke er noen brudd igjen, eller når hvert\nav dem ble rettet, med 1 når brudd gjenstår, og med 2 når konfigurasjonen eller\nkommandolinjen er ugyldig eller Ruff selv feiler, slik ESLint og Prettier også\ngjør. `ruff format --check` avslutter med 1 når en fil ville blitt formatert om.\nEn regel er enten valgt eller av, og hver valgt regel som slår ut, setter\navslutningskoden til 1.\n\nKostnaden er at regelsettet er en beslutning noen må eie. Ruff råder selv til\nå liste regler eksplisitt med `select` i stedet for å stable `extend-select`,\ntil å begynne med E og F og legge til én gruppe om gangen, og til å bruke\n`ALL` med forsiktighet, fordi den velgeren slår på nye regler ved hver\noppgradering.\n\n## Slik ser det ut i praksis\n\nRuff dekket Python i\n[et krav om null advarsler på seks språk](/nb/portfolio/set-a-zero-warnings-bar-across-six-languages/),\nder hvert språk hadde sin egen linter. Hvert funn telte som en feil, og\nundertrykkelser i selve koden var forbudt, noe som for Ruff utelukker\nkommentaren `# noqa`: et funn i Python kunne bare rettes i koden og på ingen\nannen måte. Pre-commit- og pre-push-hooks kjørte linterne og testene, så sjekken\nkjørte før en commit fantes.\n\nI det dokumenterte verktøyoppsettet fra oktober 2026 hadde Ruff en mindre jobb\npå dette nettstedet: de 22 hjelpeskriptene ved siden av Hugo-bygget.\n[Kolofonen](/nb/credits/) nevner Ruff blant verktøyene som holder kildekoden\nærlig. Regelsettet i `pyproject.toml` er målt og ikke valgt. Den 15. oktober\n2026 ble hver av de 54 regelfamiliene i Ruff kjørt mot disse skriptene, og 39 av\ndem rapporterte ingenting. De tause familiene som faktisk handler om denne typen\nkode, ble lagt til de opprinnelige elleve, og det gir et utvalg på 33.\nSikkerhetsfamilien, S, står på, med fem regler ignorert etter kode, hver ved\nsiden av en kommentar som forklarer hvorfor mønsteret som flagges her, er den\ntrygge tvillingen til et farlig mønster, slik at de andre reglene i familien\nfortsatt er en del av kvalitetsporten. Tre Ruff-spesifikke regler om tvetydige\nUnicode-tegn er ignorert, fordi teksten på nettstedet bruker ekte lange og korte\ntankestreker og danske bokstaver med vilje.\n\nPre-commit-konfigurasjonen kjører `ruff check` og `ruff format --check` på hver\nPython-fil under `scripts/` som en commit rører, og oppgaven i prosjektet som\nretter alt som kan rettes automatisk, kjører de samme to kommandoene i den\nformen som retter. Ved siden av Ruff står basedpyright, en typesjekker, med en\nkommentar som markerer grensen mellom dem: en linter følger ikke en verdi over\nen funksjonsgrense, og ved første kjøring fant typesjekkeren to reelle\nprogramvarefeil som Ruff hadde sluppet gjennom.\n\n## Hvor det går galt\n\nDet meste av trøbbelet med Ruff kommer av en konfigurasjon som er mer\nbokstavelig enn folkene som skrev den.\n\n**En oppgradering feiler en gren ingen har rørt.** Kode som besto i går,\nrapporterer nye brudd etter at Ruff er oppdatert. Den vanlige årsaken er\n`select = [\"ALL\"]`, som tar inn hver regel en utgivelse legger til, sammen med\nen versjon som ikke er låst. Lås Ruff-versjonen slik at en oppgradering blir en\ncommit noen har sett gjennom, og list opp familiene prosjektet vil ha i stedet\nfor `ALL`, så en ny familie kommer først når noen legger den til.\n\n**Én mappe slutter å følge prosjektets regler.** Brudd som rotkonfigurasjonen\nforbyr, slipper gjennom i en underkatalog, eller en regel teamet har slått av,\nslår ut der. En `ruff.toml`, eller en `pyproject.toml` med en\n`[tool.ruff]`-tabell, ligger i den mappen, og fordi Ruff bruker den nærmeste\nfilen i sin helhet, slutter hver innstilling fra roten å gjelde under den.\n`ruff check --show-settings` på en fil der skriver ut stien til innstillingene\nRuff kom fram til. Slett den nestede filen, eller la den arve med\n`extend = \"../pyproject.toml\"`.\n\n**En undertrykkelse lever lenger enn grunnen til den.** En `# noqa`-kommentar\nble lagt inn av en god grunn, koden endret seg, og kommentaren skjuler nå\ningenting, eller det neste problemet på den linjen. En naken `# noqa` er verre:\nden demper hver regel på linjen. Velg RUF100, som rapporterer `noqa`-kommentarer\nsom ikke lenger undertrykker noe, og PGH004, som krever en bestemt kode, og la\n`--fix` fjerne de døde. Her har importen siden blitt tatt i bruk, så kommentaren\nbeskytter ingenting, og RUF100 rapporterer den:\n\n```python\nimport json  # noqa: F401\n\nprint(json.dumps({\"ok\": True}))\n```\n\n**Formatereren og linteren er uenige.** `ruff format` skriver om en fil, og\n`ruff check` flagger deretter resultatet. Noen lintregler passer på ting\nformatereren bestemmer, som avsluttende kommaer (COM812), innrykk (W191, E111)\nog stil på anførselstegn (Q-reglene), og formatereren gjør bare et forsøk etter\nbeste evne på linjelengden, så E501 kan fortsatt slå ut på formatert kode. Les\nadvarslene `ruff format` skriver ut, siden en kjøring uten dem er\ndokumentasjonens egen test på at de to er enige, ignorer hver regel en advarsel\nnavngir, og behandle E501 som et signal om å bygge om linjen.\n\n**En masseretting endrer oppførsel.** Etter `ruff check --fix --unsafe-fixes`\nover hele treet feiler tester, eller en feilhåndterer slutter å fange det den\npleide å fange. Utrygge rettinger har lov til å endre oppførselen under kjøring\neller fjerne kommentarer, og dokumentasjonens eget eksempel endrer hvilket\nunntak et stykke kode kaster. Hold `--unsafe-fixes` ute av hooks og skript, bruk\nutrygge rettinger én regel om gangen med `--select` og les diffen, og flytt en\nregel over med `extend-safe-fixes` først når teamet har sjekket den.\n\n## Les mer\n\n- [Ruff](https://docs.astral.sh/ruff/) — hva Ruff erstatter, hvor raskt\n  prosjektet hevder at det er, og hvem som vedlikeholder det.\n- [The Ruff Linter](https://docs.astral.sh/ruff/linter/) — valg av regler og\n  rekkefølgen de gjelder i, trygge og utrygge rettinger, `noqa`-kommentarer og\n  avslutningskoder.\n- [The Ruff Formatter](https://docs.astral.sh/ruff/formatter/) — samsvaret med\n  Black, og lintreglene som kommer i konflikt med formateringen.\n- [Rules](https://docs.astral.sh/ruff/rules/) — hver regel etter kode, hvor den\n  kommer fra, og om den kan rettes automatisk.\n- [Configuring Ruff](https://docs.astral.sh/ruff/configuration/) — hvordan\n  konfigurasjonsfiler blir funnet, regelen om den nærmeste filen, `extend` og\n  valgene på kommandolinjen.\n\n\u003chttps://engineer.company/nb/glossary/ruff/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Hvordan Ruff linter og formaterer Python fra én binærfil, hvordan regler velges etter kode, og hvorfor en nestet konfigurasjonsfil stille slipper reglene.","formats":{"gemtext":"https://engineer.company/nb/glossary/ruff/index.gmi","gopher":"https://engineer.company/nb/glossary/ruff/gophermap","html":"https://engineer.company/nb/glossary/ruff/","json":"https://engineer.company/nb/glossary/ruff/index.json","markdown":"https://engineer.company/nb/glossary/ruff/index.md","pdf":"https://engineer.company/nb/glossary/ruff/index.pdf"},"kind":"page","language":"nb","title":"Hva er Ruff?","url":"https://engineer.company/nb/glossary/ruff/","version":1}