Latest HA update 2025.12.3 broke '@pyscript_compile'

[erkr]

After my update from HA core 2025.12.2 to 2025.12.3, my modules that use @pyscript_compile fail to load.

Example of the module code:

import yaml

# this extra class avoids we add the generic loader for others 
@pyscript_compile
class YamlLoader(yaml.SafeLoader):
    pass

The error:

This error originated from a custom integration.

Logger: custom_components.pyscript.file.search_config
Source: custom_components/pyscript/global_ctx.py:341
integration: Pyscript Python scripting (documentation, issues)
First occurred: 20:22:58 (1 occurrence)
Last logged: 20:22:58

Exception in </config/pyscript/modules/yaml_loader.py> line 4: @pyscript_compile ^ NameError: name 'pyscript_compile' is not defined ```

[ALERTua]

O_o same for me

[dmamelin]

@pyscript_compile
class YamlLoader(yaml.SafeLoader):

That’s very strange:

• @pyscript_compile was never processed for classes
• this should have raised an error before as well class decorators were ignored before Improve class loading #778

Which version of Pyscript is installed?

[ALERTua]

I'm on the master branch HEAD commit.

[erkr]

I'm on v1.7.0.
I'm not a python programmer. So this was part of a copied snippet.

I commented it out for the classes (understand it won't have impact), and left them in for the functions. Now it compiles

Latest core update made it fail. Not the latest pyscript update

[erkr]

I didn't want to polute this issue with another error after the core update. But maybe relevant, as it seems the compilation got more strict (and if so I can close this issue).

For these two lines I got an name error for final as well (commented them out and inserted the resulting strings in the code):

DOMAIN: Final = "websocket_api"
DATA_CONNECTIONS: Final = f"{DOMAIN}.connections"

Just for my understanding, was that invalid python code as well? It was working untill the lasted core update

Thanks for your help so far!

[dmamelin]

Before version 1.7.0, class decorators were completely ignored. Initial support for class decorators was added in #778.
So it’s caused by the Pyscript update, not by Home Assistant.

[erkr]

Ok, wierd though, it didn't fail after updating to v1.7.0 some days ago

[dmamelin]

For these two lines I got an name error for final as well (commented them out and inserted the resulting strings in the code):

I can’t reproduce this. Could you provide more details: imports, the class definition up to the first method, and the error log?

Ok, wierd though, it didn't fail after updating to v1.7.0 some days ago

I didn’t see anything in the 2025.12.3 changelog that could explain this issue.

[erkr]

Of course. This is the whole file:

DOMAIN: Final = "websocket_api"
DATA_CONNECTIONS: Final = f"{DOMAIN}.connections"

from homeassistant.auth import auth_store 
from homeassistant.auth.models import User, RefreshToken
from datetime import datetime, timezone

@service(supports_response="only")
def get_users_info(include_tokens=False, return_response=True):
    """yaml
description: List configured users and their tokens
fields:
    include_tokens:
        name: Include Refresh Tokens
        description: Include the Refresh Tokens info for each user
        default: false
        example: true
        selector:
            boolean: 
""" 
    store = auth_store.AuthStore(hass)
    store.async_load()
    users = store.async_get_users()
    if users:
        result=[]
        for u in users:
           entry = { "name": u.name, "id": u.id, "is_owner": u.is_owner, "is_active": u.is_active,
                     "local_only": u.local_only, "system_generated": u.system_generated }
           if include_tokens:
               tokens = u.refresh_tokens
               tokenInfo=[]
               for k,v in tokens.items():
                   exp = datetime.fromtimestamp(v.expire_at, timezone.utc) if v.expire_at else None
                   tokenInfo += [{"token_type": v.token_type, "id": v.id, "token": v.token, "last_used_at": v.last_used_at, 
                                  "expire_at": exp, "last_used_ip": v.last_used_ip, "client_id": v.client_id} ]
               entry["tokens"] = sorted(tokenInfo,  key=lambda d: d['last_used_at'], reverse=True)
           result += [entry]
        return { "result": "success", "connections": hass.data.get(DATA_CONNECTIONS, 0), "users": result }
    return { "result": "failed" }

It seems, the compilation got more strict. So not a bug. I never understood the first two lines. Which worked before, but maybe not correct.

Now I'm passing the url directly as a string:

        return { "result": "success", "connections": hass.data.get("websocket_api.connections", 0), "users": result }

Update, the error:

This error originated from a custom integration.

Logger: custom_components.pyscript.file.get_users_info
Source: custom_components/pyscript/global_ctx.py:341
integration: Pyscript Python scripting (documentation, issues)
First occurred: 16:08:34 (1 occurrence)
Last logged: 16:08:34

Exception in </config/pyscript/get_users_info.py> line 1: DOMAIN: Final = "websocket_api" ^ NameError: name 'Final' is not defined

[ALERTua]

You haven't imported Final from typing.
https://docs.python.org/3/library/typing.html#typing.Final

[erkr]

Thanks, I will give that a try. I copied this without understanding tbh (and worked before)

Edit: yes that fixes it 🙏

Wil close the issue, as somehow, these code constructs where not ok to begin with, without surfacing before the updates.

Thanks for the help. I learned from you guys 😀

[dmamelin]

It worked before because type annotations (: Final) were ignored.
The correct code is:

from typing import Final
DOMAIN: Final = "websocket_api"
DATA_CONNECTIONS: Final = f"{DOMAIN}.connections"