gh-35841: deprecate some imports
    
- Head toward deprecation of automatic imports of some dev tools
- Remove unnecessary assignments in tests/benchmark.py

Deprecate the imports of some dev tools

<!-- Please provide a concise, informative and self-explanatory title.
-->
<!-- Don't put issue numbers in the title. Put it in the Description
below. -->
<!-- For example, instead of "Fixes #12345", use "Add a new method to
multiply two integers" -->

### 📚 Description

This is a branch to address #34259, replacing the old trac branch. It
doesn't make all of the original changes: the original branch. In
particular, the original branch added a bunch of lines like `from
sage.misc.misc import cputime` even though the import of `cputime` was
not changes, just in case someone wanted to change it later. I skipped
all of those additions. The original branch made a few other changes
that were not connected to the purposes of this pull request (e.g. the
changes to src/sage/combinat/composition.py), and I skipped those, too.

<!-- Describe your changes here in detail. -->
<!-- Why is this change required? What problem does it solve? -->
<!-- If this PR resolves an open issue, please link to it here. For
example "Fixes #12345". -->
<!-- If your change requires a documentation PR, please link it
appropriately. -->

### 📝 Checklist

<!-- Put an `x` in all the boxes that apply. It should be `[x]` not `[x
]`. -->

- [x] The title is concise, informative, and self-explanatory.
- [x] The description explains in detail what this PR is about.
- [x] I have linked a relevant issue or discussion.
- [x] I have created tests covering the changes.
- [x] I have updated the documentation accordingly.

### ⌛ Dependencies

<!-- List all open PRs that this PR logically depends on
- #12345: short description why this is a dependency
- #34567: ...
-->

<!-- If you're unsure about any of these, don't hesitate to ask. We're
here to help! -->
    
URL: #35841
Reported by: John H. Palmieri
Reviewer(s): Matthias Köppe

Author: Release Manager

src/sage/all.py

@@ -194,10 +194,6 @@
 copying = license
 copyright = license
 
-_cpu_time_ = cputime()
-_wall_time_ = walltime()
-
-
 def quit_sage(verbose=True):
     """
     Does nothing. Code that needs cleanup should register its own

src/sage/misc/abstract_method.py

@@ -127,10 +127,10 @@ def abstract_method(f=None, optional=False):
 
         sage: abstract_method(optional = True)
         <function abstract_method.<locals>.<lambda> at ...>
-        sage: abstract_method(optional = True)(banner)
-        <optional abstract method banner at ...>
-        sage: abstract_method(banner, optional = True)
-        <optional abstract method banner at ...>
+        sage: abstract_method(optional = True)(version)
+        <optional abstract method version at ...>
+        sage: abstract_method(version, optional = True)
+        <optional abstract method version at ...>
     """
     if f is None:
         return lambda f: AbstractMethod(f, optional=optional)
@@ -173,11 +173,11 @@ def __repr__(self):
         """
         EXAMPLES::
 
-            sage: abstract_method(banner)
-            <abstract method banner at ...>
+            sage: abstract_method(version)
+            <abstract method version at ...>
 
-            sage: abstract_method(banner, optional = True)
-            <optional abstract method banner at ...>
+            sage: abstract_method(version, optional = True)
+            <optional abstract method version at ...>
         """
         return "<" + ("optional " if self._optional else "") + "abstract method %s at %s>" % (self.__name__, hex(id(self._f)))
 
@@ -188,12 +188,12 @@ def _sage_src_lines_(self):
         EXAMPLES::
 
             sage: from sage.misc.sageinspect import sage_getsourcelines
-            sage: g = abstract_method(banner)
+            sage: g = abstract_method(version)
             sage: (src, lines) = sage_getsourcelines(g)
             sage: src[0]
-            'def banner():\n'
+            'def version():\n'
             sage: lines
