android-notify 1.59.4__py3-none-any.whl → 1.60.0__py3-none-any.whl

docs/tests/flet/basic/src/core.py

@@ -0,0 +1,221 @@
+""" Non-Advanced Stuff """
+import random
+import os
+ON_ANDROID = False
+
+def on_flet_app():
+    return os.getenv("MAIN_ACTIVITY_HOST_CLASS_NAME")
+
+def get_activity_class_name():
+    ACTIVITY_CLASS_NAME = os.getenv("MAIN_ACTIVITY_HOST_CLASS_NAME") # flet python
+    if not ACTIVITY_CLASS_NAME:
+        try:
+            from android import config
+            ACTIVITY_CLASS_NAME = getattr(config, "JAVA_NAMESPACE", None)
+        except (ImportError, AttributeError):
+            ACTIVITY_CLASS_NAME = 'org.kivy.android'
+    return ACTIVITY_CLASS_NAME
+
+try:
+
+    from jnius import autoclass # Needs Java to be installed
+    # Get the required Java classes
+    ACTIVITY_CLASS_NAME = get_activity_class_name()
+    PythonActivity = autoclass(ACTIVITY_CLASS_NAME)
+    context = PythonActivity.mActivity # Get the app's context 
+    NotificationChannel = autoclass('android.app.NotificationChannel')
+    String = autoclass('java.lang.String')
+    Intent = autoclass('android.content.Intent')
+    PendingIntent = autoclass('android.app.PendingIntent')
+    BitmapFactory = autoclass('android.graphics.BitmapFactory')
+    BuildVersion = autoclass('android.os.Build$VERSION')    
+    ON_ANDROID=True
+except Exception as e:
+    print('\nThis Package Only Runs on Android !!! ---> Check "https://github.com/Fector101/android_notify/" to see design patterns and more info.\n')
+
+if ON_ANDROID:
+    try:
+        NotificationManagerCompat = autoclass('androidx.core.app.NotificationManagerCompat')                                       
+        NotificationCompat = autoclass('androidx.core.app.NotificationCompat')
+
+        # Notification Design
+        NotificationCompatBuilder = autoclass('androidx.core.app.NotificationCompat$Builder')
+        NotificationCompatBigTextStyle = autoclass('androidx.core.app.NotificationCompat$BigTextStyle')
+        NotificationCompatBigPictureStyle = autoclass('androidx.core.app.NotificationCompat$BigPictureStyle')
+        NotificationCompatInboxStyle = autoclass('androidx.core.app.NotificationCompat$InboxStyle')
+    except Exception as e:
+        print("""\n
+        Dependency Error: Add the following in buildozer.spec:
+        * android.gradle_dependencies = androidx.core:core-ktx:1.15.0, androidx.core:core:1.6.0
+        * android.enable_androidx = True
+        * android.permissions = POST_NOTIFICATIONS\n
+        """)
+
+
+def get_app_root_path():
+    if on_flet_app():
+        return os.path.join(context.getFilesDir().getAbsolutePath(),'flet')
+    else:
+        from android.storage import app_storage_path # type: ignore
+        return app_storage_path()
+    
+def asks_permission_if_needed():
+    """
+    Ask for permission to send notifications if needed.
+    """
+    if on_flet_app():
+        VERSION_CODES = autoclass('android.os.Build$VERSION_CODES')
+        ContextCompat = autoclass('androidx.core.content.ContextCompat')
+        # if you get error `Failed to find class: androidx/core/app/ActivityCompat`
+        #in proguard-rules.pro add `-keep class androidx.core.app.ActivityCompat { *; }`
+        ActivityCompat = autoclass('androidx.core.app.ActivityCompat')
+        Manifest = autoclass('android.Manifest$permission')
+        VERSION_CODES = autoclass('android.os.Build$VERSION_CODES')
+
+        if BuildVersion.SDK_INT >= VERSION_CODES.TIRAMISU:
+            permission = Manifest.POST_NOTIFICATIONS
+            granted = ContextCompat.checkSelfPermission(context, permission)
+
+            if granted != 0:  # PackageManager.PERMISSION_GRANTED == 0
+                ActivityCompat.requestPermissions(context, [permission], 101)
+    else: # android package is from p4a which is for kivy
+        try:
+            from android.permissions import request_permissions, Permission,check_permission # type: ignore
+            permissions=[Permission.POST_NOTIFICATIONS]
+            if not all(check_permission(p) for p in permissions):
+                request_permissions(permissions)
+        except Exception as e:
+            print("android_notify- error trying to request notification access: ", e)
+
+def get_image_uri(relative_path):
+    """
+    Get the absolute URI for an image in the assets folder.
+    :param relative_path: The relative path to the image (e.g., 'assets/imgs/icon.png').
+    :return: Absolute URI java Object (e.g., 'file:///path/to/file.png').
+    """
+    app_root_path = get_app_root_path() 
+    output_path = os.path.join(app_root_path,'app', relative_path)
+    # print(output_path,'output_path')  # /data/user/0/org.laner.lan_ft/files/app/assets/imgs/icon.png
+    
+    if not os.path.exists(output_path):
+        raise FileNotFoundError(f"\nImage not found at path: {output_path}\n")
+    
+    Uri = autoclass('android.net.Uri')
+    return Uri.parse(f"file://{output_path}")
+
+def get_icon_object(uri):
+    BitmapFactory = autoclass('android.graphics.BitmapFactory')
+    IconCompat = autoclass('androidx.core.graphics.drawable.IconCompat')
+
+    bitmap= BitmapFactory.decodeStream(context.getContentResolver().openInputStream(uri))
+    return IconCompat.createWithBitmap(bitmap)
+
+def insert_app_icon(builder,custom_icon_path):
+    if custom_icon_path:
+        try:
+            uri = get_image_uri(custom_icon_path)
+            icon = get_icon_object(uri)
+            builder.setSmallIcon(icon)
+        except Exception as e:
+            print('android_notify- error: ',e)
+            builder.setSmallIcon(context.getApplicationInfo().icon)
+    else:
+        print('Found res icon -->',context.getApplicationInfo().icon,'<--')
+        builder.setSmallIcon(context.getApplicationInfo().icon)
+
+def send_notification(
+    title:str,
+    message:str,
+    style=None,
+    img_path=None,
+    channel_name="Default Channel",
+    channel_id:str="default_channel",
+    custom_app_icon_path="",
+
+    big_picture_path='',
+    large_icon_path='',
+    big_text="",
+    lines=""
+    ):
+    """
+    Send a notification on Android.
+
+    :param title: Title of the notification.
+    :param message: Message body.
+    :param style: Style of the notification ('big_text', 'big_picture', 'inbox', 'large_icon').
+    :param img_path: Path to the image resource.
+    :param channel_id: Notification channel ID.(Default is lowercase channel name arg in lowercase)
+    """
+    if not ON_ANDROID:
+        print('This Package Only Runs on Android !!! ---> Check "https://github.com/Fector101/android_notify/" for Documentation.')
+        return
+
+    asks_permission_if_needed()
+    channel_id=channel_name.replace(' ','_').lower().lower() if not channel_id else channel_id
+    # Get notification manager
+    notification_manager = context.getSystemService(context.NOTIFICATION_SERVICE)
+
+    # importance= autoclass('android.app.NotificationManager').IMPORTANCE_HIGH # also works #NotificationManager.IMPORTANCE_DEFAULT
+    importance= NotificationManagerCompat.IMPORTANCE_HIGH #autoclass('android.app.NotificationManager').IMPORTANCE_HIGH also works #NotificationManager.IMPORTANCE_DEFAULT
+
+    # Notification Channel (Required for Android 8.0+)
+    if BuildVersion.SDK_INT >= 26:
+        channel = NotificationChannel(channel_id, channel_name,importance)
+        notification_manager.createNotificationChannel(channel)
+
+    # Build the notification
+    builder = NotificationCompatBuilder(context, channel_id)
+    builder.setContentTitle(title)
+    builder.setContentText(message)
+    insert_app_icon(builder,custom_app_icon_path)
+    builder.setDefaults(NotificationCompat.DEFAULT_ALL)
+    builder.setPriority(NotificationCompat.PRIORITY_HIGH)
+
+    if img_path:
+        print('android_notify- img_path arg deprecated use "large_icon_path or big_picture_path or custom_app_icon_path"instead ')
+
+    big_picture = None
+    if big_picture_path:
+        try:
+            big_picture = get_image_uri(big_picture_path)
+        except FileNotFoundError as e:
+            print('android_notify- Error Getting Uri for big_picture_path: ',e)
+
+    large_icon = None
+    if large_icon_path:
+        try:
+            large_icon = get_image_uri(large_icon_path)
+        except FileNotFoundError as e:
+            print('android_notify- Error Getting Uri for large_icon_path: ',e)
+
+
+    # Apply notification styles
+    try:
+        if big_text:
+            big_text_style = NotificationCompatBigTextStyle()
+            big_text_style.bigText(big_text)
+            builder.setStyle(big_text_style)
+
+        elif lines:
+            inbox_style = NotificationCompatInboxStyle()
+            for line in lines.split("\n"):
+                inbox_style.addLine(line)
+            builder.setStyle(inbox_style)
+
+        if large_icon:
+            bitmap = BitmapFactory.decodeStream(context.getContentResolver().openInputStream(large_icon))
+            builder.setLargeIcon(bitmap)
+
+        if big_picture:
+            bitmap = BitmapFactory.decodeStream(context.getContentResolver().openInputStream(big_picture))
+            builder.setLargeIcon(bitmap)
+            big_picture_style = NotificationCompatBigPictureStyle().bigPicture(bitmap)
+            builder.setStyle(big_picture_style)
+
+    except Exception as e:
+        print('android_notify- Error Failed Adding Style: ',e)
+    # Display the notification
+    notification_id = random.randint(0, 100)
+    notification_manager.notify(notification_id, builder.build())
+    return notification_id
+

