pythongh-117873: Deprecate grp keyword arguments

vstinner · vstinner · commit b8bde53c3af3 · 2024-04-17T23:14:28.000+02:00
diff --git a/Doc/whatsnew/3.13.rst b/Doc/whatsnew/3.13.rst
@@ -891,6 +891,10 @@ Deprecated
   *root_dir* argument instead.
   (Contributed by Barney Gale in :gh:`117337`.)
 
+* :mod:`grp`: Deprecate passing keyword arguments to :func:`grp.getgrgid` and
+  :func:`grp.getgrnam` functions.
+  (Contributed by Victor Stinner in :gh:`117873`.)
+
 * :mod:`http.server`: :class:`http.server.CGIHTTPRequestHandler` now emits a
   :exc:`DeprecationWarning` as it will be removed in 3.15.  Process-based CGI
   HTTP servers have been out of favor for a very long time.  This code was
diff --git a/Misc/NEWS.d/next/Library/2024-04-17-23-14-05.gh-issue-117873.3cf35E.rst b/Misc/NEWS.d/next/Library/2024-04-17-23-14-05.gh-issue-117873.3cf35E.rst
@@ -0,0 +1,2 @@
+:mod:`grp`: Deprecate passing keyword arguments to :func:`grp.getgrgid` and
+:func:`grp.getgrnam` functions. Patch by Victor Stinner.
diff --git a/Modules/clinic/grpmodule.c.h b/Modules/clinic/grpmodule.c.h
diff --git a/Modules/grpmodule.c b/Modules/grpmodule.c
@@ -114,6 +114,7 @@ mkgrent(PyObject *module, struct group *p)
 grp.getgrgid
 
     id: object
+    / [from 3.15]
 
 Return the group database entry for the given numeric group ID.
 
@@ -122,7 +123,7 @@ If id is not valid, raise KeyError.
 
 static PyObject *
 grp_getgrgid_impl(PyObject *module, PyObject *id)
-/*[clinic end generated code: output=30797c289504a1ba input=15fa0e2ccf5cda25]*/
+/*[clinic end generated code: output=30797c289504a1ba input=37d91205dc746913]*/
 {
     PyObject *retval = NULL;
     int nomem = 0;
@@ -194,6 +195,7 @@ grp_getgrgid_impl(PyObject *module, PyObject *id)
 grp.getgrnam
 
     name: unicode
+    / [from 3.15]
 
 Return the group database entry for the given group name.
 
@@ -202,7 +204,7 @@ If name is not valid, raise KeyError.
 
 static PyObject *
 grp_getgrnam_impl(PyObject *module, PyObject *name)
-/*[clinic end generated code: output=67905086f403c21c input=08ded29affa3c863]*/
+/*[clinic end generated code: output=67905086f403c21c input=9006cc8364872920]*/
 {
     char *buf = NULL, *buf2 = NULL, *name_chars;
     int nomem = 0;

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	+:mod:`grp`: Deprecate passing keyword arguments to :func:`grp.getgrgid` and
	`2`	+:func:`grp.getgrnam` functions. Patch by Victor Stinner.