| 1 |
============ |
| 2 |
Introduction |
| 3 |
============ |
| 4 |
|
| 5 |
This tutorial is intended to introduce you to the basics of Traits |
| 6 |
and to give you an idea of what capabilities the Traits library provides. |
| 7 |
This tutorial assumes that you are comfortable with the Python |
| 8 |
programming language, object-oriented programming, and the core tools of |
| 9 |
the Python scientific ecosystem, such as NumPy. |
| 10 |
|
| 11 |
This tutorial is designed to introduce the basics of Traits, but also to |
| 12 |
explain *why* you might want to use Traits in your own code. |
| 13 |
|
| 14 |
An interactive version of this tutorial can be accessed using the |
| 15 |
`ETS Demo application <https://pypi.org/project/etsdemo/>`_. |
| 16 |
|
| 17 |
.. include:: ../../../traits/examples/introduction/0_introduction.py |
| 18 |
:start-after: """ |
| 19 |
:end-before: """ |
| 20 |
|
| 21 |
.. literalinclude:: ../../../traits/examples/introduction/0_introduction.py |
| 22 |
:start-at: import datetime |
| 23 |
|
| 24 |
Links |
| 25 |
----- |
| 26 |
|
| 27 |
- :download:`Source code <../../../traits/examples/introduction/0_introduction.py>` |
| 28 |
|
| 29 |
.. include:: ../../../traits/examples/introduction/1_validation.py |
| 30 |
:start-after: """ |
| 31 |
:end-before: """ |
| 32 |
|
| 33 |
Links |
| 34 |
----- |
| 35 |
|
| 36 |
- :ref:`defining-traits-initialization-and-validation` |
| 37 |
- :download:`Source code <../../../traits/examples/introduction/1_validation.py>` |
| 38 |
|
| 39 |
.. include:: ../../../traits/examples/introduction/2_initialization.py |
| 40 |
:start-after: """ |
| 41 |
:end-before: """ |
| 42 |
|
| 43 |
Links |
| 44 |
----- |
| 45 |
|
| 46 |
- :ref:`defining-traits-initialization-and-validation` |
| 47 |
- :download:`Source code <../../../traits/examples/introduction/2_initialization.py>` |
| 48 |
|
| 49 |
.. include:: ../../../traits/examples/introduction/3_observation.py |
| 50 |
:start-after: """ |
| 51 |
:end-before: """ |
| 52 |
|
| 53 |
Links |
| 54 |
----- |
| 55 |
|
| 56 |
- :ref:`observe-notification` |
| 57 |
- :download:`Source code <../../../traits/examples/introduction/3_observation.py>` |
| 58 |
|
| 59 |
.. include:: ../../../traits/examples/introduction/4_properties.py |
| 60 |
:start-after: """ |
| 61 |
:end-before: """ |
| 62 |
|
| 63 |
Links |
| 64 |
----- |
| 65 |
|
| 66 |
- :ref:`property-traits` |
| 67 |
- :download:`Source code <../../../traits/examples/introduction/4_properties.py>` |
| 68 |
|
| 69 |
.. include:: ../../../traits/examples/introduction/5_documentation.py |
| 70 |
:start-after: """ |
| 71 |
:end-before: """ |
| 72 |
|
| 73 |
Links |
| 74 |
----- |
| 75 |
|
| 76 |
- :ref:`hasstricttraits` |
| 77 |
- :download:`Source code <../../../traits/examples/introduction/5_documentation.py>` |
| 78 |
|
| 79 |
.. include:: ../../../traits/examples/introduction/6_visualization.py |
| 80 |
:start-after: """ |
| 81 |
:end-before: """ |
| 82 |
|
| 83 |
Links |
| 84 |
----- |
| 85 |
|
| 86 |
- `TraitsUI Documentation <https://docs.enthought.com/traitsui/>`_ |
| 87 |
- :download:`Source code <../../../traits/examples/introduction/6_visualization.py>` |