pythonhere 0.2.0__tar.gz → 0.2.2__tar.gz

{pythonhere-0.2.0/pythonhere.egg-info → pythonhere-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythonhere
-Version: 0.2.0
+Version: 0.2.2
 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
@@ -16,7 +16,7 @@ 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: herethere[magic]>=0.2.3
 Requires-Dist: ipython
 Requires-Dist: ipywidgets
 Requires-Dist: Pillow
@@ -40,7 +40,7 @@ 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          
+   :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
@@ -68,6 +68,9 @@ Project documentation: https://herethere.me/pythonhere
 Install the Android app
 -----------------------
 
+Install *PythonHere* with `Obtainium <https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://github.com/b3b/pythonhere>`_
+to receive updates from GitHub Releases.
+
 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>`_.
@@ -120,6 +123,7 @@ To build with `Buildozer <https://github.com/kivy/buildozer>`_, run in the sourc
 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 <https://github.com/kivy/buildozer>`_ : Tool used to build the Android APK.
+* `python-for-android <https://github.com/kivy/python-for-android>`_ : Build toolchain used by Buildozer to package Python applications for Android.

{pythonhere-0.2.0 → pythonhere-0.2.2}/README.rst

@@ -16,7 +16,7 @@ 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          
+   :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
@@ -44,6 +44,9 @@ Project documentation: https://herethere.me/pythonhere
 Install the Android app
 -----------------------
 
+Install *PythonHere* with `Obtainium <https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://github.com/b3b/pythonhere>`_
+to receive updates from GitHub Releases.
+
 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>`_.
@@ -96,6 +99,7 @@ To build with `Buildozer <https://github.com/kivy/buildozer>`_, run in the sourc
 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 <https://github.com/kivy/buildozer>`_ : Tool used to build the Android APK.
+* `python-for-android <https://github.com/kivy/python-for-android>`_ : Build toolchain used by Buildozer to package Python applications for Android.

{pythonhere-0.2.0 → pythonhere-0.2.2}/pyproject.toml

@@ -22,7 +22,7 @@ classifiers = [
     "Programming Language :: Python :: 3.14",
 ]
 dependencies = [
-    "herethere[magic]>=0.1.0",
+    "herethere[magic]>=0.2.3",
     "ipython",
     "ipywidgets",
     "Pillow",
@@ -36,7 +36,6 @@ dev = [
     "docutils",
     "ifaddr",
     "kivy==2.3.1",
-    "nest-asyncio2==1.7.2",
     "pylint",
     "pytest",
     "pytest-asyncio",
@@ -47,6 +46,8 @@ dev = [
 ]
 docker = [
     "jupytext==1.19.3",
+    "pandas",
+    "matplotlib",
 ]
 
 [project.urls]
@@ -60,6 +61,7 @@ environments = [
 
 [tool.pytest.ini_options]
 asyncio_mode = "auto"
+pythonpath = ["pythonhere"]
 
 [tool.setuptools]
 packages = [
@@ -75,6 +77,7 @@ version = { attr = "pythonhere.version_here.__version__" }
 pythonhere = [
     "*.kv",
     "data/logo/*.png",
+    "magic_here/prompts/*.md",
     "ui_here/*.kv",
 ]
 

pythonhere-0.2.2/pythonhere/__init__.py

@@ -0,0 +1,15 @@
+"""PythonHere Jupyter magic."""
+
+from herethere.magic import load_ipython_extension as load_herethere_extension
+
+from .magic_here import shortcuts  # noqa
+from .magic_here.prompts import register_pythonhere_ai_prompts
+from .version_here import __version__  # noqa
+
+__all__ = ("load_ipython_extension",)
+
+
+def load_ipython_extension(ipython):
+    """Hook for `%load_extension pythonhere`."""
+    register_pythonhere_ai_prompts()
+    load_herethere_extension(ipython)

{pythonhere-0.2.0 → pythonhere-0.2.2}/pythonhere/android_here.py

@@ -22,7 +22,7 @@ def get_current_intent() -> Intent:
     return PythonActivity.mActivity.getIntent()
 
 
-def get_startup_script(intent: None = None) -> str | None:
+def get_startup_script(intent: Intent | None = None) -> str | None:
     """Return script entrypoint that was passed to a given, or current, intent."""
     if not intent:
         intent = get_current_intent()
@@ -35,8 +35,7 @@ def restart_app(script: str = None):
     Logger.info("PythonHere: restart requested with a script: %s", script)
     activity = PythonActivity.mActivity
     intent = Intent(activity.getApplicationContext(), PythonActivity)
-    intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
-    intent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TASK)
+    intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TASK)
 
     if script:
         intent.setData(Uri.parse(script))
@@ -59,11 +58,17 @@ def bind_run_script_on_new_intent():
 
 
 def create_shortcut_icon() -> Icon:
-    """Create icon to use for a shurtcut."""
+    """Create icon to use for a shortcut."""
     activity = PythonActivity.mActivity
-    Drawable = autoclass(f"{activity.getPackageName()}.R$drawable")
     context = cast("android.content.Context", activity.getApplicationContext())
-    return Icon.createWithResource(context, Drawable.icon)
+
+    app_info = context.getApplicationInfo()
+    icon_res_id = app_info.icon
+
+    if not icon_res_id:
+        raise RuntimeError("Application icon resource id was not found")
+
+    return Icon.createWithResource(context, icon_res_id)
 
 
 def resolve_script_path(script: str) -> str:
@@ -97,4 +102,6 @@ def pin_shortcut(script: str, label: str):
     )
 
     manager = activity.getSystemService(Context.SHORTCUT_SERVICE)
+    if not manager.isRequestPinShortcutSupported():
+        raise RuntimeError("Pinned shortcuts are not supported by this launcher")
     manager.requestPinShortcut(shortcut, None)

pythonhere-0.2.2/pythonhere/magic_here/prompts/README.md

@@ -0,0 +1,49 @@
+# PythonHere `%%there ai` prompts
+
+These Markdown files are PythonHere-specific prompt sections for `%%there ai`.
+They are registered when the `pythonhere` IPython extension is loaded.
+
+The prompt sections describe the live PythonHere runtime: Kivy widgets,
+Android/Python-for-Android APIs, Pyjnius, Plyer, runtime permissions, installed
+packages, media access, BLE, and MIDI.
+
+## Active by default
+
+Normal `%%there ai` requests use these PythonHere sections together with the
+generic [`default`](https://github.com/b3b/herethere/blob/master/herethere/there/ai/prompts/default.md)
+prompt from `herethere`:
+
+- [`kivy-runtime`](kivy-runtime.md)
+- [`kivy-kv`](kivy-kv.md)
+- [`android-runtime`](android-runtime.md)
+- [`jnius`](jnius.md)
+- [`android-permissions`](android-permissions.md)
+- [`android-packages`](android-packages.md)
+- [`android-media`](android-media.md)
+- [`plyer`](plyer.md)
+
+## Available on request
+
+These sections are registered but not active by default. Add them with
+`%%there ai --prompts ...` when a request needs that context:
+
+- [`able`](able.md)
+- [`midi`](midi.md)
+
+Example:
+
+```python
+%%there ai --prompts able
+Build a small BLE scanner prototype.
+```
+
+`%%there ai --fix` also uses the `herethere`
+[`fix`](https://github.com/b3b/herethere/blob/master/herethere/there/ai/prompts/fix.md)
+prompt section.
+
+## Custom prompts
+
+Notebook-specific prompt sections can be added with
+`herethere.there.ai.register_ai_prompt(...)`. Use custom prompts for visual
+style, domain vocabulary, prototype conventions, or other context that should
+not be part of the built-in PythonHere prompt stack.