docs/tests/flet/basic/src/main.py

@@ -0,0 +1,112 @@
+import flet as ft
+import os,traceback
+
+try:
+    from core import send_notification
+except Exception as e:
+    print("Not on android")
+    print("Error importing android_notify: {}".format(e))
+
+md1 = """ """
+i=0
+
+def main(page: ft.Page): 
+    page.scroll = ft.ScrollMode.ADAPTIVE
+    mdObj=ft.Markdown(
+            md1,
+            selectable=True,
+            extension_set=ft.MarkdownExtensionSet.GITHUB_WEB,
+            on_tap_link=lambda e: page.launch_url(e.data),
+        )
+    def handle_click(style):
+        if style == "big_text":
+            send_notification(
+                title="Big Text Example",
+                message="This uses the BigTextStyle!",
+                style="big_text",
+                big_text="This is an expanded notification showing how much text can fit here."
+            )
+        elif style == "big_picture":
+            send_notification(
+                title="Big Picture Example",
+                message="This uses the BigPictureStyle!",
+                big_picture_path="assets/splash_android.png"
+            )
+        elif style == "large_icon":
+            send_notification(
+                title="Large Icon Example",
+                message="This uses a Large Icon!",
+                large_icon_path="assets/icon.png"
+            )
+        elif style == "both_imgs":
+            send_notification(
+                title="Both 'Large Icon' and 'Big Picture' Example",
+                message="This uses a Both Imgs!",
+                big_picture_path="assets/splash_android.png",
+                large_icon_path="assets/icon.png"
+            )
+        elif style == "inbox":
+            send_notification(
+                title="Inbox Example",
+                message="This uses the InboxStyle!",
+                lines="Line 1\nLine 2\nLine 3"
+            )
+        else:
+            send_notification(
+                title="Simple Notification",
+                message="This is a normal notification!"
+            )
+
+        page.snack_bar = ft.SnackBar(ft.Text(f"Sent: {style or 'default'}"))
+        page.snack_bar.open = True
+        page.update()
+
+    def console(a):
+        global md1,i
+        i+=1
+        print('Testing print visibility: ',i,'\n')
+        try:
+            with open(os.getenv("FLET_APP_CONSOLE"), "r") as f:
+                md1 = f.read()
+                mdObj.value=md1
+        except Exception as e:
+            mdObj.value=f"{e}, hello readddd me i'm Error"
+        finally:
+            mdObj.update()
+
+
+    def send_basic(e):
+        send_notification(title='Hello World',message='From android_notify',custom_app_icon_path=f'assets/icon.png')
+
+    def request_permission(e):
+        try:
+            from core import asks_permission_if_needed
+            asks_permission_if_needed()
+        except Exception as e:
+            print( f"pyjnius android_ import error: {traceback.format_exc()}"            )
+
+    page.add(
+        ft.OutlinedButton(
+            "Request Permission if Needed",
+            on_click=request_permission,
+        ), ft.OutlinedButton(
+            "Refresh Prints",
+            on_click=console,
+        )
+    )
+    page.add(
+        ft.Text("🧪 Android Notify Test", size=25, weight=ft.FontWeight.BOLD),
+        ft.Text("Click a button below to test the corresponding style.\n", size=16),
+
+        ft.ElevatedButton("🔔 Simple Notification", on_click=lambda e: handle_click(None)),
+        ft.ElevatedButton("🖼️ Big Picture Style", on_click=lambda e: handle_click("big_picture")),
+        ft.ElevatedButton("🧩 Large Icon Style", on_click=lambda e: handle_click("large_icon")),
+        ft.ElevatedButton("# Both imgs", on_click=lambda e: handle_click("both_imgs")),
+        ft.ElevatedButton("📝 Big Text Style", on_click=lambda e: handle_click("big_text")),
+        ft.ElevatedButton("📋 Inbox Style", on_click=lambda e: handle_click("inbox")),
+    )
+    btn = ft.ElevatedButton("Click me!", on_click=send_basic)
+    page.add(btn)
+    page.add(mdObj)
+ft.app(main)
+

