Metadata-Version: 2.0
Name: fsleyes-props
Version: 1.2.1
Summary: [wx]Python event programming framework
Home-page: https://git.fmrib.ox.ac.uk/fsl/fsleyes/props
Author: Paul McCarthy
Author-email: pauldmccarthy@gmail.com
License: Apache License Version 2.0
Description-Content-Type: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: six (==1.*)
Requires-Dist: numpy (==1.*)
Requires-Dist: matplotlib (<3,>=1.5)
Requires-Dist: wxPython (<4.1,>=3.0.2.0)
Requires-Dist: deprecation (==1.*)
Requires-Dist: fsleyes-widgets (==0.*)
Requires-Dist: fslpy (==1.*)

fsleyes-props
=============


.. image:: https://git.fmrib.ox.ac.uk/fsl/fsleyes/props/badges/master/build.svg
   :target: https://git.fmrib.ox.ac.uk/fsl/fsleyes/props/commits/master/

.. image:: https://git.fmrib.ox.ac.uk/fsl/fsleyes/props/badges/master/coverage.svg
   :target: https://git.fmrib.ox.ac.uk/fsl/fsleyes/props/commits/master/


The ``fsleyes-props`` project is an event programming framework, which
includes the ability for automatic CLI generation and, optionally, automatic
GUI generation (if `wxPython <http://www.wxpython.org>`_ is present). It is
used by `FSLeyes <https://git.fmrib.ox.ac.uk/fsl/fsleyes/fsleyes>`_.


Dependencies
------------


All of the dependencies of ``fsleyes-props`` are listed in the
`requirements.txt <requirements.txt>`_ file. ``fsleyes-props`` can be used
without wxPython, but GUI functionality will not be available.


Documentation
-------------

``fsleyes-props`` is documented using `sphinx
<http://http://sphinx-doc.org/>`_. You can build the API documentation by
running::

    python setup.py doc

The HTML documentation will be generated and saved in the ``doc/html/``
directory.


Example usage
-------------


.. code-block:: python

    >>> import fsleyes_props as props
    >>>
    >>> class PropObj(props.HasProperties):
    >>>     myProperty = props.Boolean()
    >>>
    >>> myPropObj = PropObj()
    >>>
    >>> # Access the property value as a normal attribute:
    >>> myPropObj.myProperty = True
    >>> myPropObj.myProperty
    True
    >>>
    >>> # access the props.Boolean instance:
    >>> myPropObj.getProp('myProperty')
    <props.prop.Boolean at 0x1045e2710>
    >>>
    >>> # access the underlying props.PropertyValue object
    >>> # (there are caveats for List properties):
    >>> myPropObj.getPropVal('myProperty')
    <props.prop.PropertyValue instance at 0x1047ef518>
    >>>
    >>> # Receive notification of property value changes
    >>> def myPropertyChanged(value, *args):
    >>>     print('New property value: {}'.format(value))
    >>>
    >>> myPropObj.addListener(
    >>>    'myProperty', 'myListener', myPropertyChanged)
    >>>
    >>> myPropObj.myProperty = False
    New property value: False
    >>>
    >>> # Remove a previously added listener
    >>> myPropObj.removeListener('myListener')


Contributing
------------

If you would like to contribute to ``fsleyes-props``, take a look at the
``fslpy`` `contributing guide
<https://git.fmrib.ox.ac.uk/fsl/fslpy/blob/master/doc/contributing.rst>`_.


