Learn by cloning

Minimal two-way hello

Repo: examples/01 - hello_world

import glue

glue.init()

@glue.expose
def say_hello_py(x):
    print('Hello from %s' % x)

say_hello_py('Python World!')
glue.say_hello_js('Python World!')

glue.start()

Force Chrome host

Repo: examples/02 - hello_world_chrome

import glue

glue.init()

@glue.expose
def say_hello_py(x):
    print('Hello from %s' % x)

say_hello_py('Python World!')
glue.say_hello_js('Python World!')

# Force Google Chrome/Chromium (app mode still on)
glue.start(mode='chrome')

Async callbacks

Repo: examples/03 - callbacks

import random
import glue

glue.init()

@glue.expose
def py_random():
    return random.random()

@glue.expose
def py_exception(error):
    if error:
        raise ValueError("Test")
    return "No Error"

def print_num(n):
    print('Got this from JavaScript:', n)

def print_num_failed(error, stack):
    print("Error:", error)
    print("Stack:", stack)

glue.js_random()(print_num)
glue.js_random()(lambda n: print('Got this from JavaScript:', n))
glue.js_with_error()(print_num, print_num_failed)

glue.start()

Blocking returns

Repo: examples/04 - sync_callbacks

import random
import glue

glue.init()

@glue.expose
def py_random():
    return random.random()

glue.start(block=False)

# Sync calls must happen after start()
n = glue.js_random()()
print('Got this from JavaScript:', n)

while True:
    glue.sleep(1.0)

Python file access from the UI

Repo: examples/05 - file_access

import os
import random
import glue

glue.init()

@glue.expose
def pick_file(folder):
    folder = os.path.expanduser(folder)
    if os.path.isdir(folder):
        files = [name for name in os.listdir(folder)
                 if os.path.isfile(os.path.join(folder, name))]
        return random.choice(files) if files else 'No files'
    return 'Not a valid folder'

glue.start()

Live input bridge

Repo: examples/06 - input

import glue

glue.init()

@glue.expose
def handle_input(value):
    print(value)
    return 'Received by Python: %s' % value

glue.start()

Jinja2 pages

Repo: examples/07 - jinja_templates

import random
import glue

glue.init()

@glue.expose
def py_random():
    return random.random()

@glue.expose
def say_hello_py(x):
    print('Hello from %s' % x)

say_hello_py('Python World!')
glue.say_hello_js('Python World!')

glue.start(
    'templates/index.html',
    jinja_templates='templates',
)

React + TypeScript

Repo: examples/08 - createreactapp

import os
import random
import sys
import glue

@glue.expose
def say_hello_py(x):
    print('Hello from %s' % x)
    glue.say_hello_js('Python!')

@glue.expose
def pick_file(folder):
    folder = os.path.expanduser(folder)
    if not os.path.isdir(folder):
        return '%s is not a valid folder' % folder
    files = [f for f in os.listdir(folder)
             if not os.path.isdir(os.path.join(folder, f))]
    return random.choice(files) if files else 'No files'

def start_glue(develop):
    if develop:
        glue.init('src', ['.tsx', '.ts', '.jsx', '.js', '.html'])
        page, mode = {'port': 3000}, None
    else:
        glue.init('build', ['.tsx', '.ts', '.jsx', '.js', '.html'])
        page, mode = 'index.html', 'auto'
    glue.start(page, mode=mode, host='localhost', port=8080)

if __name__ == '__main__':
    start_glue(develop=len(sys.argv) == 2)

Cache-Control no-store

Repo: examples/09 - disable_cache

import glue

# Serve ui/ (default). disable_cache defaults to True;
# pass False to let the browser cache UI assets.
glue.init()

glue.start(
    disable_cache=True,
)

Custom Bottle routes

Repo: examples/10 - custom_app_routes

import bottle
import glue

app = bottle.Bottle()

@app.route('/custom')
def custom_route():
    return {'message': 'Hello from a custom Bottle route'}

glue.init()

# If wrapping Bottle with middleware, also call:
# glue.register_glue_routes(app)

glue.start(app=app)

Transparent startup splash

Repo: examples/11 - splash

import multiprocessing
import glue

def main():
    glue.init()
    glue.start(splash=True)

if __name__ == '__main__':
    multiprocessing.freeze_support()
    main()

Scrolling below window controls

Repo: examples/12 - scrolling

import glue

glue.init()
glue.start()

A naturally overflowing page scrolls beneath the simulated native title bar while its controls remain fixed.