[wx]Python event programming framework
Project description
fsleyes-props is a library which is used by used by FSLeyes, and which allows you to:
Listen for change to attributes on a python object,
Automatically generate wxpython widgets which are bound to attributes of a python object
Automatically generate a command line interface to set values of the attributes of a python object.
To do this, you just need to subclass the fsleyes_props.HasProperties class (also available as fsleyes_props.Props), and add some PropertyBase types as class attributes.
Installation
You can install fsleyes-props via pip. If you are using Linux, you need to install wxPython first, as binaries are not available on PyPI. Change the URL for your specific platform:
pip install -f https://extras.wxpython.org/wxPython4/extras/linux/gtk2/ubuntu-16.04/ wxpython
Then install fsleyes-props like so:
pip install fsleyes-props
fsleyes-props is also available on conda-forge:
conda install -c conda-forge fsleyes-props
Dependencies
All of the dependencies of fsleyes-props are listed in the pyproject.toml file. fsleyes-props can be used without wxPython, but GUI functionality will not be available.
Dependencies for running the tests and building documentation are listed as extra test and doc dependencies, and can be installed with pip like so:
pip install fsleyes-props[doc,test]
Documentation
The fsleyes-props API documentation is hosted at https://open.win.ox.ac.uk/pages/fsl/fsleyes/props/.
fsleyes-props is documented using sphinx. You can build the API documentation by running:
sphinx-build doc html
The HTML documentation will be generated and saved in the html/ directory.
Tests
Run the test suite via:
pytest
Many of the tests assume that a display is accessible - if you are running on a headless machine, you may need to run the tests using xvfb-run.
Example usage
>>> import fsleyes_props as props
>>>
>>> class PropObj(props.Props):
>>> myProperty = props.Boolean()
>>>
>>> myPropObj = PropObj()
>>>
>>> # Access the property value as a normal attribute:
>>> myPropObj.myProperty = True
>>> myPropObj.myProperty
True
>>>
>>> # Receive notification of property value changes
>>> def myPropertyChanged(value, *args):
>>> print(f'New property value: {value}')
>>>
>>> myPropObj.listen('myProperty', 'myListener', myPropertyChanged)
>>>
>>> myPropObj.myProperty = False
New property value: False
>>>
>>> # Remove a previously added listener
>>> myPropObj.remove('myListener')Contributing
If you would like to contribute to fsleyes-props, take a look at the fslpy contributing guide.
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 fsleyes_props-1.11.0-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | de4fd26f1c4cdf4e5ebb43ec5cce5ce381c93022b0d6e3396c0f2fa2217d9d31 |
|
| MD5 | 87a1ec227a9982e686b354e46a9463df |
|
| BLAKE2b-256 | ba71cede74bacc31becec8e91ff9eaa2b07c18a87939b38705d101c61bc1ae8c |
