cloup.constraints
¶
Constraints for parameter groups.
New in version v0.5.0.
Submodules¶
Classes¶
|
Checks one constraint or another depending on the truth value of the condition. |
|
Satisfied if the number of set parameters is <= n. |
|
Satisfied if the number of set parameters is between |
|
It’s satisfied if all operands are satisfied. |
A constraint that can be checked against an arbitrary collection of CLI parameters with respect to a specific |
|
|
|
|
Base class for all n-ary operators defined on constraints. |
|
It’s satisfied if at least one of the operands is satisfied. |
|
A constraint decorator that can override the help and/or the error message of the wrapped constraint. |
Satisfied if the number of set parameters is >= n. |
|
Requires an exact number of parameters to be set. |
|
|
Abstract class that wraps another constraint and delegates all methods to it. |
|
A NamedTuple storing a |
|
Provides support for constraints. |
|
True if all listed parameters are set. |
|
True if any of the listed parameters is set. |
|
True if the parameter value equals |
|
True if the parameter is set. |
|
Logical NOT of a predicate. |
Functions¶
|
Return a decorator that adds the given parameters and applies a constraint to them. Equivalent to::. |
|
Register a constraint on a list of parameters specified by (destination) name (e.g. |
Attributes¶
Satisfied if none of the parameters is set. Useful only in conditional constraints. |
|
Satisfied if either all or none of the parameters are set. |
|
Satisfied if at most one of the parameters is set. |
|
Satisfied if all parameters are set. |
|
Alias for |
|
Alias for |
Contents¶
-
class
cloup.constraints.
If
(condition, then, else_=None)[source]¶ Bases:
cloup.constraints._core.Constraint
Checks one constraint or another depending on the truth value of the condition.
New in version 0.8.0: you can now pass a sequence of parameter names as condition, which corresponds to the predicate
AllSet(*param_names)
.- Parameters
condition (Union[str, Sequence[str], cloup.constraints.conditions.Predicate]) – can be either an instance of
Predicate
or (more often) the name of a parameter or a list/tuple of parameters that must be all set for the condition to be true.then (cloup.constraints._core.Constraint) – a constraint checked if the condition is true.
else – an (optional) constraint checked if the condition is false.
else_ (Optional[cloup.constraints._core.Constraint]) –
-
help
(self, ctx)[source]¶ A description of the constraint.
- Parameters
ctx (click.Context) –
- Return type
-
check_consistency
(self, params)[source]¶ Perform some sanity checks that detect inconsistencies between these constraints and the properties of the input parameters (e.g. required).
For example, a constraint that requires the parameters to be mutually exclusive is not consistent with a group of parameters with multiple required options.
These sanity checks are meant to catch developer’s mistakes and don’t depend on the values assigned to the parameters; therefore:
they can be performed before any parameter parsing
they can be disabled in production (setting
check_constraints_consistency=False
incontext_settings
)
- Parameters
params (Sequence[click.Parameter]) – list of
click.Parameter
instances- Raises
UnsatisfiableConstraint
if the constraint cannot be satisfied independently from the values provided by the user- Return type
-
check_values
(self, params, ctx)[source]¶ Check that the constraint is satisfied by the input parameters in the given context, which (among other things) contains the values assigned to the parameters in
ctx.params
.You probably don’t want to call this method directly. Use
check()
instead.- Parameters
params (Sequence[click.Parameter]) – list of
click.Parameter
instancesctx (click.Context) –
click.Context
- Raises
- Return type
-
class
cloup.constraints.
AcceptAtMost
(n)[source]¶ Bases:
Constraint
Satisfied if the number of set parameters is <= n.
- Parameters
n (int) –
-
help
(self, ctx)[source]¶ A description of the constraint.
- Parameters
ctx (click.Context) –
- Return type
-
check_consistency
(self, params)[source]¶ Perform some sanity checks that detect inconsistencies between these constraints and the properties of the input parameters (e.g. required).
For example, a constraint that requires the parameters to be mutually exclusive is not consistent with a group of parameters with multiple required options.
These sanity checks are meant to catch developer’s mistakes and don’t depend on the values assigned to the parameters; therefore:
they can be performed before any parameter parsing
they can be disabled in production (setting
check_constraints_consistency=False
incontext_settings
)
- Parameters
params (Sequence[click.Parameter]) – list of
click.Parameter
instances- Raises
UnsatisfiableConstraint
if the constraint cannot be satisfied independently from the values provided by the user- Return type
-
check_values
(self, params, ctx)[source]¶ Check that the constraint is satisfied by the input parameters in the given context, which (among other things) contains the values assigned to the parameters in
ctx.params
.You probably don’t want to call this method directly. Use
check()
instead.- Parameters
params (Sequence[click.Parameter]) – list of
click.Parameter
instancesctx (click.Context) –
click.Context
- Raises
- Return type
-
class
cloup.constraints.
AcceptBetween
(min, max)[source]¶ Bases:
WrapperConstraint
Abstract class that wraps another constraint and delegates all methods to it. Useful when you want to define a parametric constraint combining other existing constraints minimizing the boilerplate.
This is an alternative to defining a function and using
Rephraser
. Feel free to do that in your code, but cloup will stick to the convention that parametric constraints are defined as classes and written in camel-case.Satisfied if the number of set parameters is between
min
andmax
(included).-
help
(self, ctx)[source]¶ A description of the constraint.
- Parameters
ctx (click.Context) –
- Return type
-
-
class
cloup.constraints.
And
(*constraints)[source]¶ Bases:
Operator
It’s satisfied if all operands are satisfied.
N-ary operator for constraints. :param constraints: operands
- Parameters
constraints (cloup.constraints._core.Constraint) –
-
HELP_SEP
= and¶
-
check_values
(self, params, ctx)[source]¶ Check that the constraint is satisfied by the input parameters in the given context, which (among other things) contains the values assigned to the parameters in
ctx.params
.You probably don’t want to call this method directly. Use
check()
instead.- Parameters
params (Sequence[click.Parameter]) – list of
click.Parameter
instancesctx (click.Context) –
click.Context
- Raises
- Return type
-
__and__
(self, other)[source]¶ - Parameters
other (Constraint) –
- Return type
-
class
cloup.constraints.
Constraint
[source]¶ Bases:
abc.ABC
A constraint that can be checked against an arbitrary collection of CLI parameters with respect to a specific
click.Context
(which contains the values assigned to the parameters inctx.params
).Changed in version 0.9.0: calling a constraint, previously equivalent to
check()
, is now equivalent to callingcloup.constrained_params()
with this constraint as first argument.-
static
must_check_consistency
(ctx)[source]¶ Return
True
if consistency checks are enabled.Changed in version 0.9.0: this method now a static method and takes a
click.Context
in input.- Parameters
ctx (click.Context) –
- Return type
-
abstract
help
(self, ctx)[source]¶ A description of the constraint.
- Parameters
ctx (click.Context) –
- Return type
-
check_consistency
(self, params)[source]¶ Perform some sanity checks that detect inconsistencies between these constraints and the properties of the input parameters (e.g. required).
For example, a constraint that requires the parameters to be mutually exclusive is not consistent with a group of parameters with multiple required options.
These sanity checks are meant to catch developer’s mistakes and don’t depend on the values assigned to the parameters; therefore:
they can be performed before any parameter parsing
they can be disabled in production (setting
check_constraints_consistency=False
incontext_settings
)
- Parameters
params (Sequence[click.Parameter]) – list of
click.Parameter
instances- Raises
UnsatisfiableConstraint
if the constraint cannot be satisfied independently from the values provided by the user- Return type
-
abstract
check_values
(self, params, ctx)[source]¶ Check that the constraint is satisfied by the input parameters in the given context, which (among other things) contains the values assigned to the parameters in
ctx.params
.You probably don’t want to call this method directly. Use
check()
instead.- Parameters
params (Sequence[click.Parameter]) – list of
click.Parameter
instancesctx (click.Context) –
click.Context
- Raises
- Return type
-
check
(self, params: Sequence[click.Parameter], ctx: Optional[click.Context] = None) → None[source]¶ -
check
(self, params: Sequence[str], ctx: Optional[click.Context] = None) → None Raise an exception if the constraint is not satisfied by the input parameters in the given (or current) context.
This method calls both
check_consistency()
(if enabled) andcheck_values()
.Tip
By default
check_consistency()
is called since it shouldn’t have any performance impact. Nonetheless, you can disable it in production passingcheck_constraints_consistency=False
as part of yourcontext_settings
.- Parameters
params – an iterable of parameter names or a sequence of
click.Parameter
ctx – a click.Context; if not provided,
click.get_current_context()
is used
- Raises
-
rephrased
(self, help=None, error=None)[source]¶ Override the help string and/or the error message of this constraint wrapping it with a
Rephraser
.- Parameters
help (Union[None, str, HelpRephraser]) – if provided, overrides the help string of this constraint. It can be a string or a function
(ctx: click.Context, constr: Constraint) -> str
. If you want to hide this constraint from the help, passhelp=""
.error (Union[None, str, ErrorRephraser]) –
if provided, overrides the error message of this constraint. It can be:
a string, eventually a
format
string supporting the replacement fields described inErrorFmt
.or a function
(err: ConstraintViolated) -> str
; note that aConstraintViolated
error has fields forctx
,constraint
andparams
, so it’s a complete description of what happened.
- Return type
Hide this constraint from the command help.
- Return type
-
__call__
(self, *param_adders)[source]¶ Equivalent to calling
cloup.constrained_params()
with this constraint as first argument.Changed in version 0.9.0: this method, previously equivalent to
check()
, is now equivalent to callingcloup.constrained_params()
with this constraint as first argument.- Parameters
param_adders (cloup.typing.Decorator) –
- Return type
Callable[[cloup.typing.F], cloup.typing.F]
-
__or__
(self, other)[source]¶ - Parameters
other (Constraint) –
- Return type
-
__and__
(self, other)[source]¶ - Parameters
other (Constraint) –
- Return type
-
static
-
class
cloup.constraints.
ErrorFmt
[source]¶ Bases:
cloup._util.FrozenSpace
Rephraser
allows you to pass aformat
string aserror
argument; this class contains the “replacement fields” supported by such format string. You can use them as following:mutually_exclusive.rephrased( error=f"{ErrorFmt.error}\n" f"Some extra information here." )
- Return type
-
error
= {error}¶ Replaced by the original error message. Useful if all you want is to append or prepend some extra info to the original error message.
-
param_list
= {param_list}¶ Replaced by a 2-space indented list of the constrained parameters.
-
cloup.constraints.
ErrorRephraser
¶
-
cloup.constraints.
HelpRephraser
¶
-
class
cloup.constraints.
Operator
(*constraints)[source]¶ Bases:
Constraint
,abc.ABC
Base class for all n-ary operators defined on constraints.
N-ary operator for constraints. :param constraints: operands
- Parameters
constraints (cloup.constraints._core.Constraint) –
-
HELP_SEP
:str¶ Used as separator of all constraints’ help strings.
-
help
(self, ctx)[source]¶ A description of the constraint.
- Parameters
ctx (click.Context) –
- Return type
-
check_consistency
(self, params)[source]¶ Perform some sanity checks that detect inconsistencies between these constraints and the properties of the input parameters (e.g. required).
For example, a constraint that requires the parameters to be mutually exclusive is not consistent with a group of parameters with multiple required options.
These sanity checks are meant to catch developer’s mistakes and don’t depend on the values assigned to the parameters; therefore:
they can be performed before any parameter parsing
they can be disabled in production (setting
check_constraints_consistency=False
incontext_settings
)
- Parameters
params (Sequence[click.Parameter]) – list of
click.Parameter
instances- Raises
UnsatisfiableConstraint
if the constraint cannot be satisfied independently from the values provided by the user- Return type
-
class
cloup.constraints.
Or
(*constraints)[source]¶ Bases:
Operator
It’s satisfied if at least one of the operands is satisfied.
N-ary operator for constraints. :param constraints: operands
- Parameters
constraints (cloup.constraints._core.Constraint) –
-
HELP_SEP
= or¶
-
check_values
(self, params, ctx)[source]¶ Check that the constraint is satisfied by the input parameters in the given context, which (among other things) contains the values assigned to the parameters in
ctx.params
.You probably don’t want to call this method directly. Use
check()
instead.- Parameters
params (Sequence[click.Parameter]) – list of
click.Parameter
instancesctx (click.Context) –
click.Context
- Raises
- Return type
-
__or__
(self, other)[source]¶ - Parameters
other (Constraint) –
- Return type
-
class
cloup.constraints.
Rephraser
(constraint, help=None, error=None)[source]¶ Bases:
Constraint
A constraint decorator that can override the help and/or the error message of the wrapped constraint.
You’ll rarely (if ever) use this class directly. In most cases, you’ll use the method
Constraint.rephrased()
. Refer to it for more info.See also
Constraint.rephrased()
– wraps a constraint with aRephraser
.WrapperConstraint
– alternative toRephraser
.ErrorFmt
– describes the keyword you can use in an error format string.
- Parameters
constraint (cloup.constraints._core.Constraint) –
help (Union[None, str, Callable[[click.core.Context, Constraint], str]]) –
error (Union[None, str, Callable[[cloup.constraints.exceptions.ConstraintViolated], str]]) –
-
help
(self, ctx)[source]¶ A description of the constraint.
- Parameters
ctx (click.Context) –
- Return type
-
check_consistency
(self, params)[source]¶ Perform some sanity checks that detect inconsistencies between these constraints and the properties of the input parameters (e.g. required).
For example, a constraint that requires the parameters to be mutually exclusive is not consistent with a group of parameters with multiple required options.
These sanity checks are meant to catch developer’s mistakes and don’t depend on the values assigned to the parameters; therefore:
they can be performed before any parameter parsing
they can be disabled in production (setting
check_constraints_consistency=False
incontext_settings
)
- Parameters
params (Sequence[click.Parameter]) – list of
click.Parameter
instances- Raises
UnsatisfiableConstraint
if the constraint cannot be satisfied independently from the values provided by the user- Return type
-
check_values
(self, params, ctx)[source]¶ Check that the constraint is satisfied by the input parameters in the given context, which (among other things) contains the values assigned to the parameters in
ctx.params
.You probably don’t want to call this method directly. Use
check()
instead.- Parameters
params (Sequence[click.Parameter]) – list of
click.Parameter
instancesctx (click.Context) –
click.Context
- Raises
- Return type
-
class
cloup.constraints.
RequireAtLeast
(n)[source]¶ Bases:
Constraint
Satisfied if the number of set parameters is >= n.
- Parameters
n (int) –
-
help
(self, ctx)[source]¶ A description of the constraint.
- Parameters
ctx (click.Context) –
- Return type
-
check_consistency
(self, params)[source]¶ Perform some sanity checks that detect inconsistencies between these constraints and the properties of the input parameters (e.g. required).
For example, a constraint that requires the parameters to be mutually exclusive is not consistent with a group of parameters with multiple required options.
These sanity checks are meant to catch developer’s mistakes and don’t depend on the values assigned to the parameters; therefore:
they can be performed before any parameter parsing
they can be disabled in production (setting
check_constraints_consistency=False
incontext_settings
)
- Parameters
params (Sequence[click.Parameter]) – list of
click.Parameter
instances- Raises
UnsatisfiableConstraint
if the constraint cannot be satisfied independently from the values provided by the user- Return type
-
check_values
(self, params, ctx)[source]¶ Check that the constraint is satisfied by the input parameters in the given context, which (among other things) contains the values assigned to the parameters in
ctx.params
.You probably don’t want to call this method directly. Use
check()
instead.- Parameters
params (Sequence[click.Parameter]) – list of
click.Parameter
instancesctx (click.Context) –
click.Context
- Raises
- Return type
-
class
cloup.constraints.
RequireExactly
(n)[source]¶ Bases:
WrapperConstraint
Requires an exact number of parameters to be set.
- Parameters
constraint – the constraint to wrap
attrs – these are just used to generate a
__repr__
methodn (int) –
-
help
(self, ctx)[source]¶ A description of the constraint.
- Parameters
ctx (click.Context) –
- Return type
-
check_values
(self, params, ctx)[source]¶ Check that the constraint is satisfied by the input parameters in the given context, which (among other things) contains the values assigned to the parameters in
ctx.params
.You probably don’t want to call this method directly. Use
check()
instead.- Parameters
params (Sequence[click.Parameter]) – list of
click.Parameter
instancesctx (click.Context) –
click.Context
- Raises
- Return type
-
class
cloup.constraints.
WrapperConstraint
(constraint, **attrs)[source]¶ Bases:
Constraint
Abstract class that wraps another constraint and delegates all methods to it. Useful when you want to define a parametric constraint combining other existing constraints minimizing the boilerplate.
This is an alternative to defining a function and using
Rephraser
. Feel free to do that in your code, but cloup will stick to the convention that parametric constraints are defined as classes and written in camel-case.- Parameters
constraint (cloup.constraints._core.Constraint) – the constraint to wrap
attrs (Any) – these are just used to generate a
__repr__
method
-
help
(self, ctx)[source]¶ A description of the constraint.
- Parameters
ctx (click.Context) –
- Return type
-
check_consistency
(self, params)[source]¶ Perform some sanity checks that detect inconsistencies between these constraints and the properties of the input parameters (e.g. required).
For example, a constraint that requires the parameters to be mutually exclusive is not consistent with a group of parameters with multiple required options.
These sanity checks are meant to catch developer’s mistakes and don’t depend on the values assigned to the parameters; therefore:
they can be performed before any parameter parsing
they can be disabled in production (setting
check_constraints_consistency=False
incontext_settings
)
- Parameters
params (Sequence[click.Parameter]) – list of
click.Parameter
instances- Raises
UnsatisfiableConstraint
if the constraint cannot be satisfied independently from the values provided by the user- Return type
-
check_values
(self, params, ctx)[source]¶ Check that the constraint is satisfied by the input parameters in the given context, which (among other things) contains the values assigned to the parameters in
ctx.params
.You probably don’t want to call this method directly. Use
check()
instead.- Parameters
params (Sequence[click.Parameter]) – list of
click.Parameter
instancesctx (click.Context) –
click.Context
- Raises
- Return type
-
cloup.constraints.
accept_none
¶ Satisfied if none of the parameters is set. Useful only in conditional constraints.
-
cloup.constraints.
all_or_none
¶ Satisfied if either all or none of the parameters are set.
-
cloup.constraints.
mutually_exclusive
¶ Satisfied if at most one of the parameters is set.
-
cloup.constraints.
require_all
¶ Satisfied if all parameters are set.
-
cloup.constraints.
require_any
¶ Alias for
RequireAtLeast(1)
.
-
cloup.constraints.
require_one
¶ Alias for
RequireExactly(1)
.
-
class
cloup.constraints.
BoundConstraintSpec
[source]¶ Bases:
NamedTuple
A NamedTuple storing a
Constraint
and the names of the parameters it has to check.- Parameters
constraint (cloup.constraints._core.Constraint) –
param_names (Sequence[str]) –
-
constraint
:cloup.constraints._core.Constraint¶
-
param_names
:Union[Sequence[str]]¶
-
resolve_params
(self, cmd)[source]¶ - Parameters
cmd (ConstraintMixin) –
- Return type
-
class
cloup.constraints.
ConstraintMixin
(*args, constraints=(), show_constraints=None, **kwargs)[source]¶ Provides support for constraints.
- Parameters
constraints (Sequence[Union[cloup.constraints._support.BoundConstraintSpec, cloup.constraints._support.BoundConstraint]]) – sequence of constraints bound to specific groups of parameters. Note that constraints applied to option groups are collected from the option groups themselves, so they don’t need to be included in this argument.
show_constraints (Optional[bool]) – whether to include a “Constraint” section in the command help. This is also available as a context setting having a lower priority than this attribute.
args (Any) – positional arguments forwarded to the next class in the MRO
kwargs (Any) – keyword arguments forwarded to the next class in the MRO
-
optgroup_constraints
¶ Constraints applied to
OptionGroup
instances.
-
param_constraints
:Tuple[BoundConstraint, Ellipsis]¶ Constraints registered using
@constraint
(or equivalent method).
-
all_constraints
¶ All constraints applied to parameter/option groups of this command.
-
parse_args
(self, ctx, args)[source]¶ - Parameters
ctx (click.Context) –
args (List[str]) –
- Return type
List[str]
-
get_params_by_name
(self, names)[source]¶ - Parameters
names (Iterable[str]) –
- Return type
Sequence[click.Parameter]
-
format_constraints
(self, ctx, formatter)[source]¶ - Parameters
ctx (click.Context) –
formatter (cloup.HelpFormatter) –
- Return type
-
must_show_constraints
(self, ctx)[source]¶ - Parameters
ctx (click.Context) –
- Return type
-
cloup.constraints.
constrained_params
(constr, *param_adders)[source]¶ Return a decorator that adds the given parameters and applies a constraint to them. Equivalent to:
@param_adders[0] ... @param_adders[-1] @constraint(constr, <param names>)
This decorator saves you to manually (re)type the parameter names. It can also be used inside
@option_group
.Instead of using this decorator, you can also call the constraint itself:
@constr(*param_adders)
but remember that:
Python 3.9 is the first that allows arbitrary expressions on the right of
@
;using a long conditional/composite constraint as decorator may be less readable.
In these cases, you may consider using
@constrained_params
.New in version 0.9.0.
- Parameters
constr (cloup.constraints._core.Constraint) – an instance of
Constraint
param_adders (Callable[[Callable[[..], Any]], Callable[[..], Any]]) – function decorators, each attaching a single parameter to the decorated function.
- Return type
Callable[[F], F]
-
cloup.constraints.
constraint
(constr, params)[source]¶ Register a constraint on a list of parameters specified by (destination) name (e.g. the default name of
--input-file
isinput_file
).- Parameters
constr (cloup.constraints._core.Constraint) –
params (Iterable[str]) –
- Return type
Callable[[F], F]
-
class
cloup.constraints.
AllSet
(*param_names)[source]¶ Bases:
Predicate
True if all listed parameters are set.
New in version 0.8.0.
- Parameters
param_names (str) –
-
negated_description
(self, ctx)[source]¶ Succinct description of the negation of this predicate (alias: neg_desc).
- Parameters
ctx (click.Context) –
- Return type
-
description
(self, ctx)[source]¶ Succinct description of the predicate (alias: desc).
- Parameters
ctx (click.Context) –
- Return type
-
__call__
(self, ctx)[source]¶ Evaluate the predicate on the given context.
- Parameters
ctx (click.Context) –
- Return type
-
class
cloup.constraints.
AnySet
(*param_names)[source]¶ 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)[source]¶ Succinct description of the negation of this predicate (alias: neg_desc).
- Parameters
ctx (click.Context) –
- Return type
-
description
(self, ctx)[source]¶ Succinct description of the predicate (alias: desc).
- Parameters
ctx (click.Context) –
- Return type
-
__call__
(self, ctx)[source]¶ Evaluate the predicate on the given context.
- Parameters
ctx (click.Context) –
- Return type
-
class
cloup.constraints.
Equal
(param_name, value)[source]¶ Bases:
Predicate
True if the parameter value equals
value
.- Parameters
param_name (str) –
value (Any) –
-
description
(self, ctx)[source]¶ Succinct description of the predicate (alias: desc).
- Parameters
ctx (click.Context) –
- Return type
-
negated_description
(self, ctx)[source]¶ Succinct description of the negation of this predicate (alias: neg_desc).
- Parameters
ctx (click.Context) –
- Return type
-
__call__
(self, ctx)[source]¶ Evaluate the predicate on the given context.
- Parameters
ctx (click.Context) –
- Return type
-
class
cloup.constraints.
IsSet
(param_name)[source]¶ Bases:
Predicate
True if the parameter is set.
- Parameters
param_name (str) –
-
description
(self, ctx)[source]¶ Succinct description of the predicate (alias: desc).
- Parameters
ctx (click.Context) –
- Return type
-
negated_description
(self, ctx)[source]¶ Succinct description of the negation of this predicate (alias: neg_desc).
- Parameters
ctx (click.Context) –
- Return type
-
__call__
(self, ctx)[source]¶ Evaluate the predicate on the given context.
- Parameters
ctx (click.Context) –
- Return type
-
class
cloup.constraints.
Not
(predicate)[source]¶ Bases:
Predicate
,Generic
[P
]Logical NOT of a predicate.
- Parameters
predicate (P) –
-
description
(self, ctx)[source]¶ Succinct description of the predicate (alias: desc).
- Parameters
ctx (click.Context) –
- Return type
-
negated_description
(self, ctx)[source]¶ Succinct description of the negation of this predicate (alias: neg_desc).
- Parameters
ctx (click.Context) –
- Return type
-
__call__
(self, ctx)[source]¶ Evaluate the predicate on the given context.
- Parameters
ctx (click.Context) –
- Return type
-
exception
cloup.constraints.
ConstraintViolated
(message, ctx, constraint, params)[source]¶ Bases:
click.UsageError
An internal exception that signals a usage error. This typically aborts any further handling.
- Parameters
message (str) – the error message to display.
ctx (click.Context) – optionally the context that caused this error. Click will fill in the context automatically in some situations.
constraint (cloup.constraints._core.Constraint) –
params (Sequence[click.Parameter]) –
Initialize self. See help(type(self)) for accurate signature.
-
classmethod
default
(cls, desc, ctx, constraint, params)[source]¶ - Parameters
desc (str) –
ctx (click.Context) –
constraint (cloup.constraints._core.Constraint) –
params (Sequence[click.Parameter]) –
- Return type
-
exception
cloup.constraints.
UnsatisfiableConstraint
(constraint, params, reason)[source]¶ Bases:
Exception
Raised if a constraint cannot be satisfied by a group of parameters independently from their values at runtime; e.g.
mutually_exclusive
cannot be satisfied if multiple of the parameters are required.Initialize self. See help(type(self)) for accurate signature.
- Parameters
constraint (cloup.constraints._core.Constraint) –
params (Iterable[click.Parameter]) –
reason (str) –