Pidon Documentation

Pidon (aka PIDON) is an easier coding language that combines the best aspects of Python and TypeScript indefinitely. With enough creativity, it can also effectively replace HTML and CSS for templating workflows.

Throughout this documentation, whenever you see brackets (e.g., [var name here]), replace them — and the text inside — with the actual instructions or names specified in the description.

The full native IDE and desktop runtime is slated for release in September 2026. The countdown timer on the dashboard tracks the remaining time.

All Pidon source files must use the lowercase .pidon extension.

• type("Hello World") — Functions exactly like Python's print("Hello World").
• [var name here] = [content] — Creates a variable (similar to Python). Replace the bracketed placeholders with your actual variable name and content.
• let db [var name here] = python — Creates a variable for a database (replace db with ls for local storage). Replace let with make to create an actual file.
• let db [file name] = f"[file code here]" — Creates a database file. You must keep the f and the quotation marks; this is how the engine knows it's dealing with file content.
• Define — Functions exactly like Python's def for creating functions.
• stop — Halts the script execution (optional, but recommended for larger scripts).
• Make [file name]; Content: f"[content here]" — Creates a physical file with the specified content. Keep the f and quotation marks.
• Get source = [website here] — Scrapes the target website, grabbing as much data as possible, and downloads it as a local file.

• {[var name here]} — Every variable must be wrapped in {} after declaration (e.g., {apples} or {candy sold}).
• Input({user}, prompt) — Opens a prompt dialog. The user's input is stored in the variable specified in the first argument.
• Fetch response = input(text) — Captures input and stores it in a variable for later use.
• Warn({user}, msg) — Triggers a JavaScript-style alert dialog with the specified message.
• From [path]; & [file]; && Run — Executes an external .pidon file from the specified path. The && Run suffix is required.
• Del([folder]; [file]) && Run — Deletes a specified file or folder from the filesystem.
• Search("name") && del — Finds files or variables matching the name and deletes them.
• Request("{response}") to [folder]; [file] && run — Sends a request to a specific folder/file and fetches the response.

• while {website} == none — Functions exactly like a Python while loop.
• for x = true; — If the variable is true, it executes the subsequent block of code.
• repeat [number] of x — Repeats a block of code a specific number of times. The of x is optional.
• {rantimes} = /loop/ — Variable that automatically counts loop iterations. Must keep the exact /loop/ syntax.
• import python — Imports all of Python's math, logic, and capabilities.
• import lua — Imports all of Lua's gaming logic and capabilities.
• import golang — Imports all of Google's Go capabilities.
• import rust — Imports all of Rust's capabilities.
• {[var]} = /script.ran/ — Stores the identifier of the last script that was executed.
• del db {[db name]} — Deletes the specified database.

The Anchor System

Pidon acts as the main orchestrator (the "anchor"). When you use import python or import rust, those languages become runtime "addons." The Pidon engine reads top-to-bottom and dynamically hands off code blocks to the correct addon engine in the exact order you wrote them.

Syntax Pre-processing

Because Pidon is the anchor, its unique syntax (like {variables} and f"[files]") is natively understood. The engine handles this formatting before passing logic to addon engines — meaning Python and Rust never get confused by Pidon-specific brackets.

Mixing Languages

Standard logic can be written in Python, Lua, Rust, or Go, and you can mix them all in a single file. However, you must use the import keyword to activate a specific addon — you cannot write raw Python code without importing it first.

The File System

Commands like Make and let db interact with actual physical files and folders on your local hard drive. It writes real data to your machine based on the file paths you provide.

Web Fetching & Source Grabbing

Get source performs a raw scrape of the URL. It downloads the raw HTML/CSS/JS and saves it directly into a physical local file for you to use or parse.

By default, error handling operates silently. Unless 5 errors accumulate, the engine ignores the error, outputs the recommended fix in gray text, and attempts to auto-correct typos to the most likely intended command.

Error Handling Commands

• Try — Attempts to execute a command safely (e.g., Try apple = true).
• eilf — Functions as Pidon's equivalent to Python's elif (else-if).
• fetch {error} = type("/last_error/") — Fetches the details of the last error and stores it in a variable.
• {debug} = /fetch --10 commands/ — Fetches the last 10 commands executed. Replace 10 with any number.
• {verbose} = /verbose output/ — Enables verbose mode showing everything the engine does behind the scenes.
• {stop on error} = /error=stop/ — Forces the script to halt immediately on any error, overriding silent auto-correct.

Math functions just like Python. You can combine and mix operators in complex equations.