====================
Traits and Traits UI
====================
:Author: Enthought Developers
:Contact: enthought-dev@enthought.co
:Copyright: 2007 by Enthought, Inc.  All rights reserved.


.. contents::


Introduction
============

This document provides some details on Enthought's Traits and Traits UI
packages which are one component of ETS (Enthought Tool Suite.)


.. _Packaging:

Packaging
=========

Our intention is to make Traits and Traits UI usable without requiring a full
install of all ETS components.  We do this by providing eggs, which are a
binary distrubtion mechanism.  We also provide source distributions as tarballs
and zip files (for Windows users).

While our goal is to minimize the dependencies on other ETS components, there
are likely going to be some ETS dependencies.  The egg distribution mechanism
tracks these dependencies automatically for you.  And since they change over
time with each release of Traits, this document will not list them.


Stack
=====

Not with standing the description under Packaging_, a decision has been made
on some of the core stack designs that underlie Traits.  In particular, we have
decide that Traits UI will be built on top of Pyface.  The stack looks like:

::

     xxx := other ets components

     -------------------
     | ... xxxx ...
     -------------------
     ----------------- -----------------
     | traits.ui.wx  | |  ... xxxx ...
     ----------------- -----------------
     ----------------------- ----------------
     |        traits.ui    | |   ... xxxx ...
     ----------------------- ----------------
     ------------------------------- ----------------
     |          pyface             | |  ... xxxx ...
     ------------------------------- ----------------
     --------------------------------------------------------
     |            traits                                    |
     --------------------------------------------------------