docs/website/src/pages/data/laner_Sent.py

@@ -0,0 +1,24 @@
+import React, { useState, useEffect } from 'react';
+
+const ResponsiveText: React.FC = () => {
+  const [fontSize, setFontSize] = useState<string>(getFontSize());
+
+  function getFontSize(): string {
+    return window.innerWidth < 600 ? '12px' : '16px';
+  }
+
+  useEffect(() => {
+    const handleResize = () => setFontSize(getFontSize());
+
+    window.addEventListener('resize', handleResize);
+    return () => window.removeEventListener('resize', handleResize);
+  }, []);
+
+  return (
+    <p style={{ fontSize }}>
+      This text adjusts size based on screen width!
+    </p>
+  );
+};
+
+export default ResponsiveText;

venv/Lib/site-packages/__editable___android_notify_1_60_0_finder.py

@@ -0,0 +1,85 @@
+from __future__ import annotations
+import sys
+from importlib.machinery import ModuleSpec, PathFinder
+from importlib.machinery import all_suffixes as module_suffixes
+from importlib.util import spec_from_file_location
+from itertools import chain
+from pathlib import Path
+
+MAPPING: dict[str, str] = {'android_notify': 'C:\\Users\\hp\\Documents\\fabian\\android_notify\\android_notify', 'dist': 'C:\\Users\\hp\\Documents\\fabian\\android_notify\\dist', 'docs': 'C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs', 'venv': 'C:\\Users\\hp\\Documents\\fabian\\android_notify\\venv'}
+NAMESPACES: dict[str, list[str]] = {'dist': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\dist'], 'docs': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs'], 'venv': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\venv'], 'android_notify.res': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\android_notify\\res'], 'android_notify.res.layout': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\android_notify\\res\\layout'], 'android_notify.res.layout.dev': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\android_notify\\res\\layout\\dev'], 'docs.examples': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\examples'], 'docs.imgs': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\imgs'], 'docs.tests': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\tests'], 'docs.website': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\website'], 'docs.examples.flet-working': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\examples\\flet-working'], 'docs.examples.flet-working.src': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\examples\\flet-working\\src'], 'docs.examples.flet-working.src.assets': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\examples\\flet-working\\src\\assets'], 'docs.tests.flet': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\tests\\flet'], 'docs.tests.flet.adv': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\tests\\flet\\adv'], 'docs.tests.flet.basic': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\tests\\flet\\basic'], 'docs.tests.flet.basic.src': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\tests\\flet\\basic\\src'], 'docs.tests.flet.basic.src.assets': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\tests\\flet\\basic\\src\\assets'], 'docs.website.public': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\website\\public'], 'docs.website.src': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\website\\src'], 'docs.website.src.assets': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\website\\src\\assets'], 'docs.website.src.pages': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\website\\src\\pages'], 'docs.website.src.ui': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\website\\src\\ui'], 'docs.website.src.assets.css': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\website\\src\\assets\\css'], 'docs.website.src.assets.imgs': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\website\\src\\assets\\imgs'], 'docs.website.src.assets.js': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\website\\src\\assets\\js'], 'docs.website.src.pages.data': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\website\\src\\pages\\data'], 'docs.website.src.pages.versions-data': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\website\\src\\pages\\versions-data'], 'docs.website.src.ui.CodeBlock': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\website\\src\\ui\\CodeBlock'], 'docs.website.src.ui.Footer': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\website\\src\\ui\\Footer'], 'docs.website.src.ui.Header': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\website\\src\\ui\\Header'], 'docs.website.src.ui.SiteOverview': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\docs\\website\\src\\ui\\SiteOverview'], 'venv.Include': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\venv\\Include'], 'venv.Lib': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\venv\\Lib'], 'venv.Scripts': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\venv\\Scripts'], 'venv.Lib.site-packages': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\venv\\Lib\\site-packages'], 'venv.Lib.site-packages.jaraco': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\venv\\Lib\\site-packages\\jaraco'], 'venv.Lib.site-packages.docutils.parsers.rst.include': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\venv\\Lib\\site-packages\\docutils\\parsers\\rst\\include'], 'venv.Lib.site-packages.docutils.writers.s5_html.themes': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\venv\\Lib\\site-packages\\docutils\\writers\\s5_html\\themes'], 'venv.Lib.site-packages.docutils.writers.s5_html.themes.big-black': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\venv\\Lib\\site-packages\\docutils\\writers\\s5_html\\themes\\big-black'], 'venv.Lib.site-packages.docutils.writers.s5_html.themes.big-white': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\venv\\Lib\\site-packages\\docutils\\writers\\s5_html\\themes\\big-white'], 'venv.Lib.site-packages.docutils.writers.s5_html.themes.default': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\venv\\Lib\\site-packages\\docutils\\writers\\s5_html\\themes\\default'], 'venv.Lib.site-packages.docutils.writers.s5_html.themes.medium-black': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\venv\\Lib\\site-packages\\docutils\\writers\\s5_html\\themes\\medium-black'], 'venv.Lib.site-packages.docutils.writers.s5_html.themes.medium-white': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\venv\\Lib\\site-packages\\docutils\\writers\\s5_html\\themes\\medium-white'], 'venv.Lib.site-packages.docutils.writers.s5_html.themes.small-black': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\venv\\Lib\\site-packages\\docutils\\writers\\s5_html\\themes\\small-black'], 'venv.Lib.site-packages.docutils.writers.s5_html.themes.small-white': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\venv\\Lib\\site-packages\\docutils\\writers\\s5_html\\themes\\small-white'], 'venv.Lib.site-packages.id._internal': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\venv\\Lib\\site-packages\\id\\_internal'], 'venv.Lib.site-packages.jnius.src': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\venv\\Lib\\site-packages\\jnius\\src'], 'venv.Lib.site-packages.jnius.src.org': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\venv\\Lib\\site-packages\\jnius\\src\\org'], 'venv.Lib.site-packages.jnius.src.org.jnius': ['C:\\Users\\hp\\Documents\\fabian\\android_notify\\venv\\Lib\\site-packages\\jnius\\src\\org\\jnius']}
+PATH_PLACEHOLDER = '__editable__.android_notify-1.60.0.finder' + ".__path_hook__"
+
+
+class _EditableFinder:  # MetaPathFinder
+    @classmethod
+    def find_spec(cls, fullname: str, path=None, target=None) -> ModuleSpec | None:  # type: ignore
+        # Top-level packages and modules (we know these exist in the FS)
+        if fullname in MAPPING:
+            pkg_path = MAPPING[fullname]
+            return cls._find_spec(fullname, Path(pkg_path))
+
+        # Handle immediate children modules (required for namespaces to work)
+        # To avoid problems with case sensitivity in the file system we delegate
+        # to the importlib.machinery implementation.
+        parent, _, child = fullname.rpartition(".")
+        if parent and parent in MAPPING:
+            return PathFinder.find_spec(fullname, path=[MAPPING[parent]])
+
+        # Other levels of nesting should be handled automatically by importlib
+        # using the parent path.
+        return None
+
+    @classmethod
+    def _find_spec(cls, fullname: str, candidate_path: Path) -> ModuleSpec | None:
+        init = candidate_path / "__init__.py"
+        candidates = (candidate_path.with_suffix(x) for x in module_suffixes())
+        for candidate in chain([init], candidates):
+            if candidate.exists():
+                return spec_from_file_location(fullname, candidate)
+        return None
+
+
+class _EditableNamespaceFinder:  # PathEntryFinder
+    @classmethod
+    def _path_hook(cls, path) -> type[_EditableNamespaceFinder]:
+        if path == PATH_PLACEHOLDER:
+            return cls
+        raise ImportError
+
+    @classmethod
+    def _paths(cls, fullname: str) -> list[str]:
+        paths = NAMESPACES[fullname]
+        if not paths and fullname in MAPPING:
+            paths = [MAPPING[fullname]]
+        # Always add placeholder, for 2 reasons:
+        # 1. __path__ cannot be empty for the spec to be considered namespace.
+        # 2. In the case of nested namespaces, we need to force
+        #    import machinery to query _EditableNamespaceFinder again.
+        return [*paths, PATH_PLACEHOLDER]
+
+    @classmethod
+    def find_spec(cls, fullname: str, target=None) -> ModuleSpec | None:  # type: ignore
+        if fullname in NAMESPACES:
+            spec = ModuleSpec(fullname, None, is_package=True)
+            spec.submodule_search_locations = cls._paths(fullname)
+            return spec
+        return None
+
+    @classmethod
+    def find_module(cls, _fullname) -> None:
+        return None
+
+
+def install():
+    if not any(finder == _EditableFinder for finder in sys.meta_path):
+        sys.meta_path.append(_EditableFinder)
+
+    if not NAMESPACES:
+        return
+
+    if not any(hook == _EditableNamespaceFinder._path_hook for hook in sys.path_hooks):
+        # PathEntryFinder is needed to create NamespaceSpec without private APIS
+        sys.path_hooks.append(_EditableNamespaceFinder._path_hook)
+    if PATH_PLACEHOLDER not in sys.path:
+        sys.path.append(PATH_PLACEHOLDER)  # Used just to trigger the path hook

venv/Lib/site-packages/build/__init__.py

@@ -0,0 +1,39 @@
+"""
+build - A simple, correct Python build frontend
+"""
+
+from __future__ import annotations
+
+from ._builder import ProjectBuilder
+from ._exceptions import (
+    BuildBackendException,
+    BuildException,
+    BuildSystemTableValidationError,
+    FailedProcessError,
+    TypoWarning,
+)
+from ._types import ConfigSettings as ConfigSettingsType
+from ._types import Distribution as DistributionType
+from ._types import SubprocessRunner as RunnerType
+from ._util import check_dependency
+
+
+__version__ = '1.3.0'
+
+__all__ = [
+    'BuildBackendException',
+    'BuildException',
+    'BuildSystemTableValidationError',
+    'ConfigSettingsType',
+    'DistributionType',
+    'FailedProcessError',
+    'ProjectBuilder',
+    'RunnerType',
+    'TypoWarning',
+    '__version__',
+    'check_dependency',
+]
+
+
+def __dir__() -> list[str]:
+    return __all__