iStub

Validator for type annotations.

Code style checking with flake8 and ruff
Type checking with mypy and pyright
Type consistency checking with mypy.stubtest

Usage

Basic usage

Let's assume that you want to check mylib-stubs package against mylib

Create a file istub.yml in your project root:

packages:
  - name: mylib
    path: ./mylib-stubs
    checks:
      mypy: true
      stubtest: true

Run checker:

python -m istub

You can create a whitelist of acceptable errors:

python -m istub --update

Custom configuration

packages:
  - name: mylib
    path: ./mylib-stubs
    checks:
      mypy: true
      stubtest: true
      flake8: false
      pyright: false
      ruff: false
    pip_install:
      - pypi_dependency
      - pypi_dependency2
    pip_uninstall:
      - dependency_to_uninstall
    build:
      - ./build_cmd.sh

Latest changes

Full changelog can be found in Releases.

Versioning

istub version follows PEP 440 format.

Support and contributing

Please reports any bugs or request new features in istub repository.

Metadata

Release files for istub 0.2.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for istub 0.2.5
File	Size	Uploaded
istub-0.2.5.tar.gz	56.3 kB	Oct 11, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for istub 0.2.5
File	Interpreter	ABI	Platform	Reset
istub-0.2.5-py3-none-any.whl 15.9 kB Oct 11, 2025	Python 3	none	any	Details

Total release size: 72.2 kB

Release files / istub-0.2.5.tar.gz

Download URL	istub-0.2.5.tar.gz
Size	56.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`81f5d3c7f748d3043ba5194d48e053c42b31af355f147b11166e723d7db3c5e9`
BLAKE2b-256 checksum How to use checksums	`d6055316d594a0f6df60351429d58f9b37ab62a0266a3c653863e6d85da1f1b5`
Upload date	Oct 11, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.9.2`

Release files / istub-0.2.5-py3-none-any.whl

Download URL	istub-0.2.5-py3-none-any.whl
Size	15.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a7d5e449f54c2c020bb9e1778968e35f100293b9cbc7fcff6ca5629a74a0b4ab`
BLAKE2b-256 checksum How to use checksums	`1471e463c23cdcbf982764c9f6088047719d7f5ec592cb86ca98c48746e66e60`
Upload date	Oct 11, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.9.2`