pyDiffTools 0.1.29__tar.gz → 0.1.31__tar.gz

{pydifftools-0.1.29/pyDiffTools.egg-info → pydifftools-0.1.31}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyDiffTools
-Version: 0.1.29
+Version: 0.1.31
 Summary: Diff tools
 Author: J M Franck
 License: Copyright (c) 2015, jmfranck
@@ -34,6 +34,8 @@ License: Copyright (c) 2015, jmfranck
         
 Description-Content-Type: text/x-rst
 License-File: LICENSE.md
+Requires-Dist: numpy
+Requires-Dist: Pillow
 Requires-Dist: selenium
 Requires-Dist: fuzzywuzzy[speedup]
 Requires-Dist: PyYAML>=6.0
@@ -48,6 +50,7 @@ Requires-Dist: nbconvert
 Requires-Dist: pygments
 Requires-Dist: ansi2html
 Requires-Dist: lxml
+Requires-Dist: PySide6
 Dynamic: license-file
 
 pydifftools
@@ -98,6 +101,15 @@ included are (listed in order of fun/utility):
   refreshed as you edit the file.  This wraps the former
   ``flowchart/watch_graph.py`` script so all of its functionality is now
   available through the main ``pydifft`` entry point.
+  Add ``--diff-base HEAD`` (or a branch, tag, commit, or quoted reflog
+  reference) to compare against that Git snapshot throughout the preview
+  session. Additions are green, deletions are red and struck through, and
+  unchanged content is muted. Renames share one box; date, status, and
+  dependency changes are annotated. Navigation, filters, and reloads retain
+  the baseline, whose reference and commit appear below the graph.
+  Comparison uses the same repository-relative YAML path; a file absent
+  from the revision is treated as an empty plan. Historical file renames
+  are not followed, and comparison markup is never written to YAML.
 - `pydifft tex2qmd file.tex` converts LaTeX sources to Quarto markdown.
   The converter preserves custom observation blocks and errata tags while
   translating verbatim/python environments into fenced code blocks so the
@@ -108,10 +120,32 @@ included are (listed in order of fun/utility):
   ``_build``/``_display`` directories; with ``--watch`` it starts the HTTP
   server and automatically rebuilds the staged fragments whenever you edit
   a ``.qmd`` file.
-- `pydifft gd [git diff args...]` shows the same Qt review table as the old
+- ``pydifft tree`` (or ``git tree`` with the alias installed) opens the last
+  40 commits across all branches, in Git date order. Use the down arrow
+  below the history to add the next 40 commits. Colors follow
+  first-parent ancestry; merged branches join the receiving branch.
+  Tags and branch tips have vector icon badges; hashes appear on hover.
+  Click any part of a commit row
+  to compare with the working directory, or right-click to copy its hash
+  or set a commit as the comparison endpoint. The right-click menu can restore
+  the working-directory endpoint. Diff window titles show the equivalent
+  arguments, preferring tags, then branch names, then six-character hashes.
+  Run ``pydifft tree --install`` to add the matching ``git tree`` alias.
+- ``pydifft gd`` (or ``git gd`` with the alias installed) reviews unstaged
+  changes, like bare ``git diff``.
+  ``pydifft gd [git diff args...]`` shows the same Qt review table as the old
   ``git_gd_qt.py`` helper before launching ``git difftool`` for a selected
-  file.  Run ``pydifft gd --install`` to add the matching ``git gd`` alias
-  to your global git config.
+  file.
+  Image rows are scored in the background and displayed as normalized
+  ``rgb X.X a X.X`` RMS changes; RGB change orders the image rows as scores
+  arrive.
+  Raster images open in a Qt viewer that aligns the old and new image,
+  displays their RGB difference, and uses up/down controls to switch
+  among the original, difference, and aligned new image. Images with an
+  alpha channel are displayed over a checkerboard; when transparency
+  changes, an additional red/blue alpha-difference view is included.
+  Run ``pydifft gd --install`` to add the matching ``git gd`` alias to
+  your global git config.
 - `pydifft qmdinit [directory]` scaffolds a new Quarto-style project using
   the bundled templates and example ``project1`` hierarchy, then downloads
   MathJax into ``_template/mathjax`` so the builder can run immediately.
@@ -122,12 +156,20 @@ included are (listed in order of fun/utility):
   wrapping, ideal for when you are
   working on manuscripts that you
   are version tracking with git.
