mkoeppe commented 4 years ago

For Sage 10.4, all of the following features can be used

Python 3.6 features (https://docs.python.org/3.10/whatsnew/3.6.html):

pathlib
static typing
- 32058 add typing annotations in permutations
- 32067 Developer manual: Section on typing annotations
- 29775 Add a bit of typing to manifold code
- 30381 Python 3 typing/protocols/ABCs
- 30511 Type hints (__annotations__) and coercion/Cython
native namespace packages - #28925
yield from - #29857
f-strings (formatted strings)
keyword-only parameters (#16607, #31309)
new import machinery - #27074 (Make .sage modules importable)
__matmul__ (infix @ operator) - #22760
from ..a import b
...?

Python 3.7 features (https://docs.python.org/3.10/whatsnew/3.7.html)

importlib.resources (#31306)
fromfutureimport annotations (#31006)
https://docs.python.org/3/library/dataclasses.html

Python 3.8 features (https://docs.python.org/3.10/whatsnew/3.8.html)

assignment expressions := (https://docs.python.org/3.10/whatsnew/3.8.html#assignment-expressions)
positional-only parameters (PEP 570)
f'{expr=}' https://docs.python.org/3.10/whatsnew/3.8.html#f-strings-support-for-self-documenting-expressions-and-debugging
PEP 590: Vectorcall: a fast calling protocol for CPython https://docs.python.org/3.10/whatsnew/3.8.html#pep-590-vectorcall-a-fast-calling-protocol-for-cpython
functools.cached_property() https://docs.python.org/3.10/whatsnew/3.8.html#functools
pprint(sort_dicts=False)
shutil.copytree(dirs_exist_ok=True) https://docs.python.org/3.10/whatsnew/3.8.html#shutil
as_integer_ratio, __index__ special method (https://docs.python.org/3.10/whatsnew/3.8.html#other-language-changes)
math.dist, hypot, prod, perm, comb, isqrt https://docs.python.org/3.10/whatsnew/3.8.html#math
typing.TypedDict, typing.Literal, Final, Protocol https://docs.python.org/3.10/whatsnew/3.8.html#typing

Python 3.9 features (https://docs.python.org/3.10/whatsnew/3.9.html)

Features introduced in Python 3.10 or later cannot be used in Sage yet because we support system Python 3.9.x

Python 3.10 features (https://docs.python.org/3.10/whatsnew/3.10.html):

34678: match ... case
36609

Python 3.11 features (https://docs.python.org/3.11/whatsnew/3.11.html):

Python 3.12 features (https://docs.python.org/3.12/whatsnew/3.12.html):

Python 3.13 features (https://docs.python.org/3.13/whatsnew/3.13.html):

--- 
+++ 
@@ -2,5 +2,6 @@
 - types (#29775)
 - native namespace packages - #28925
 - `yield from` - #29857
+- [importlib.resources](https://docs.python.org/3/library/importlib.html#module-importlib.resources) (requires python 3.7 or backport `importlib_resources` if we want to support 3.6 - but that does not support resources within namespace packages)
 - ...?

slel commented 4 years ago

Description changed:

--- 
+++ 
@@ -3,5 +3,6 @@
 - native namespace packages - #28925
 - `yield from` - #29857
 - [importlib.resources](https://docs.python.org/3/library/importlib.html#module-importlib.resources) (requires python 3.7 or backport `importlib_resources` if we want to support 3.6 - but that does not support resources within namespace packages)
-- ...?
+- f-strings (formatted strings)
+  - ...?

slel commented 4 years ago

Description changed:

--- 
+++ 
@@ -4,5 +4,8 @@
 - `yield from` - #29857
 - [importlib.resources](https://docs.python.org/3/library/importlib.html#module-importlib.resources) (requires python 3.7 or backport `importlib_resources` if we want to support 3.6 - but that does not support resources within namespace packages)
 - f-strings (formatted strings)
-  - ...?
+- ...?

+See also:
+
+- #29728: Meta-ticket: improve compatibility with the Python library

slel commented 4 years ago

comment:11

Regarding f-strings, see this comment:

#30107 comment:19

mkoeppe commented 4 years ago

Description changed:

--- 
+++ 
@@ -4,6 +4,7 @@
 - `yield from` - #29857
 - [importlib.resources](https://docs.python.org/3/library/importlib.html#module-importlib.resources) (requires python 3.7 or backport `importlib_resources` if we want to support 3.6 - but that does not support resources within namespace packages)
 - f-strings (formatted strings)
+- keyword-only parameters (#16607)
 - ...?

 See also:

mkoeppe commented 4 years ago

Description changed:

--- 
+++ 
@@ -5,6 +5,7 @@
 - [importlib.resources](https://docs.python.org/3/library/importlib.html#module-importlib.resources) (requires python 3.7 or backport `importlib_resources` if we want to support 3.6 - but that does not support resources within namespace packages)
 - f-strings (formatted strings)
 - keyword-only parameters (#16607)
+- new import machinery - #27074    (Make `.sage` modules importable)
 - ...?

 See also:

mkoeppe commented 4 years ago

Description changed:

--- 
+++ 
@@ -6,6 +6,7 @@
 - f-strings (formatted strings)
 - keyword-only parameters (#16607)
 - new import machinery - #27074    (Make `.sage` modules importable)
+- `__matmul__` (infix `@` operator) - #22760
 - ...?

 See also:

mkoeppe commented 4 years ago

Description changed:

--- 
+++ 
@@ -7,6 +7,7 @@
 - keyword-only parameters (#16607)
 - new import machinery - #27074    (Make `.sage` modules importable)
 - `__matmul__` (infix `@` operator) - #22760
+- `from ..a import b`
 - ...?

 See also:

mkoeppe commented 4 years ago

Description changed:

--- 
+++ 
@@ -1,5 +1,5 @@

-- types (#29775)
+- types (#29775, #30381)
 - native namespace packages - #28925
 - `yield from` - #29857
 - [importlib.resources](https://docs.python.org/3/library/importlib.html#module-importlib.resources) (requires python 3.7 or backport `importlib_resources` if we want to support 3.6 - but that does not support resources within namespace packages)

mkoeppe commented 4 years ago

Description changed:

--- 
+++ 
@@ -13,3 +13,5 @@
 See also:

 - #29728: Meta-ticket: improve compatibility with the Python library
+- #30384: Adopt the “time window-based” policy for support of Python versions from NEP 29
+

mwageringel commented 4 years ago

comment:18

Replying to @egourgoulhon:

About types, has a general policy been discussed on sage-devel?

+1 for using typing. Return types in particular are useful for tab-completion on the result of function calls. For example

sage: "hello".upper().lower().upper()

this tab-completes without evaluating the code (i.e. without setting IPython's IPCompleter.greedy config option).

mkoeppe commented 4 years ago

Description changed:

--- 
+++ 
@@ -1,5 +1,7 @@

-- types (#29775, #30381)
+- static typing (#29775, #30381)
+  - #30381 Python 3 typing/protocols/ABCs
+  - #30511 Type hints (`__annotations__`) and coercion/categories/Cython
 - native namespace packages - #28925
 - `yield from` - #29857
 - [importlib.resources](https://docs.python.org/3/library/importlib.html#module-importlib.resources) (requires python 3.7 or backport `importlib_resources` if we want to support 3.6 - but that does not support resources within namespace packages)

mkoeppe commented 4 years ago

Description changed:

--- 
+++ 
@@ -1,7 +1,8 @@

-- static typing (#29775, #30381)
+- static typing
+  - #29775 Add a bit of typing to manifold code
   - #30381 Python 3 typing/protocols/ABCs
-  - #30511 Type hints (`__annotations__`) and coercion/categories/Cython
+  - #30511 Type hints (`__annotations__`) and coercion/Cython
 - native namespace packages - #28925
 - `yield from` - #29857
 - [importlib.resources](https://docs.python.org/3/library/importlib.html#module-importlib.resources) (requires python 3.7 or backport `importlib_resources` if we want to support 3.6 - but that does not support resources within namespace packages)

mkoeppe commented 4 years ago

Description changed:

--- 
+++ 
@@ -1,3 +1,4 @@
+Python 3.6 features

 - static typing
   - #29775 Add a bit of typing to manifold code
@@ -5,7 +6,6 @@
   - #30511 Type hints (`__annotations__`) and coercion/Cython
 - native namespace packages - #28925
 - `yield from` - #29857
-- [importlib.resources](https://docs.python.org/3/library/importlib.html#module-importlib.resources) (requires python 3.7 or backport `importlib_resources` if we want to support 3.6 - but that does not support resources within namespace packages)
 - f-strings (formatted strings)
 - keyword-only parameters (#16607)
 - new import machinery - #27074    (Make `.sage` modules importable)
@@ -13,8 +13,14 @@
 - `from ..a import b`
 - ...?

+Python 3.7+ features
+
+- [importlib.resources](https://docs.python.org/3/library/importlib.html#module-importlib.resources) (requires python 3.7 or backport `importlib_resources` if we want to support 3.6 - but that does not support resources within namespace packages)
+
+
 See also:

 - #29728: Meta-ticket: improve compatibility with the Python library
 - #30384: Adopt the “time window-based” policy for support of Python versions from NEP 29
+- #30551 Drop Python 3.6 support

mwageringel commented 4 years ago

Description changed:

--- 
+++ 
@@ -17,6 +17,9 @@

 - [importlib.resources](https://docs.python.org/3/library/importlib.html#module-importlib.resources) (requires python 3.7 or backport `importlib_resources` if we want to support 3.6 - but that does not support resources within namespace packages)

+Python 3.8+ features:
+
+- positional-only parameters ([PEP 570](https://www.python.org/dev/peps/pep-0570/))

 See also: