A plugin to help understand Napari UI components and check their source code definition
Project description
napari-ui-tracer
A plugin to help understand Napari UI components and locate their code definition
This napari plugin was generated with Cookiecutter using @napari's cookiecutter-napari-plugin template.
Installation
You can install napari-ui-tracer
via pip:
pip install napari-ui-tracer
To install latest development version :
pip install git+https://github.com/dalthviz/napari-ui-tracer.git
Usage
-
Show the plugin inside the napari interface:
-
You can launch napari with the plugin visible running:
napari -w napari-ui-tracer
-
Or select it from
Plugins > Napari UI tracer widget
-
-
Check the
Enable Qt event filter
checkbox:- Use
Ctrl/Cmd + Mouse button right click
to see the information available about any widget inside napari - An option to show objects documentation (object class docstring) can be used by checking the
Show object documentation
checkbox
- Use
-
Check the
Enable application events logging
checkbox:- A log like information with the events generated when interacting with the application will appear
- Some configuration options are available:
Stack depth
: Stack depth to show. Default to 20Allowed nested events
: How many sub-emit nesting levels to show (i.e. events that get triggered by other events). Default to 0
-
If you want to explore the related widget or event module source file, click the link in the output section of the plugin (the module file will open if you have a registered program to open such kind of file)
Contributing
Contributions are very welcome. Pre-commit is used for formatting. Tests can be run with tox, please ensure the coverage at least stays the same before you submit a pull request.
License
Distributed under the terms of the MIT license, "napari-ui-tracer" is free and open source software
Issues
If you encounter any problems, please file an issue along with a detailed description.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for napari_ui_tracer-0.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b3c8d5a61bbd48a4aa4c5b1272b21f324955d3715e2fa9a7ea50038b649c6001 |
|
MD5 | 88ec06592e224fd59f9d947ecccfbe43 |
|
BLAKE2b-256 | fa3b86a18d9fd8cdb4fec45a66cad7cf681ff28732d1b9674e3483c9f1fc86a9 |