pythonhere 0.3.0__py3-none-any.whl → 0.4.0__py3-none-any.whl

pythonhere/ml_here/storage.py

@@ -0,0 +1,145 @@
+"""Find ML model files managed by PythonHere."""
+
+import os
+import sys
+
+
+def _android_models_directory():
+    """Return the model directory belonging to the running Android app."""
+
+    from jnius import autoclass
+
+    PythonActivity = autoclass("org.kivy.android.PythonActivity")
+    activity = PythonActivity.mActivity
+    if activity is None:
+        raise RuntimeError("A running PythonHere activity is required")
+
+    external_files = activity.getExternalFilesDir(None)
+    if external_files is None:
+        raise RuntimeError("Android external app storage is unavailable")
+
+    return os.path.join(str(external_files.getAbsolutePath()), "models")
+
+
+def _is_android():
+    return sys.platform == "android" or "ANDROID_ARGUMENT" in os.environ
+
+
+def models_directory(create=False):
+    """Return PythonHere's platform-specific model directory.
+
+    Android uses the app-specific external files directory. Linux uses
+    PythonHere's per-user application data directory.
+    """
+
+    if _is_android():
+        path = _android_models_directory()
+    else:
+        path = os.path.expanduser("~/.local/share/pythonhere/models")
+
+    path = os.path.abspath(path)
+    if create:
+        os.makedirs(path, exist_ok=True)
+    return path
+
+
+def _relative_parts(value, label):
+    """Return safe POSIX-style path components for a remote identifier."""
+
+    parts = value.split("/")
+    if not value or any(part in {"", ".", ".."} for part in parts):
+        raise ValueError(f"{label} must be a relative path without dot components")
+    return parts
+
+
+def model_path(repo_id, filename):
+    """Return the local path for a model identified by repository and file."""
+
+    path = os.path.join(
+        models_directory(),
+        *_relative_parts(repo_id, "repo_id"),
+        *_relative_parts(filename, "filename"),
+    )
+    return os.path.abspath(path)
+
+
+def require_model(repo_id, filename):
+    """Return an installed model path, or raise ``FileNotFoundError``."""
+
+    path = model_path(repo_id, filename)
+    if not os.path.isfile(path):
+        raise FileNotFoundError(
+            f"ML model is not installed: {repo_id}/{filename} ({path})"
+        )
+    return path
+
+
+def _model_extensions(extensions):
+    """Normalize an optional model-extension filter."""
+
+    if extensions is None:
+        return None
+    if isinstance(extensions, str):
+        extensions = (extensions,)
+
+    normalized = set()
+    for extension in extensions:
+        if not isinstance(extension, str) or not extension:
+            raise ValueError("extensions must contain non-empty strings")
+        normalized_extension = extension.lower()
+        normalized.add(
+            normalized_extension
+            if normalized_extension.startswith(".")
+            else f".{normalized_extension}"
+        )
+    return tuple(sorted(normalized))
+
+
+def _discover_directory(directory, extensions):
+    """Yield model files recursively beneath a directory."""
+
+    path = os.path.abspath(os.fspath(directory))
+    if not os.path.isdir(path):
+        return
+
+    def ignore_error(_error):
+        pass
+
+    for root, directories, files in os.walk(path, onerror=ignore_error):
+        directories.sort(key=str.casefold)
+        for filename in files:
+            lower_filename = filename.lower()
+            if lower_filename.endswith((".part", ".part.json")):
+                continue
+            if extensions is None or lower_filename.endswith(extensions):
+                yield os.path.abspath(os.path.join(root, filename))
+
+
+def discover_models(extra_directories=(), *, extensions=".litertlm"):
+    """Find local model files, optionally filtered by filename extension.
+
+    ``extensions`` may be one extension or an iterable, with or without the
+    leading dot. The default finds LiteRT-LM models. Pass ``None`` to return
+    all completed files. Temporary files belonging to an in-progress download
+    are always ignored.
+    """
+
+    if isinstance(extra_directories, (str, bytes, os.PathLike)):
+        extra_directories = (extra_directories,)
+    extensions = _model_extensions(extensions)
+
+    models = []
+    seen = set()
+    for directory in (models_directory(), *extra_directories):
+        for discovered_path in _discover_directory(directory, extensions):
+            key = os.path.normcase(discovered_path)
+            if key not in seen:
+                seen.add(key)
+                models.append(discovered_path)
+    return sorted(
+        models,
+        key=lambda path: (os.path.basename(path).casefold(), path.casefold()),
+    )
+
+
+__all__ = ("discover_models", "model_path", "models_directory", "require_model")

