File: widgets.rst

package info (click to toggle)
guidata 3.14.2-2
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 2,908 kB
  • sloc: python: 20,597; makefile: 17
file content (96 lines) | stat: -rw-r--r-- 2,571 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
.. _widgets:

Ready-to-use widgets
====================

As a complement to the :py:mod:`guidata.dataset` module which focus on automatic
GUI generation for data sets editing and display, the :py:mod:`guidata.widgets`
module provides a set of ready-to-use widgets for building interactive GUIs.

.. note:: Most of the widgets originally come from the `Spyder`_ project
          (Copyright © Spyder Project Contributors, MIT-licensed). They were
          adapted to be used outside of the Spyder IDE and to be compatible with
          guidata internals.

.. _Spyder: https://github.com/spyder-ide/spyder

Python console
--------------

.. literalinclude:: ../guidata/tests/widgets/test_console.py
   :start-after: guitest:

.. image:: images/screenshots/console.png

Code editor
-----------

.. literalinclude:: ../guidata/tests/widgets/test_codeeditor.py
   :start-after: guitest:

.. image:: images/screenshots/codeeditor.png

Array editor
------------

.. literalinclude:: ../guidata/tests/widgets/test_arrayeditor.py
   :start-after: guitest:

.. image:: images/screenshots/arrayeditor.png

Collection editor
-----------------

.. literalinclude:: ../guidata/tests/widgets/test_collectionseditor.py
   :start-after: guitest:

.. image:: images/screenshots/collectioneditor.png

Dataframe editor
----------------

.. literalinclude:: ../guidata/tests/widgets/test_dataframeeditor.py
   :start-after: guitest:

.. image:: images/screenshots/dataframeeditor.png

Import wizard
-------------

.. literalinclude:: ../guidata/tests/widgets/test_importwizard.py
   :start-after: guitest:

.. image:: images/screenshots/importwizard.png

Icon browser
------------

The icon browser is a utility widget for browsing and exploring icon collections
in directories. It is useful for developers managing icons for their applications
and libraries.

**Features:**

* Browse icon collections with tree view for folder navigation
* Adjustable thumbnail sizes (16-256 pixels) via toolbar
* Single-click on icons to open file location in system file explorer
* Support for PNG, SVG, ICO, JPG, GIF, and BMP formats
* Responsive grid layout that adapts to window size
* Refresh action to reload current folder after external changes

**Command-line usage:**

.. code-block:: console

    $ # Launch with folder selection dialog
    $ giconbrowser

    $ # Launch with a specific folder
    $ giconbrowser /path/to/icons

**Programmatic usage:**

.. literalinclude:: ../guidata/tests/widgets/test_iconbrowser.py
   :start-after: guitest:

.. image:: images/screenshots/iconbrowser.png