FilesExpand file tree

main

/

main.py

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

142 lines (119 loc) · 4.4 KB

main

/

main.py

Copy path

Top

File metadata and controls

• Code
• Blame

142 lines (119 loc) · 4.4 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

82

83

84

85

86

87

88

89

90

91

92

93

94

95

96

97

98

99

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

# Copyright 2026 Unstable Build, LLC.

#

# Licensed under the Apache License, Version 2.0 (the "License");

# you may not use this file except in compliance with the License.

# You may obtain a copy of the License at

#

# http://www.apache.org/licenses/LICENSE-2.0

#

# Unless required by applicable law or agreed to in writing, software

# distributed under the License is distributed on an "AS IS" BASIS,

# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

# See the License for the specific language governing permissions and

# limitations under the License.

"""textual_app: an interactive Textual repl served into a Rune tab.

Ports the spirit of the Go SDK's examples/repl to Textual: an Input

plus a Run Button feed a tiny command interpreter (clear, echo,

exit, help) whose history lands in a DataTable. The app is hosted

headless by rune_sdk.adapt.textual.TextualAdapter and installed as a

browser tab; keys and mouse events arrive through the handler stream

and every repaint publishes an interrupt so the host redraws.

Run from a Rune workspace by registering this script as an extension;

requires the textual extra: pip install "rune-sdk[textual]".

"""

from __future__ import annotations

import asyncio

from typing import Any

from textual.app import App, ComposeResult

from textual.containers import Horizontal

from textual.widgets import Button, DataTable, Input

from rune_sdk.adapt.textual import TextualAdapter

from rune_sdk.api.workspace import parse_uri

from rune_sdk.extension import (

Metadata,

Permission,

TabPlacement,

Workspace,

serve_handler,

serve_workspace_extension,

)

META = Metadata(

developer_id="dev.example",

developer_email="dev@example.com",

developer_key="",

extension_id="textual-app",

extension_name="Textual Repl",

extension_version="0.0.1",

permissions=frozenset(

{

Permission.BROWSER_WINDOW_MANAGER,

Permission.INTERRUPT,

}

),

)

COMMANDS = ("clear", "echo", "exit", "help")

class ReplApp(App[None]):

"""A tiny command interpreter: Input + Button feed a DataTable."""

CSS = """

#prompt { height: 3; }

#cmd { width: 1fr; }

"""

def compose(self) -> ComposeResult:

with Horizontal(id="prompt"):

yield Input(placeholder="Type a command ('help')", id="cmd")

yield Button("Run", id="run")

yield DataTable[str](id="log")

def on_mount(self) -> None:

self.query_one(DataTable).add_columns("command", "output")

def on_input_submitted(self, event: Input.Submitted) -> None:

# Use the submitted snapshot: keys arriving between the Enter

# and this handler must not leak into the command line.

self._run(event.value)

def on_button_pressed(self, _event: Button.Pressed) -> None:

self._run(self.query_one("#cmd", Input).value)

def _run(self, line: str) -> None:

line = line.strip()

if not line:

return

self.query_one("#cmd", Input).value = ""

log = self.query_one(DataTable)

name, _, rest = line.partition(" ")

if name == "help":

output = "Commands: " + ", ".join(COMMANDS)

elif name == "echo":

output = rest

elif name == "clear":

log.clear()

return

elif name == "exit":

self.exit()

return

else:

output = f"Unknown: {name}. Try 'help'."

log.add_row(line, output)

async def extend(workspace: Workspace, _config: dict[str, Any]) -> None:

"""The extension body: serve the repl tab until it is closed."""

interrupter = workspace.interrupter()

redraws: set[asyncio.Task[None]] = set()

def on_dirty() -> None:

# Fires on the event loop after every app repaint; publish an

# interrupt so the host redraws the tab.

task = asyncio.get_running_loop().create_task(interrupter.interrupt())

redraws.add(task)

task.add_done_callback(redraws.discard)

adapter = TextualAdapter(ReplApp(), on_dirty=on_dirty)

await adapter.start()

try:

await serve_handler(

workspace,

adapter,

placement=TabPlacement(

uri=parse_uri("repl://textual-app"),

icon=">",

name="repl",

),

)

finally:

await adapter.aclose()

if __name__ == "__main__":

serve_workspace_extension(extend, META)