qgis plugin dev on mac os - notes for ide setup

qgis-plugin-vscode-mac.md

I am mainly following

AsgerPetersen's gist and MS's visualstudio python-tutorial and qgis developer_cookbook

1. install this extension pack

2. install ptvsd using the QGIS python3 bin:

cd /Applications/QGIS.app/Contents/MacOS/bin
./python3 -m pip install ptvsd  

3. do not install firstaid qqis plugin (or uninstall - see comment below)

4. install lmotta/debug_vs_plugin

5. fork and/or clone a plugin repo and open the repo in vs code

cd "~/Library/Application Support/QGIS/QGIS3/profiles/default/python/plugins"
git clone git@github.com:onezoomin/VolumeCalculation.git && cd VolumeCalculation && code .

6. If the repo doesn't already have one, add a debug profile and adapt
   6b. Choose the qgis bin folder as Python Interpreter /Applications/QGIS.app/Contents/MacOS/bin

7. Try to set a breakpoint somewhere predictable, eg: on the about button
   7b. go to qgis and start the vsdebugger
   7c. start debugging session from vs code
   7d. use the plugin in qgis in a way that will hit your breakpoint
   eg: click the volume calc button and then click about in the dialog

When i feel this is more refined and thorough, i'd like to submit a PR to here:
https://github.com/qgis/QGIS-Documentation/blob/master/docs/pyqgis_developer_cookbook/plugins/ide_debugging.rst

This also needs to be added/integrated/considered:
https://py-vscode.readthedocs.io/en/latest/files/linting.html

windows centric, but conceptually relevant:
https://gispofinland.medium.com/cooking-with-gispo-qgis-plugin-development-in-vs-code-19f95efb1977

My command in #5 was slightly different:
cd "/Users/korinna/Library/Application Support/QGIS/QGIS3/profiles/default/python/plugins"

Note: The debugging mode (=stopping at a breakpoint) only worked after deinstalling FirstAid.

Error message in the python console in QGIS:

PYDEV DEBUGGER WARNING:
sys.settrace() should not be used when the debugger is being used.
This may cause the debugger to stop working correctly.
If this is needed, please check:
http://pydev.blogspot.com/2007/06/why-cant-pydev-debugger-work-with.html
to see how to restore the debug tracing back correctly.