pythonhere 0.1.5.2__py3-none-any.whl → 0.2.0__py3-none-any.whl

pythonhere/__init__.py

@@ -1,8 +1,8 @@
 """PythonHere Jupyter magic."""
+
 from herethere.magic import load_ipython_extension
 
 from .magic_here import shortcuts  # noqa
 from .version_here import __version__  # noqa
 
-
 __all__ = ("load_ipython_extension",)

pythonhere/android_here.py

@@ -1,14 +1,13 @@
 """Android specific functions."""
+
 # pylint: disable=invalid-name,import-error,import-outside-toplevel
-from pathlib import Path
-from typing import Optional
 import uuid
+from pathlib import Path
 
 from android import activity as android_activity
 from jnius import autoclass, cast
 from kivy.logger import Logger
 
-
 Context = autoclass("android.content.Context")
 Icon = autoclass("android.graphics.drawable.Icon")
 Intent = autoclass("android.content.Intent")
@@ -23,7 +22,7 @@ def get_current_intent() -> Intent:
     return PythonActivity.mActivity.getIntent()
 
 
-def get_startup_script(intent: None = None) -> Optional[str]:
+def get_startup_script(intent: None = None) -> str | None:
     """Return script entrypoint that was passed to a given, or current, intent."""
     if not intent:
         intent = get_current_intent()
@@ -62,7 +61,7 @@ def bind_run_script_on_new_intent():
 def create_shortcut_icon() -> Icon:
     """Create icon to use for a shurtcut."""
     activity = PythonActivity.mActivity
-    Drawable = autoclass("{}.R$drawable".format(activity.getPackageName()))
+    Drawable = autoclass(f"{activity.getPackageName()}.R$drawable")
     context = cast("android.content.Context", activity.getApplicationContext())
     return Icon.createWithResource(context, Drawable.icon)
 

pythonhere/enum_here.py

@@ -1,4 +1,5 @@
 """Enums."""
+
 from enum import Enum
 
 

pythonhere/exception_manager_here.kv

@@ -0,0 +1,22 @@
+<-UnhandledExceptionPopupHere>:
+    title: "Unhandled Exception catched"
+    BoxLayout:
+        orientation: 'vertical'
+        padding: 10
+        spacing: 20
+        Label:
+            size_hint_y: None
+            font_size: '18sp'
+            height: '24sp'
+            text: 'Exception details: '
+        ScrollView:
+            CodeInput:
+                id: catched_exception_code_input_here
+                text: root.message
+                size_hint: 1, None
+                height: self.minimum_height
+        Button:
+            size_hint_y: None
+            height: '40sp'
+            text: 'OK, continue'
+            on_press: root.dismiss()

pythonhere/exception_manager_here.py

@@ -1,46 +1,26 @@
 """App exceptions manager."""
+
 import asyncio
 import traceback
-from typing import Optional
+from pathlib import Path
 
 from kivy.base import (
     ExceptionHandler,
     ExceptionManager,
 )
 from kivy.clock import Clock
-from kivy.properties import StringProperty  # pylint: disable=no-name-in-module
 from kivy.lang import Builder
 from kivy.logger import Logger
+from kivy.properties import StringProperty  # pylint: disable=no-name-in-module
 from kivy.uix.popup import Popup
 
 
 def load_exception_popup_style():
     """Load KV rules for `UnhandledExceptionPopupHere`."""
-    Builder.load_string(
-        """<-UnhandledExceptionPopupHere>:
-    title: "Unhandled Exception catched"
-    BoxLayout:
-        orientation: 'vertical'
-        padding: 10
-        spacing: 20
-        Label:
-            size_hint_y: None
-            font_size: '18sp'
-            height: '24sp'
-            text: 'Exception details: '
-        ScrollView:
-            CodeInput:
-                id: catched_exception_code_input_here
-                text: root.message
-                size_hint: 1, None
-                height: self.minimum_height
-        Button:
-            size_hint_y: None
-            height: '40sp'
-            text: 'OK, continue'
-            on_press: root.dismiss()
-    """
-    )
+    kv_path = str(Path(__file__).with_suffix(".kv"))
+
+    if kv_path not in Builder.files:
+        Builder.load_file(kv_path)
 
 
 class ErrorMessageOnException(ExceptionHandler):
@@ -48,9 +28,9 @@ class ErrorMessageOnException(ExceptionHandler):
 
     def handle_exception(self, exception) -> int:
         """Handle a exception."""
-        Logger.exception("Unhandled Exception catched")
         if isinstance(exception, (asyncio.CancelledError, KeyboardInterrupt)):
             return ExceptionManager.RAISE
+        Logger.exception("Unhandled Exception catched")
         show_exception_popup()
         return ExceptionManager.PASS
 
@@ -63,10 +43,14 @@ class UnhandledExceptionPopupHere(Popup):
 
 def install_exception_handler():
     """Install `ErrorMessageOnException` exception handler."""
-    ExceptionManager.add_handler(ErrorMessageOnException())
+    if not any(
+        isinstance(handler, ErrorMessageOnException)
+        for handler in ExceptionManager.handlers
+    ):
+        ExceptionManager.add_handler(ErrorMessageOnException())
 
 
-def show_exception_popup(exc: Optional[Exception] = None):
+def show_exception_popup(exc: Exception | None = None):
     """Show exception popup."""
     load_exception_popup_style()
     if exc:

pythonhere/launcher_here.py

@@ -1,12 +1,12 @@
 """Utilities for launching scripts."""
+
 import os
-from pathlib import Path
 import runpy
 import sys
