As discussed in this thread, it would be nice to have a simple text editor that supports code highlight and indentation that can be routed directly into the python console for interactive python scripts.
Would be a valuable tool for novices starting to learn Slicer API and python programming and test samples from Script repository.
Cool…
like the sublime Text?
'''
li zhenzhu
Ningbo NO.2 Hospital
'''
import os
from pathlib import Path
import sys
import re
from PyQt5.QtWidgets import *
from PyQt5.QtGui import *
from PyQt5.QtCore import *
class MainWindow(QMainWindow):
def __init__(self, parent=None):
QMainWindow.__init__(self, parent)
self._highlighter = Highlighter()
self.setup_file_menu()
self.setup_editor()
self.setCentralWidget(self._editor)
self.setWindowTitle(self.tr("Syntax Highlighter"))
def new_file(self):
self._editor.clear()
def open_file(self, path=""):
file_name = path
if not file_name:
file_name, _ = QFileDialog.getOpenFileName(self, self.tr("Open File"), "",
"Python Files (*.py)")
if file_name:
in_file = QFile(file_name)
if in_file.open(QFile.ReadOnly | QFile.Text):
stream = QTextStream(in_file)
self._editor.setPlainText(stream.readAll())
def setup_editor(self):
class_format = QTextCharFormat()
class_format.setFontWeight(QFont.Bold)
class_format.setForeground(Qt.blue)
pattern = r'^\s*class\s+\w+\(.*$'
self._highlighter.add_mapping(pattern, class_format)
function_format = QTextCharFormat()
function_format.setFontItalic(True)
function_format.setForeground(Qt.blue)
pattern = r'^\s*def\s+\w+\s*\(.*\)\s*:\s*$'
self._highlighter.add_mapping(pattern, function_format)
comment_format = QTextCharFormat()
comment_format.setBackground(QColor("#77ff77"))
self._highlighter.add_mapping(r'^\s*#.*$', comment_format)
font = QFontDatabase.systemFont(QFontDatabase.FixedFont)
self._editor = QPlainTextEdit()
self._editor.setFont(font)
self._highlighter.setDocument(self._editor.document())
def setup_file_menu(self):
file_menu = self.menuBar().addMenu(self.tr("&File"))
new_file_act = file_menu.addAction(self.tr("&New..."))
new_file_act.setShortcut(QKeySequence(QKeySequence.New))
new_file_act.triggered.connect(self.new_file)
open_file_act = file_menu.addAction(self.tr("&Open..."))
open_file_act.setShortcut(QKeySequence(QKeySequence.Open))
open_file_act.triggered.connect(self.open_file)
quit_act = file_menu.addAction(self.tr("E&xit"))
quit_act.setShortcut(QKeySequence(QKeySequence.Quit))
quit_act.triggered.connect(self.close)
help_menu = self.menuBar().addMenu("&Help")
help_menu.addAction("About &Qt", qApp.aboutQt) # noqa: F821
class Highlighter(QSyntaxHighlighter):
def __init__(self, parent=None):
QSyntaxHighlighter.__init__(self, parent)
self._mappings = {}
def add_mapping(self, pattern, format):
self._mappings[pattern] = format
def highlightBlock(self, text):
for pattern, format in self._mappings.items():
for match in re.finditer(pattern, text):
start, end = match.span()
self.setFormat(start, end - start, format)
if __name__ == '__main__':
app = QApplication(sys.argv)
window = MainWindow()
window.resize(640, 512)
window.show()
window.open_file(os.fspath(Path(__file__).resolve()))
sys.exit(app.exec())
this from Syntax Highlighter Example - Qt for Python
the picture after running
Yes, something like that. A real basic editor, just a step above a text editor that preserve indentations, and some highlighting…
Storing code snippets in the scene is a good idea. The Texts module GUI is simple and fast (can handle text updates at hundreds of times per second for IGT use cases), so I would not try to add serious text editing features to it.
Jupyter notebook is a close-to-perfect solution for script development (it supports syntax highlighting, auto-complete, function documentation, code block execution, interactive step-by-step debugging, etc.) and it is already available in Slicer. But it is somewhat heavyweight (requires packages of about 1GB in total) and by default saves the text in a separate file (so we would need to figure out a solution for saving it to the scene). So, it may make sense to explore alternatives.
Trying to improve QTextEdit to match features of a modern code editor is hard. We know from our experience with the Python console. It took a lot of time of several developers and it is still very limited and has a number of bugs that we can not find time to fix.
Embedding an existing editor (implemented in C++, Python, or running in the web browser) could work. Embedding VS Code would be quite an obvious choice due to its popularity, and it should be feasible, too (see for example in github and elsewhere). Marimo is quite lighweight, uses text for script storage, and has a notebook-like interface, but somebody would need to figure out how to run it within an existing Python session. There are many web-based code editors out there.
It could be also possible to develop plugins for an existing editor that to allow remote code execution in Slicer’s Python environment. Similarly to how it is discussed here.
Do we really need all the features of a full fledged code editor? What I was seeking is meant to provide simple, internal mechanism to direct python code into console. what you are proposing is almost integrating a full IDE into Slicer, which I am all for it, but is sum of the requirement to make it work would be any less than Jupyter Notebook?
From the example @timeanddoctor pasted above (and I saw online the same link), I thought it might be a simple change to the Text module, but of course I will defer to you folks.
I support Murat’s idea, having a simple editor inside Slicer that executes the code in the console on a button press would be really useful, and the Texts module could be a natural place for it, given that it is the only place with a sizeable text field, and then the snippets could be stored in the scene.
The reason it would be useful is that many times I am experimenting with simple things like setting display options, string operations, or anything that is relatively short, I open Notepad++, start typing there, and then copy-paste the code until it does what I exactly want it to do. Then I paste it in the actual code. The reason that I cannot just do the edit-copy-paste cycle in my VS code with all the code is that it is indented, so it does not run in the console (and many times I need to use temporary variables to get it to run etc.).
In terms of features I think relatively basic things could do the trick, like support of indentation with tab. I think this alone could speed up this development style a lot. A full-fledged editor would be awesome of course, but this simlpe feature in Texts would take very little development, but would still improve such workflows considerably.
As far as I know @pieper works a similar way, maybe he could comment on this too. (Edit: I see he already answered in the previous topic)
I work in a very similar way.
Further improvement of helping during this prototyping code snippet phase would be if valid execution in the python console could then go into a texts area as a code command history stack. Then I could copy-paste from there back into my editor more easily. Otherwise I have to filter through the python console to find my input lines between the output lines while also ignoring the >> prefix that is in the Python console for each line.
That would be great.
I think I would also potentially use this a lot if it were available. I have two early stage development workflows that I use now:
I would probably use Text module code running similarly to the Ctrl-G method. Advantages over Ctrl-G are:
Disadvantages vs Ctrl-G are:
Time would tell whether it was more convenient to use the Text module code approach or the Ctrl-G + VS Code window approach. In any case, I would also appreciate it if any code run via Ctrl-G or via the Texts module was logged in the history. Currently, using the Ctrl-G approach, there is no way to see what was run when when looking back.
Here’s an experiment everyone should be able to try and if we like the approach we could flesh it out with more features like hotkeys, saving buffers to Text nodes, command history, etc.
The approach is to use the monaco editor, which is the core javascript code that runs in VSCode in a qSlicerWebWidget. Since the python and javascript code can communicate its easy to send text buffers back and forth.
To try this you just need to paste this into your python console:
editor = slicer.qSlicerWebWidget()
editor.size = qt.QSize(900, 750)
editor.url = "https://pieper.github.io/SlicerEditor"
editor.show()
Then click the slicer icon to execute.
More info in the repository: https://github.com/pieper/SlicerEditor
This looks workable to me. Couple questions:
When/if implemented will this still require an external URL to work, or the editor app would be fully local? Reaching out internet to work is always a challenge and potential obstacle in my particular work environment.
Would it be possible to highlight the code to be sent to console? (Currently it is sending everything).
Otherwise, it seems fine to me with proper resizing of the window, some icons and shortcuts and ability to save the text buffers and retrieving them, it definitely fits the bill.
Yes, it can be hosted from the Slicer WebServer if we want to bundle everything. It’s not a huge amount of code but monaco has a lot of features like multiple language support that we may not want to carry along.
Yes, that is easy - try refreshing. For now it sends the selection if there is one, otherwise the full buffer. It could be a separate button if we want.
I think the one thing that would keep me from using this a lot would be the lack of autocomplete (the tab pop-up menu we have in the python console). For that we could either expose the ctkPythonConsoleCompleter or just reimplement it in python and hook it into monaco.
When incorporated, it will be nice if Edit button in Developer mode opens the module codes in this too (or people can continue to register their own preferred editors)
This is amazing @pieper ! I’ll use it a bit and see what could be next.
@mikebind I wish I knew about the Ctrl-G combination earlier 
I’m excited about the potential of integrating a simple code editor within Slicer’s Text module. The ability to directly execute Python code from a lightweight editor would streamline the development process, especially for quick prototyping and testing. I agree that features like code highlighting and indentation support would be invaluable for beginners and experienced users alike. The idea of embedding an existing editor like VS Code sounds promising, but I appreciate the concern about keeping the solution lightweight. Looking forward to seeing how this feature evolves!
@Robert_Leo did you try the SlicerEditor demo linked above? It already integrates the core editor features of vscode to run code. It does not yet integrated with the Texts module but that would be very doable.
Hi. I think I would like to work on this new feature during Project Week as well. I’ve created a draft project page:
Project: Simple Editor for Python Scripting · Issue #1128 · NA-MIC/ProjectWeek (github.com)