RhinoPython is a plugin to allow you to code Rhino python script in VS Code editor and run it in Rhino runtime. It inherits all the autocomplete intelligence from original rhinopython editor and can react faster, while you can benifit all the amazing advatanges that VS Code brings to you.
It is a DesignToProduction open source project, programmed initially for internal use.
From v0.1.7, it supports both Rhino 5 and Rhino 6, with correct build being installed.
:star: If you prefer to code in Visual Studio, RhinoPythonForVS is a lot faster and provides much better IntelliSense. Give it a try!
The same way as you use the original editor. Just more efficient, simpler and faster.
Check this youtube video to see more clearly of the gif shown below.
This is the client side of RhinoPython editor. To bridge it to Rhino you need a server to listen to VS Code editor, which is another plugin called CodeListener.
Install VS code.
Install python for VS code. It's recommended to familarize yourself with python for VS code at this post first.
Install RhinoPython for VS code.
CodeListener file in food4rhino, and install it.
Start Rhino, click
tools -> pythonscript -> edit, in the python editor, click
tools -> options, copy those module paths. You might have additional libraries and you have to copy them as well.
In Rhino, click
tools -> options -> Plug-ins -> CodeListener -> Proterties, copy the file containing folder path and open it in the explorer. Copy the
AutoComplete folder path.
Start VS Code, open
user settings by keyboard shortcut
Ctrl+, paste the libraries paths and autocomplete path into the
user settings with key "python.autoComplete.extraPaths", below is an example setting.
AutoComplete doesn't work even if you add the path into
python.autoComplete.extraPaths, it's probably that you haven't add the root folder of the library. For instance, if your library
ExampleLib is under folder
"...\Libs", you might have to add
"...\Libs instead of
// disable certain pylint messages
// python autocomplete extra path
"C:\\Program Files\\Rhinoceros 5 (64-bit)\\Plug-ins\\IronPython\\Lib",
// enable new language server. THIS IS EXTREMELY IMPORTANT TO HAVE FAST AUTOCOMPLETE!!
// Enable/Disable rhinopython
// True if you want to reset script engine every time you send code, otherwise False
The microsoft team has implemented their own language server, which replaces the old jedi languange server. This has made autocomplete in python super fast and it is strongly recommended to enable it by
"python.jediEnabled": false in the settings.
- Start Rhino, type command
CodeListener. You should see
VS Code Listener Started....
You can add
CodeListener into Rhino Command Lists every time Rhino starts.
There are other commands in Rhino:
- Start VS Code, create a new file (To have python autocomplete and lint working you have to specify it's python file) or open an existing python file or folder or workspace.
- Send the your code by simply press
F2 or by typing command
CodeSender in Command Palette(
Ctrl+Shift+P) You should then see returned printed message or errors in
Debug Console. Depending on your
RhinoPython.ResetAndRun settings, you might reset script engine every time before you send.
- If you want to reset Rhino Python Script Engine, simply press
Ctrl + R.
The following settings can be configured under User Settings:
RhinoPython.Enabled: Enable/Disable this RhinoPython extension.
RhinoPython.ResetAndRun: Determines if
CodeSender Command) reset the script engine every time before it executes.
- The debugger has not implemented yet.
- It only supports one Rhino instance at a time. If you want to switch Rhino instance, either close the former Rhino instance or command
StopCodeListener on the former one.
The IntelliSense of RhinoCommon in VS Code is originated from ironpython-stubs. Thanks to Gui Talarico.