Trac #30747: Deprecate sage.misc.package functions standard_packages, optional_packages, experimental_packages

These functions are superseded by the more general function
`list_packages`.

This is also a step toward deprecating all of `sage.misc.package`.

URL: https://trac.sagemath.org/30747
Reported by: mkoeppe
Ticket author(s): Matthias Koeppe
Reviewer(s): John Palmieri

Author: Release Manager

build/pkgs/configure/checksums.ini

@@ -1,4 +1,4 @@
 tarball=configure-VERSION.tar.gz
-sha1=24c85de6c9a1b6ceac8b26b1eeef8d66eefc7fd0
-md5=e1b3adb6f13d5731be4f13f1dfed11cc
-cksum=2688232296
+sha1=67f6206cf84dd6ad7dcfc88c85d8a60fc8cfc804
+md5=ea0cbc6181c37d24a0113c1affd0d1dc
+cksum=4111744968

build/pkgs/configure/package-version.txt

@@ -1 +1 @@
-7194a858ab1eb039fdbdddbfaeee15cccd73d237
+344dd08c66028e6e9200d1fef4aa7ef20049eb78

src/sage/misc/package.py

@@ -425,9 +425,14 @@ def standard_packages():
 
         sage: from sage.misc.package import standard_packages
         sage: installed, not_installed = standard_packages()  # optional - build
+        doctest:...: DeprecationWarning: ...
         sage: installed[0], installed[-1]  # optional - build
         ('alabaster', 'zope_interface')
     """
+    from sage.misc.superseded import deprecation
+    deprecation(30747,
+                'the functions standard_packages, optional_packages, experimental_packages'
+                'are deprecated, use sage.features instead')
     pkgs = list_packages('standard', local=True).values()
     return (sorted(pkg['name'] for pkg in pkgs if pkg['installed']),
             sorted(pkg['name'] for pkg in pkgs if not pkg['installed']))
@@ -454,12 +459,17 @@ def optional_packages():
 
         sage: from sage.misc.package import optional_packages
         sage: installed, not_installed = optional_packages()  # optional - build
+        doctest:...: DeprecationWarning: ...
         sage: 'beautifulsoup4' in installed+not_installed  # optional - build
         True
 
         sage: 'beautifulsoup4' in installed   # optional - build beautifulsoup4
         True
     """
+    from sage.misc.superseded import deprecation
+    deprecation(30747,
+                'the functions standard_packages, optional_packages, experimental_packages'
+                'are deprecated, use sage.features instead')
     pkgs = list_packages('optional', local=True)
     pkgs = pkgs.values()
     return (sorted(pkg['name'] for pkg in pkgs if pkg['installed']),
@@ -487,7 +497,12 @@ def experimental_packages():
 
         sage: from sage.misc.package import experimental_packages
         sage: installed, not_installed = experimental_packages()  # optional - build
+        doctest:...: DeprecationWarning: ...
     """
+    from sage.misc.superseded import deprecation
+    deprecation(30747,
+                'the functions standard_packages, optional_packages, experimental_packages'
+                'are deprecated, use sage.features instead')
     pkgs = list_packages('experimental', local=True).values()
     return (sorted(pkg['name'] for pkg in pkgs if pkg['installed']),
             sorted(pkg['name'] for pkg in pkgs if not pkg['installed']))