Metadata-Version: 2.1 Name: traitsui Version: 8.0.0 Summary: Traits-capable user interfaces Author-email: Enthought License: This software is OSI Certified Open Source Software. OSI Certified is a certification mark of the Open Source Initiative. Copyright (c) 2004-2023, Enthought, Inc. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of Enthought, Inc. nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Project-URL: source, https://github.com/enthought/traitsui Project-URL: docs, https://docs.enthought.com/traitsui Keywords: gui,traits,traitsui,pyqt,pyside,wxpython Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: BSD License Classifier: Operating System :: OS Independent Classifier: Programming Language :: Python :: 3 Requires-Python: >=3.7 Description-Content-Type: text/x-rst Provides-Extra: docs Provides-Extra: editors Provides-Extra: examples Provides-Extra: pyqt5 Provides-Extra: pyqt6 Provides-Extra: pyside2 Provides-Extra: pyside6 Provides-Extra: test Provides-Extra: wx License-File: LICENSE.txt ============================================ TraitsUI: Traits-capable windowing framework ============================================ The TraitsUI project provides a toolkit-independent GUI abstraction layer, which is used to support the "visualization" features of the `Traits `__ package. You can write a model using the Traits API and specify a GUI using the TraitsUI API (views, items, editors, etc.), and let TraitsUI and your selected toolkit back-end (Qt or Wx) take care of the details of displaying them. Example ------- Given a Traits model like the following:: from traits.api import HasTraits, Str, Range, Enum class Person(HasTraits): name = Str('Jane Doe') age = Range(low=0) gender = Enum('female', 'male') person = Person(age=30) And using TraitsUI to specify and display a GUI view:: from traitsui.api import Item, RangeEditor, View person_view = View( Item('name'), Item('gender'), Item('age', editor=RangeEditor(mode='spinner', low=0, high=150)), buttons=['OK', 'Cancel'], resizable=True, ) person.configure_traits(view=person_view) It creates a GUI which looks like this: .. image:: https://raw.github.com/enthought/traitsui/main/README_example.png Important Links --------------- - Website and Documentation: ``__ * User Manual ``__ * Tutorial ``__ * API Documentation ``__ - Source code repository: ``__ * Issue tracker: ``__ - Download releases: ``__ - Mailing list: ``__ Installation ------------ If you want to run traitsui, you must also install: - Traits ``__ - Pyface ``__ You will also need one of the following backends: - wxPython - PySide2 - PyQt5 Backends have additional dependencies and there are optional dependencies on NumPy and Pandas for some editors. TraitsUI along with all dependencies can be installed in a straightforward way using the `Enthought Deployment Manager `__, ``pip`` or other package managers. .. end_of_long_description Running the Test Suite ---------------------- To run the test suite, you will need to install Git and `EDM `__ as well as have a Python environment which has install `Click `__ available. You can then follow the instructions in ``etstool.py``. In particular:: > python etstool.py test_all will run tests in all supported environments automatically.