How can I package type stubs for another package?

Question

The Python package Flask-HTTPAuth does and likely will not have type annotations (source). I would like to create them and provide them as a package on mypy, without forking the project. I've created a flask-httpauth-stubs package.

What do I need to do to tell mypy that this package provides the stubs for Flask-HTTPAuth?

How I test

code.py:

from flask_httpauth import HTTPAuth

def autho(a: HTTPAuth):
    return a.get_auth()

Then:

$ pip install flask_httpauth flask_httpauth-stubs

$ mypy code.py

code.py:1: error: Skipping analyzing 'flask_httpauth': found module but no type hints or library stubs
code.py:1: note: See https://mypy.readthedocs.io/en/latest/running_mypy.html#missing-imports
Found 1 error in 1 file (checked 1 source file)

I've also tried renaming the package to flask_httpauth-stubs in case the CASE or the dash/underscore matters. Same result.

Answer 1

Your attempt seems to be otherwise just perfect, but there was a minor error in naming of the Python package that was installed by your stubs distribution package. Since the code is in a Python package named "flask_httpauth" (with an underscore) the stubs must be in a Python package named "flask_httpauth-stubs", i.e. exactly same name with "-stubs" appended.

I created a pull request which fixes your stubs package: https://github.com/MartinThoma/flask-httpauth-stubs/pull/1

I checked that your example code.py can be type checked just fine when the stubs are installed with this minor change:

$ mypy code.py 
Success: no issues found in 1 source file