+  Headers, fenced code blocks, and Pandoc tables retain their formatting.
+  Display-math delimiters get their own lines while equation contents retain
+  their wrapping; inline-math boundaries are preferred places to wrap prose.
 - `pydifft wmatch` ("whitespace match"): a script that matches whitespace between two text files.
 
     * pandoc can convert between markdown/latex/word, but doing this messes with your whitespace and gvimdiff comparisons.
 
     * this allows you to use an original file with good whitespace formatting as a "template" that you can match other (e.g. pandoc converted file) onto another
 
+    * changed prose lines exceeding 1.5 times the nearby reference width are
+      wrapped using the same sentence and punctuation rules as ``wr``.
+      Existing surrounding line breaks are retained; the fallback width is
+      80 columns when the reference provides too little prose.
+
 - `pydifft wd` ("word diff"): generate "track changes" word files starting from pandoc markdown in a git history.  Assuming that you have copied diff-doc.js (copied + licensed from elsewhere) into your home directory, this will use pandoc to convert the markdown files to MS Word, then use the MS Word comparison tool to generate a document where all relevant changes are shown with "track changes."
 
     * by default, this uses the file `template.docx` in the current directory as a pandoc word template

{pydifftools-0.1.29 → pydifftools-0.1.31}/README.rst

@@ -46,6 +46,15 @@ included are (listed in order of fun/utility):
   refreshed as you edit the file.  This wraps the former
   ``flowchart/watch_graph.py`` script so all of its functionality is now
   available through the main ``pydifft`` entry point.
+  Add ``--diff-base HEAD`` (or a branch, tag, commit, or quoted reflog
+  reference) to compare against that Git snapshot throughout the preview
+  session. Additions are green, deletions are red and struck through, and
+  unchanged content is muted. Renames share one box; date, status, and
+  dependency changes are annotated. Navigation, filters, and reloads retain
+  the baseline, whose reference and commit appear below the graph.
+  Comparison uses the same repository-relative YAML path; a file absent
+  from the revision is treated as an empty plan. Historical file renames
+  are not followed, and comparison markup is never written to YAML.
 - `pydifft tex2qmd file.tex` converts LaTeX sources to Quarto markdown.
   The converter preserves custom observation blocks and errata tags while
   translating verbatim/python environments into fenced code blocks so the
@@ -56,10 +65,32 @@ included are (listed in order of fun/utility):
   ``_build``/``_display`` directories; with ``--watch`` it starts the HTTP
   server and automatically rebuilds the staged fragments whenever you edit
   a ``.qmd`` file.
-- `pydifft gd [git diff args...]` shows the same Qt review table as the old
+- ``pydifft tree`` (or ``git tree`` with the alias installed) opens the last
+  40 commits across all branches, in Git date order. Use the down arrow
+  below the history to add the next 40 commits. Colors follow
+  first-parent ancestry; merged branches join the receiving branch.
+  Tags and branch tips have vector icon badges; hashes appear on hover.
+  Click any part of a commit row
+  to compare with the working directory, or right-click to copy its hash
+  or set a commit as the comparison endpoint. The right-click menu can restore
+  the working-directory endpoint. Diff window titles show the equivalent
+  arguments, preferring tags, then branch names, then six-character hashes.
+  Run ``pydifft tree --install`` to add the matching ``git tree`` alias.
+- ``pydifft gd`` (or ``git gd`` with the alias installed) reviews unstaged
+  changes, like bare ``git diff``.
+  ``pydifft gd [git diff args...]`` shows the same Qt review table as the old
   ``git_gd_qt.py`` helper before launching ``git difftool`` for a selected
-  file.  Run ``pydifft gd --install`` to add the matching ``git gd`` alias
-  to your global git config.
+  file.
+  Image rows are scored in the background and displayed as normalized
+  ``rgb X.X a X.X`` RMS changes; RGB change orders the image rows as scores
+  arrive.
+  Raster images open in a Qt viewer that aligns the old and new image,
+  displays their RGB difference, and uses up/down controls to switch
+  among the original, difference, and aligned new image. Images with an
+  alpha channel are displayed over a checkerboard; when transparency
+  changes, an additional red/blue alpha-difference view is included.
+  Run ``pydifft gd --install`` to add the matching ``git gd`` alias to
+  your global git config.
 - `pydifft qmdinit [directory]` scaffolds a new Quarto-style project using
   the bundled templates and example ``project1`` hierarchy, then downloads
   MathJax into ``_template/mathjax`` so the builder can run immediately.
