Editor

The Notebook is great for exploratory work, but when you are writing a standalone script, a utility module, or a longer program you want to save as a .py file, the Editor is where you go. It gives you a full-featured code editing environment with Tree-Sitter-powered syntax highlighting, line numbers, code folding, and the ability to run your script and see output in a panel below.

Writing Code

The Editor works like a text editor built specifically for Python. You get a full-screen writing area with line numbers in the left gutter, a current-line highlight so you never lose your place, and syntax highlighting that color-codes your code as you type.

def greet(name, times=1):
    for i in range(times):
        print(f"Hello, {name}!")

greet("Pyodios", times=3)

iPhone

iPad

What you are seeing above:

1. Tab bar: shows your open files; tap the + button to create a new tab
2. Line numbers: displayed in the left gutter for easy reference and debugging
3. Syntax highlighting: Python code is color-coded so keywords, strings, functions, and comments are visually distinct
4. Output panel: at the bottom, shows results when you run your script
5. Toolbar: contains undo/redo, find, editor actions menu, and the run button

Syntax Highlighting

The Editor uses Tree-Sitter for syntax highlighting, which means it understands the structure of your Python code rather than just matching patterns. The highlighting covers:

• Keywords like if, for, def, class, return, shown in purple
• Functions like print(), len(), range(), shown in blue
• Strings like "hello world" and f"value: {x}", shown in red/coral
• Numbers like 42, 3.14, shown in green
• Comments starting with #, shown in gray
• Decorators like @staticmethod, @dataclass, highlighted distinctly

The colors adapt to light and dark mode automatically.

iPhone

iPad

Editor Options

Editor behavior is split across two pages in Settings:

• Settings > Editor holds the editing options: Tab Size, Auto-indent, Line Numbers, Highlight Current Line, Word Wrap, and Auto-close Brackets.
• Settings > Appearance holds the color themes that apply to both the Editor and the Notebook code cells. Pick a Light Theme and a Dark Theme independently. The active one follows the system appearance. Popular options include Dracula, Monokai, Solarized Light, and Nord. See the dedicated Themes page for the full list, custom theme editor, and import/export options.

iPhone

iPad

Code Outline

For longer scripts, the Code Outline provides a structural map of your file. It shows all your functions, classes, and import statements in a sidebar list. Tap any entry to jump directly to that location in the code. Access the outline from the File menu > Navigate > Code Outline, or use the keyboard shortcut Cmd+Shift+O on iPad.

iPhone

iPad

Code Folding

Enable code folding from the … menu to collapse functions, classes, loops, and other code blocks. Small chevrons appear in the gutter next to lines that start a foldable block. Tap a chevron to collapse the block, hiding everything inside it so you can focus on the section you are working on. Tap again to expand.

iPhone

iPad

1. Fold chevron: tap the arrow in the gutter to collapse or expand a code block
2. Folded region: collapsed code is hidden and replaced with a summary indicator

Find and Replace

Tap the magnifying glass icon in the toolbar to open the find bar. Type a search term to highlight all matches in your code and navigate between them with the up and down arrows. Expand the find bar to reveal the replace field, where you can replace matches one at a time or all at once.

Code Completion

As you type, the Editor suggests function names, variable names, module members, and keyword arguments. Suggestions appear in a popup below the cursor; tap one to insert it. When you type the opening parenthesis of a function call, signature help shows the function’s parameters so you know what arguments it expects.

iPhone

iPad

Snippets

When you want a quick starting point, the Snippets feature provides pre-built Python code templates organized by category. Open it from the … menu (Editor actions) and browse templates covering common patterns like creating DataFrames, plotting, writing classes, working with files, and more.

Each snippet uses placeholder syntax. After inserting one, you can quickly fill in the variable names and values relevant to your task. You can also create your own custom snippets for code patterns you use frequently.

Snippets are a great way to learn Python patterns too. Insert one, read through it, and experiment with modifying it to see what changes.

Multi-file Tabs

The Editor supports multiple open files through a tab bar at the top of the screen. Tap a tab to switch to that file, tap the x on a tab to close it, and tap the + button to create a new empty tab. A blue dot on a tab indicates unsaved changes.

For file operations, tap the document icon in the top-left toolbar to open the File menu:

• New Tab: creates a fresh, empty editor tab
• Open…: opens the iOS file picker so you can load any .py or text file from Files, iCloud Drive, or other storage providers
• Open Recent: quickly reopen files you have worked on before
• Save: saves the current tab (you will be prompted for a filename if the file is new)
• Export to Gist: shares your code as a GitHub Gist

Files are saved as .py scripts in the app’s project storage. You can also find them in the Files tab.

iPhone

iPad

Running Your Code

There are two ways to execute code from the Editor, and the run button color tells you which mode you are in:

• Green play button: runs your entire script from top to bottom. This is what you get when no text is selected.
• Blue play button: runs only the selected text. Select a portion of your code (by long-pressing and dragging), and the play button turns blue to indicate it will run just that selection.

iPhone

iPad

Here is an example script you might write and run:

def fibonacci(n):
    """Generate first n Fibonacci numbers."""
    fib = [0, 1]
    for i in range(2, n):
        fib.append(fib[-1] + fib[-2])
    return fib

result = fibonacci(10)
print(result)

Output from your script appears in the Output panel at the bottom of the Editor. You can resize this panel by dragging the handle at its top edge, collapse it by tapping the chevron, or double-tap the divider to toggle it open and closed.

Running a selection is incredibly useful for debugging. If your script is not producing the result you expect, select just one section at a time to see where things go off track.

The Python Keyboard Toolbar

When the keyboard is open, a scrollable toolbar appears just above it with buttons for common Python symbols and operators. This saves you from hunting through the iOS symbol keyboard for characters you use constantly in Python:

• Tab: inserts four spaces for indentation
• =: the assignment operator
• :: used for slices, dict literals, and block starters
• ( ) [ ] { } "": matched pairs that insert both characters at once
• #: comment prefix
• _: underscore, common in Python variable names
• def: quickly insert the def keyword
• import: quickly insert the import keyword

There is also a dismiss keyboard button at the far right of the toolbar so you can quickly hide the keyboard and see more of your code.

iPhone

iPad

You can customize which buttons appear on the Python keyboard accessory under Settings > Editor > Keyboard Toolbar. Add, remove, or reorder buttons so the symbols you use most are within one tap.

File Operations

The File menu (tap the document icon in the toolbar) gives you full control over your scripts:

• New Tab: start a fresh file
• Open: load an existing .py file from anywhere accessible to iOS Files
• Open Recent: re-open recently edited files
• Save / Save As: save to the app’s storage or to an external location
• Export to Gist: share your code as a GitHub Gist for easy sharing and collaboration

iPad Features

On iPad, you can open the Editor in a detached window using iPadOS multi-window support. Long-press a file in the Files tab and choose Open in New Window, or use Window > New Editor Window from the menu bar with a hardware keyboard. This lets you have the notebook open in one window and the editor in another, or two editor windows side by side. You can also use the Split Editor feature to view two files side by side within a single editor window, and standard iPad Split View / Slide Over works too for running Pyodios alongside Safari or Notes.

With an external keyboard on iPad, you can use Cmd+R to run your script, Cmd+S to save, Cmd+F to find, and Cmd+Z / Cmd+Shift+Z for undo/redo.