cloup.constraints.conditions

This modules contains predicates with an associated description that you can use as conditions of conditional constraints (see cloup.constraints.If).

Predicates should be treated as immutable objects, even though immutability is not (at the moment) enforced.

Classes

Predicate()	A Callable that takes a Context and returns a boolean, with an associated description.
Not(predicate)	Logical NOT of a predicate.
IsSet(param_name)	True if the parameter is set.
AllSet(*param_names)	True if all listed parameters are set.
AnySet(*param_names)	True if any of the listed parameters is set.
Equal(param_name, value)	True if the parameter value equals value.

Attributes

P

Contents

cloup.constraints.conditions.P

class cloup.constraints.conditions.Predicate

Bases: abc.ABC

A Callable that takes a Context and returns a boolean, with an associated description. Meant to be used as condition in a conditional constraint (see If).

abstract description(self, ctx)

Succint description of the predicate (alias: desc).

Parameters

ctx (click.Context) –

Return type

str

negated_description(self, ctx)

Succint description of the negation of this predicate (alias: neg_desc).

Parameters

ctx (click.Context) –

Return type

str

desc(self, ctx)

Short alias for description().

Parameters

ctx (click.Context) –

Return type

str

neg_desc(self, ctx)

Short alias for negated_description().

Parameters

ctx (click.Context) –

Return type

str

negated(self)

abstract __call__(self, ctx)

Evaluate the predicate on the given context.

Parameters

ctx (click.Context) –

Return type

bool

__invert__(self)

Return type

Predicate

__or__(self, other)

Parameters

other (Predicate) –

Return type

_Or

__and__(self, other)

Parameters

other (Predicate) –

Return type

_And

__repr__(self)

Return repr(self).

__eq__(self, other)

Return self==value.

class cloup.constraints.conditions.Not(predicate)

Bases: Predicate, Generic[P]

Logical NOT of a predicate.

description(self, ctx)

Succint description of the predicate (alias: desc).

Parameters

ctx (click.Context) –

Return type

str

negated_description(self, ctx)

Succint description of the negation of this predicate (alias: neg_desc).

Parameters

ctx (click.Context) –

Return type

str

__call__(self, ctx)

Evaluate the predicate on the given context.

Parameters

ctx (click.Context) –

Return type

bool

__invert__(self)

Return type

P

__repr__(self)

Return repr(self).

Return type

str

class cloup.constraints.conditions.IsSet(param_name)

Bases: Predicate

True if the parameter is set.

Parameters

param_name (str) –

description(self, ctx)

Succint description of the predicate (alias: desc).

Parameters

ctx (click.Context) –

Return type

str

negated_description(self, ctx)

Succint description of the negation of this predicate (alias: neg_desc).

Parameters

ctx (click.Context) –

Return type

str

__call__(self, ctx)

Evaluate the predicate on the given context.

Parameters

ctx (click.Context) –

Return type

bool

__and__(self, other)

Parameters

other (Predicate) –

__or__(self, other)

Parameters

other (Predicate) –

class cloup.constraints.conditions.AllSet(*param_names)

Bases: Predicate

True if all listed parameters are set.

New in version 0.8.0.

Parameters

param_names (str) –

negated_description(self, ctx)

Succint description of the negation of this predicate (alias: neg_desc).

Parameters

ctx (click.Context) –

Return type

str

description(self, ctx)

Succint description of the predicate (alias: desc).

Parameters

ctx (click.Context) –

Return type

str

__call__(self, ctx)

Evaluate the predicate on the given context.

Parameters

ctx (click.Context) –

Return type

bool

__and__(self, other)

Parameters

other (Predicate) –

class cloup.constraints.conditions.AnySet(*param_names)

Bases: Predicate

True if any of the listed parameters is set.

New in version 0.8.0.

Parameters

param_names (str) –

negated_description(self, ctx)

Succint description of the negation of this predicate (alias: neg_desc).

Parameters

ctx (click.Context) –

Return type

str

description(self, ctx)

Succint description of the predicate (alias: desc).

Parameters

ctx (click.Context) –

Return type

str

__call__(self, ctx)

Evaluate the predicate on the given context.

Parameters

ctx (click.Context) –

Return type

bool

__or__(self, other)

Parameters

other (Predicate) –

class cloup.constraints.conditions.Equal(param_name, value)

Bases: Predicate

True if the parameter value equals value.

Parameters

• param_name (str) –

• value (Any) –

description(self, ctx)

Succint description of the predicate (alias: desc).

Parameters

ctx (click.Context) –

Return type

str

negated_description(self, ctx)

Succint description of the negation of this predicate (alias: neg_desc).

Parameters

ctx (click.Context) –

Return type

str

__call__(self, ctx)

Evaluate the predicate on the given context.

Parameters

ctx (click.Context) –

Return type

bool