From 9142bebff2657f2129a2028137f81d09db989968 Mon Sep 17 00:00:00 2001 From: Simon Charette Date: Sun, 5 Aug 2018 22:15:10 -0400 Subject: Refs #11964 -- Changed CheckConstraint() signature to use keyword-only arguments. Also renamed the `constraint` argument to `check` to better represent which part of the constraint the provided `Q` object represents. --- docs/ref/models/check-constraints.txt | 14 +++++++------- docs/ref/models/options.txt | 2 +- 2 files changed, 8 insertions(+), 8 deletions(-) (limited to 'docs/ref') diff --git a/docs/ref/models/check-constraints.txt b/docs/ref/models/check-constraints.txt index 29681d7ebc..06ddd26b54 100644 --- a/docs/ref/models/check-constraints.txt +++ b/docs/ref/models/check-constraints.txt @@ -23,20 +23,20 @@ explains the API references of :class:`CheckConstraint`. ``CheckConstraint`` options =========================== -.. class:: CheckConstraint(constraint, name) +.. class:: CheckConstraint(*, check, name) Creates a check constraint in the database. -``constraint`` --------------- +``check`` +--------- -.. attribute:: CheckConstraint.constraint +.. attribute:: CheckConstraint.check -A :class:`Q` object that specifies the condition you want the constraint to +A :class:`Q` object that specifies the check you want the constraint to enforce. -For example ``CheckConstraint(Q(age__gte=18), 'age_gte_18')`` ensures the age -field is never less than 18. +For example ``CheckConstraint(check=Q(age__gte=18), name='age_gte_18')`` +ensures the age field is never less than 18. ``name`` -------- diff --git a/docs/ref/models/options.txt b/docs/ref/models/options.txt index 3994e408a5..6c098a8f56 100644 --- a/docs/ref/models/options.txt +++ b/docs/ref/models/options.txt @@ -469,7 +469,7 @@ Django quotes column and table names behind the scenes. class Meta: constraints = [ - models.CheckConstraint(models.Q(age__gte=18), 'age_gte_18'), + models.CheckConstraint(check=models.Q(age__gte=18), name='age_gte_18'), ] ``verbose_name`` -- cgit v1.3