pythonhere/version_here.py

@@ -1 +1 @@
-__version__ = "0.3.0"
+__version__ = "0.4.0"

{pythonhere-0.3.0.dist-info → pythonhere-0.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythonhere
-Version: 0.3.0
+Version: 0.4.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
@@ -16,10 +16,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.3.1
+Requires-Dist: herethere[magic]>=0.3.2
 Requires-Dist: ipython
 Requires-Dist: ipywidgets
 Requires-Dist: Pillow
+Provides-Extra: litert
+Requires-Dist: litert-lm-api==0.16.0; extra == "litert"
+Requires-Dist: requests; extra == "litert"
 Dynamic: license-file
 
 PythonHere

{pythonhere-0.3.0.dist-info → pythonhere-0.4.0.dist-info}/RECORD

@@ -10,9 +10,9 @@ pythonhere/patches_here.py,sha256=zB7Ohbk5PIXt0imnnrV5Mtl-Y7jpD_p5IBPlijQcCCQ,17
 pythonhere/pythonhere.kv,sha256=x1xwiKvJAevqBhtXGLb_axIf-VRos4V_jM9Q2i44f2U,1453
 pythonhere/server_here.py,sha256=dhNMJj1Abz6RZq6SGqkh8-PVOxKThpI519Msoy5WCgM,1862
 pythonhere/tools_here.py,sha256=RWPBX309d7E4mjkiszzsoJwdaSwXZIqb7ODcRBljC0Y,11437
-pythonhere/version_here.py,sha256=VrXpHDu3erkzwl_WXrqINBm9xWkcyUy53IQOj042dOs,22
+pythonhere/version_here.py,sha256=42STGor_9nKYXumfeV5tiyD_M8VdcddX7CEexmibPBk,22
 pythonhere/window_here.py,sha256=oFPoNMGafGo4Eij3iU1WwaftmRa05Thm1jzuEAQIwK8,2584
-pythonhere/.agents/skills/pythonhere/SKILL.md,sha256=WLYmv0ntjVsK4EOKhVdpylp9Tc6pyeWRuos-oeJg_so,10542
+pythonhere/.agents/skills/pythonhere/SKILL.md,sha256=sZruiB7DaMeFLNAm2YLrPE7emmHELj2SEieMfxGrGJw,11080
 pythonhere/.agents/skills/pythonhere/agents/openai.yaml,sha256=LuAs_jPFRl9Mhvb8bU8E8JSnCc8uc5JYFqYxlhd5elw,210
 pythonhere/.agents/skills/pythonhere/references/able.md,sha256=3KFblzcGy8VDmriqgcWtqyfZZXoYfDV7kZyKIESCZ_c,22918
 pythonhere/.agents/skills/pythonhere/references/android-media.md,sha256=vM55sxJmvkLQmKAjHZYL_z0F0SR__PjOHSXtGIgP1BI,6631
@@ -22,6 +22,7 @@ pythonhere/.agents/skills/pythonhere/references/android-runtime.md,sha256=VCZkyw
 pythonhere/.agents/skills/pythonhere/references/jnius.md,sha256=lyjdGUsZXw2lS-0eppS2-JNTVgEED30z1DglzT6H0D8,14999
 pythonhere/.agents/skills/pythonhere/references/kivy-kv.md,sha256=9PQR4j-LT66cOUKYCM6AuHXIs5ywmutOQKfxr3frDYw,8546
 pythonhere/.agents/skills/pythonhere/references/kivy-runtime.md,sha256=ggPCmea5lkdg4p6LlxIVUstJhxC40SbrysqXXQ7-lmM,14616
+pythonhere/.agents/skills/pythonhere/references/litert.md,sha256=MAchOo-acMlSwkmtSkAizNMdwKJHzIe87gFyzq6hyZE,4238
 pythonhere/.agents/skills/pythonhere/references/midi.md,sha256=1rB4t7LWnMi139Ou896FzgU-6CGFSNVO1QF9kRBvUgo,10934
 pythonhere/.agents/skills/pythonhere/references/plyer.md,sha256=FYqumbRo826aLrOiRGckS8Oq26v_PoVrSTVbTBZRBs8,6713
 pythonhere/data/logo/logo-128.png,sha256=4sitDJcVBHOU5UPxicmrzc6YqFY7_xtYrc_ULyrw9ks,4161
@@ -41,6 +42,9 @@ pythonhere/magic_here/prompts/kivy-kv.md,sha256=ajIDSo6PG1_7gHcgfNrOARQOUlUEPUae
 pythonhere/magic_here/prompts/kivy-runtime.md,sha256=cAgOF0uE3RKYdKQus7h4lklKtANaLPcOYilGShjNtgM,14621
 pythonhere/magic_here/prompts/midi.md,sha256=2rKvgrwlmeA4MfdnRH9xnTSN0OFOm4mTxtgdYdMAd3Q,10611
 pythonhere/magic_here/prompts/plyer.md,sha256=wplCHPXkN1vU_thGIxvALuYPB6QDdjCHFhoc93ppvAE,6708
+pythonhere/ml_here/__init__.py,sha256=TiAtiBcGl5jkTmm3Rbt1mlPWRFo4BQTcgHHAzYOs_i0,346
+pythonhere/ml_here/huggingface.py,sha256=857iOkJh90jbxhwyTo1EJ2enVwql3rI8-wUvK04UM9s,33030
+pythonhere/ml_here/storage.py,sha256=JlKIad1bjVR7OSY2KFkyujyQA0dTH2DQPFJvFGH7AEE,4606
 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
@@ -51,8 +55,8 @@ pythonhere/ui_here/server_screen_here.kv,sha256=x0Se8hmgjS57gFIPa1r2lf6yJchs3lXO
 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.3.0.dist-info/licenses/LICENSE,sha256=nW9_eVi3dSMOkr6xghsobAovBEJiffjl_5WjujJTa74,1071
-pythonhere-0.3.0.dist-info/METADATA,sha256=atBipqGUbZ_WsS26XcbpouMep9sQpyQaPaIrz0Y5RNc,5348
-pythonhere-0.3.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-pythonhere-0.3.0.dist-info/top_level.txt,sha256=dvkfRGF1tFbkjXzD9vwqXTge1Znkv7ga5fRJy5yhJsE,11
-pythonhere-0.3.0.dist-info/RECORD,,
+pythonhere-0.4.0.dist-info/licenses/LICENSE,sha256=nW9_eVi3dSMOkr6xghsobAovBEJiffjl_5WjujJTa74,1071
+pythonhere-0.4.0.dist-info/METADATA,sha256=_Fwxkb2YFoMe4IHOHzOaRLEmWsHjUi8A6JGiLKzN3-4,5470
+pythonhere-0.4.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+pythonhere-0.4.0.dist-info/top_level.txt,sha256=dvkfRGF1tFbkjXzD9vwqXTge1Znkv7ga5fRJy5yhJsE,11
+pythonhere-0.4.0.dist-info/RECORD,,