diff options
| author | mariatta <mariatta.wijaya@gmail.com> | 2026-04-03 11:44:02 -0700 |
|---|---|---|
| committer | Jacob Walls <jacobtylerwalls@gmail.com> | 2026-04-07 15:38:35 -0400 |
| commit | e2abe321a6f1370e05c1a89a742125c9eafcac8c (patch) | |
| tree | 85bd11175bfa5e3e3cc9e7ccbb9c3af31cc37f4e /docs | |
| parent | 74e73dc1315d696330621a7f08310a2e87ea0eba (diff) | |
Fixed #37021 -- Added Permission.user_perm_str property.
For use in checking user permissions via has_perm().
Co-authored-by: 사재혁 <jaehyuck.sa.dev@gmail.com>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/ref/contrib/auth.txt | 10 | ||||
| -rw-r--r-- | docs/releases/6.1.txt | 3 | ||||
| -rw-r--r-- | docs/topics/auth/default.txt | 9 |
3 files changed, 22 insertions, 0 deletions
diff --git a/docs/ref/contrib/auth.txt b/docs/ref/contrib/auth.txt index ff16de6423..b09b55cdda 100644 --- a/docs/ref/contrib/auth.txt +++ b/docs/ref/contrib/auth.txt @@ -405,6 +405,16 @@ Methods :class:`~django.contrib.auth.models.Permission` objects have the standard data-access methods like any other :doc:`Django model </ref/models/instances>`. +.. class:: models.Permission + :noindex: + + .. attribute:: user_perm_str + + .. versionadded:: 6.1 + + Returns the string representation for use in :meth:`has_perm + <django.contrib.auth.models.User.has_perm>`. + ``Group`` model =============== diff --git a/docs/releases/6.1.txt b/docs/releases/6.1.txt index 9c8aeea70c..00eaf5388d 100644 --- a/docs/releases/6.1.txt +++ b/docs/releases/6.1.txt @@ -129,6 +129,9 @@ Minor features * :attr:`.Permission.name` and :attr:`.Permission.codename` values are now renamed when renaming models via a migration. +* The new :attr:`.Permission.user_perm_str` property returns the string + suitable to use with :meth:`.User.has_perm`. + :mod:`django.contrib.contenttypes` ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/docs/topics/auth/default.txt b/docs/topics/auth/default.txt index 77888febb3..83925d009f 100644 --- a/docs/topics/auth/default.txt +++ b/docs/topics/auth/default.txt @@ -243,6 +243,15 @@ to test for basic permissions you should use: The :class:`~django.contrib.auth.models.Permission` model is rarely accessed directly. +The :class:`~django.contrib.auth.models.Permission` model provides a helper +property, :attr:`~django.contrib.auth.models.Permission.user_perm_str`, +that returns the string representation that can be used to check permission +using the :meth:`~django.contrib.auth.models.User.has_perm` method. + +.. versionchanged:: 6.1 + + The ``user_perm_str`` property was added. + Groups ------ |