omdev 0.0.0.dev439__py3-none-any.whl → 0.0.0.dev486__py3-none-any.whl

omdev/tui/textual/__init__.py

@@ -0,0 +1,226 @@
+# ruff: noqa: F401
+# flake8: noqa: F401
+from omlish import lang as _lang
+
+
+with _lang.auto_proxy_init(globals()):
+    ##
+
+    from textual import app  # noqa
+    from textual import binding  # noqa
+    from textual import constants  # noqa
+    from textual import containers  # noqa
+    from textual import content  # noqa
+    from textual import driver  # noqa
+    from textual import events  # noqa
+    from textual import geometry  # noqa
+    from textual import markup  # noqa
+    from textual import message  # noqa
+    from textual import messages  # noqa
+    from textual import on  # noqa
+    from textual import pad  # noqa
+    from textual import reactive  # noqa
+    from textual import screen  # noqa
+    from textual import style  # noqa
+    from textual import suggester  # noqa
+    from textual import suggestions  # noqa
+    from textual import timer  # noqa
+    from textual import widget  # noqa
+    from textual import widgets  # noqa
+    from textual import work  # noqa
+    from textual.app import ActionError  # noqa
+    from textual.app import ActiveModeError  # noqa
+    from textual.app import App as App_  # noqa
+    from textual.app import AppError  # noqa
+    from textual.app import AutopilotCallbackType  # noqa
+    from textual.app import CallThreadReturnType  # noqa
+    from textual.app import CommandCallback  # noqa
+    from textual.app import ComposeResult  # noqa
+    from textual.app import InvalidModeError  # noqa
+    from textual.app import InvalidThemeError  # noqa
+    from textual.app import ModeError  # noqa
+    from textual.app import RenderResult  # noqa
+    from textual.app import ReturnType  # noqa
+    from textual.app import ScreenError  # noqa
+    from textual.app import ScreenStackError  # noqa
+    from textual.app import ScreenType  # noqa
+    from textual.app import SuspendNotSupported  # noqa
+    from textual.app import SystemCommand  # noqa
+    from textual.app import UnknownModeError  # noqa
+    from textual.app import get_system_commands_provider  # noqa
+    from textual.binding import ActiveBinding  # noqa
+    from textual.binding import Binding  # noqa
+    from textual.binding import BindingError  # noqa
+    from textual.binding import BindingIDString  # noqa
+    from textual.binding import BindingType  # noqa
+    from textual.binding import BindingsMap  # noqa
+    from textual.binding import InvalidBinding  # noqa
+    from textual.binding import KeyString  # noqa
+    from textual.binding import Keymap  # noqa
+    from textual.binding import KeymapApplyResult  # noqa
+    from textual.binding import NoBinding  # noqa
+    from textual.containers import Center  # noqa
+    from textual.containers import CenterMiddle  # noqa
+    from textual.containers import Container  # noqa
+    from textual.containers import Grid  # noqa
+    from textual.containers import Horizontal  # noqa
+    from textual.containers import HorizontalGroup  # noqa
+    from textual.containers import HorizontalScroll  # noqa
+    from textual.containers import ItemGrid  # noqa
+    from textual.containers import Middle  # noqa
+    from textual.containers import Right  # noqa
+    from textual.containers import ScrollableContainer  # noqa
+    from textual.containers import Vertical  # noqa
+    from textual.containers import VerticalGroup  # noqa
+    from textual.containers import VerticalScroll  # noqa
+    from textual.content import Content  # noqa
+    from textual.content import ContentText  # noqa
+    from textual.content import ContentType  # noqa
+    from textual.content import EMPTY_CONTENT  # noqa
+    from textual.content import Span  # noqa
+    from textual.driver import Driver  # noqa
+    from textual.events import Action  # noqa
+    from textual.events import AppBlur  # noqa
+    from textual.events import AppFocus  # noqa
+    from textual.events import Blur  # noqa
+    from textual.events import Callback  # noqa
+    from textual.events import Click  # noqa
+    from textual.events import Compose  # noqa
+    from textual.events import CursorPosition  # noqa
+    from textual.events import DeliveryComplete  # noqa
+    from textual.events import DeliveryFailed  # noqa
+    from textual.events import DescendantBlur  # noqa
+    from textual.events import DescendantFocus  # noqa
+    from textual.events import Enter  # noqa
+    from textual.events import Event  # noqa
+    from textual.events import Focus  # noqa
+    from textual.events import Hide  # noqa
+    from textual.events import Idle  # noqa
+    from textual.events import InputEvent  # noqa
+    from textual.events import Key  # noqa
+    from textual.events import Leave  # noqa
+    from textual.events import Load  # noqa
+    from textual.events import Mount  # noqa
+    from textual.events import MouseCapture  # noqa
+    from textual.events import MouseDown  # noqa
+    from textual.events import MouseEvent  # noqa
+    from textual.events import MouseMove  # noqa
+    from textual.events import MouseRelease  # noqa
+    from textual.events import MouseScrollDown  # noqa
+    from textual.events import MouseScrollLeft  # noqa
+    from textual.events import MouseScrollRight  # noqa
+    from textual.events import MouseScrollUp  # noqa
+    from textual.events import MouseUp  # noqa
+    from textual.events import Paste  # noqa
+    from textual.events import Print  # noqa
+    from textual.events import Ready  # noqa
+    from textual.events import Resize  # noqa
+    from textual.events import ScreenResume  # noqa
+    from textual.events import ScreenSuspend  # noqa
+    from textual.events import Show  # noqa
+    from textual.events import Timer as TimerEvent  # noqa
+    from textual.events import Unmount  # noqa
+    from textual.geometry import NULL_OFFSET  # noqa
+    from textual.geometry import NULL_REGION  # noqa
+    from textual.geometry import NULL_SIZE  # noqa
+    from textual.geometry import NULL_SPACING  # noqa
+    from textual.geometry import Offset  # noqa
+    from textual.geometry import Region  # noqa
+    from textual.geometry import Size  # noqa
+    from textual.geometry import Spacing  # noqa
+    from textual.geometry import SpacingDimensions  # noqa
+    from textual.geometry import clamp  # noqa
+    from textual.markup import MarkupError  # noqa
+    from textual.markup import MarkupTokenizer  # noqa
+    from textual.markup import StyleTokenizer  # noqa
+    from textual.markup import escape  # noqa
+    from textual.markup import parse_style  # noqa
+    from textual.markup import to_content  # noqa
+    from textual.message import Message  # noqa
+    from textual.messages import CloseMessages  # noqa
+    from textual.messages import ExitApp  # noqa
+    from textual.messages import InBandWindowResize  # noqa
+    from textual.messages import InvokeLater  # noqa
+    from textual.messages import Layout  # noqa
+    from textual.messages import Prompt  # noqa
+    from textual.messages import Prune  # noqa
+    from textual.messages import ScrollToRegion  # noqa
+    from textual.messages import TerminalSupportsSynchronizedOutput  # noqa
+    from textual.messages import Update  # noqa
+    from textual.messages import UpdateScroll  # noqa
+    from textual.pad import HorizontalPad  # noqa
+    from textual.reactive import Initialize  # noqa
+    from textual.reactive import Reactive  # noqa
+    from textual.reactive import ReactiveError  # noqa
+    from textual.reactive import await_watcher  # noqa
+    from textual.reactive import invoke_watcher  # noqa
+    from textual.reactive import reactive as reactive_  # noqa
+    from textual.reactive import var  # noqa
+    from textual.screen import ModalScreen  # noqa
+    from textual.screen import Screen  # noqa
+    from textual.screen import SystemModalScreen  # noqa
+    from textual.style import Style  # noqa
+    from textual.suggester import SuggestFromList  # noqa
+    from textual.suggester import Suggester  # noqa
+    from textual.suggester import SuggestionReady  # noqa
+    from textual.suggestions import get_suggestion  # noqa
+    from textual.suggestions import get_suggestions  # noqa
+    from textual.timer import Timer  # noqa
+    from textual.timer import TimerCallback  # noqa
+    from textual.widget import Widget  # noqa
+    from textual.widgets import Button  # noqa
+    from textual.widgets import Checkbox  # noqa
+    from textual.widgets import Collapsible  # noqa
+    from textual.widgets import ContentSwitcher  # noqa
+    from textual.widgets import DataTable  # noqa
+    from textual.widgets import Digits  # noqa
+    from textual.widgets import DirectoryTree  # noqa
+    from textual.widgets import Footer  # noqa
+    from textual.widgets import Header  # noqa
+    from textual.widgets import HelpPanel  # noqa
+    from textual.widgets import Input  # noqa
+    from textual.widgets import KeyPanel  # noqa
+    from textual.widgets import Label  # noqa
+    from textual.widgets import Link  # noqa
+    from textual.widgets import ListItem  # noqa
+    from textual.widgets import ListView  # noqa
+    from textual.widgets import LoadingIndicator  # noqa
+    from textual.widgets import Log  # noqa
+    from textual.widgets import Markdown  # noqa
+    from textual.widgets import MarkdownViewer  # noqa
+    from textual.widgets import MaskedInput  # noqa
+    from textual.widgets import OptionList  # noqa
+    from textual.widgets import Placeholder  # noqa
+    from textual.widgets import Pretty  # noqa
+    from textual.widgets import ProgressBar  # noqa
+    from textual.widgets import RadioButton  # noqa
+    from textual.widgets import RadioSet  # noqa
+    from textual.widgets import RichLog  # noqa
+    from textual.widgets import Rule  # noqa
+    from textual.widgets import Select  # noqa
+    from textual.widgets import SelectionList  # noqa
+    from textual.widgets import Sparkline  # noqa
+    from textual.widgets import Static  # noqa
+    from textual.widgets import Switch  # noqa
+    from textual.widgets import Tab  # noqa
+    from textual.widgets import TabPane  # noqa
+    from textual.widgets import TabbedContent  # noqa
+    from textual.widgets import Tabs  # noqa
+    from textual.widgets import TextArea  # noqa
+    from textual.widgets import Tooltip  # noqa
+    from textual.widgets import Tree  # noqa
+    from textual.widgets import Welcome  # noqa
+    from textual.widgets.option_list import OptionDoesNotExist  # noqa
+    from textual.widgets.option_list import Option  # noqa
+    from textual.widgets.option_list import DuplicateID  # noqa
+
+    ##
+
+    from .app2 import (  # noqa
+        App,
+    )
+
+    from .drivers2 import (  # noqa
+        PendingWritesDriverMixin,
+        get_pending_writes_driver_class,
+    )

