flash-linear-attention/pyproject.toml at main · fla-org/flash-linear-attention · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
[project]
name = "flash-linear-attention"
dynamic = ["version"]
description = "Fast Triton-based implementations of causal linear attention"
readme = "README.md"
authors = [
    { name = "Songlin Yang", email = "yangsl66@mit.edu" },
    { name = "Yu Zhang", email = "yzhang.cs@outlook.com" },
]
license = { file = "LICENSE" }
classifiers = [
    "Programming Language :: Python :: 3",
    "License :: OSI Approved :: MIT License",
    "Operating System :: OS Independent",
    "Topic :: Scientific/Engineering :: Artificial Intelligence",
]
requires-python = ">=3.10"
# torch and triton are NOT in base deps. Pick a backend extra
# ([cuda] / [rocm] / [xpu] / [cpu]) plus the matching --extra-index-url.
dependencies = [
    "transformers>=5.6.2,<6",
    "einops",
]

[project.optional-dependencies]
cuda = ["torch>=2.7.0", "triton>=3.3"]
# rocm / xpu intentionally don't pin a triton flavor: torch sourced from the
# matching PyTorch wheel index pulls the right one transitively (pytorch-triton-rocm
# on stable, triton-rocm on nightly, etc.).
rocm = ["torch>=2.7.0"]
xpu  = ["torch>=2.7.0"]
npu  = ["torch==2.10.0", "torch_npu==2.10.0.post7", "torchvision==0.25.0", "triton-ascend==3.6.0"]
cpu  = ["torch>=2.7.0", "triton>=3.3"]
tilelang = ["tilelang>=0.1.9"]
conv1d = ["causal-conv1d>=1.7.0"]
benchmark = ["matplotlib", "pandas", "datasets>=3.3.0"]
test = ["pytest", "pytest-xdist"]

[project.urls]
Homepage = "https://github.com/fla-org/flash-linear-attention"
Repository = "https://github.com/fla-org/flash-linear-attention"

[build-system]
requires = ["setuptools>=64", "wheel"]

[tool.setuptools.dynamic]
version = {attr = "fla.__version__"}

[tool.pytest.ini_options]
log_cli = true
log_cli_level = "INFO"
markers = [
    "smoke: core tests run in the dependent-files smoke tier on every PR push (fast feedback)",
]
pythonpath = [
  "."
]

[tool.ruff]
target-version = "py310"
line-length = 127


[tool.autopep8]
max-line-length = 127


[tool.ruff.lint]
select = [
    "E",    # pycodestyle
    "F",    # Pyflakes
    "UP",   # pyupgrade
    "B",    # flake8-bugbear
    "SIM",  # flake8-simplify
    "I",    # isort
    "C4",   # flake8-comprehensions
    "TCH",  # flake8-type-checking
    "T",    # flake8-debugger
]
ignore = [
    # pycodestyle (E)
    "E501",   # line-too-long: Triton kernels and benchmark tables often have long calls/shape lists.
    "E741",   # ambiguous-variable-name: math code commonly uses short symbols like l/I/O.

    # flake8-bugbear (B)
    "B023",   # function-uses-loop-variable: closures in generated/autotuned code may intentionally capture loop vars.
    "B006",   # mutable-argument-default: some APIs use defaults like []/{} for compatibility with existing call sites.
    "B007",   # unused-loop-control-variable: loops may keep named indices for shape/layout readability.
    "B008",   # function-call-in-default-argument: defaults sometimes depend on module-level factories/constants.
    "B028",   # no-explicit-stacklevel: warning locations are usually less important in tests/scripts.
    "B904",   # raise-without-from-inside-except: concise re-raise patterns are used in compatibility paths.
    "B905",   # zip-without-explicit-strict: many zips intentionally allow the pre-Python-3.10 default strict=False behavior.

    # flake8-comprehensions (C4)
    "C408",   # unnecessary-collection-call: dict()/list()/tuple() can be clearer when constructing dynamic values.
    "C416",   # unnecessary-comprehension: comprehensions may preserve structure for later filtering/debugging.
    "C417",   # unnecessary-map: map(...) is allowed when it mirrors functional or data-pipeline code.

    # flake8-debugger / print checks (T)
    "T201",   # print-found: benchmark, release, and CI helper scripts intentionally print progress and summaries.

    # flake8-type-checking (TC)
    "TC002",  # typing-only-third-party-import: moving imports behind TYPE_CHECKING can hide optional dependency failures.
    "TC003",  # typing-only-standard-library-import: runtime stdlib imports are cheap and often improve readability.

    # flake8-simplify (SIM)
    "SIM102", # collapsible-if: nested guards often document staged shape/device checks.
    "SIM108", # if-else-block-instead-of-if-exp: explicit branches are easier to debug around tensor setup.
    "SIM118", # in-dict-keys: explicit .keys() can be clearer when the object is mapping-like, not always a plain dict.
    "SIM211", # if-expr-with-false-true: keep explicit boolean expressions when they mirror config/env logic.

    # flake8-commas (COM)
    "COM812", # missing-trailing-comma: formatter/autofix tools should own trailing comma style.
]
extend-select = ["RUF022"]

[tool.ruff.lint.isort]
known-first-party = ["fla"]
force-sort-within-sections = false

[tool.isort]
profile = "black"
line_length = 127
known_first_party = ["fla"]
multi_line_output = 3
include_trailing_comma = true
force_grid_wrap = 0

[tool.ruff.lint.per-file-ignores]
"__init__.py" = ["F401"]
"fla/utils.py" = ["TCH004"]
"evals/harness.py" = ["I", "TCH"]
"tests/conftest.py" = ["E402", "I001"]
"tests/*/*.py" = ["UP030"]
"scripts/*.py" = ["C414"]
"legacy/training/flame/*.py" = ["C408"]