From 729aeb2425985182950d3a967361c351b290fc8b Mon Sep 17 00:00:00 2001
From: Kay0u <pierre@kayou.io>
Date: Mon, 30 Mar 2020 19:36:41 +0200
Subject: [PATCH] add ynh_permission_has_user

---
 data/actionsmap/yunohost.yml |  9 +++++++++
 data/helpers.d/setting       | 19 +++++++++++++++++++
 src/yunohost/permission.py   | 22 ++++++++++++++++++++++
 src/yunohost/user.py         |  6 ++++++
 4 files changed, 56 insertions(+)

diff --git a/data/actionsmap/yunohost.yml b/data/actionsmap/yunohost.yml
index 245b3615d..af697efc0 100644
--- a/data/actionsmap/yunohost.yml
+++ b/data/actionsmap/yunohost.yml
@@ -296,6 +296,15 @@ user:
                             help: Display all info known about each permission, including the full user list of each group it is granted to.
                             action: store_true
 
+                ### user_permission_info()
+                info:
+                    action_help: Get information about a specific permission
+                    api: GET /users/permissions/<permission>
+                    arguments:
+                        permission:
+                            help: Name of the permission to fetch info about
+                            extra:
+                                pattern: *pattern_username
 
                 ### user_permission_update()
                 update:
diff --git a/data/helpers.d/setting b/data/helpers.d/setting
index 557afb332..917d4def7 100644
--- a/data/helpers.d/setting
+++ b/data/helpers.d/setting
@@ -367,3 +367,22 @@ ynh_permission_update() {
 
     yunohost user permission update "$app.$permission" ${add:-} ${remove:-}
 }
+
+# Check if a permission exists
+#
+# usage: ynh_permission_has_user --permission=permission --user=user
+# | arg: -p, --permission - the permission to check
+# | arg: -u, --user - the user seek in the permission
+#
+# Requires YunoHost version 3.7.1 or higher.
+ynh_permission_has_user() {
+    declare -Ar args_array=( [p]=permission= [u]=user)
+    local permission
+    ynh_handle_getopts_args "$@"
+
+    if ! ynh_permission_exists --permission $permission
+        return 1
+    fi
+
+    yunohost user permission info $permission | grep -w -q "$user"
+}
\ No newline at end of file
diff --git a/src/yunohost/permission.py b/src/yunohost/permission.py
index 71472eeaf..79b346a1f 100644
--- a/src/yunohost/permission.py
+++ b/src/yunohost/permission.py
@@ -196,6 +196,28 @@ def user_permission_reset(operation_logger, permission, sync_perm=True):
 
     return new_permission
 
+
+def user_permission_info(permission, sync_perm=True):
+    """
+    Return informations about a specific permission
+
+    Keyword argument:
+        permission -- Name of the permission (e.g. mail or nextcloud or wordpress.editors)
+    """
+
+    # By default, manipulate main permission
+    if "." not in permission:
+        permission = permission + ".main"
+
+    # Fetch existing permission
+
+    existing_permission = user_permission_list(full=True)["permissions"].get(permission, None)
+    if existing_permission is None:
+        raise YunohostError('permission_not_found', permission=permission)
+
+    return existing_permission
+
+
 #
 #
 #  The followings methods are *not* directly exposed.
diff --git a/src/yunohost/user.py b/src/yunohost/user.py
index bc19bc5ea..69baf4435 100644
--- a/src/yunohost/user.py
+++ b/src/yunohost/user.py
@@ -792,6 +792,12 @@ def user_permission_reset(permission, sync_perm=True):
                                                      sync_perm=sync_perm)
 
 
+def user_permission_info(permission, sync_perm=True):
+    import yunohost.permission
+    return yunohost.permission.user_permission_info(permission,
+                                                     sync_perm=sync_perm)
+
+
 #
 # SSH subcategory
 #