# (C) Copyright 2004-2021 Enthought, Inc., Austin, TX
# All rights reserved.
#
# This software is provided without warranty under the terms of the BSD
# license included in LICENSE.txt and may be redistributed only under
# the conditions described in the aforementioned license. The license
# is also available online at http://www.enthought.com/licenses/BSD.txt
#
# Thanks for using Enthought open source!

"""
Dynamic changing an Enum selection list, depending on checked items

Another way to dynamically change the values shown by an EnumEditor.

The scenario is a restaurant that at the beginning of the day has a menu list
of entrees based upon a fully stocked kitchen. However, as the day progresses,
the kitchen's larder gets depleted, and the kitchen may no longer be able to
prepare certain entrees, which must then be deleted from the menu. Similarly,
deliveries may allow certain entrees to be added back onto the menu.

The demo is divided into two tabs: Order and Kitchen.

The Order tab represents a customer's order and consists of a single Entree
field, which represents the customer's selection from the drop-down list of
entrees that the kitchen can currently prepare.

The Kitchen tab represents the current set of entrees that the kitchen can
prepare, based upon the current contents of its larder.

As entrees are checked on or off from the Kitchen tab, the customer's Entree
drop-down is dynamically updated with the current list of available entrees.

Notes:

- The key point of the demo is the use of the 'name' trait in the EnumEditor
  definition, which links the list of available entrees from the
  KitchenCapabilities object to the OrderMenu object's entree EnumEditor.

- The user can freely type any value they want, but only items in the
  capabilities will be accepted, due to the use of the 'values' argument
  to the Enum trait.  This will be updated as the capabilities change.

- With the Qt backend, the user can type text and it will be auto-completed
  to valid values as a the user types. The Wx backend doesn't support this
  capability in the underlying toolkit.

- The design will work with any number of active OrderMenu objects, since they
  all share a common KitchenCapabilities object. As the KitchenCapabilities
  object is updated, all OrderMenu UI's will automatically update their
  associated Entree's drop-down list.

- A careful reader will also observe that this example contains only
  declarative code. No imperative code is required to handle the automatic
  updating of the Entree list.

"""


from traits.api import Enum, HasPrivateTraits, List, Constant

from traitsui.api import (
    View, Item, VGroup, HSplit, EnumEditor, CheckListEditor
)

#-- The list of possible entrees -----------------------------------------

possible_entrees = [
    'Chicken Fried Steak',
    'Chicken Fingers',
    'Chicken Enchiladas',
    'Cheeseburger',
    'Pepper Steak',
    'Beef Tacos',
    'Club Sandwich',
    'Ceasar Salad',
    'Cobb Salad'
]

#-- The KitchenCapabilities class ----------------------------------------


class KitchenCapabilities(HasPrivateTraits):

    # The current set of entrees the kitchen can make (based on its larder):
    available = List(possible_entrees)

# The KitchenCapabilities are shared by all waitstaff taking orders:
kitchen_capabilities = KitchenCapabilities()

#-- The OrderMenu class --------------------------------------------------


class OrderMenu(HasPrivateTraits):

    # The person's entree order:
    entree = Enum(values='capabilities.available')

    # Reference to the restaurant's current entree capabilities:
    capabilities = Constant(kitchen_capabilities)

    # The user interface view:
    view = View(
        HSplit(
            VGroup(
                Item('entree',
                     editor=EnumEditor(
                         name='object.capabilities.available',
                         evaluate=str,
                         completion_mode='popup',
                        )
                     ),
                label='Order',
                show_border=True,
                dock='tab'
            ),
            VGroup(
                Item('object.capabilities.available',
                     show_label=False,
                     style='custom',
                     editor=CheckListEditor(values=possible_entrees)
                     ),
                label='Kitchen',
                show_border=True,
                dock='tab'
            )
        ),
        title='Dynamic EnumEditor Demo',
        resizable=True,
    )

#-------------------------------------------------------------------------

# Create the demo:
demo = OrderMenu()

# Run the demo (if invoked from the command line):
if __name__ == '__main__':
    demo.configure_traits()
    print(demo.entree)
