Pythonista

Pythonista is a Python development environment for iOS. Protocol Launcher allows you to generate deep links to open Pythonista, edit or run scripts, pass command-line arguments, select the Python interpreter version, and execute embedded code.

Usage

There are two ways to use this library:

• On-Demand import from subpaths enables tree-shaking and keeps bundles small.
• Full Import from the root package is convenient but includes all app modules.

Pick On-Demand for production builds; Full Import is fine for quick scripts or demos.

Select Installation Method

On-Demand

Recommended. Optimized for production.

Full Import

Convenient. Good for quick scripts.

Open App

On-Demand

import { open } from 'protocol-launcher/pythonista'

const url = open()

Open Pythonista

Open Pythonista 3

On-Demand

import { open } from 'protocol-launcher/pythonista'

const url = open({
  scheme: 'pythonista3',
})

Open Pythonista 3

Open Pythonista 2

On-Demand

import { open } from 'protocol-launcher/pythonista'

const url = open({
  scheme: 'pythonista2',
})

Open Pythonista 2

Open Script

On-Demand

import { openScript } from 'protocol-launcher/pythonista'

const url = openScript({
  path: 'MyScript.py',
})

Open Script in Pythonista

Open iCloud Script

On-Demand

import { openScript } from 'protocol-launcher/pythonista'

const url = openScript({
  path: 'MyScript.py',
  root: 'icloud',
})

Open iCloud Script

Open iCloud Script by Path

On-Demand

import { openScript } from 'protocol-launcher/pythonista'

const url = openScript({
  path: 'iCloud/MyScript.py',
})

Open iCloud Script by Path

Run Script

On-Demand

import { runScript } from 'protocol-launcher/pythonista'

const url = runScript({
  path: 'MyScript.py',
})

Run Script

Run iCloud Script

On-Demand

import { runScript } from 'protocol-launcher/pythonista'

const url = runScript({
  path: 'MyScript.py',
  root: 'icloud',
})

Run iCloud Script

Run Script with args

On-Demand

import { runScript } from 'protocol-launcher/pythonista'

const url = runScript({
  path: 'MyScript',
  args: 'foo bar',
})

Run Script with args

Run Script with argv

On-Demand

import { runScript } from 'protocol-launcher/pythonista'

const url = runScript({
  path: 'MyScript',
  argv: ['foo', 'bar'],
})

Run Script with argv

Run Script with version

On-Demand

import { runScript } from 'protocol-launcher/pythonista'

const url = runScript({
  path: 'MyScript.py',
  version: 3,
})

Run Script with version

Run Script with py

On-Demand

import { runScript } from 'protocol-launcher/pythonista'

const url = runScript({
  path: 'MyScript.py',
  py: 3,
})

Run Script with py

Execute Code

On-Demand

import { exec } from 'protocol-launcher/pythonista'

const url = exec({
  code: 'print("Hello from Pythonista")',
})

Execute Code in Pythonista