CountsSelectorCallback

class selectortools.CountsSelectorCallback(counts=(3, ), cyclic=True, fuse_overhang=False, nonempty=False, overhang=True, rotate=True)

A counts selector callback.

Example 1. Initializes callback by hand:

>>> callback = selectortools.CountsSelectorCallback([3])
>>> print(format(callback))
selectortools.CountsSelectorCallback(
    counts=datastructuretools.CyclicTuple(
        [3]
        ),
    cyclic=True,
    fuse_overhang=False,
    nonempty=False,
    overhang=True,
    rotate=True,
    )

Example 2. Selects components:

>>> selector = selectortools.Selector()
>>> selector = selector.by_leaf()
>>> selector = selector.by_counts([3])
>>> staff = Staff("c'8 r8 d'8 e'8 r8 f'8 g'8 a'8 b'8 r8 c''8")
>>> selector(staff)
Selection([Selection([Note("c'8"), Rest('r8'), Note("d'8")])])

Example 3. Selects objects:

>>> selector = selectortools.Selector()
>>> selector = selector.by_counts([3])
>>> numbers = [1, 'two', 'three', 4, -5, 'foo', 7.0, 8]
>>> selector(numbers)
Selection([Selection([1, 'two', 'three'])])

Lineage

digraph InheritanceGraph { graph [background=transparent, bgcolor=transparent, color=lightslategrey, fontname=Arial, outputorder=edgesfirst, overlap=prism, penwidth=2, rankdir=LR, root="__builtin__.object", splines=spline, style="dotted, rounded", truecolor=true]; node [colorscheme=pastel19, fontname=Arial, fontsize=12, penwidth=2, style="filled, rounded"]; edge [color=lightsteelblue2, penwidth=2]; subgraph cluster_abctools { graph [label=abctools]; "abjad.tools.abctools.AbjadObject.AbjadObject" [color=1, group=0, label=AbjadObject, shape=box]; "abjad.tools.abctools.AbjadObject.AbstractBase" [color=1, group=0, label=AbstractBase, shape=box]; "abjad.tools.abctools.AbjadValueObject.AbjadValueObject" [color=1, group=0, label=AbjadValueObject, shape=box]; "abjad.tools.abctools.AbjadObject.AbjadObject" -> "abjad.tools.abctools.AbjadValueObject.AbjadValueObject"; "abjad.tools.abctools.AbjadObject.AbstractBase" -> "abjad.tools.abctools.AbjadObject.AbjadObject"; } subgraph cluster_selectortools { graph [label=selectortools]; "abjad.tools.selectortools.CountsSelectorCallback.CountsSelectorCallback" [color=black, fontcolor=white, group=2, label=<<B>CountsSelectorCallback</B>>, shape=box, style="filled, rounded"]; } subgraph cluster_builtins { graph [label=builtins]; "builtins.object" [color=2, group=1, label=object, shape=box]; } "abjad.tools.abctools.AbjadValueObject.AbjadValueObject" -> "abjad.tools.selectortools.CountsSelectorCallback.CountsSelectorCallback"; "builtins.object" -> "abjad.tools.abctools.AbjadObject.AbstractBase"; }

Bases

Attribute summary

counts Gets counts selector callback counts.
cyclic Gets counts selector callback cyclicity.
fuse_overhang Gets counts selector callback fuse overhang flag.
nonempty Gets counts selector callback nonempty flag.
overhang Gets counts selector callback overhang flag.
rotate Gets counts selector callback rotate flag.
__call__(expr[, rotation]) Iterates tuple expr.
__copy__(\*args) Copies Abjad value object.
__eq__(expr) Is true when all initialization values of Abjad value object equal the initialization values of expr.
__format__([format_specification]) Formats Abjad object.
__hash__() Hashes Abjad value object.
__ne__(expr) Is true when Abjad object does not equal expr.
__repr__() Gets interpreter representation of Abjad object.

Read-only properties

CountsSelectorCallback.counts

Gets counts selector callback counts.

Returns tuple.

CountsSelectorCallback.cyclic

Gets counts selector callback cyclicity.

Returns true or false.

CountsSelectorCallback.fuse_overhang

Gets counts selector callback fuse overhang flag.

Returns ordinal constant.

CountsSelectorCallback.nonempty

Gets counts selector callback nonempty flag.

Returns true or false.

CountsSelectorCallback.overhang

Gets counts selector callback overhang flag.

Returns true or false.

CountsSelectorCallback.rotate

Gets counts selector callback rotate flag.

Returns true or false.

Special methods

CountsSelectorCallback.__call__(expr, rotation=None)

Iterates tuple expr.

Returns tuple in which each item is a selection or component.

(AbjadValueObject).__copy__(*args)

Copies Abjad value object.

Returns new Abjad value object.

(AbjadValueObject).__eq__(expr)

Is true when all initialization values of Abjad value object equal the initialization values of expr.

Returns true or false.

(AbjadObject).__format__(format_specification='')

Formats Abjad object.

Set format_specification to ‘’ or ‘storage’. Interprets ‘’ equal to ‘storage’.

Returns string.

(AbjadValueObject).__hash__()

Hashes Abjad value object.

Returns integer.

(AbjadObject).__ne__(expr)

Is true when Abjad object does not equal expr. Otherwise false.

Returns true or false.

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.