Skip to main content

Type annotations for the Traits package

Project description

The traits-stubs package contains external type annotations for the Traits package. These annotations can be used with static type checkers like mypy to type-check your Traits-using Python code.

Installation

  • To install from PyPI, simply use pip install traits-stubs.

  • To install from source, run pip install . from this directory.

Usage

You’ll usually want to install mypy (or another type checker) into your Python environment alongside these stubs. You can then use mypy from the command line to check a file or directory, for example with:

mypy <somefile.py>

Alternatively, some IDEs (including VS Code and PyCharm) can be configured to perform type checking as you edit.

Development

To test traits stubs locally:

  • Create a fresh venv and activate it, for example with:

    $ python -m venv --clear ~/.venvs/traits-stubs && source ~/.venvs/traits-stubs/bin/activate
  • Make sure all build-related packages are up to date

    $ python -m pip install –upgrade pip setuptools wheel

  • Install the Traits library into the environment (non-editable install)

    $ python -m pip install .

  • Install traits stubs in editable mode (from the repo, not from PyPI).

    $ python -m pip install -e traits-stubs/

  • Install mypy (or your favourite type checker)

    $ python -m pip install mypy

  • From the traits-stubs directory, run mypy on individual files in traits_stubs_tests/examples with e.g.,

    $ python -m mypy traits_stubs_tests/examples/completeness.py

  • From the traits-stubs directory, run the test suite with:

    $ python -m unittest discover -v traits_stubs_tests

Note: it’s easy to get confusing results if you accidentally use the wrong version of mypy. To avoid that, you can make sure that you don’t have mypy installed globally, and/or always invoke mypy using python -m mypy from within the environment.

Note: the unittest run can give the wrong result in the presence of a stale .mypy_cache. If you’re getting a pass where you expect to get a failure (or vice versa), try deleting the local cache and trying again.

Dependencies

This package depends on Traits.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

traits-stubs-6.4.0.tar.gz (20.1 kB view details)

Uploaded Source

Built Distribution

traits_stubs-6.4.0-py3-none-any.whl (45.6 kB view details)

Uploaded Python 3

File details

Details for the file traits-stubs-6.4.0.tar.gz.

File metadata

  • Download URL: traits-stubs-6.4.0.tar.gz
  • Upload date:
  • Size: 20.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.6

File hashes

Hashes for traits-stubs-6.4.0.tar.gz
Algorithm Hash digest
SHA256 a0b17cc6c3c93ef0e868a93283cd1af88ff6cba04a0e70e84147aa73b7bca43d
MD5 445de85c4695279f514e6f34ea0f8682
BLAKE2b-256 929695f2b69428c0b88aad1f201ff29b486947c417beb25ac494e0d977d09b4a

See more details on using hashes here.

File details

Details for the file traits_stubs-6.4.0-py3-none-any.whl.

File metadata

  • Download URL: traits_stubs-6.4.0-py3-none-any.whl
  • Upload date:
  • Size: 45.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.6

File hashes

Hashes for traits_stubs-6.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a97c4503cb9512a973896a7ed7757f71eed5dd2f6b3de0d4113c886a74d9da0d
MD5 ceab2bb75575c61ad489cc500450cc35
BLAKE2b-256 2f879a1769591c4f5254553ece9ed81c379885fdeefb07e6ea6598ece33eda34

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page