@@ -70,12 +101,20 @@ included are (listed in order of fun/utility):
   wrapping, ideal for when you are
   working on manuscripts that you
   are version tracking with git.
+  Headers, fenced code blocks, and Pandoc tables retain their formatting.
+  Display-math delimiters get their own lines while equation contents retain
+  their wrapping; inline-math boundaries are preferred places to wrap prose.
 - `pydifft wmatch` ("whitespace match"): a script that matches whitespace between two text files.
 
     * pandoc can convert between markdown/latex/word, but doing this messes with your whitespace and gvimdiff comparisons.
 
     * this allows you to use an original file with good whitespace formatting as a "template" that you can match other (e.g. pandoc converted file) onto another
 
+    * changed prose lines exceeding 1.5 times the nearby reference width are
+      wrapped using the same sentence and punctuation rules as ``wr``.
+      Existing surrounding line breaks are retained; the fallback width is
+      80 columns when the reference provides too little prose.
+
 - `pydifft wd` ("word diff"): generate "track changes" word files starting from pandoc markdown in a git history.  Assuming that you have copied diff-doc.js (copied + licensed from elsewhere) into your home directory, this will use pandoc to convert the markdown files to MS Word, then use the MS Word comparison tool to generate a document where all relevant changes are shown with "track changes."
 
     * by default, this uses the file `template.docx` in the current directory as a pandoc word template

