sage.features.Executable: Add method absolute_filename

[mkoeppe]

We refactor Executable and StaticFile through a base class FileFeature.

The method absolute_filename replaces StaticFile.absolute_path and is now also available for Executable. (This is for #33440/#31296/#30818.)

The renaming from StaticFile.absolute_path to absolute_filename (with deprecation) is preparation for reclaiming the name absolute_path for a method that returns a Path instead of a str.

We also add some type annotations.

Follow-up: #31296

CC: @tobiasdiez @fchapoton @seblabbe @orlitzky @kiwifb @antonio-rojas @tornaria

Component: refactoring

Author: Matthias Koeppe

Branch/Commit: e9568e9

Reviewer: Tobias Diez

Issue created by migration from https://trac.sagemath.org/ticket/31292

[mkoeppe]

comment:1

Setting new milestone based on a cursory review of ticket status, priority, and last modification date.

[mkoeppe]

Description changed:

--- 
+++ 
@@ -1 +1,4 @@
-In particular, we change `absolute_path` to return a `Path`
+In particular, we change `StaticFile.absolute_path` to return a `Path`.
+
+We also add a method `Executable.absolute_path`. (This is for #33440/#31296/#30818.)
+

[mkoeppe]

Author: Matthias Koeppe

[mkoeppe]

Replying to @mkoeppe:

In particular, we change StaticFile.absolute_path to return a Path.

Actually this would lead to errors like

File "src/sage/databases/cremona.py", line 1552, in sage.databases.cremona.LargeCremonaDatabase.degphi
Failed example:
    c = CremonaDatabase()
Exception raised:
...
      File "/Users/mkoeppe/s/sage/sage-rebasing/worktree-gcc11/local/var/lib/sage/venv-python3.9/lib/python3.9/site-packages/sage/databases/sql_db.py", line 1066, in __init__
        elif (filename[-3:] != '.db'):
    TypeError: 'PosixPath' object is not subscriptable

[mkoeppe]

Branch: u/mkoeppe/sage_features_staticfile__executable__use_pathlib__add_type_annotations

[mkoeppe]

Commit: 32ce831

[mkoeppe]

New commits:

32ce831

sage.features.Executable.absolute_path: New

[mkoeppe]

Description changed:

--- 
+++ 
@@ -1,4 +1,4 @@
-In particular, we change `StaticFile.absolute_path` to return a `Path`.
+We add a method `Executable.absolute_path`, in analogy to `StaticFile`. (This is for #33440/#31296/#30818.)
 
-We also add a method `Executable.absolute_path`. (This is for #33440/#31296/#30818.)
+We also add some type annotations.
 

[sagetrac-git]

Changed commit from 32ce831 to 88860d3

[sagetrac-git]

Branch pushed to git repo; I updated commit sha1. New commits:

88860d3

sage.features.Executable.absolute_path: If SAGE_LOCAL != SAGE_VENV, search first in SAGE_VENV/bin, SAGE_LOCAL/bin, then PATH

[sagetrac-git]

Branch pushed to git repo; I updated commit sha1. This was a forced push. New commits:

[sagetrac-git]

Changed commit from 88860d3 to 32ce831

[mkoeppe]

Description changed:

--- 
+++ 
@@ -2,3 +2,5 @@
 
 We also add some type annotations.
 
+Follow-up: #31296
+

[sagetrac-git]

Changed commit from 32ce831 to 8bb7e3a

[sagetrac-git]

Branch pushed to git repo; I updated commit sha1. New commits:

8bb7e3a

src/sage/features/__init__.py: Relax doctest