omdev/tui/textual/app2.py

@@ -0,0 +1,11 @@
+import typing as ta
+
+from textual.app import App as App_
+from textual.binding import BindingType  # noqa
+
+
+##
+
+
+class App(App_):
+    BINDINGS: ta.ClassVar[ta.Sequence[BindingType]] = App_.BINDINGS  # type: ignore[assignment]

omdev/tui/textual/autocomplete/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Darren Burns
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

omdev/tui/textual/autocomplete/__init__.py

@@ -0,0 +1,33 @@
+# MIT License
+#
+# Copyright (c) 2023 Darren Burns
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
+# documentation files (the "Software"), to deal in the Software without restriction, including without limitation the
+# rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit
+# persons to whom the Software is furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all copies or substantial portions of the
+# Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
+# WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+# COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+# OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+# https://github.com/darrenburns/textual-autocomplete/tree/0344cd3eb3383cbbd80e01b035ed808ce53cef4d
+from .matching import (  # noqa
+    FuzzySearch,
+    FuzzyMatcher,
+)
+
+from .paths import (  # noqa
+    PathAutoComplete,
+)
+
+from .widget import (  # noqa
+    AutoCompleteItem,
+    AutoCompleteItemHit,
+    AutoCompleteList,
+    AutoComplete,
+)