{pydifftools-0.1.29 → pydifftools-0.1.31/pyDiffTools.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyDiffTools
-Version: 0.1.29
+Version: 0.1.31
 Summary: Diff tools
 Author: J M Franck
 License: Copyright (c) 2015, jmfranck
@@ -34,6 +34,8 @@ License: Copyright (c) 2015, jmfranck
         
 Description-Content-Type: text/x-rst
 License-File: LICENSE.md
+Requires-Dist: numpy
+Requires-Dist: Pillow
 Requires-Dist: selenium
 Requires-Dist: fuzzywuzzy[speedup]
 Requires-Dist: PyYAML>=6.0
@@ -48,6 +50,7 @@ Requires-Dist: nbconvert
 Requires-Dist: pygments
 Requires-Dist: ansi2html
 Requires-Dist: lxml
+Requires-Dist: PySide6
 Dynamic: license-file
 
 pydifftools
@@ -98,6 +101,15 @@ included are (listed in order of fun/utility):
   refreshed as you edit the file.  This wraps the former
   ``flowchart/watch_graph.py`` script so all of its functionality is now
   available through the main ``pydifft`` entry point.
+  Add ``--diff-base HEAD`` (or a branch, tag, commit, or quoted reflog
+  reference) to compare against that Git snapshot throughout the preview
+  session. Additions are green, deletions are red and struck through, and
+  unchanged content is muted. Renames share one box; date, status, and
+  dependency changes are annotated. Navigation, filters, and reloads retain
+  the baseline, whose reference and commit appear below the graph.
+  Comparison uses the same repository-relative YAML path; a file absent
+  from the revision is treated as an empty plan. Historical file renames
+  are not followed, and comparison markup is never written to YAML.
 - `pydifft tex2qmd file.tex` converts LaTeX sources to Quarto markdown.
   The converter preserves custom observation blocks and errata tags while
   translating verbatim/python environments into fenced code blocks so the
@@ -108,10 +120,32 @@ included are (listed in order of fun/utility):
   ``_build``/``_display`` directories; with ``--watch`` it starts the HTTP
   server and automatically rebuilds the staged fragments whenever you edit
   a ``.qmd`` file.
-- `pydifft gd [git diff args...]` shows the same Qt review table as the old
+- ``pydifft tree`` (or ``git tree`` with the alias installed) opens the last
+  40 commits across all branches, in Git date order. Use the down arrow
+  below the history to add the next 40 commits. Colors follow
+  first-parent ancestry; merged branches join the receiving branch.
+  Tags and branch tips have vector icon badges; hashes appear on hover.
+  Click any part of a commit row
+  to compare with the working directory, or right-click to copy its hash
+  or set a commit as the comparison endpoint. The right-click menu can restore
+  the working-directory endpoint. Diff window titles show the equivalent
+  arguments, preferring tags, then branch names, then six-character hashes.
+  Run ``pydifft tree --install`` to add the matching ``git tree`` alias.
+- ``pydifft gd`` (or ``git gd`` with the alias installed) reviews unstaged
+  changes, like bare ``git diff``.
+  ``pydifft gd [git diff args...]`` shows the same Qt review table as the old
   ``git_gd_qt.py`` helper before launching ``git difftool`` for a selected
-  file.  Run ``pydifft gd --install`` to add the matching ``git gd`` alias
-  to your global git config.
+  file.
+  Image rows are scored in the background and displayed as normalized
+  ``rgb X.X a X.X`` RMS changes; RGB change orders the image rows as scores
+  arrive.
+  Raster images open in a Qt viewer that aligns the old and new image,
+  displays their RGB difference, and uses up/down controls to switch
+  among the original, difference, and aligned new image. Images with an
+  alpha channel are displayed over a checkerboard; when transparency
+  changes, an additional red/blue alpha-difference view is included.
+  Run ``pydifft gd --install`` to add the matching ``git gd`` alias to
+  your global git config.
 - `pydifft qmdinit [directory]` scaffolds a new Quarto-style project using
   the bundled templates and example ``project1`` hierarchy, then downloads
   MathJax into ``_template/mathjax`` so the builder can run immediately.
@@ -122,12 +156,20 @@ included are (listed in order of fun/utility):
   wrapping, ideal for when you are
   working on manuscripts that you
   are version tracking with git.
+  Headers, fenced code blocks, and Pandoc tables retain their formatting.
+  Display-math delimiters get their own lines while equation contents retain
+  their wrapping; inline-math boundaries are preferred places to wrap prose.
 - `pydifft wmatch` ("whitespace match"): a script that matches whitespace between two text files.
 
     * pandoc can convert between markdown/latex/word, but doing this messes with your whitespace and gvimdiff comparisons.
 
     * this allows you to use an original file with good whitespace formatting as a "template" that you can match other (e.g. pandoc converted file) onto another
 
+    * changed prose lines exceeding 1.5 times the nearby reference width are
+      wrapped using the same sentence and punctuation rules as ``wr``.
+      Existing surrounding line breaks are retained; the fallback width is
+      80 columns when the reference provides too little prose.
+
 - `pydifft wd` ("word diff"): generate "track changes" word files starting from pandoc markdown in a git history.  Assuming that you have copied diff-doc.js (copied + licensed from elsewhere) into your home directory, this will use pandoc to convert the markdown files to MS Word, then use the MS Word comparison tool to generate a document where all relevant changes are shown with "track changes."
 
     * by default, this uses the file `template.docx` in the current directory as a pandoc word template

{pydifftools-0.1.29 → pydifftools-0.1.31}/pyDiffTools.egg-info/SOURCES.txt

@@ -59,7 +59,10 @@ pydifftools/continuous.py
 pydifftools/copy_files.py
 pydifftools/diff-doc.js
 pydifftools/doc_contents.py
+pydifftools/forward_search.py
 pydifftools/git_gd.py
+pydifftools/git_gd_history.py
+pydifftools/git_gd_image.py
 pydifftools/git_gd_qt.py
 pydifftools/html_comments.py
 pydifftools/html_uncomments.py
@@ -77,6 +80,7 @@ pydifftools/update_check.py
 pydifftools/wrap_sentences.py
 pydifftools/xml2xlsx.vbs
 pydifftools/flowchart/__init__.py
+pydifftools/flowchart/comparison.py
 pydifftools/flowchart/dot_to_yaml.py
 pydifftools/flowchart/graph.py
 pydifftools/flowchart/watch_graph.py
@@ -85,8 +89,15 @@ pydifftools/notebook/display.py
 pydifftools/notebook/fast_build.py
 pydifftools/notebook/tex_to_qmd.py
 tests/test_browser_lifecycle.py
+tests/test_check_single_use.py
 tests/test_command_line_help.py
 tests/test_continuous_shutdown.py
+tests/test_forward_search.py
+tests/test_git_gd_history.py
+tests/test_git_gd_image.py
+tests/test_git_gd_qt.py
 tests/test_rrng.py
 tests/test_tex_to_qmd.py
-tests/test_update_check.py
+tests/test_update_check.py
+tests/test_wrap_check.py
+tests/test_wrapping.py

{pydifftools-0.1.29 → pydifftools-0.1.31}/pyDiffTools.egg-info/requires.txt

@@ -1,3 +1,5 @@
+numpy
+Pillow
 selenium
 fuzzywuzzy[speedup]
 PyYAML>=6.0
@@ -12,3 +14,4 @@ nbconvert
 pygments
 ansi2html
 lxml
+PySide6

{pydifftools-0.1.29 → pydifftools-0.1.31}/pydifftools/command_line.py

@@ -10,7 +10,6 @@ import re
 import nbformat
 import difflib
 import shutil
-import socket
 import importlib.util
 from pathlib import Path
 from . import (
@@ -20,7 +19,15 @@ from . import (
     update_check,
 )
 from .continuous import cpb, FORWARD_SEARCH_HOST, FORWARD_SEARCH_PORT
+from .forward_search import (
+    ForwardSearchProtocolError,
+    ForwardSearchUnavailable,
+    send_forward_search,
+)
 from .wrap_sentences import wr as wrap_sentences_wr  # registers wrap command
+from .wrap_sentences import (  # registers wrchk command
+    wrchk as wrap_sentences_wrchk,
+)
 from .separate_comments import tex_sepcomments
 from .unseparate_comments import tex_unsepcomments
 from .comment_functions import matchingbrackets
@@ -356,7 +363,10 @@ def gvr(arguments):
     subprocess.Popen(" ".join(cmd))
 
 
-@register_command("match whitespace")
+@register_command(
+    "match whitespace",
+    filename_extensions={"arguments": [".md", ".tex"]},
+)
 def wmatch(arguments):
     match_spaces.run(arguments)
 
@@ -530,7 +540,21 @@ def mfs(text):
     if marker_match:
         search_text = search_text[: marker_match.start()]
     search_text = re.sub(r"\[@[^\]]+\]", " ", search_text)
-    search_text = search_text.replace("**", " ").replace("*", " ")
+    # Strip paired markup delimiters (bold/italic, strikethrough,
+    # superscript/subscript). These delimiters hug the text they wrap with no
+    # space in the rendered output (e.g. "x^2^" renders as "x2"), so they are
+    # dropped rather than replaced with a space. Plain str.replace is used
+    # (not regex) so this is linear time regardless of how many delimiter
+    # characters appear.
+    search_text = (
+        search_text.replace("**", "")
+        .replace("__", "")
+        .replace("~~", "")
+        .replace("*", "")
+        .replace("_", "")
+        .replace("~", "")
+        .replace("^", "")
+    )
     search_text = re.sub(r"\s+", " ", search_text).strip()
     if not search_text:
         search_text = text.strip()
@@ -540,16 +564,27 @@ def mfs(text):
         (FORWARD_SEARCH_HOST, FORWARD_SEARCH_PORT),
         (QMDB_FORWARD_SEARCH_HOST, QMDB_FORWARD_SEARCH_PORT),
     ]
-    client = None
-    for address in socket_addresses:
-        candidate = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
-        try:
-            candidate.connect(address)
-            client = candidate
-            break
-        except OSError:
-            candidate.close()
-    if client is None:
+
+    def try_existing_listener():
+        protocol_errors = []
+        for address in socket_addresses:
+            try:
+                send_forward_search(address, search_text)
+            except ForwardSearchUnavailable:
+                continue
+            except ForwardSearchProtocolError as exc:
+                protocol_errors.append(str(exc))
+                continue
+            return True
+        if protocol_errors:
+            raise RuntimeError(
+                "A forward-search port accepted the connection but did not "
+                "acknowledge the pydifft protocol. Refusing to open another "
+                "browser window.\n" + "\n".join(protocol_errors)
+            )
+        return False
+
+    if not try_existing_listener():
         # If no listener is running yet, choose a markdown file in this
         # directory that contains the requested search text and start cpb for
         # it.
@@ -581,24 +616,14 @@ def mfs(text):
         # Wait up to 20 seconds so the child can bring up the listener,
         # then resend the forward-search text.
         for _ in range(80):
-            for address in socket_addresses:
-                candidate = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
-                try:
-                    candidate.connect(address)
-                    client = candidate
-                    break
-                except OSError:
-                    candidate.close()
-            if client is not None:
-                break
+            if try_existing_listener():
+                return
             time.sleep(0.25)
         else:
             raise RuntimeError(
-                "Started cpb automatically, but the forward search socket "
-                "did not come up within 20 seconds."
+                "Started cpb automatically, but no acknowledged forward "
+                "search endpoint came up within 20 seconds."
             )
-    client.sendall(search_text.encode("utf-8"))
-    client.close()
 
 
 @register_command("Convert xml to xlsx")