-            89
+            19
         """
         from sage.misc.sageinspect import sage_getsourcelines
         return sage_getsourcelines(self._f)

src/sage/misc/all.py

@@ -15,36 +15,28 @@
 lazy_import('sage.misc.misc', 'union',
             deprecation=32096)
 
-from .banner import version, banner
+from .banner import version
 
-from .dev_tools import runsnake, import_statements
+from .dev_tools import import_statements
 
 from .html import html, pretty_print_default
 
 from .table import table
 
 from .sage_timeit_class import timeit
 
-from .edit_module import edit, set_edit_template
+from .edit_module import edit
 
 from .map_threaded import map_threaded
 
 from .session import load_session, save_session, show_identifiers
 
 from .remote_file import get_remote_file
 
-from .profiler import Profiler
-
 from .mrange import xmrange, mrange, xmrange_iter, mrange_iter, cartesian_product_iterator
 
 from .fpickle import pickle_function, unpickle_function
 
-from .dist import install_scripts
-
-lazy_import('sage.misc.package', ('installed_packages', 'is_package_installed',
-                                  'standard_packages', 'optional_packages',
-                                  'experimental_packages', 'package_versions'))
-
 lazy_import('sage.misc.pager', 'pager')
 
 lazy_import('sage.misc.sagedoc', ['browse_sage_doc',
@@ -128,8 +120,6 @@
 
 from .latex import LatexExpr, latex, view
 
-from .trace import trace
-
 from .randstate import seed, set_random_seed, initial_seed, current_randstate
 
 from .prandom import *
@@ -140,36 +130,15 @@
 
 lazy_import('sage.misc.inline_fortran', 'fortran')
 
-
-##########################################################################
-def benchmark(n=-1):
-    """
-    Run a well-chosen range of Sage commands and record the time it
-    takes for each to run.
-
-    INPUT:
-
-    - ``n`` -- int (default: -1); the benchmark number. The default
-      of -1 runs all the benchmarks.
-
-    OUTPUT:
-
-    - ``list`` -- summary of timings for each benchmark
-    """
-    import sage.misc.benchmark
-    return sage.misc.benchmark.benchmark(n)
-
-
-class logstr(str):
-    def __repr__(self):
-        return self
-
-    def _latex_(self):
-        # return "\\begin{verbatim}%s\\end{verbatim}"%self
-        if '#' not in self:
-            delim = '#'
-        elif '@' not in self:
-            delim = '@'
-        elif '~' not in self:
-            delim = '~'
-        return r"""\verb%s%s%s""" % (delim, self.replace('\n\n', '\n').replace('\n', '; '), delim)
+lazy_import('sage.misc.banner', 'banner', deprecation=34259)
+lazy_import('sage.misc.dev_tools', 'runsnake', deprecation=34259)
+lazy_import('sage.misc.edit_module', 'set_edit_template', deprecation=34259)
+lazy_import('sage.misc.profiler', 'Profiler', deprecation=34259)
+lazy_import('sage.misc.dist', 'install_scripts', deprecation=34259)
+lazy_import('sage.misc.trace', 'trace', deprecation=34259)
+lazy_import('sage.misc.package', ('installed_packages', 'is_package_installed',
+                                  'standard_packages', 'optional_packages',
+                                  'experimental_packages', 'package_versions'),
+            deprecation=34259)
+lazy_import('sage.misc.benchmark', 'benchmark', deprecation=34259)
+lazy_import('sage.repl.interpreter', 'logstr', deprecation=34259)

src/sage/misc/banner.py

@@ -100,7 +100,7 @@ def banner():
     EXAMPLES::
 
         sage: import sage.misc.banner; sage.misc.banner.SAGE_BANNER = ''
-        sage: banner()
+        sage: sage.misc.banner.banner()
         ┌────────────────────────────────────────────────────────────────────┐
         │ SageMath version ..., Release Date: ...                            │
         │ Using Python .... Type "help()" for help.                          │

src/sage/misc/dev_tools.py

@@ -31,6 +31,7 @@ def runsnake(command):
 
     EXAMPLES::
 
+        sage: from sage.misc.dev_tools import runsnake
         sage: runsnake("list(SymmetricGroup(3))")        # optional - runsnake
 
     ``command`` is first preparsed (see :func:`preparse`)::

src/sage/misc/dist.py

@@ -70,6 +70,7 @@ def install_scripts(directory=None, ignore_existing=False):
     EXAMPLES::
 
         sage: import tempfile
+        sage: from sage.misc.dist import install_scripts
         sage: with tempfile.TemporaryDirectory() as d:
         ....:     install_scripts(d, ignore_existing=True)
         doctest:warning...

src/sage/misc/lazy_attribute.pyx

@@ -82,7 +82,7 @@ cdef class _lazy_attribute():
         EXAMPLES::
 
             sage: from sage.misc.sageinspect import sage_getsourcelines
-            sage: g = lazy_attribute(banner)
+            sage: g = lazy_attribute(sage.misc.banner.banner)
             sage: (src, lines) = sage_getsourcelines(g)
             sage: src[0]
             'def banner():\n'

src/sage/misc/package.py

@@ -424,6 +424,7 @@ def installed_packages(exclude_pip=True):
     records of Python packages. Our ``SAGE_VENV`` is not necessarily the
     main Sage venv; it could be a user-created venv or a venv created by tox.)::
 
+        sage: from sage.misc.package import installed_packages
         sage: sorted(installed_packages().keys())         # optional - sage_spkg
         [...'conway_polynomials', ...]
         sage: installed_packages()['conway_polynomials']  # optional - sage_spkg, random
@@ -462,6 +463,7 @@ def is_package_installed(package, exclude_pip=True):
 
     EXAMPLES::
 
+        sage: from sage.misc.package import is_package_installed
         sage: is_package_installed('conway_polynomials')  # optional - sage_spkg
         True
 
@@ -532,6 +534,7 @@ def package_versions(package_type, local=False):
 
     EXAMPLES::
 
+        sage: from sage.misc.package import package_versions
         sage: std = package_versions('standard', local=True)  # optional - sage_spkg
         sage: 'gap' in std  # optional - sage_spkg
         True

src/sage/misc/profiler.py

@@ -28,6 +28,7 @@ class Profiler:
 
     EXAMPLES::
 
+        from sage.misc.profiler import Profiler
         sage: def f():                        # not tested
         ....:     p = Profiler()
 

src/sage/misc/trace.py

@@ -26,6 +26,7 @@ def trace(code, preparse=True):
 
     ::
 
+        sage: from sage.misc.trace import trace
         sage: trace("factor(100)")             # not tested
 
     then at the (Pdb) prompt type ``s`` (or ``step``), then press :kbd:`Return`
@@ -55,7 +56,7 @@ def trace(code, preparse=True):
 
         sage: import pexpect
         sage: s = pexpect.spawn('sage')
-        sage: _ = s.sendline("trace('print(factor(10))'); print(3+97)")
+        sage: _ = s.sendline("from sage.misc.trace import trace; trace('print(factor(10))'); print(3+97)")
         sage: _ = s.expect('ipdb>', timeout=90)
         sage: _ = s.sendline("s"); _ = s.sendline("c")
         sage: _ = s.expect('100', timeout=90)