[🐛 Bug]: [py] linters, typing broken with selenium.webdriver lazy imports

[niklasmohrin]

Description

In our code we import from selenium.webdriver. Our code is checked with pylint which now throws error like:

E0611: No name 'ActionChains' in module 'selenium.webdriver' (no-name-in-module)

Notably, all tests still pass because the import works at runtime.

The PR introducing this is #16993. In a similar issue with pylint (pylint-dev/pylint#9553), the proposed solution was to provide .pyi files.

The context in which this occurred to me is here: https://redirect.github.com/e-valuation/EvaP/pull/2627

Reproducible Code

from selenium.webdriver import ActionChains

Debugging Logs

$ pylint --version
pylint 4.0.4
astroid 4.0.3
Python 3.13.7 (main, Aug 14 2025, 11:12:11) [GCC 14.3.0]
$ python -c 'from importlib.metadata import version; print(version("selenium"))'
4.41.0

---

ℹ️ Last known working version: 4.39.0

[selenium-ci]

@niklasmohrin, thank you for creating this issue. We will troubleshoot it as soon as we can.

Selenium Triage Team: remember to follow the Triage Guide

[Kakadus]

As a workaround from selenium.webdriver.common.action_chains import ActionChains works, but it would improve developer experience a lot, if typing works when importing from selenium.webdriver directly

[cgoldberg]

I have some ideas for fixing this.. I'm assigning it to myself and will submit a PR in a little while.

[cgoldberg]

@niklasmohrin @Kakadus Can you take a look at #17165?

My PR only adds a stub file for the main selenium.webdriver package. We still do lazy imports in some other sub-packages that may cause similar problems with type checkers. We will have to publish more comprehensive type stubs to address those if they are problematic.

It would also be very helpful if someone could test it to see if it solves this issue.

[cgoldberg]

I added the rest of the stub files to #17165. Once that is merged, all lazy imported classes and modules should expose type annotations correctly.