Access items
instance items
The items object provides dict-like access to the items. It's mainly
useful for programatically executing items.
An items object is created automatically when the experiment starts.
In addition to the functions listed below, the following semantics are supported:
Example:
# Programmatically prepare and run a sketchpad item.
items.execute(u'my_sketchpad')
# Check if an item exists
if u'my_sketchpad' in items:
print(u'my_sketchpad exists')
# Delete an item
del items[u'my_sketchpad']
# Walk through all item names
for item_name in items:
print(item_name)
function items._type(name)
Gets the type of an item.
Example:
print(items._type('target_sketchpad'))
Arguments:
name-- The name of an item.- Type: unicode
Returns:
The type of an item, or None if the item doesn't exist.
- Type: unicode, NoneType
function items.execute(name)
Executes the run and prepare phases of an item, and updates the item stack.
Example:
items.execute(u'target_sketchpad')
Arguments:
name-- An item name.- Type: str
function items.new(_type, name=None, script=None, allow_rename=True)
Creates a new item.
Example:
items.new(u'sketchpad', name=u'my_sketchpad')
items[u'my_sketchpad'].prepare()
items[u'my_sketchpad'].run()
Arguments:
_type-- The item type.- Type: unicode
Keywords:
name-- The item name, or None to choose a unique name based on the item type.- Type: unicode, NoneType
- Default: None
script-- A definition script, or None to start with a blank item.- Type: unicode, NoneType
- Default: None
allow_rename-- Indicates whether OpenSesame can use a different name from the one that is provided asnameto avoid duplicate names etc.- Type: bool
- Default: True
Returns:
The newly generated item.
- Type: item
function items.prepare(name)
Executes the prepare phase of an item, and updates the item stack.
Example:
items.prepare('target_sketchpad')
items.run('target_sketchpad')
Arguments:
name-- An item name.- Type: str
function items.run(name)
Executes the run phase of an item, and updates the item stack.
Example:
items.prepare('target_sketchpad')
items.run('target_sketchpad')
Arguments:
name-- An item name.- Type: str
function items.valid_name(item_type, suggestion=None)
Generates a unique name that is valid and resembles the desired name.
Example:
valid_name = items.valid_name(u'sketchpad', u'an invalid name')
Arguments:
item_type-- The type of the item to suggest a name for.- Type: unicode
Keywords:
suggestion-- The desired name, or None to choose a name based on the item's type.- Type: unicode, NoneType
- Default: None
Returns:
A unique name.
- Type: unicode