[Qgis-psc] QGIS grant report: PyQGIS linter warnings

[Julien Cabieces]

Hi PSC,

Here is the report for the grant regarding the QEP #287 [0]

Contrary to what was initially proposed, I didn't modify *.pyi files at
build time using python scripts. I tried it and it was perfecly working
but it was making the whole building process a bit more complex and
fragile and brought more dependencies to install.

So, I went the hardway and contribute to SIP [1] [2] so it could
generate the *.pyi file directly. In addition to static linter message
initially planned, I also added the support of deprecated messages when
the deprecation warning is raised at runtime.

And so the deprecated annotation with message is now used in QGIS since
#59834 [3].

Be aware that you need a Python-SIP 6.9.0 or more to have your
deprecated message fully working (if not, you would have the same
behavior than before).

I couldn't make the proposed modifications on the plugin platform
because of 2 reasons:
- Python-SIP 6.9.0 and the associated PyQt built with it are not yet
included in any linux distribution (it just appeared in fedora rawhide
but I would prefer use a "stable" distribution)
- I completely exceeded the allocated budget, specially in my way to
contribute to SIP.

I'll try to secure funding to implement the plateform plugin part next year.

Thanks again for funding this work.

Regards,
Julien

[0] https://github.com/qgis/QGIS-Enhancement-Proposals/issues/287
[1] https://github.com/Python-SIP/sip/pull/46
[2] https://github.com/Python-SIP/sip/pull/51
[3] https://github.com/qgis/QGIS/pull/59834



-- 

Julien Cabieces
Senior Developer at Oslandia
julien.cabieces at oslandia.com