oplang 1.0.1

One Piece Language: a lightweight scripting language with pirate syntax, a VM, debugger, and editor tooling.

OPL (One Piece Language)

OPL is a lightweight programming language with a readable pirate-flavored syntax and a real runtime behind it. It includes an AST interpreter, a stack-based bytecode VM, compiled .oplb files, closures, models, collections, modules, a standard library, CLI tooling, a debugger, LSP support, and a VSCode extension.

OPL source files use the .opl extension.

Features

• Pirate syntax frontend with clean core OPL underneath
• AST interpreter for reference execution
• Stack-based VM with compiled bytecode support
• .oplb build and inspect workflow
• First-class functions and lexical closures
• Models, methods, properties, and captain binding
• Lists, maps, indexing, for-in loops, and collection built-ins
• Modules/imports and first-party standard library
• CLI, REPL, formatter, diagnostics, and debugger
• LSP-powered VSCode support with hover, definitions, symbols, completions, diagnostics, and DAP debugging

Quickstart

Install OPL:

pip install oplang

Create hello.opl:

bounty x = 5
say x + 1

Run it:

opl run hello.opl

Expected output:

6

CLI

opl --version
opl run file.opl
opl check file.opl
opl format file.opl
opl repl

Run on the VM:

opl run file.opl --vm

Build bytecode:

opl build file.opl
opl run file.oplb --vm
opl inspect file.oplb

Debug

Launch the VM debugger:

opl debug file.opl

Useful debugger commands:

step
continue
stack
locals
inspect name
quit

VSCode

The VSCode extension lives in vscode-opl/.

It provides:

• .opl file association
• Syntax highlighting
• Snippets
• Language configuration
• LSP diagnostics, hover, definitions, document symbols, workspace symbols, and completions
• DAP debugger integration

For local extension development:

cd vscode-opl
npm install

Then open the extension folder in VSCode and run the extension host.

Marketplace packaging:

npm install -g @vscode/vsce
vsce package

Publishing:

vsce publish

Documentation

• docs/quickstart.md
• docs/language-basics.md
• docs/standard-library.md
• docs/examples.md

Website And Playground

The static website and local playground live in website/.

Start the local playground server:

python website/playground_server.py --port 8787

Open:

http://127.0.0.1:8787

PyPI Release

Build distributions:

python -m build

This creates:

dist/oplang-*.whl
dist/oplang-*.tar.gz

Publish manually with Twine:

python -m twine upload dist/*

Do not publish until the release artifacts have been inspected and tested.