@JKSH said in Do I need to add qmldir for python objects exposed as singleton instances?:

In addition to QML instantiation, these decorators automatically generate the qmldir + *.qmltypes files. These files are read by qmllint and the QML Language Server (qmlls) to understand your Python types.

I am not sure how adding a decorator to my class can generate these files so the language server can recognize the types. I feel like I am missing something here related to the qt tools provided for python but I cant see what. Going through the documentation I have tried to use pyside6-project build but nothing really happens even if I dont get any errors. I tried using pyside6-project qmllint and get the same warnings. My qml file and the .py file where the @QmlElement decorated class lives have been added to the pyproject.toml. Still not *.qmltypes are generated in this process. Information about these tools seems scarce so I am wondering if I am missing something.

My understanding was that when I use @QmlElement/QmlSingleton I was making the types available for QML to instantiate.

Yes, @QmlElement allows your type to be instantiated in QML. @QmlSingleton is quite flexible: The QML engine could automatically instantiate your singleton, or you can make the engine use your existing instance by implementing a static create() method (see below).

In addition to QML instantiation, these decorators automatically generate the qmldir + *.qmltypes files. These files are read by qmllint and the QML Language Server (qmlls) to understand your Python types.

In my case, I am creating an instance of my class on the python side that I am registering after, so I can inject some dependencies into it before the QML engine gets it.

Are you saying that if I just use both decorators in my class, I can still instantiate it before loading the engine and then my QML code can use the instance I created on the python side?

If you define a static create() method (see https://doc.qt.io/qtforpython-6/PySide6/QtQml/QmlSingleton.html), the QML engine calls that method instead of automatically instantiating your type.

You can instantiate your object in Python, do your injections, then initialize the QML engine. The engine will call create() at this point, so let create() return your existing object (you can ignore the "engine" parameter of the method if you only have one engine).

The Python docs are a bit sparse; see the C++ docs to get an idea on how to use create(): https://doc.qt.io/qt-6/qml-singleton.html#defining-singletons-in-c

So I am not sure if I would need to do smth else extra or this approach does not work for registering an instance of my class.

The newer @QmlElement and its friends are replacing the older qmlRegister*() functions. If you want to continue using qmlRegister*(), you'll need to manually write a qmldir file and *.qmltypes file to keep qmllint/qmlls happy. Use some auto-generated ones as a template.

Are you saying that if I just use both decorators in my class, I can still instantiate it before loading the engine and then my QML code can use the instance I created on the python side? I actually did a quick test just changing that and it fails with:

<Unknown File>: qmlRegisterSingletonType(): "AppController" is not available because the callback function returns a null pointer.

So I am not sure if I would need to do smth else extra or this approach does not work for registering an instance of my class.

@Munhz said in Do I need to add qmldir for python objects exposed as singleton instances?:

Now My AppController doesnt use @QmlElement or @QmlSingleton bc as far as I understand I dont need those while registering a singleton instance this way. Now on my qml file I get a warning as TodoApp cant be imported

It's the other way round: If you use @QmlElement + @QmlSingleton, then you don't need to call qmlRegisterSingletonInstance() and you shouldn't get those warnings.

Just remember that your main.py file must import the file that contains @QmlElement and the related decorators/variables before you initialize your QML engine.