Pythonista Stubs

Stubs for the Pythonista iOS API. This allows for better error detection and IDE / editor autocomplete.

Installation and Usage

Install using your preferred package manager:

# Using uv (recommended)
uv add pythonista-stubs

# Using pip
pip install pythonista-stubs

You can now develop from your computer editor with proper typing and completions.

API Coverage

Built With

• mypy
• Typing Extensions

PEPs

• PEP 484 -- Type Hints
• PEP 561 -- Distributing and Packaging Type Information
• PEP 3107 -- Function Annotations

Troubleshooting

Type Checker Not Finding Stubs

• VSCode: Ensure the Python extension is using the correct interpreter where pythonista-stubs is installed
• PyCharm: Check that the stub package appears in your project's external libraries
• mypy: Make sure mypy can find the stubs in your Python path

Import Errors in IDE

• Verify pythonista-stubs is installed in the same environment as your project
• Try restarting your IDE after installation
• Check that your IDE is using the correct Python interpreter

Contributing

Please file a bug report for any issues you find. Even more excellent than a good bug report is a fix for a bug, or the implementation of a much-needed stub. We'd love to have your contributions.

Code of Conduct

Everyone participating in this community is expected to treat other people with respect and more generally to follow the guidelines articulated in the Python Community Code of Conduct.

Authors

• Harold Martin - harold.martin at gmail
• Dmytro Yaroshenko

Disclaimer

This is not an official project and is not associated with omz:software

License

Apache License 2.0