Fosstodon @fosstodon

Recent searches

Search options

Only available when logged in.

0 posts0 participants0 posts today

**Timothée Mazzucotelli** @pawamoy · Mar 26 *

Mar 26 *

Timothée Mazzucotelli @pawamoy

Presenting #Yore again, because it's a nice little tool for library maintainers:

- mark legacy code with comments: `# YORE: EOL 3.9: Remove line`
- check periodically: `yore check`
- see applied diff (dry-run): `yore diff`
- actually fix comments: `yore fix`

https://github.com/pawamoy/yore

git grep command showing Yore comments in pyproject.toml and mkdocs.yml:

mkdocs.yml: # YORE: BOL 3.13: Replace `3.13` with `3` within line.
mkdocs.yml- - url: https://docs.python.org/3.13/objects.inv
--
pyproject.toml: # YORE: EOL 3.8: Remove line.
pyproject.toml- "astunparse>=1.6; python_version < '3.9'",

% yore check
mkdocs.yml:221: since 2024-10-07 BOL 3.13: Replace `3.13` with `3` within line
pyproject.toml:40: since 2024-10-07 EOL 3.8: Remove line

The diff if we applied `yore fix` (highlighted with the `delta` tool)

% yore fix
fixed 1 comment in mkdocs.yml
fixed 1 comment in pyproject.toml

#python

**Timothée Mazzucotelli** @pawamoy · Oct 7, 2024

Oct 7, 2024

Timothée Mazzucotelli @pawamoy

Python 3.8 just reached EOL, time to run some `yore` commands!

Funny how providing a time delta before EOL changes to human-readable format "approx. a moment"

Screenshot of the terminal, where we ran the following commands:

yore check
yore check -E '1 day'

Output shows file paths with line numbers, and "Python 3.8 has reached its End of Life since 2024-10-07". In the second command output, the message is replaced with "... will reach its EOL within approx. a moment".

Screenshot of the terminal, where we ran the following commands

yore fix
git diff

In the Git diff output, we see that portions of code where automatically "fixed" now that Python 3.8 is EOL and doesn't have to be supported by the library code anymore. For example, `lstrip("_")` was replaced with `removeprefix("_")`, or some import conditions were simplified (`from ast import unparse`), or entire blocks of code were removed (`if sys.version_info < (3, 9): ...`).

#python #yore #legacy

**Timothée Mazzucotelli** @pawamoy · Jul 5, 2024

Jul 5, 2024

Timothée Mazzucotelli @pawamoy

I'm marking all the deprecated stuff in #Griffe with #Yore comments.

Yore is a new tool of mine that helps you manage legacy code. You write comments above lines or blocks of code, with a simple grammar for applying transformations once a version is reached (e.g. 1.0.0) or once a minor Python version reaches its End Of Life.

$git grep -A1 YORE src/_griffe/expressions.py:# YORE: EOL 3.9: Replace `**_dataclass_opts` with `slots=True` within line. src/_griffe/expressions.py-@dataclass(eq=True, **_dataclass_opts) -- src/_griffe/expressions.py:# YORE: EOL 3.8: Remove block. src/_griffe/expressions.py-if sys.version_info < (3, 9): -- src/_griffe/extensions/base.py:# YORE: Bump 1.0.0: Remove block. src/_griffe/extensions/base.py-class VisitorExtension: -- src/_griffe/extensions/base.py:# YORE: Bump 1.0.0: Remove block. src/_griffe/extensions/base.py-class InspectorExtension: -- src/_griffe/extensions/base.py:# YORE: Bump 1.0.0: Remove block. src/_griffe/extensions/base.py-ExtensionType = Union[VisitorExtension, InspectorExtension, Extension] -- src/_griffe/extensions/base.py:# YORE: Bump 1.0.0: Regex-replace `\bExtensionType\b` with `Extension` within line. src/_griffe/extensions/base.py-LoadableExtensionType = Union[str, Dict[str, Any], ExtensionType, Type[ExtensionType]] -- src/_griffe/extensions/base.py: # YORE: Bump 1.0.0: Replace `ExtensionType` with `Extension` within line. src/_griffe/extensions/base.py- def __init__(self, *extensions: ExtensionType) -> None: -- src/_griffe/extensions/base.py: # YORE: Bump 1.0.0: Remove block. src/_griffe/extensions/base.py- self._visitors: dict[When, list[VisitorExtension]] = defaultdict(list) -- src/_griffe/extensions/base.py: # YORE: Bump 1.0.0: Replace `ExtensionType` with `Extension` within line. etc.$

#python #legacy #deprecation

Drag & drop to upload

Recent searches

Search options

Administered by:

Server stats:

#yore