select

abjad.top.select.select(items=None)

Selects items or makes select expression.

Selects first two notes in staff:

>>> staff = abjad.Staff("c'4 d' e' f'")
>>> selection = abjad.select(staff[:2]).leaves(pitched=True)
>>> for note in selection:
...     abjad.override(note).note_head.color = 'red'
... 

>>> abjad.show(staff) 

Returns selection agent:

>>> abjad.select(staff)
Selection([Staff("c'4 d'4 e'4 f'4")])

>>> abjad.select()
abjad.select()