tkinterweb 4.17.4__tar.gz → 4.17.6__tar.gz

{tkinterweb-4.17.4/tkinterweb.egg-info → tkinterweb-4.17.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tkinterweb
-Version: 4.17.4
+Version: 4.17.6
 Summary: HTML/CSS viewer, editor, and app builder for Tkinter
 Home-page: https://github.com/Andereoo/TkinterWeb
 License: MIT

{tkinterweb-4.17.4 → tkinterweb-4.17.6}/setup.py

@@ -6,7 +6,7 @@ README = (HERE / "README.md").read_text()
 
 setup(
     name="tkinterweb",
-    version="4.17.4",
+    version="4.17.6",
     python_requires=">=3.2",
     description="HTML/CSS viewer, editor, and app builder for Tkinter",
     long_description=README,

{tkinterweb-4.17.4 → tkinterweb-4.17.6}/tkinterweb/bindings.py

@@ -584,7 +584,7 @@ It is likely that not all dependencies are installed. Make sure Cairo is install
     # --- HTML/CSS parsing ----------------------------------------------------
 
     def parse(self, html, thread_safe=False):
-        "Parse HTML code. reset() must be called before running parse() for the first time."
+        "Parse HTML code. Call :meth:`TkinterWeb.reset` before calling this method for the first time."
         # NOTE: when thread_safe=True, this method is thread-safe
 
         self.downloads_have_occured = False
@@ -737,15 +737,15 @@ It is likely that not all dependencies are installed. Make sure Cairo is install
             thread.start()
 
     def _begin_download(self):
-        # NOTE: this runs in a thread
+        # NOTE: this may run in a thread
 
         thread = utilities.get_current_thread()
         self.active_threads.append(thread)
-        self.post_event(utilities.DOWNLOADING_RESOURCE_EVENT, True)
+        self.post_event(utilities.DOWNLOADING_RESOURCE_EVENT, thread.is_subthread)
         return thread
 
     def _finish_download(self, thread):
-        # NOTE: this runs in a thread
+        # NOTE: this may run in a thread
 
         self.active_threads.remove(thread)
         if len(self.active_threads) == 0:
@@ -769,20 +769,20 @@ It is likely that not all dependencies are installed. Make sure Cairo is install
         else:
             return None, None
 
-    def text(self, *args):
-        "Enable interaction with the text of the HTML document."
-        return self.tk.call(self._w, "text", *args)
+    def text(self, subcommand, *args):
+        "Interact with the text of the HTML document. Valid subcommands are bbox, index, offset, and text."
+        return self.tk.call(self._w, "text", subcommand, *args)
 
     def tag(self, subcommand, tag_name, *args):
-        "Return the name of the Html tag that generated this document node, or an empty string if the node is a text node."
+        "Highlight regions of text displayed by the widget. Valid subcommands are add, remove, configure, and delete."
         return self.tk.call(self._w, "tag", subcommand, tag_name, *args)
 
     def search(self, selector, *a, cnf={}, **kw):
-        """Search the document for the specified CSS selector; return a Tkhtml3 node if found."""
+        """Search the document for the specified CSS selector; return a Tkhtml node if found."""
         return self.tk.call((self._w, "search", selector)+utilities.TclOpt(a)+self._options(cnf, kw))
 
     def xview(self, *args, auto_scroll=False):
-        "Used to control horizontal scrolling."
+        "Control horizontal scrolling."
         #if args:
         #    return self.tk.call(self._w, "xview", *args)
         #coords = map(float, self.tk.call(self._w, "xview").split()) #raises an error
@@ -802,7 +802,7 @@ It is likely that not all dependencies are installed. Make sure Cairo is install
         return self.xview("moveto", number, auto_scroll=auto_scroll)
 
     def yview(self, *args, auto_scroll=False):
-        """Used to control vertical scrolling."""
+        """Control vertical scrolling."""
         yview = self.tk.call(self._w, "yview", *args)
         if args:
             self.caret_manager.update(auto_scroll=auto_scroll)
@@ -970,11 +970,11 @@ It is likely that not all dependencies are installed. Make sure Cairo is install
         self.tk.call(node, "dynamic", "set", name)
 
     def remove_node_flags(self, node, name):
-        "Set dynamic flags on the given node."
+        "remove dynamic flags on the given node."
         self.tk.call(node, "dynamic", "clear", name)
 
     def get_node_tkhtml(self, node_handle):
-        "Get the path name of node."
+        "Get the path name of the node's corresponding Tkhtml instance."
         return self.tk.call(node_handle, "html")
 
     def get_node_stacking(self, node_handle):
@@ -985,7 +985,7 @@ It is likely that not all dependencies are installed. Make sure Cairo is install
         return self.tk.call(node_handle, "stacking")
 
     def get_current_hovered_node(self, event):
-        "Get current node."
+        "Get the current node."
         if self.widget_manager.hovered_embedded_node:
             return self.widget_manager.hovered_embedded_node
 
@@ -994,11 +994,11 @@ It is likely that not all dependencies are installed. Make sure Cairo is install
         )
 
     def get_current_hovered_node_parent(self, node):
-        "Get the parent of the given node."
+        "Get the parent of the node returned by :meth:`TkinterWeb.get_current_hovered_node`."
         return self.tk.eval(f"""set node [lindex [lindex [{node} parent] end] end]""")
 
     def register_handler(self, handler_type, node_tag, callback):
-        "Register a node handler"
+        "Register a node handler."
         self.tk.call(self._w, "handler", handler_type, node_tag, self.register(callback))
 
     def _lazy_handler(self, manager, method):
@@ -1008,7 +1008,7 @@ It is likely that not all dependencies are installed. Make sure Cairo is install
         return callback
     
     def register_lazy_handler(self, handler_type, node_tag, manager_name):
-        "Register a node handler to run in the given manager"
+        "Register a node handler to run lazily in the given manager."
         if handler_type == "attribute":
             callback_name = f"_on_{node_tag}_value_change"
         else:

{tkinterweb-4.17.4 → tkinterweb-4.17.6}/tkinterweb/handlers.py

@@ -479,7 +479,7 @@ class ScriptManager(utilities.BaseManager):
     
     def fetch_scripts(self, attributes, url=None, data=None):
         "Fetch and run scripts"
-        # NOTE: this runs in a thread
+        # NOTE: this may run in a thread
 
         thread = self.html._begin_download()
 
@@ -563,7 +563,7 @@ class StyleManager(utilities.BaseManager):
     
     def fetch_styles(self, url=None, node=None):
         "Fetch stylesheets and parse the CSS code they contain"
-        # NOTE: this runs in a thread
+        # NOTE: this may run in a thread
 
         thread = self.html._begin_download()
         if url and thread.isrunning():
@@ -692,7 +692,7 @@ class ImageManager(utilities.BaseManager):
 
     def fetch_images(self, url, name):
         "Fetch images and display them in the document."
-        # NOTE: this runs in a thread
+        # NOTE: this may run in a thread
 
         thread = self.html._begin_download()
         if thread.isrunning():
@@ -717,7 +717,7 @@ class ImageManager(utilities.BaseManager):
 
     def check_images(self, data, name, url, filetype, thread_safe):
         "Invert images if needed and convert SVG images to PNGs."
-        # NOTE: this runs in a thread
+        # NOTE: this may run in a thread
 
         data_is_image = False
         if "svg" in filetype:
@@ -899,7 +899,7 @@ class ObjectManager(utilities.BaseManager):
                 self.html.widget_manager.map_node(node, True)
 
     def fetch_objects(self, url, node):
-        # NOTE: this runs in a thread
+        # NOTE: this may run in a thread
 
         thread = self.html._begin_download()
 

{tkinterweb-4.17.4 → tkinterweb-4.17.6}/tkinterweb/htmlwidgets.py

@@ -1106,6 +1106,9 @@ class HtmlFrame(Frame):
         """Make all elements with the 'tkinterweb-full-page' attribute the same height as the html widget.
         This can be used in conjunction with table elements to vertical align pages,
         which is otherwise not possible with Tkhtml. Hopefully we won't need this forever."""
+        if self._html.cget("shrink"):
+            return
+
         if event:
             height = event.height
         else:
@@ -1187,7 +1190,7 @@ class HtmlFrame(Frame):
 
     def _continue_loading(self, url, data="", method="GET", decode=None, force=False, thread_safe=False):
         "Finish loading urls and handle URI fragments."
-        # NOTE: this runs in a thread
+        # NOTE: this may run in a thread
 
         code = 404
         self._current_url = url
@@ -1422,18 +1425,12 @@ class HtmlLabel(HtmlFrame):
 
         self._style = Style()
 
-        if text:
-            self.load_html(text)
-        # I'd like to just make this an else statement
-        # But someone in issue 145 mentioned layout issues when that was the case
-        # I can't seem to reproduce it though...?
+        if text: self.load_html(text)
+        # I'd like to just make this an else statement to prevent the widget from being a massive white screen when text=""
         elif self.unshrink or (not self._html.using_tkhtml30 and not self._html.cget("textwrap")):
+            # A fellow in issue 145 mentioned layout issues when this was used
+            # I can't seem to reproduce it though...?
             self.load_html("<body></body>", _relayout=False)
-
-    def _handle_html_resize(self, *args, **kwargs):
-        # Overwrite HtmlFrame._handle_html_resize, which is not necessary when shrink is set to True
-        # HtmlFrame._handle_html_resize also causes weird behaviour when tables are present and shrink set to True
-        return
     
     def load_html(self, *args, _relayout=True, **kwargs):
         ""

{tkinterweb-4.17.4 → tkinterweb-4.17.6}/tkinterweb/utilities.py

@@ -31,7 +31,7 @@ __title__ = "TkinterWeb"
 __author__ = "Andrew Clarke"
 __copyright__ = "(c) 2021-2025 Andrew Clarke"
 __license__ = "MIT"
-__version__ = "4.17.4"
+__version__ = "4.17.6"
 
 
 ROOT_DIR = os.path.join(os.path.abspath(os.path.dirname(__file__)), "resources")

{tkinterweb-4.17.4 → tkinterweb-4.17.6/tkinterweb.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tkinterweb
-Version: 4.17.4
+Version: 4.17.6
 Summary: HTML/CSS viewer, editor, and app builder for Tkinter
 Home-page: https://github.com/Andereoo/TkinterWeb
 License: MIT