• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

pantsbuild / pants / 22507851448

27 Feb 2026 11:28PM UTC coverage: 92.928% (-0.007%) from 92.935%
22507851448

push

github

web-flow
silence new HdrHistogram induced deprecation warning on Python 3.14 (#23144)

No more:
```
/usr/lib/python3.14/ctypes/_endian.py:33: DeprecationWarning: Due to '_pack_', the
'ExternalHeader' Structure will use memory layout compatible with MSVC (Windows). If this is intended, set _layout_ to 'ms'. The
 implicit default is deprecated and slated to become an error in Python 3.19.
  super().__setattr__(attrname, value)
/usr/lib/python3.14/ctypes/_endian.py:33: DeprecationWarning: Due to '_pack_', the 'PayloadHeader' Structure will use memory
layout compatible with MSVC (Windows). If this is intended, set _layout_ to 'ms'. The implicit default is deprecated and slated
to become an error in Python 3.19.
  super().__setattr__(attrname, value)
```

0 of 1 new or added line in 1 file covered. (0.0%)

71 existing lines in 12 files now uncovered.

90912 of 97831 relevant lines covered (92.93%)

4.06 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

97.5
/src/python/pants/backend/python/lint/ruff/subsystem.py
1
# Copyright 2023 Pants project contributors (see CONTRIBUTORS.md).
2
# Licensed under the Apache License, Version 2.0 (see LICENSE).
3

4
from __future__ import annotations
10✔
5

6
import os.path
10✔
7
from collections.abc import Iterable
10✔
8
from enum import StrEnum
10✔
9

10
from packaging.version import parse
10✔
11

12
from pants.backend.python.util_rules import python_sources
10✔
13
from pants.core.goals.resolves import ExportableTool
10✔
14
from pants.core.util_rules.config_files import ConfigFilesRequest
10✔
15
from pants.core.util_rules.external_tool import TemplatedExternalTool
10✔
16
from pants.engine.platform import Platform
10✔
17
from pants.engine.rules import collect_rules
10✔
18
from pants.engine.unions import UnionRule
10✔
19
from pants.option.option_types import ArgsListOption, BoolOption, FileOption, SkipOption
10✔
20
from pants.util.strutil import softwrap
10✔
21

22

23
class RuffMode(StrEnum):
10✔
24
    FIX = "check --fix"
10✔
25
    FORMAT = "format"
10✔
26
    LINT = "check"
10✔
27
    # "format --check" is automatically covered by builtin linter for RuffFmtRequest.
28

29

30
# --------------------------------------------------------------------------------------
31
# Subsystem
32
# --------------------------------------------------------------------------------------
33

34

35
class Ruff(TemplatedExternalTool):
10✔
36
    options_scope = "ruff"
10✔
37
    name = "Ruff"
10✔
38
    help = "The Ruff Python formatter (https://github.com/astral-sh/ruff)."
10✔
39

40
    default_version = "0.14.14"
10✔
41
    default_known_versions = [
10✔
42
        "0.15.2|linux_arm64 |b1417ad2977d38c93a40cc77b467b4c68d6b5578031852c38033f9b53b26a543|10034015",
43
        "0.15.2|linux_x86_64|2b11788c9457ba8350f9b55bc302adf7f440d2f92a1d9660cbc3b20b6abf5e1c|10897947",
44
        "0.15.2|macos_arm64 |59a3a08a077e81d0fd99566604556687b834edb2da34a69522cfb5168a07123b|9712551",
45
        "0.15.2|macos_x86_64|78702adcccc2309696f19442f18b5fbe6a4bf4211efa157576c2b5f498a4cc0f|10479080",
46
        "0.14.14|linux_arm64 |a4d7302aa201a6f8e71dfa217cd8273fddd4e434a93ee3b4b07047fd7a684ac1|10071345",
47
        "0.14.14|linux_x86_64|55a1ee65f5ac9416cc40f99c2df62f0d4525d40369fe371caff945c495174d57|10976010",
48
        "0.14.14|macos_arm64 |76a9b0ebe57d0eee56940dbe0b62462578d1369cca8314ed0d2a6f2102292d4f|9770588",
49
        "0.14.14|macos_x86_64|749396c675c6f07205be6c4ef89e2e95123d790062d681059a355030e9d7d119|10540822",
50
        "0.13.3|linux_arm64 |4301d51fd2fbce6d4cc55613e5f8f96ee4fcb8dcaec8419023fe555575cf78f6|12440723",
51
        "0.13.3|linux_x86_64|8d24d74171772c67366d3187b990a3dc706022aa3a631b2a612d12e362f226c7|13639367",
52
        "0.13.3|macos_arm64 |a170ead9a9f03527dba3d2fb3e9e445f73d9efe3584c3307f3d30c6d5f31c487|12345660",
53
        "0.13.3|macos_x86_64|1c3a291a595ddd08398eb1e06fba883b7d8d715bd4255af5972f858fec8b4e57|13112788",
54
        "0.13.0|linux_arm64 |bdee6f1376470b74b1dc5ed48eca52ec9c3e4512bd7f3204e0df100f0bed4741|12137114",
55
        "0.13.0|linux_x86_64|b56ac90cc6987401bafdcf1b931ef044074c5b9451286afa4606a983f64f4fdd|13437622",
56
        "0.13.0|macos_arm64 |0d706798534537b6655b79fd95c2955c0a0013d4c54d36679d3306825a6bd6aa|12098971",
57
        "0.13.0|macos_x86_64|ac47ad1ac90f3070c064d2f5fceef4fe609fec7c073fd29d0814ed126c492e6d|12924617",
58
        "0.12.5|linux_arm64 |f147ccdbe26d35f2752c6d97d158bc8e3b4d1833d283748fc48f350c698a6f7b|11787954",
59
        "0.12.5|linux_x86_64|79beb4eac07beaea24774709eeb88a87115f1b53f857dcc1155431e642e01ade|12995071",
60
        "0.12.5|macos_arm64 |8819b61cff645c1d1671df331bb57c1ab230094b686942bccedde1f888feb522|11719060",
61
        "0.12.5|macos_x86_64|5af0b2931581a5ed91743c9f669c23cb0db9bb1f0c49f8695ad1443dbc6a9e50|12478716",
62
        "0.11.13|linux_arm64 |1ff8292d610302bc20791f6ab264de499b6d2fbf89030fef915908c564a78e82|10519905",
63
        "0.11.13|linux_x86_64|4540e8bc5b2af73c4b79e9e993724b044310eea4aa9003cf05ed4bdee6c25735|11609889",
64
        "0.11.13|macos_arm64 |7d5e8feea7ee5c3962807996cad557e8a0c4d676c1cba6223bfb0e8b2ca07723|10425890",
65
        "0.11.13|macos_x86_64|8dcc61306472f75c07af6d0446060e26227d773cee319d21900ac3a1d7bc4955|11085786",
66
        "0.11.5|linux_arm64 |77c11c7a70d3bf499915bab5a7691e955f4127164c4cfb7ef4e0773892ed2509|10318966",
67
        "0.11.5|linux_x86_64|067c1c6c4d6033b65fe788f5310075686110b286a102431fb19883c079e2fca1|11413549",
68
        "0.11.5|macos_arm64 |4a5b1a44412bda817debb67d826a565f11b235744870b509f44102403a3a9e89|10228748",
69
        "0.11.5|macos_x86_64|c28725c6421d5834b2cd16c7b13c3831b3363d6d558448d7dd3e0aa695551f94|10882726",
70
        "0.11.0|linux_arm64 |60904d6d51b1a8dd49ab948dd1de33ce439ca872c82faa5dab90fce838539317|10313237",
71
        "0.11.0|linux_x86_64|3148cd8131ec4f525551b16a57186f5533c705950269cbee7674d484ca6eefe5|11412993",
72
        "0.11.0|macos_arm64 |09ea313f2aab3844432b46c6c5e3e066b26ae4953f4bac1e545176e5dea22306|10239274",
73
        "0.11.0|macos_x86_64|a208dee9c1a7a063dace746836fd2d7e5f7694d2142700d3964fccf141ada555|10861900",
74
        "0.10.0|linux_arm64 |7b9fe2e2cecde897fb35a1a0bb1ccd10dde3395acd81aea7e5e6b0b24824e7c7|10305951",
75
        "0.10.0|linux_x86_64|5e949f667a1dd76ab4382ba713fed3390ddc6088147ba0eb70fd8aa2ec564751|11399512",
76
        "0.10.0|macos_arm64 |1da279b8302cd86f50d38fc8ad62cd12f4d07c0c402c13a3bac7dc244c7db138|10224628",
77
        "0.10.0|macos_x86_64|2388af7881c7e50026388e953fa6eab7c1ae94c868926a6185c3cb38f9f15aa2|10862770",
78
        "0.9.10|linux_arm64 |c131df77457ed45aa44b617194563ceea2e29e595c42d06804e04155529423b4|10245226",
79
        "0.9.10|linux_x86_64|15e93ee078beb5ec24d1afb02a1cce2a873ac627d378c987adda4f6ab3b5f886|11373081",
80
        "0.9.10|macos_arm64 |1fccbd53431eaa596f2322494edbdc444f99db651566188fa0a9820c26bbef77|10147621",
81
        "0.9.10|macos_x86_64|1e5080489fdf483e7111bb1575f045ec13da2fdbfc6ac5fd58b5d55cf9cd7668|10838186",
82
        "0.9.6|linux_arm64 |8f64e97deae1c12f659fd13e6e14d78cf15ed876d1548ac76b235f78ab5803e1|11929444",
83
        "0.9.6|linux_x86_64|c725f57aa11d636f1d7f0f378c604d4db29c4dbb5ff0578f9fbbc578364875df|12568611",
84
        "0.9.6|macos_arm64 |a3132eb5e3d95f36d378144082276fbed0309789dadb19d8a4c41ec5e80451fb|11124436",
85
        "0.9.6|macos_x86_64|ec88c095036b25e95391ea202fcc9496d565f4e43152db10785eb9757ea0815d|11663591",
86
        "0.8.6|linux_arm64 |23c5d1dd7eed23d2bd6d340df05a068030e267db28150892a72e3dc97b175164|10868993",
87
        "0.8.6|linux_x86_64|a691c78f045f7202b15620939c4b087f301afe884e42d09a19725f61581aa887|11329234",
88
        "0.8.6|macos_arm64 |d24cfe247de2bfd90d7f0604196247b680e1db5b6c8427cf6e540c38044526f7|10005432",
89
        "0.8.6|macos_x86_64|3ff48d180472a1aee6385ba43606ba6a5a6ab89f16a3ca8ccb234966fe3698c1|10374010",
90
        "0.7.4|linux_arm64 |329ddf6bb4f34fbcba273ecb1460280aa2ad92150a94f58110861b3c4453ce35|10703090",
91
        "0.7.4|linux_x86_64|38ff38639f33764acf2cf3c3252e2a214b7f5fedafa67c50909926297dba9229|11172665",
92
        "0.7.4|macos_arm64 |af9583bff12afbca5d5670334e0187dd60c4d91bc71317d1b2dde70cb1200ba9|9882883",
93
        "0.7.4|macos_x86_64|9762afafafacd801eb95a086dcd3359075ab5cc4cd1371b7ff0550c44ac4e47c|10223356",
94
        "0.7.2|linux_arm64 |f9342fcca6b58143f316ef3e617f39334edb4c3d15fced5220bd939685f6261d|10651691",
95
        "0.7.2|linux_x86_64|b769e11a3e23a72692cb97ed762ff28e48534972a8ef447fd5b0d3178a56ffd8|11097578",
96
        "0.7.2|macos_arm64 |1c9f5a4fc815330d01fd8a56a7a70114ff3ed149bd997ff831524313705ba991|9802953",
97
        "0.7.2|macos_x86_64|5815756947d0a7b1d90805b07ffb2c376c8a9800e9462d545839dc0d79a091d2|10162492",
98
        "0.6.9|linux_arm64 |73df3729a3381d0918e4640aac4b2653c542f74c7b7843dee8310e2c877e6f2e|10724239",
99
        "0.6.9|linux_x86_64|39a1cd878962ebc88322b4f6d33cae2292454563028f93a3f1f8ce58e3025b07|11000553",
100
        "0.6.9|macos_arm64 |b94562393a4bf23f1a48521f5495a8e48de885b7c173bd7ea8206d6d09921633|9697031",
101
        "0.6.9|macos_x86_64|34aa37643e30dcb81a3c0e011c3a8df552465ea7580ba92ca727a3b7c6de25d1|10018168",
102
        "0.6.4|linux_arm64 |a9157a0f062d62c1b1582284a8d10629503f38bc9b7126b614cb7569073180ff|10120541",
103
        "0.6.4|linux_x86_64|3ca04aabf7259c59193e4153a865618cad26f73be930ce5f6109e0e6097d037b|10373921",
104
        "0.6.4|macos_arm64 |2648dd09984c82db9f3163ce8762c89536e4bf0e198f17e06a01c0e32214273e|9167424",
105
        "0.6.4|macos_x86_64|4438cbc80c6aa0e839abc3abb2a869a27113631cb40aa26540572fb53752c432|9463378",
106
        "0.5.7|linux_arm64 |2509d20ef605fb1c8af37af1f46fefc85e1d72add6e87187cb6543420c05dfb1|9991080",
107
        "0.5.7|linux_x86_64|9a5580536ef9cea7d8e56be8af712ac5cd152c081969ece2fbc3631b30bbb5e8|10263458",
108
        "0.5.7|macos_arm64 |b78a09f44dc60d8c894aba6cad55abd3b0eccc0992d60a86f74155fc459e227b|8256430",
109
        "0.5.7|macos_x86_64|1f9a7d307f191781fc895947af21d32f8c810c5a5a4cdff16ac53d88a14acd69|8662539",
110
        "0.4.10|linux_arm64 |75332c97520233b5f95cb3d40bdef13b40e1aa5e6c82a078623993545771f55f|9851689|https://github.com/astral-sh/ruff/releases/download/v0.4.10/ruff-0.4.10-aarch64-unknown-linux-musl.tar.gz",
111
        "0.4.10|linux_x86_64|332ba368c6e08afc3c5d1c7f6e4fb7bf238b7cbf007b400e6bdf01a0a36ae656|10130989|https://github.com/astral-sh/ruff/releases/download/v0.4.10/ruff-0.4.10-x86_64-unknown-linux-musl.tar.gz",
112
        "0.4.10|macos_arm64 |5a4ff81270eee1efa7901566719aca705a3e8d0f1abead96c01caa4678a7762e|8094319|https://github.com/astral-sh/ruff/releases/download/v0.4.10/ruff-0.4.10-aarch64-apple-darwin.tar.gz",
113
        "0.4.10|macos_x86_64|6e96f288d13b68863e79c9f107a0c51660215829726c9d3dc4879c1801fa3140|8490153|https://github.com/astral-sh/ruff/releases/download/v0.4.10/ruff-0.4.10-x86_64-apple-darwin.tar.gz",
114
        "0.4.9|linux_arm64 |00c50563f9921a141ddd4ec0371149f3bbfa0369d9d238a143bcc3a932363785|8106747|https://github.com/astral-sh/ruff/releases/download/v0.4.9/ruff-0.4.9-aarch64-unknown-linux-musl.tar.gz",
115
        "0.4.9|linux_x86_64|5ceba21dad91e3fa05056ca62f278b0178516cfad8dbf08cf2433c6f1eeb92d3|8863118|https://github.com/astral-sh/ruff/releases/download/v0.4.9/ruff-0.4.9-x86_64-unknown-linux-musl.tar.gz",
116
        "0.4.9|macos_arm64 |5f4506d7ec2ae6ac5a48ba309218a4b825a00d4cad9967b7bbcec1724ef04930|8148128|https://github.com/astral-sh/ruff/releases/download/v0.4.9/ruff-0.4.9-aarch64-apple-darwin.tar.gz",
117
        "0.4.9|macos_x86_64|e4d745adb0f5a0b08f2c9ca71e57f451a9b8485ae35b5555d9f5d20fc93a6cb6|8510706|https://github.com/astral-sh/ruff/releases/download/v0.4.9/ruff-0.4.9-x86_64-apple-darwin.tar.gz",
118
        "0.3.7|linux_arm64 |0e79fbefcd813a10fa60250441bbe36978c95d010b64646848fada64b9af61f0|8180808|https://github.com/astral-sh/ruff/releases/download/v0.3.7/ruff-0.3.7-aarch64-unknown-linux-musl.tar.gz",
119
        "0.3.7|linux_x86_64|3f8348096f7d9c0a9266c4a821dbc7599ef299983e456b61eb0d5290d8615df8|8905370|https://github.com/astral-sh/ruff/releases/download/v0.3.7/ruff-0.3.7-x86_64-unknown-linux-musl.tar.gz",
120
        "0.3.7|macos_x86_64|b1c961c1bed427e74ab72950c6debcb078c82aba0ee347183cc27a9fc8aaa43b|8615221|https://github.com/astral-sh/ruff/releases/download/v0.3.7/ruff-0.3.7-x86_64-apple-darwin.tar.gz",
121
        "0.2.2|linux_arm64 |e73a37f41acf4a4f44cdb9b587316f0f9eb83b51c3c134d1401501e3f8d65dee|7247275|https://github.com/astral-sh/ruff/releases/download/v0.2.2/ruff-0.2.2-aarch64-unknown-linux-musl.tar.gz",
122
        "0.2.2|linux_x86_64|044e4dbd46acc12de78a144c24fd9af86003eaba28e83244546d85076a9c7b04|7881552|https://github.com/astral-sh/ruff/releases/download/v0.2.2/ruff-0.2.2-x86_64-unknown-linux-musl.tar.gz",
123
        "0.2.2|macos_arm64 |21454a77f0a5ff8ed23a43327f6de9c2f9f6bab1352ebe87fc03866889fa7fae|7262889|https://github.com/astral-sh/ruff/releases/download/v0.2.2/ruff-0.2.2-aarch64-apple-darwin.tar.gz",
124
        "0.2.2|macos_x86_64|798a2028a783f10f21f11eb59763eabcff9961d4302cdcc37d186ab9f864ca82|7611899|https://github.com/astral-sh/ruff/releases/download/v0.2.2/ruff-0.2.2-x86_64-apple-darwin.tar.gz",
125
        "0.1.15|linux_arm64 |e9ed3c353c4f2b801ed4d21fee2b6159883ad777e959fbbad0b2d2b22e1974c7|7049764|https://github.com/astral-sh/ruff/releases/download/v0.1.15/ruff-0.1.15-aarch64-unknown-linux-musl.tar.gz",
126
        "0.1.15|linux_x86_64|d7389b9743b0b909c364d11bba94d13302171d751430b58c13dcdf248e924276|7605249|https://github.com/astral-sh/ruff/releases/download/v0.1.15/ruff-0.1.15-x86_64-unknown-linux-musl.tar.gz",
127
        "0.1.15|macos_arm64 |373c648d693ddaf4f1936a05d3093aabd08553f585c3c3afbbdba41d16b70032|7025376|https://github.com/astral-sh/ruff/releases/download/v0.1.15/ruff-0.1.15-aarch64-apple-darwin.tar.gz",
128
        "0.1.15|macos_x86_64|6d006dc427a74cba930717297b0c472856a2be4cfc37cd04309895c11329dc68|7308240|https://github.com/astral-sh/ruff/releases/download/v0.1.15/ruff-0.1.15-x86_64-apple-darwin.tar.gz",
129
    ]
130
    version_constraints = ">=0.1.2,<1"
10✔
131

132
    default_url_template = (
10✔
133
        "https://github.com/astral-sh/ruff/releases/download/{version}/ruff-{platform}.tar.gz"
134
    )
135
    default_url_platform_mapping = {
10✔
136
        # NB. musl not gnu, for increased compatibility
137
        "linux_arm64": "aarch64-unknown-linux-musl",
138
        "linux_x86_64": "x86_64-unknown-linux-musl",
139
        "macos_arm64": "aarch64-apple-darwin",
140
        "macos_x86_64": "x86_64-apple-darwin",
141
    }
142

143
    def generate_exe(self, plat: Platform) -> str:
10✔
144
        # Older versions like 0.4.x just have the binary at the top level of the tar.gz, newer
145
        # versions nest it within a directory with the platform.
146
        if parse(self.version) < parse("0.5.0"):
4✔
UNCOV
147
            return "./ruff"
×
148

149
        return f"ruff-{self.default_url_platform_mapping[plat.value]}/ruff"
4✔
150

151
    skip = SkipOption("fmt", "fix", "lint")
10✔
152
    args = ArgsListOption(example="--exclude=foo --ignore=E501")
10✔
153
    config = FileOption(
10✔
154
        default=None,
155
        advanced=True,
156
        help=softwrap(
157
            f"""
158
            Path to the `pyproject.toml` or `ruff.toml` file to use for configuration
159
            (https://github.com/astral-sh/ruff#configuration).
160

161
            Setting this option will disable `[{options_scope}].config_discovery`. Use
162
            this option if the config is located in a non-standard location.
163
            """
164
        ),
165
    )
166
    config_discovery = BoolOption(
10✔
167
        default=True,
168
        advanced=True,
169
        help=softwrap(
170
            f"""
171
            If true, Pants will include any relevant config files during
172
            runs (`pyproject.toml`, and `ruff.toml`).
173

174
            Use `[{options_scope}].config` instead if your config is in a
175
            non-standard location.
176
            """
177
        ),
178
    )
179

180
    def config_request(self, dirs: Iterable[str]) -> ConfigFilesRequest:
10✔
181
        # See https://github.com/astral-sh/ruff#configuration for how ruff discovers
182
        # config files.
183
        all_dirs = ("", *dirs)
4✔
184
        return ConfigFilesRequest(
4✔
185
            specified=self.config,
186
            specified_option_name=f"[{self.options_scope}].config",
187
            discovery=self.config_discovery,
188
            check_existence=[os.path.join(d, "ruff.toml") for d in all_dirs],
189
            check_content={os.path.join(d, "pyproject.toml"): b"[tool.ruff" for d in all_dirs},
190
        )
191

192

193
def rules():
10✔
194
    return (
4✔
195
        *collect_rules(),
196
        *python_sources.rules(),
197
        UnionRule(ExportableTool, Ruff),
198
    )
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc