{"canonical_url":"https://engineer.company/da/glossary/ruff/","content_markdown":"# Ruff\n\n## Hvad det er\n\nRuff er et enkelt kommandolinjeprogram, skrevet i Rust, der holder\nPython-kildekode op mod et katalog af lintregler og omskriver dens layout til én\nensartet stil. Bag det står Astral, firmaet bag uv og ty, og to af\nunderkommandoerne klarer det daglige arbejde: `ruff check` er linteren, og\n`ruff format` er formatteren. Ruff hævder at køre 10 til 100 gange hurtigere end\nFlake8 og Black, gemmer en cache, så uændrede filer ikke bliver analyseret igen,\nog kan træde i stedet for Flake8 med snesevis af plugins, Black, isort,\npydocstyle, pyupgrade og autoflake.\n\nLinteren har over 900 regler, mange af dem genskrevet fra populære\nFlake8-plugins. Hver regel har en kode af et kort præfiks og tre cifre, og\npræfikset fortæller, hvor reglen kommer fra: F401, en ubrugt import, stammer fra\nPyflakes, og E501, en linje der er for lang, fra pycodestyle. En konfiguration\nvælger regler ud fra koderne, én ad gangen eller efter præfiks, så\n`select = [\"E\", \"F\"]` slår hver regel til, hvis kode begynder med E eller F, og\nden særlige vælger `ALL` slår alt til. Mange regler har en rettelse med, delt op\ni sikre rettelser, der skal bevare adfærden ved kørsel, og usikre, der kan ændre\nden; `ruff check --fix` anvender kun den sikre slags, medmindre `--unsafe-fixes`\nogså er angivet.\n\nFormatteren er bygget som en direkte erstatning for Black. På kodebaser som\nDjango og Zulip kommer over 99,9 % af linjerne ud identisk, men dokumentationen\nsiger ligeud, at de to ikke er beregnet til at blive skiftet frem og tilbage på\nden samme kode. Ligesom Black springer den områder over, der er indrammet af\n`# fmt: off` og `# fmt: on`.\n\nBegge halvdele læser den samme konfiguration, som ligger under `[tool.ruff]` i\n`pyproject.toml` eller i en `ruff.toml`- eller `.ruff.toml`-fil. Hver Python-fil\ntjekkes mod den nærmeste konfigurationsfil over den, og den fil bruges hel: Ruff\nfletter intet ind fra overliggende mapper, medmindre den nærmeste fil peger på\nsin forælder med `extend`. Indstillinger på kommandolinjen går forud for alle\nfiler. Uden indstillinger må en linje være 88 tegn, som i Black, og den\nPython-version, reglerne går ud fra, hentes fra projektets\n`requires-python`-felt, når ingen konfiguration angiver en.\n\n## Hvorfor det betyder noget\n\nHastighed afgør, hvor et tjek får lov at køre. En linter, der er så langsom, at\nden afbryder folk, bliver skubbet ud i continuous integration, hvor den melder\nsig, efter at forfatteren er gået videre. En, der svarer hurtigt, kan køre i\neditoren og i en commit-hook, mens ændringen stadig er frisk.\n\nSamling fjerner uenighed mellem værktøjer. Et projekt, der linter med Flake8 og\nplugins, sorterer imports med isort og formaterer med Black, skal holde flere\nkonfigurationer og versionslåse i takt. Ruff giver én konfiguration, én version\nat låse og én nummerering af regler, og projektet offentliggør listen over de\nlintregler, der strides med dets egen formatter, så de to kan bringes til at\nstemme overens med vilje.\n\nExitkoderne gør Ruff til en kvalitetsport uden indpakning. `ruff check`\nafslutter med 0, når der ikke er nogen overtrædelser tilbage, eller alle blev\nrettet, med 1, når der stadig er overtrædelser, og med 2, når konfigurationen\neller kommandolinjen er ugyldig, eller Ruff selv går ned, ligesom ESLint og\nPrettier gør. `ruff format --check` afslutter med 1, når en fil ville blive\nomformateret. En regel er enten valgt eller slået fra, og enhver valgt regel,\nder slår ud, sætter exitkoden til 1.\n\nPrisen er, at regelsættet er en beslutning, som nogen skal eje. Ruffs egne råd\ner at liste reglerne eksplicit med `select` i stedet for at stable\n`extend-select`, at starte med E og F og tilføje én gruppe ad gangen og at bruge\n`ALL` med omtanke, fordi den slår nye regler til ved hver opgradering.\n\n## Sådan ser det ud i praksis\n\nRuff dækkede Python i\n[en zero-warnings-standard på tværs af seks sprog](/da/portfolio/set-a-zero-warnings-bar-across-six-languages/),\nhvor hvert sprog havde sin egen linter. Hver diagnostik talte som en fejl, og\ninline-undertrykkelser var forbudt, hvilket for Ruff udelukker\n`# noqa`-kommentaren: et fund i Python kunne rettes i koden og på ingen anden\nmåde. Pre-commit- og pre-push-hooks kørte linterne og testene, så tjekket kørte,\nfør en commit fandtes.\n\nI den dokumenterede værktøjsopsætning fra oktober 2026 havde Ruff en mindre\nopgave på dette site: de 22 hjælpescripts ved siden af Hugo-buildet.\n[Kolofonen](/da/credits/) nævner Ruff blandt de værktøjer, der holder kilden\nærlig. Regelsættet i `pyproject.toml` er målt frem for valgt. Hver af Ruffs 54\nregelfamilier blev den 15. oktober 2026 kørt mod scriptene, 39 af dem meldte\nintet, og de tavse familier, hvis emne er netop denne kode, blev føjet til de\noprindelige elleve, så udvalget nu tæller 33. Sikkerhedsfamilien, S, er slået\ntil med fem regler ignoreret efter kode, hver med en kommentar om, hvorfor det\nmønster, der slår ud her, er den sikre tvilling til et farligt, så familiens\nøvrige regler stadig kan stoppe en commit. Tre Ruff-specifikke regler om\ntvetydige Unicode-tegn er ignoreret, fordi sitets tekst med vilje bruger rigtige\ntankestreger og danske bogstaver.\n\nPre-commit-konfigurationen kører `ruff check` og `ruff format --check` på hver\nPython-fil under `scripts/`, som en commit rører, og projektets fix-task kører\nde samme to kommandoer i deres rettende form. Ved siden af Ruff står\nbasedpyright, en typechecker, med en kommentar, der trækker grænsen mellem dem:\nen linter følger ikke en værdi på tværs af en funktionsgrænse, og ved sin første\nkørsel fandt typecheckeren to reelle fejl, som Ruff havde godkendt.\n\n## Hvor det går galt\n\nDet meste besvær med Ruff kommer af en konfiguration, der er mere bogstavelig\nend de mennesker, der skrev den.\n\n**En opgradering får en urørt branch til at fejle.** Kode, der bestod i går,\nmelder nye overtrædelser, efter at Ruff er blevet opdateret. Den sædvanlige\nårsag er `select = [\"ALL\"]`, der tager hver regel med, som en udgivelse\ntilføjer, sammen med en version, der flyder. Lås Ruff-versionen, så en\nopgradering er en commit, som nogen reviewer, og list de familier, projektet vil\nhave, i stedet for `ALL`, så en ny familie først kommer med, når nogen tilføjer\nden.\n\n**Én mappe holder op med at følge projektets regler.** Overtrædelser, som\nrodkonfigurationen forbyder, slipper igennem i en undermappe, eller en regel,\nteamet slog fra, slår ud dér. En `ruff.toml` eller en `pyproject.toml` med en\n`[tool.ruff]`-tabel ligger i mappen, og fordi Ruff bruger den nærmeste fil hel,\nholder alle rodindstillinger op med at gælde under den.\n`ruff check --show-settings` på en fil dér udskriver stien til de indstillinger,\nden endte med. Slet den indlejrede fil, eller lad den arve med\n`extend = \"../pyproject.toml\"`.\n\n**En undertrykkelse overlever sin grund.** En `# noqa`-kommentar kom ind af en\ngod grund, koden ændrede sig, og nu skjuler kommentaren ingenting eller det\nnæste problem på linjen. En bar `# noqa` er værre: den gør alle regler på linjen\ntavse. Vælg RUF100, der melder `noqa`-kommentarer, som ikke længere undertrykker\nnoget, og PGH004, der kræver en bestemt kode, og lad `--fix` fjerne de døde. Her\ner importen siden kommet i brug, så kommentaren beskytter ingenting, og RUF100\nmelder den:\n\n```python\nimport json  # noqa: F401\n\nprint(json.dumps({\"ok\": True}))\n```\n\n**Formatteren og linteren er uenige.** `ruff format` omskriver en fil, og\n`ruff check` markerer bagefter resultatet. Nogle lintregler kontrollerer det,\nformatteren bestemmer, som afsluttende kommaer (COM812), indrykning (W191, E111)\nog anførselstegn (Q-reglerne), og formatteren gør kun et bedste forsøg på\nlinjelængden, så E501 kan stadig slå ud på formateret kode. Læs de advarsler,\n`ruff format` skriver ud, for en kørsel uden dem er dokumentationens egen prøve\npå, at de to er enige, ignorér enhver regel, en advarsel nævner, og tag E501 som\net signal til at bygge linjen om.\n\n**En samlet rettelse ændrer adfærd.** Efter `ruff check --fix --unsafe-fixes`\nover hele træet fejler testene, eller en fejlhåndtering holder op med at fange\ndet, den plejede. Usikre rettelser må gerne ændre adfærden ved kørsel eller\nfjerne kommentarer, og dokumentationens eget eksempel ændrer, hvilken undtagelse\net stykke kode kaster. Hold `--unsafe-fixes` ude af hooks og scripts, anvend\nusikre rettelser én regel ad gangen med `--select` og læs diffen, og forfrem kun\nen regel med `extend-safe-fixes`, når teamet har tjekket den.\n\n## Læs mere\n\n- [Ruff](https://docs.astral.sh/ruff/) — hvad Ruff erstatter, hvor hurtigt det\n  hævder at være, og hvem der vedligeholder det.\n- [The Ruff Linter](https://docs.astral.sh/ruff/linter/) — regelvalg og forrang,\n  sikre og usikre rettelser, `noqa`-kommentarer og exitkoder.\n- [The Ruff Formatter](https://docs.astral.sh/ruff/formatter/) — kompatibilitet\n  med Black og de lintregler, der strides med formateringen.\n- [Rules](https://docs.astral.sh/ruff/rules/) — hver regel efter kode, dens\n  oprindelse, og om den kan rettes automatisk.\n- [Configuring Ruff](https://docs.astral.sh/ruff/configuration/) — hvordan\n  filerne findes, reglen om den nærmeste fil, `extend` og kommandolinjens\n  indstillinger.\n\n\u003chttps://engineer.company/da/glossary/ruff/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Hvordan Ruff linter og formaterer Python fra ét program, hvordan regler vælges efter kode, og hvorfor en indlejret konfigurationsfil sætter reglerne ud af spil.","formats":{"gemtext":"https://engineer.company/da/glossary/ruff/index.gmi","gopher":"https://engineer.company/da/glossary/ruff/gophermap","html":"https://engineer.company/da/glossary/ruff/","json":"https://engineer.company/da/glossary/ruff/index.json","markdown":"https://engineer.company/da/glossary/ruff/index.md","pdf":"https://engineer.company/da/glossary/ruff/index.pdf"},"kind":"page","language":"da","title":"Hvad er Ruff?","url":"https://engineer.company/da/glossary/ruff/","version":1}