+from pathlib import Path
 
-
-from kivy.logger import Logger
 from kivy import platform
+from kivy.logger import Logger
 
 
 def run_script(script: str):

pythonhere/magic_here/shortcuts.py

@@ -4,11 +4,10 @@
 from base64 import b64decode
 from io import BytesIO, StringIO
 
-from PIL import Image as PILImage
-from IPython.display import display
 import click
-from herethere.there.commands import there_group, there_code_shortcut
-
+from herethere.there.commands import there_code_shortcut, there_group
+from IPython.display import display
+from PIL import Image as PILImage
 
 KV_COMMAND_TEMPLATE = r"""
 from window_here import load_kv_string
@@ -67,7 +66,9 @@ def screenshot(ctx, width, output):
     img = PILImage.open(BytesIO(data)).convert("RGB")
     if width:
         height = int(width * img.size[1] // img.size[0])
-        img = img.resize((width, height), PILImage.ANTIALIAS)
+        resampling = getattr(PILImage, "Resampling", PILImage)
+        resample_filter = getattr(resampling, "LANCZOS", PILImage.LANCZOS)
+        img = img.resize((width, height), resample_filter)
 
     if output:
         img.save(output)

pythonhere/main.py

@@ -1,4 +1,5 @@
 """PythonHere app."""
+
 # pylint: disable=wrong-import-order,wrong-import-position
 
 from launcher_here import try_startup_script
@@ -12,18 +13,17 @@ else:
 
 import asyncio
 import os
-from pathlib import Path
 import sys
 import threading
-from typing import Any, Dict
+from pathlib import Path
+from typing import Any
 
+from enum_here import ScreenName, ServerState
+from exception_manager_here import install_exception_handler, show_exception_popup
 from kivy.app import App
 from kivy.clock import Clock
 from kivy.config import Config, ConfigParser
 from kivy.logger import Logger
-
-from enum_here import ScreenName, ServerState
-from exception_manager_here import install_exception_handler, show_exception_popup
 from patches_here import monkeypatch_kivy
 from server_here import run_ssh_server
 from window_here import reset_window_environment
@@ -36,13 +36,25 @@ class PythonHereApp(App):
 
     def __init__(self):
         super().__init__()
-        self.server_task = None
+        self.server_task: asyncio.Task | None = None
+        self.app_task: asyncio.Task | None = None
+        self.asyncio_loop: asyncio.AbstractEventLoop | None = None
         self.settings = None
+
+        # Created once a running asyncio loop exists.
+        self.ssh_server_config_ready: asyncio.Event | None = None
+        self.ssh_server_started: asyncio.Event | None = None
+        self.ssh_server_connected: asyncio.Event | None = None
+
+        self.ssh_server_namespace = {}
+        self.icon = "data/logo/logo-32.png"
+
+    def init_asyncio_state(self):
+        """Initialize asyncio-owned state after the event loop is running."""
+        self.asyncio_loop = asyncio.get_running_loop()
         self.ssh_server_config_ready = asyncio.Event()
         self.ssh_server_started = asyncio.Event()
         self.ssh_server_connected = asyncio.Event()
-        self.ssh_server_namespace = {}
-        self.icon = "data/logo/logo-32.png"
 
     @property
     def upload_dir(self) -> str:
@@ -67,9 +79,7 @@ class PythonHereApp(App):
         """Initialize application UI."""
         super().build()
         install_exception_handler()
-
         self.settings = self.root.ids.settings
-
         self.ssh_server_namespace.update(
             {
                 "app": self,
@@ -82,47 +92,81 @@ class PythonHereApp(App):
                 lambda _: show_exception_popup(startup_script_exception), 0
             )
 
-    def run_app(self):
-        """Run application and SSH server tasks."""
-        self.ssh_server_started = asyncio.Event()
-        self.server_task = asyncio.ensure_future(run_ssh_server(self))
-        return asyncio.gather(self.async_run_app(), self.server_task)
+    async def run_app(self):
+        """Run application and SSH server until either main task exits."""
+        self.init_asyncio_state()
+
+        self.server_task = asyncio.create_task(run_ssh_server(self))
+        self.app_task = asyncio.create_task(self.async_run_app())
+
+        tasks = (self.server_task, self.app_task)
+
+        try:
+            done, pending = await asyncio.wait(
+                tasks,
+                return_when=asyncio.FIRST_COMPLETED,
+            )
+
+            for task in pending:
+                task.cancel()
+
+            if pending:
+                await asyncio.gather(*pending, return_exceptions=True)
+
+            for task in done:
+                if task.cancelled():
+                    continue
+                exc = task.exception()
+                if exc is not None:
+                    raise exc
+        finally:
+            await self.cancel_app_tasks()
 
     async def async_run_app(self):
         """Run app asynchronously."""
         try:
-            await self.async_run(async_lib="asyncio")
+            await self.async_run()
             Logger.info("PythonHere: async run completed")
         except asyncio.CancelledError:
             Logger.info("PythonHere: app main task canceled")
+            raise
         except Exception as exc:
             Logger.exception(exc)
+            raise
+        finally:
+            if self.get_running_app():
+                self.stop()
 
-        if self.server_task:
-            self.server_task.cancel()
-
-        if self.get_running_app():
-            self.stop()
-
-        await self.cancel_asyncio_tasks()
-
-    async def cancel_asyncio_tasks(self):
-        """Cancel all asyncio tasks."""
+    async def cancel_app_tasks(self):
+        """Cancel tasks owned by this app."""
         tasks = [
-            task for task in asyncio.all_tasks() if task is not asyncio.current_task()
+            task
+            for task in (self.server_task, self.app_task)
+            if task is not None
+            and task is not asyncio.current_task()
+            and not task.done()
         ]
+
+        for task in tasks:
+            task.cancel()
+
         if tasks:
-            for task in tasks:
-                task.cancel()
-            await asyncio.wait(tasks, timeout=1)
+            await asyncio.gather(*tasks, return_exceptions=True)
 
     def update_server_config_status(self):
         """Check and update value of the `ssh_server_config_ready`, update screen."""
 
         def update():
             if all(self.get_pythonhere_config().values()):
-                self.ssh_server_config_ready.set()
-            screen.update()
+                if (
+                    self.asyncio_loop is not None
+                    and self.ssh_server_config_ready is not None
+                ):
+                    self.asyncio_loop.call_soon_threadsafe(
+                        self.ssh_server_config_ready.set
+                    )
+
+            Clock.schedule_once(lambda _: screen.update(), 0)
 
         screen = self.root.ids.here_screen_manager
         screen.current = ServerState.starting_server
@@ -133,7 +177,7 @@ class PythonHereApp(App):
         """Return user settings for SSH server."""
         return self.settings.get_pythonhere_config()
 
-    def update_ssh_server_namespace(self, namespace: Dict[str, Any]):
+    def update_ssh_server_namespace(self, namespace: dict[str, Any]):
         """Update SSH server namespace."""
         self.ssh_server_namespace.update(namespace)
 
@@ -152,8 +196,14 @@ class PythonHereApp(App):
     def on_ssh_connection_made(self):
         """New authenticated SSH client connected handler."""
         Logger.info("PythonHere: new SSH client connected")
+
+        if self.ssh_server_connected is None:
+            Logger.warning("PythonHere: SSH connected before asyncio state was ready")
+            return
+
         if not self.ssh_server_connected.is_set():
             self.ssh_server_connected.set()
+
             Logger.info("PythonHere: reset window environment")
             self.ssh_server_namespace["root"] = reset_window_environment()
             self.chdir(self.upload_dir)
@@ -165,7 +215,11 @@ class PythonHereApp(App):
         sys.path.insert(0, path)
 
 
+async def main():
+    """Run PythonHere."""
+    app = PythonHereApp()
+    await app.run_app()
+
+
 if __name__ == "__main__":
-    loop = asyncio.get_event_loop()
-    loop.run_until_complete(PythonHereApp().run_app())
-    loop.close()
+    asyncio.run(main())

pythonhere/network_here.py

@@ -1,5 +1,6 @@
 """Network addresses discovering."""
-from typing import Iterator, Tuple
+
+from collections.abc import Iterator
 
 from kivy import platform
 
@@ -14,7 +15,7 @@ else:
 
 def get_android_interface_addresses(
     interface: "NetworkInterface",
-) -> Iterator[Tuple[str, str]]:
+) -> Iterator[tuple[str, str]]:
     """Yields active IPv4 addresses for given network interface."""
     if interface.isUp():
         addresses = interface.getInetAddresses()
@@ -24,7 +25,7 @@ def get_android_interface_addresses(
                 yield interface.getDisplayName(), address.getHostAddress()
 
 
-def get_all_available_ipv4_adrresses() -> Iterator[Tuple[str, str]]:
+def get_all_available_ipv4_adrresses() -> Iterator[tuple[str, str]]:
     """Yields available interfaces with IPv4 addresses
     available for connections from there.
     """

pythonhere/patches_here.py

@@ -1,9 +1,8 @@
 """Monkey patching Kivy @('_')@."""
 
+import kivy.uix.widget
 from kivy.factory import Factory
 from kivy.lang.builder import BuilderBase
-import kivy.uix.widget
-
 
 _original_factory_register = Factory.register
 _original_builderbase_match = BuilderBase.match

pythonhere/pythonhere.kv

@@ -0,0 +1,49 @@
+#:kivy 1.0
+#:import RootLayout ui_here.layout_here.RootLayout
+#:import ScreenName enum_here.ScreenName
+#:import ServerState enum_here.ServerState
+#:import ServerScreenManager ui_here.server_screen_here.ServerScreenManager
+#:include ui_here/actionbar_here.kv
+#:include ui_here/common_here.kv
+#:include ui_here/connection_address_here.kv
+#:include ui_here/server_screen_here.kv
+#:include ui_here/settings_here.kv
+
+RootLayout:
+    orientation: "vertical"
+
+    ActionBar:
+        pos_hint: {"top": 1}
+
+        ActionView:
+            ActionPrevious:
+                title: ""
+                with_previous: False
+                app_icon: "data/logo/logo-32.png"
+
+            ScreenActionButton:
+                id: open_here_action
+                text: f"%{tc('H', 3)}ere"
+                screen: ScreenName.here
+            ScreenActionButton:
+                id: open_settings_action
+                text: f"{tc('S', 3)}ettings"
+                screen: ScreenName.settings
+
+            ActionButton:
+                text: f"{tc('Q', 3)}uit"
+                on_release: app.get_running_app().stop()
+
+    ScreenManager:
+        id: screen_manager
+        Screen:
+        Screen:
+            id: here_screen
+            name: ScreenName.here
+            ServerScreenManager:
+                id: here_screen_manager
+        Screen:
+            id: settings_screen
+            name: ScreenName.settings
+            SettingsHere:
+                id: settings

pythonhere/server_here.py

@@ -1,12 +1,12 @@
 """SSH server."""
+
 import asyncio
 from pathlib import Path
 
+from exception_manager_here import show_exception_popup
+from herethere.here.server import ServerConfig, SSHServerHere, start_server
 from kivy.app import App
 from kivy.logger import Logger
-from herethere.here.server import SSHServerHere, ServerConfig, start_server
-
-from exception_manager_here import show_exception_popup
 
 
 class PythonHereServer(SSHServerHere):
@@ -53,7 +53,7 @@ async def run_ssh_server(app):
         Logger.info("PythonHere: SSH server task canceled")
         await server.stop()
     except Exception as exc:
-        Logger.errror("PythonHere: SSH server stop by exception")
+        Logger.error("PythonHere: SSH server stop by exception")
         Logger.exception(exc)
         show_exception_popup(exc)
     Logger.info("PythonHere: SSH server closed")

pythonhere/ui_here/actionbar_here.kv

@@ -0,0 +1,8 @@
+#:kivy 1.0
+#:import App kivy.app.App
+
+<ScreenActionButton@ActionToggleButton>:
+    group: "screen"
+    screen: ""
+    allow_no_selection: False
+    on_release: App.get_running_app().root.switch_screen(self.screen)

pythonhere/ui_here/common_here.kv

@@ -0,0 +1,14 @@
+#:kivy 1.0
+# Common settings
+
+#:import hex kivy.utils.get_color_from_hex
+#:import sp kivy.metrics.sp
+
+#:set bg_color "#EEEEEE"
+#:set pallete ["#646464", "#306998", "#4B8BBE", "#FFD43B", "#FFE873"]
+#:set tc lambda text, index: f"[color={pallete[index]}]{text}[/color]"
+
+
+<Label>:
+    font_name: "DejaVuSans"
+    markup: True

pythonhere/ui_here/connection_address_here.kv

@@ -0,0 +1,32 @@
+#:kivy 1.0
+#:import ConnectionAddressLabel ui_here.connection_address_here.ConnectionAddressLabel
+#:import ConnectionAddressInfoBox ui_here.connection_address_here.ConnectionAddressInfoBox
+
+<ConnectionAddressLabel>:
+    text: f"{tc('↳', 3)} {tc(self.address, 2)} ({self.interface})"
+    size_hint: 1, None
+    text_size: self.size
+    height: self.texture_size[1]
+    font_size: "20sp"
+
+<ConnectionAddressInfoBox>:
+    cols: 1
+    size_hint: 1, 1
+    padding: '20sp', 0, 0, 0
+
+    Label:
+        text: f"Server is running.\nConnect {tc('here', 3)} via"
+        size_hint: 1, None
+        text_size: self.size
+        height: "80sp"
+        font_size: "30sp"
+
+    ScrollView:
+        do_scroll_x: False
+        size_hint: 1, 1
+
+        BoxLayout:
+            id: address_list
+            orientation: "vertical"
+            size_hint: 1, None
+            height: self.minimum_size[1]

pythonhere/ui_here/connection_address_here.py

@@ -1,10 +1,10 @@
 """Connection information widgets."""
+
 from kivy.clock import Clock, mainthread
 from kivy.logger import Logger
 from kivy.properties import StringProperty  # pylint: disable=no-name-in-module
-from kivy.uix.label import Label
 from kivy.uix.gridlayout import GridLayout
-
+from kivy.uix.label import Label
 from network_here import get_all_available_ipv4_adrresses
 
 

pythonhere/ui_here/layout_here.py

@@ -1,4 +1,5 @@
 """Layouts."""
+
 from kivy.uix.boxlayout import BoxLayout
 from kivy.uix.togglebutton import ToggleButton
 

pythonhere/ui_here/server_screen_here.kv

@@ -0,0 +1,57 @@
+#:import FallOutTransition kivy.uix.screenmanager.FallOutTransition
+#:import App kivy.app.App
+
+<LoadingImage@Image>:
+    source: "data/images/image-loading.zip"
+    allow_stretch: True
+    pos_hint: {'center_x': 0.5, 'center_y': 0.4}
+    size_hint: None, None
+    size: sp(100), sp(100)
+
+<StackLabel@Label>:
+    size_hint: None, None
+    font_size: "20sp"
+    size: self.texture_size
+
+<ServerNotConfigured@Screen>:
+    StackLayout:
+        orientation: "lr-tb"
+        padding: sp(20), sp(20), 0, 0
+        StackLabel:
+            text: "To start "
+        StackLabel:
+            text: f"{tc('Python', 1)}{tc('here', 3)}, "
+        StackLabel:
+            text: "you "
+        StackLabel:
+            text: "need to "
+        StackLabel:
+            text: "edit the "
+        Button:
+            text: "Settings"
+            font_size: "20sp"
+            size_hint: None, None
+            width: self.texture_size[0] + sp(20)
+            height: sp(30)
+            on_release: App.get_running_app().root.switch_screen(ScreenName.settings)
+        StackLabel:
+            text: " section."
+
+<StartingServerScreen@Screen>:
+    Label:
+        text: f"Waiting {tc('Python', 1)}{tc('here', 3)} to start"
+        font_size: "30sp"
+    LoadingImage:
+
+<ServerScreenManager>:
+    transition: FallOutTransition()
+    Screen:
+        LoadingImage:
+    ServerNotConfigured:
+        name: ServerState.not_configured
+    Screen:
+    StartingServerScreen:
+        name: ServerState.starting_server
+    Screen:
+        name: ServerState.ready
+        ConnectionAddressInfoBox:

pythonhere/ui_here/server_screen_here.py

@@ -1,10 +1,10 @@
 """%here server screen."""
+
+from enum_here import ServerState
 from kivy.app import App
 from kivy.clock import Clock, mainthread
 from kivy.uix.screenmanager import ScreenManager
 
-from enum_here import ServerState
-
 
 class ServerScreenManager(ScreenManager):
     """Screen manager for server %here section."""

pythonhere/ui_here/settings_here.kv

@@ -0,0 +1,31 @@
+#:kivy 1.0
+#:import App kivy.app.App
+#:import SettingPassword ui_here.settings_here.SettingPassword
+
+<SettingPassword>:
+    PasswordLabel:
+        pos: root.pos
+        font_size: "15sp"
+        text: '*' * len(root.value or '')
+
+<SettingButton>:
+    size_hint: 1, None
+    height: sp(60)
+    opacity: 1 if self.active else 0
+
+    Button:
+        size_hint: None, None
+        width: self.texture_size[0] + sp(20)
+        height: sp(40)
+        halign: "center"
+        text: root.title
+        disabled: not root.active
+        on_release: root.on_release()
+
+
+<StartServersettingButton>:
+    title: f"{tc('▶', 3)} Start the server"
+
+
+<ShowPolicySettingButton>:
+    title: "Open privacy\n policy in browser"

pythonhere/ui_here/settings_here.py

@@ -1,6 +1,7 @@
 """Settings panel widgets."""
-from typing import Any, Dict
+
 import webbrowser
+from typing import Any
 
 from kivy.app import App
 from kivy.config import Config
@@ -14,7 +15,6 @@ from kivy.uix.label import Label
 from kivy.uix.popup import Popup
 from kivy.uix.settings import Settings, SettingString
 
-
 SETTINGS_HERE = """
 [
     {
@@ -137,7 +137,7 @@ class SettingsHere(Settings):
         self.add_kivy_panel()
         self.add_json_panel("Privacy Policy", Config, data=SETTINGS_PRIVACY)
 
-    def get_pythonhere_config(self) -> Dict[str, Any]:
+    def get_pythonhere_config(self) -> dict[str, Any]:
         """Extract server parts of the config."""
         return {
             "username": Config.get("pythonhere", "username"),

pythonhere/version_here.py

@@ -1 +1 @@
-__version__ = "0.1.5.2"
+__version__ = "0.2.0"

pythonhere/window_here.py

@@ -1,8 +1,9 @@
 """Utilities for working with Kivy window."""
-from base64 import b64encode
+
 import os
-from pathlib import Path
 import time
+from base64 import b64encode
+from pathlib import Path
 
 from kivy.app import App
 from kivy.lang import Builder

pythonhere-0.2.0.dist-info/METADATA

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: pythonhere
+Version: 0.2.0
+Summary: Here is the Kivy based app to run code from the Jupyter magic %there
+Author-email: b3b <ash.b3b@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/b3b/ipython-pythonhere
+Project-URL: Changelog, https://github.com/b3b/pythonhere/blob/master/CHANGELOG.rst
+Keywords: android,ipython,jupyter,magic,kivy
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.10
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Requires-Dist: herethere[magic]>=0.1.0
+Requires-Dist: ipython
+Requires-Dist: ipywidgets
+Requires-Dist: Pillow
+Dynamic: license-file
+
+PythonHere
+==========
+
+.. start-badges
+.. image:: https://img.shields.io/pypi/status/pythonhere
+    :target: https://pypi.python.org/pypi/pythonhere
+    :alt: Status
+.. image:: https://img.shields.io/pypi/v/pythonhere.svg
+    :target: https://pypi.python.org/pypi/pythonhere
+    :alt: Latest version on PyPi
+.. image:: https://img.shields.io/docker/v/herethere/pythonhere?color=%23FFD43B&label=Docker%20Image
+   :target: https://hub.docker.com/r/herethere/pythonhere
+   :alt: Docker Image Version (latest by date)
+.. image:: https://img.shields.io/pypi/pyversions/pythonhere.svg
+    :target: https://pypi.python.org/pypi/pythonhere
+    :alt: Supported Python versions
+.. image:: https://github.com/b3b/pythonhere/actions/workflows/tests.yml/badge.svg?branch=master
+   :target: https://github.com/b3b/pythonhere/actions/workflows/tests.yml?query=branch%3Amaster
+   :alt: CI Status          
+.. image:: https://codecov.io/github/b3b/pythonhere/coverage.svg?branch=master
+    :target: https://codecov.io/github/b3b/pythonhere?branch=master
+    :alt: Code coverage Status
+.. end-badges
+
+*PythonHere* lets you run Python code from a local `Jupyter <https://jupyter.org/>`_
+notebook inside a remote `Kivy <https://kivy.org>`_ app.
+
+PythonHere has two parts:
+
+* *Here* is the remote/server side. It runs a Python environment with a Kivy GUI,
+  for example on Android, Raspberry Pi, or another machine.
+* *%there* is the local/client side. It is a Jupyter magic command for running
+  code interactively in the remote PythonHere environment.
+
+This makes PythonHere useful as a live Python/Kivy playground, and as a way to
+inspect or control a Python app running remotely.
+
+Project documentation: https://herethere.me/pythonhere
+
+.. image:: https://raw.githubusercontent.com/b3b/pythonhere/master/docs/description.png
+  :alt: Project description
+
+
+Install the Android app
+-----------------------
+
+Ready-to-use *PythonHere* APKs are available from the `GitHub Releases <https://github.com/b3b/pythonhere/releases>`_ page.
+
+For APK provenance and signing checks, see `Android APK verification <https://github.com/b3b/pythonhere/blob/master/docs/android-apk-verification.rst>`_.
+For a list of Python packages included in the Android build, see `buildozer.spec <https://github.com/b3b/pythonhere/blob/master/buildozer.spec>`_.
+
+Start a local Jupyter environment with Docker
+---------------------------------------------
+
+The Docker image is based on `Jupyter Docker Stacks <https://jupyter-docker-stacks.readthedocs.io/en/latest/>`_
+and includes *PythonHere* with usage examples.
+
+Example command to start the Docker container::
+
+    docker run \
+           --rm \
+           -p 8888:8888 \
+           --user root \
+           -e CHOWN_EXTRA=/home/jovyan/work \
+           -e CHOWN_EXTRA_OPTS='-R' \
+           -v "$(pwd)/work":/home/jovyan/work \
+           herethere/pythonhere:latest
+
+The command exposes the Jupyter server on host port ``8888``. Jupyter logs are
+printed in the terminal and include a URL such as
+``http://127.0.0.1:8888/?token=...``. Open this URL in a browser to use the
+local Jupyter environment.
+
+Files in ``/home/jovyan/work`` inside the container are stored in the local
+``work`` directory.
+
+
+Run a local Jupyter environment without Docker
+----------------------------------------------
+
+Commands to run locally::
+
+   pip install pythonhere jupyter
+   jupyter notebook
+
+
+Build Android app
+-----------------
+
+To build with `Buildozer <https://github.com/kivy/buildozer>`_, run in the source directory::
+
+
+  buildozer android debug
+
+
+Related resources
+-----------------
+
+* `Kivy Remote Shell <https://github.com/kivy/kivy-remote-shell>`_ : Remote SSH+Python interactive shell application
+* `herethere <https://github.com/b3b/herethere>`_ : Library for interactive code execution, based on AsyncSSH
+* `AsyncSSH <https://github.com/ronf/asyncssh>`_ : Asynchronous SSH for Python

pythonhere-0.2.0.dist-info/RECORD

@@ -0,0 +1,33 @@
+pythonhere/__init__.py,sha256=gkVrYFkF3klE1fripHpmTuZx8_BaVHWRRvvr6PK6XWE,212
+pythonhere/android_here.py,sha256=imQCNkhAJYgT3gMeX25kd9cQzH5ZbeF5PlgP8e9sbl0,3316
+pythonhere/enum_here.py,sha256=FPj3pBeXfpPwl4-LDdC-wmbaoiv4QdbKHkGoBfTXnTE,449
+pythonhere/exception_manager_here.kv,sha256=FZNhQgVojSLcVxZ0vjAxAF915xCBP-3nldPXVczRzCE,656
+pythonhere/exception_manager_here.py,sha256=-UYqGRbzkoyfF0-pLWbxaFGEAvAdaw6b8hkm_bMIKx8,1943
+pythonhere/launcher_here.py,sha256=I5zBpN0P3hmhsZFOJemxQ9Q2k2am5zkfS6Vg0Svnl98,1274
+pythonhere/main.py,sha256=7vAF6mznCr2JFxeXjm3-a6PN1abPt-loI8ZHncAAPp0,7237
+pythonhere/network_here.py,sha256=e3FDlBcXPaTFlWaqW2_bcWctht-ifpFIvtOj0lO4S9w,1558
+pythonhere/patches_here.py,sha256=zB7Ohbk5PIXt0imnnrV5Mtl-Y7jpD_p5IBPlijQcCCQ,1727
+pythonhere/pythonhere.kv,sha256=x1xwiKvJAevqBhtXGLb_axIf-VRos4V_jM9Q2i44f2U,1453
+pythonhere/server_here.py,sha256=ss4Alg4ySkI0aG58l8D2SQMXiGHJeK-hGUIIBrbQ6nE,1854
+pythonhere/version_here.py,sha256=Zn1KFblwuFHiDRdRAiRnDBRkbPttWh44jKa5zG2ov0E,22
+pythonhere/window_here.py,sha256=na47v7bgomAjb6VC_g35RwhzEtm5RCInQIuQK27zY8U,2023
+pythonhere/data/logo/logo-128.png,sha256=4sitDJcVBHOU5UPxicmrzc6YqFY7_xtYrc_ULyrw9ks,4161
+pythonhere/data/logo/logo-32.png,sha256=qanrIAt6vK_2BsCjCxth2B4vxBa0ONnpDlils7syUWE,1247
+pythonhere/data/logo/logo-splash.png,sha256=-edmwKnkkpGP4RZ0AJYto5_BOy8NoISt5ftOEI8BQOY,4663
+pythonhere/magic_here/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pythonhere/magic_here/shortcuts.py,sha256=pdB_ET6Snl4DxusbyZPI1_G8jGzA8d35er60qQb_2cY,2499
+pythonhere/ui_here/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pythonhere/ui_here/actionbar_here.kv,sha256=cOjY4ByOyBDUbeS9kbI3JAhi_X3kJ3Pb5h4RL58urwU,214
+pythonhere/ui_here/common_here.kv,sha256=vnNyDwAKKNbRKvh0QKMbTvR0jNDKiY8DdGRnoEEexSc,324
+pythonhere/ui_here/connection_address_here.kv,sha256=T0E8WX6QVvFLB2QL4GP7g9uDwQt5ja7aAODUe8x1NUY,885
+pythonhere/ui_here/connection_address_here.py,sha256=_NM2mJuXM2jgk9eXH8NEV6IxGvJX_fc3wuEq-n7BoLs,1160
+pythonhere/ui_here/layout_here.py,sha256=4sOf4ELSeaJJQkBfgrkM0Cmf6A1bpYTYtZl5GDXGJZE,485
+pythonhere/ui_here/server_screen_here.kv,sha256=x0Se8hmgjS57gFIPa1r2lf6yJchs3lXOrAAtWf6M5Io,1562
+pythonhere/ui_here/server_screen_here.py,sha256=2zQv1YFmiKNxa__7UZDYbAAAwYFLoZPSZPhr7vjCAkU,925
+pythonhere/ui_here/settings_here.kv,sha256=stMcDq8dCYjay4idK30_7EUu5edkMDAQVPv0H0GuAcM,710
+pythonhere/ui_here/settings_here.py,sha256=7NflZBUqY2ANZaSEuubaX9wIKniqbekcNQkUbqhhmto,4093
+pythonhere-0.2.0.dist-info/licenses/LICENSE,sha256=nW9_eVi3dSMOkr6xghsobAovBEJiffjl_5WjujJTa74,1071
+pythonhere-0.2.0.dist-info/METADATA,sha256=s6EVWNzwY9n6PDwLpNX6kVrd55fGxGpba3j26LYz7cQ,4790
+pythonhere-0.2.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+pythonhere-0.2.0.dist-info/top_level.txt,sha256=dvkfRGF1tFbkjXzD9vwqXTge1Znkv7ga5fRJy5yhJsE,11
+pythonhere-0.2.0.dist-info/RECORD,,

{pythonhere-0.1.5.2.dist-info → pythonhere-0.2.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.36.2)
+Generator: setuptools (82.0.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

pythonhere-0.1.5.2.dist-info/METADATA

@@ -1,139 +0,0 @@
-Metadata-Version: 2.1
-Name: pythonhere
-Version: 0.1.5.2
-Summary: Here is the Kivy based app to run code from the Jupyter magic %there
-Home-page: https://github.com/b3b/ipython-pythonhere
-Author: b3b
-Author-email: ash.b3b@gmail.com
-License: MIT
-Project-URL: Changelog, https://github.com/b3b/pythonhere/blob/master/CHANGELOG.rst
-Keywords: android ipython jupyter magic kivy
-Platform: UNKNOWN
-Classifier: Development Status :: 3 - Alpha
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Description-Content-Type: text/x-rst
-Requires-Dist: kivy (>=2.0.0)
-Requires-Dist: herethere (<0.2.0,>=0.1.0)
-Requires-Dist: ifaddr
-Requires-Dist: ipython
-Requires-Dist: ipywidgets
-Requires-Dist: nest-asyncio
-Requires-Dist: Pillow
-Provides-Extra: dev
-Requires-Dist: black ; extra == 'dev'
-Requires-Dist: codecov ; extra == 'dev'
-Requires-Dist: docutils ; extra == 'dev'
-Requires-Dist: flake8 ; extra == 'dev'
-Requires-Dist: jupytext ; extra == 'dev'
-Requires-Dist: pylint ; extra == 'dev'
-Requires-Dist: pytest ; extra == 'dev'
-Requires-Dist: pytest-asyncio ; extra == 'dev'
-Requires-Dist: pytest-cov ; extra == 'dev'
-Requires-Dist: pytest-mock ; extra == 'dev'
-Provides-Extra: docker
-Requires-Dist: jupytext (==1.7.1) ; extra == 'docker'
-
-PythonHere
-==========
-
-.. start-badges
-.. image:: https://img.shields.io/pypi/status/pythonhere
-    :target: https://pypi.python.org/pypi/pythonhere
-    :alt: Status
-.. image:: https://img.shields.io/pypi/v/pythonhere.svg
-    :target: https://pypi.python.org/pypi/pythonhere
-    :alt: Latest version on PyPi
-.. image:: https://img.shields.io/docker/v/herethere/pythonhere?color=%23FFD43B&label=Docker%20Image
-   :target: https://hub.docker.com/r/herethere/pythonhere
-   :alt: Docker Image Version (latest by date)
-.. image:: https://img.shields.io/pypi/pyversions/pythonhere.svg
-    :target: https://pypi.python.org/pypi/pythonhere
-    :alt: Supported Python versions
-.. image:: https://github.com/b3b/pythonhere/workflows/ci/badge.svg?branch=master
-     :target: https://github.com/b3b/pythonhere/actions?workflow=CI
-     :alt: CI Status
-.. image:: https://codecov.io/github/b3b/pythonhere/coverage.svg?branch=master
-    :target: https://codecov.io/github/b3b/pythonhere?branch=master
-    :alt: Code coverage Status
-.. end-badges
-
-*Here* is the `Kivy <https://kivy.org>`_ based app to run Python code from the `Jupyter <https://jupyter.org/>`_ magic %there.
-
-- *Here* is a server part with the GUI interface. It could be Android, Raspberry Pi, some other remote device that being debugged.
-- And *%there* is a client - Jupyter magic command to run code interactively on remote device.
-
-This app could serve as a Python Kivy playground, for dynamic code execution from the PC.
-
-Project documentation: https://herethere.me
-
-.. image:: https://raw.githubusercontent.com/b3b/pythonhere/master/docs/description.png
-  :alt: Project description
-
-
-Install on Android
-------------------
-
-App is available on `Google Play <https://play.google.com/store/apps/details?id=me.herethere.pythonhere>`_.
-
-Ready-to-use *PythonHere* APKs are available in the `Releases <https://github.com/b3b/pythonhere/releases>`_ section.
-
-For a list of installed Python packages, see: `buildozer.spec <./buildozer.spec>`_.
-
-
-Quick Start with Docker
------------------------
-
-Docker image is based on `Jupyter Docker Stacks <https://jupyter-docker-stacks.readthedocs.io/en/latest/>`_, and includes installed *PythonHere* with usage examples.
-
-Example command to start the Docker container::
-
-    docker run \
-           --rm \
-           -p 8888:8888 \
-           -v "$(pwd)/work":/home/jovyan/work \
-           herethere/pythonhere:latest
-
-
-Command will expose the Jupyter Notebook server on host port 8888. Jupyter logs appear in the terminal and include an URL to the notebook server: http://127.0.0.1:8888/?token=... . Visiting this URL in a browser loads the Jupyter Notebook dashboard page.
-
-Files from the directory **work** inside container, will be available in the host directory with the same name: **work**.
-
-
-Run with Docker Compose
------------------------
-
-Commands to run with Docker Compose, in the source directory:::
-
-  cp docker-compose.yml.tmpl docker-compose.yml
-  docker-compose up
-
-
-Run locally
------------
-
-Commands to run locally::
-
-   pip install pythonhere jupyter
-   jupyter notebook
-
-
-Build Android app
------------------
-
-To build with `Buildozer <https://github.com/kivy/buildozer>`_, run in the source directory::
-
-
-  buildozer android debug
-
-
-
-Related resources
------------------
-
-* `Kivy Remote Shell <https://github.com/kivy/kivy-remote-shell>`_ : Remote SSH+Python interactive shell application
-* `herethere <https://github.com/b3b/herethere>`_ : Library for interactive code execution, based on AsyncSSH
-* `AsyncSSH <https://github.com/ronf/asyncssh>`_ : Asynchronous SSH for Python
-* `Buildozer action <https://github.com/ArtemSBulgakov/buildozer-action>`_ : GitHub action that is used to build Android APK with Buildozer
-
-

pythonhere-0.1.5.2.dist-info/RECORD

@@ -1,23 +0,0 @@
-pythonhere/__init__.py,sha256=Z8wJ5iv1FshCKvQpoRKY28rulC7HTWfy8rj9TdYJIJ8,212
-pythonhere/android_here.py,sha256=niI9UJOMwBocblMg2bseZLtTRqDMz4-k-pUcY3PsmTg,3355
-pythonhere/enum_here.py,sha256=RBXnu8ppF4idfVvBYbMQ1JO3cfEXfRDrm-uYlPXzhrw,448
-pythonhere/exception_manager_here.py,sha256=rm8gHFU37cEJk10anyrIX_CyTqATBsnQVIJJLcgINhs,2399
-pythonhere/launcher_here.py,sha256=sBgFv9-GJ5LbxfEiikKlejcA8mDi7zPBxEbKWStVAGc,1274
-pythonhere/main.py,sha256=Crc76Py2rz7ERg9mEBD4KD1mOdCqvuy8N-hgMDPxMUY,5571
-pythonhere/network_here.py,sha256=vbVjAnnEtnysj2SfblVG2Fr0HNqnAPVHZQCU22K9BnQ,1555
-pythonhere/patches_here.py,sha256=bjUvdved7ZaL-9HTKJrtocCOEWEueSkGZs4dxr1L7rU,1728
-pythonhere/server_here.py,sha256=IDH_ZYCg0z4F9LjkfY9Wzs21Z4z2L7slfc6xqfMYxH4,1855
-pythonhere/version_here.py,sha256=tfw61Ig2RHTD_q6DG85fYMOUic2ygXuYT-eBNy9J8MY,24
-pythonhere/window_here.py,sha256=2VU1AC_78wvKtwObezCRYiBdrEYpNCr9lJ1c3nnPgMs,2022
-pythonhere/magic_here/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pythonhere/magic_here/shortcuts.py,sha256=kk9JycYcBrmo3lbVdiXLAJz82Zle4Z6_SQLGuiW0SE4,2365
-pythonhere/ui_here/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pythonhere/ui_here/connection_address_here.py,sha256=VrMMFG9wUJVwmegysi8cl-GZeyNRdKWSjCFcmQtm9ps,1160
-pythonhere/ui_here/layout_here.py,sha256=ofEpRTWhwvEmYF9MK8f_UKC6FuCTP9KEPBhOR_S7Z-Y,484
-pythonhere/ui_here/server_screen_here.py,sha256=3sBLldgRWvo48_NBG16YjHvAzom-GWg6ngVpUUCu0Uw,925
-pythonhere/ui_here/settings_here.py,sha256=P3KeR6TTX0ErGxXjNQ3LN8ujrJ9SQNEr4ZV-3UBw1M4,4099
-pythonhere-0.1.5.2.dist-info/LICENSE,sha256=nW9_eVi3dSMOkr6xghsobAovBEJiffjl_5WjujJTa74,1071
-pythonhere-0.1.5.2.dist-info/METADATA,sha256=n-NOX_4hz1SQEfC-h8cHYkew9M8bygBjj8CDCw491_M,5002
-pythonhere-0.1.5.2.dist-info/WHEEL,sha256=OqRkF0eY5GHssMorFjlbTIq072vpHpF60fIQA6lS9xA,92
-pythonhere-0.1.5.2.dist-info/top_level.txt,sha256=dvkfRGF1tFbkjXzD9vwqXTge1Znkv7ga5fRJy5yhJsE,11
-pythonhere-0.1.5.2.dist-info/RECORD,,