`invenio-typing-stubs`

This is a package that provides typing support for the InvenioRDM source base. It is intended as a temporary solution until InvenioRDM itself provides typing support.

As such, it is a collection of type stubs for the InvenioRDM source base, as well as some utility functions to help with typing.

It must not contain any runtime code, it is intended to be used only for type checking.

Warning

These stubs were generated mostly automatically and only some have been manually checked. They will surely contain some errors. Please report any issues you find.

Usage

Please install the package directly from github:

pip install git+https://github.com/oarepo/invenio-typing-stubs.git

If you add the dependency to your pyproject.toml built with hatchling, do it like:

[project.optional-dependencies]
dev = [
    "invenio-typing-stubs @ git+https://github.com/oarepo/invenio-typing-stubs.git",
]

How it was generated

Automatic generation

Copilot with GPT-5 was used to generate the stubs. The following prompt was used:

There is a agent_helper command that will give you work. Please call the command as 
`.venv/bin/python agent_helper.py invenio_communities`. 

The output of the command are the instructions that you should do. 
Read them carefully and execute them. 

After that, continue calling the agent and processing the instructions 
until it will tell you that all work has been done.

Manual checks

Some manual checks were done to ensure the stubs are correct. Systemfields were patched manually to ensure correct typing.

Problems

Typing for SQL Alchemy mostly does not work with invenio_db.

Final checks

Checked with

mypy --check-untyped-defs --ignore-missing-imports invenio_records_resources-stubs/

Metadata

Release files for oarepo-invenio-typing-stubs 0.1.39

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

Source distribution (sdist)

Source distribution for oarepo-invenio-typing-stubs 0.1.39
File	Size	Uploaded
oarepo_invenio_typing_stubs-0.1.39.tar.gz	165.4 kB	Oct 4, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for oarepo-invenio-typing-stubs 0.1.39
File	Interpreter	ABI	Platform	Reset
oarepo_invenio_typing_stubs-0.1.39-py3-none-any.whl 430.4 kB Oct 4, 2026	Python 3	none	any	Details

Total release size: 595.8 kB

Release files / oarepo_invenio_typing_stubs-0.1.39.tar.gz

Download URL	oarepo_invenio_typing_stubs-0.1.39.tar.gz
Size	165.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`02875f95f28264843ffb9caeabe1156766a45650330d3ff98c018cb274278e7d`
BLAKE2b-256 checksum How to use checksums	`8baa2a87560c4e423d7f78f37446a68f5fec4268e4a3948f1b689ad83ca535f6`
Upload date	Oct 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / oarepo_invenio_typing_stubs-0.1.39-py3-none-any.whl

Download URL	oarepo_invenio_typing_stubs-0.1.39-py3-none-any.whl
Size	430.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`680d89e4e530b3476dc8514408dbe794da676cd5d474c84f4ef24b5971aa8bc3`
BLAKE2b-256 checksum How to use checksums	`6f91a69495ae36769feb489ea12c268b0e0946d304bbfc2e00eb380d552f5bfe`
Upload date	Oct 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`