omdev/tui/textual/autocomplete/matching.py

@@ -0,0 +1,226 @@
+import functools
+import operator
+import re
+import typing as ta
+
+import rich.repr
+from textual.cache import LRUCache
+from textual.content import Content
+from textual.style import Style
+
+
+##
+
+
+class FuzzySearch:
+    """
+    Performs a fuzzy search.
+
+    Unlike a regex solution, this will finds all possible matches.
+    """
+
+    def __init__(
+            self,
+            case_sensitive: bool = False,
+            *,
+            cache_size: int = 1024 * 4,
+    ) -> None:
+        """
+        Initialize fuzzy search.
+
+        Args:
+            case_sensitive: Is the match case sensitive?
+            cache_size: Number of queries to cache.
+        """
+
+        self.case_sensitive = case_sensitive
+        self.cache: LRUCache[tuple[str, str], tuple[float, ta.Sequence[int]]] = LRUCache(cache_size)
+
+    def match(self, query: str, candidate: str) -> tuple[float, ta.Sequence[int]]:
+        """
+        Match against a query.
+
+        Args:
+            query: The fuzzy query.
+            candidate: A candidate to check,.
+
+        Returns:
+            A pair of (score, tuple of offsets). `(0, ())` for no result.
+        """
+
+        cache_key = (query, candidate)
+        if cache_key in self.cache:
+            return self.cache[cache_key]
+        default: tuple[float, ta.Sequence[int]] = (0.0, [])
+        result = max(self._match(query, candidate), key=operator.itemgetter(0), default=default)
+        self.cache[cache_key] = result
+        return result
+
+    @classmethod
+    @functools.lru_cache(maxsize=1024)
+    def get_first_letters(cls, candidate: str) -> frozenset[int]:
+        return frozenset({match.start() for match in re.finditer(r'\w+', candidate)})
+
+    def score(self, candidate: str, positions: ta.Sequence[int]) -> float:
+        """
+        Score a search.
+
+        Args:
+            search: Search object.
+
+        Returns:
+            Score.
+        """
+
+        first_letters = self.get_first_letters(candidate)
+        # This is a heuristic, and can be tweaked for better results.
+        # Boost first letter matches.
+        offset_count = len(positions)
+        score: float = offset_count + len(first_letters.intersection(positions))
+
+        groups = 1
+        last_offset, *offsets = positions
+        for offset in offsets:
+            if offset != last_offset + 1:
+                groups += 1
+            last_offset = offset
+
+        # Boost to favor less groups
+        normalized_groups = (offset_count - (groups - 1)) / offset_count
+        score *= 1 + (normalized_groups * normalized_groups)
+        return score
+
+    def _match(self, query: str, candidate: str) -> ta.Iterable[tuple[float, ta.Sequence[int]]]:
+        letter_positions: list[list[int]] = []
+        position = 0
+
+        if not self.case_sensitive:
+            candidate = candidate.lower()
+            query = query.lower()
+        score = self.score
+        if query in candidate:
+            # Quick exit when the query exists as a substring
+            query_location = candidate.rfind(query)
+            offsets = list(range(query_location, query_location + len(query)))
+            yield (
+                score(candidate, offsets) * (2.0 if candidate == query else 1.5),
+                offsets,
+            )
+            return
+
+        for offset, letter in enumerate(query):
+            last_index = len(candidate) - offset
+            positions: list[int] = []
+            letter_positions.append(positions)
+            index = position
+            while (location := candidate.find(letter, index)) != -1:
+                positions.append(location)
+                index = location + 1
+                if index >= last_index:
+                    break
+            if not positions:
+                yield (0.0, ())
+                return
+            position = positions[0] + 1
+
+        possible_offsets: list[list[int]] = []
+        query_length = len(query)
+
+        def get_offsets(offsets: list[int], positions_index: int) -> None:
+            """
+            Recursively match offsets.
+
+            Args:
+                offsets: A list of offsets.
+                positions_index: Index of query letter.
+            """
+
+            for offset in letter_positions[positions_index]:
+                if not offsets or offset > offsets[-1]:
+                    new_offsets = [*offsets, offset]
+                    if len(new_offsets) == query_length:
+                        possible_offsets.append(new_offsets)
+                    else:
+                        get_offsets(new_offsets, positions_index + 1)
+
+        get_offsets([], 0)
+
+        for offsets in possible_offsets:
+            yield score(candidate, offsets), offsets
+
+
+@rich.repr.auto
+class FuzzyMatcher:
+    """A fuzzy matcher."""
+
+    def __init__(
+            self,
+            query: str,
+            *,
+            match_style: Style | None = None,
+            case_sensitive: bool = False,
+    ) -> None:
+        """
+        Initialize the fuzzy matching object.
+
+        Args:
+            query: A query as typed in by the user.
+            match_style: The style to use to highlight matched portions of a string.
+            case_sensitive: Should matching be case sensitive?
+        """
+
+        self._query = query
+        self._match_style = Style(reverse=True) if match_style is None else match_style
+        self._case_sensitive = case_sensitive
+        self.fuzzy_search = FuzzySearch()
+
+    @property
+    def query(self) -> str:
+        """The query string to look for."""
+
+        return self._query
+
+    @property
+    def match_style(self) -> Style:
+        """The style that will be used to highlight hits in the matched text."""
+
+        return self._match_style
+
+    @property
+    def case_sensitive(self) -> bool:
+        """Is this matcher case sensitive?"""
+
+        return self._case_sensitive
+
+    def match(self, candidate: str) -> float:
+        """
+        Match the candidate against the query.
+
+        Args:
+            candidate: Candidate string to match against the query.
+
+        Returns:
+            Strength of the match from 0 to 1.
+        """
+
+        return self.fuzzy_search.match(self.query, candidate)[0]
+
+    def highlight(self, candidate: str) -> Content:
+        """
+        Highlight the candidate with the fuzzy match.
+
+        Args:
+            candidate: The candidate string to match against the query.
+
+        Returns:
+            A [`Text`][rich.text.Text] object with highlighted matches.
+        """
+
+        content = Content.from_markup(candidate)
+        score, offsets = self.fuzzy_search.match(self.query, candidate)
+        if not score:
+            return content
+        for offset in offsets:
+            if not candidate[offset].isspace():
+                content = content.stylize(self._match_style, offset, offset + 1)
+        return content