TOC for `.py` files with percent markup

I suggest to have a TOC available for .py files with percent markup. I guess for that we’ll need to have the user select which kind of “Outline” view is of interest - the one for regular code files (which will not pickup e.g. markdown cells), or the one adjusted for notebooks.

My use case - in our team we manage a big .py file that acts as a sort of “catalog” of useful and relatively independent cells. This has to go under source control for version management and collaboration. The typical workflow is then to open an Interactive Window and execute a few of the cells of interest. So for finding these cells in the large file the described TOC is useful.

_Originally posted by @syagev in https://github.com/microsoft/vscode-jupyter/issues/1348#issuecomment-814769835_

[GitHunter0]

@DavidKutu , great! A TOC in the Outline pane is incredibly helpful, I miss that feature very much.

Two suggestions if I may:

(1) The hierarchical section system of Spyder IDE seems a good one to implement:

#%% Section
#%%% Subsection
#%%%% Subsubsection
And so on

(2) Since VScode is providing native conversion from .py files to notebooks (.ipynb), it would be nice to have a syntax that allows the user to go back and forth between .py and .ipynb maintaining code sections, markdown sections and TOC intact.

Thank you

[DavidKutu]

Thanks for the request @syagev! We’ll discuss it in an upcoming meeting.