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

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):
@@ -21,28 +21,31 @@ class PythonHereServer(SSHServerHere):
 async def run_ssh_server(app):
     """Start and run SSH server."""
     Logger.debug("PythonHere: wait for %here settings")
-    try:
-        await app.ssh_server_config_ready.wait()
-    except asyncio.CancelledError:
-        return
-
-    config = ServerConfig(
-        host="",
-        chroot=app.upload_dir,
-        key_path=Path("./key.rsa").resolve(),
-        **app.get_pythonhere_config(),
-    )
-
-    try:
-        server = await start_server(
-            config, namespace=app.ssh_server_namespace, server_factory=PythonHereServer
-        )
-        app.ssh_server_started.set()
-    except Exception as exc:
-        Logger.error("PythonHere: SSH server start error")
-        Logger.exception(exc)
-        show_exception_popup(exc)
-        return
+    while not app.ssh_server_started.is_set():
+        try:
+            await app.ssh_server_config_ready.wait()
+        except asyncio.CancelledError:
+            return
+
+        try:
+            config = ServerConfig(
+                host="",
+                chroot=app.upload_dir,
+                key_path=Path("./key.rsa").resolve(),
+                **app.get_pythonhere_config(),
+            )
+            server = await start_server(
+                config,
+                namespace=app.ssh_server_namespace,
+                server_factory=PythonHereServer,
+            )
+        except Exception as exc:
+            Logger.error("PythonHere: SSH server start error")
+            Logger.exception(exc)
+            show_exception_popup(exc)
+            app.ssh_server_config_ready.clear()
+        else:
+            app.ssh_server_started.set()
 
     try:
         await server.wait_closed()
@@ -50,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,9 +1,9 @@
 """%here server screen."""
-from kivy.app import App
-from kivy.clock import Clock
-from kivy.uix.screenmanager import ScreenManager
 
 from enum_here import ServerState
+from kivy.app import App
+from kivy.clock import Clock, mainthread
+from kivy.uix.screenmanager import ScreenManager
 
 
 class ServerScreenManager(ScreenManager):
@@ -13,6 +13,7 @@ class ServerScreenManager(ScreenManager):
         super().__init__(*args, **kwargs)
         self.update_event = Clock.schedule_interval(self.update, 0.5)
 
+    @mainthread
     def update(self, _=None):
         """Determines server state, and switch to appropriate screen."""
         app = App.get_running_app()

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
@@ -11,11 +12,9 @@ from kivy.properties import (  # pylint: disable=no-name-in-module
 )
 from kivy.uix.anchorlayout import AnchorLayout
 from kivy.uix.label import Label
+from kivy.uix.popup import Popup
 from kivy.uix.settings import Settings, SettingString
 
-from enum_here import ScreenName
-
-
 SETTINGS_HERE = """
 [
     {
@@ -97,8 +96,18 @@ class StartServerSettingButton(SettingButton):
     def on_release(self):
         """Start the server."""
         app = App.get_running_app()
+        if app.ssh_server_started.is_set():
+            popup = Popup(
+                title="Server is already started",
+                content=Label(
+                    text="New settings takes effect\n after application restart."
+                ),
+                size_hint=(None, None),
+                size=("250sp", "250sp"),
+            )
+            popup.open()
+            return
         app.update_server_config_status()
-        app.root.switch_screen(ScreenName.here)
 
 
 class ShowPolicySettingButton(SettingButton):
@@ -128,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.4"
+__version__ = "0.2.0"

pythonhere/window_here.py

@@ -1,17 +1,20 @@
 """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.core.window import Window
 from kivy.lang import Builder
 from kivy.uix.boxlayout import BoxLayout
 
 
 def reset_window_environment() -> BoxLayout:
     """Remove PythonHere app widgets and styles."""
+    # import Window inside function to avoid early loading of the app config
+    from kivy.core.window import Window  # pylint: disable=import-outside-toplevel
+
     for widget in Window.children:
         widget.clear_widgets()
         Window.remove_widget(widget)
@@ -30,6 +33,8 @@ def unload_app_kv_styles():
 
 def load_kv_string(code: str, clear_style: bool):
     """Insert given rules into the Kivy Language Builder."""
+    from kivy.core.window import Window  # pylint: disable=import-outside-toplevel
+
     app = App.get_running_app()
 
     if clear_style:
@@ -50,6 +55,8 @@ def load_kv_string(code: str, clear_style: bool):
 
 def encoded_screenshot() -> str:
     """Return base64 encoded displayed image."""
+    from kivy.core.window import Window  # pylint: disable=import-outside-toplevel
+
     path = str(Path(f"screenshot_{time.time()}.png").resolve())
     Window.children[0].export_to_png(path)
     with open(path, "rb") as png_file:

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.4.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.4.dist-info/METADATA

@@ -1,139 +0,0 @@
-Metadata-Version: 2.1
-Name: pythonhere
-Version: 0.1.4
-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 notebook start
-
-
-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
-
-