overleaf-comments-export 0.18.2__tar.gz → 0.18.4__tar.gz

{overleaf_comments_export-0.18.2 → overleaf_comments_export-0.18.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: overleaf-comments-export
-Version: 0.18.2
+Version: 0.18.4
 Summary: Export comment threads and tracked changes from an Overleaf project to Markdown + JSON, optimized for AI-agent consumption.
 Author-email: Shivang Gupta <47645533+Mangluu@users.noreply.github.com>
 License: MIT
@@ -102,31 +102,24 @@ unzip it, and open it. There is nothing else to install, and no Python needed.
 
 | Your computer | Download |
 |---|---|
-| Mac | `OverleafCommentsExport-macOS.zip` |
 | Windows | `OverleafCommentsExport-Windows.zip` |
 | Linux | `OverleafCommentsExport-Linux.zip`, then `chmod +x "Overleaf Comments Export"` |
 
-The first time you open it, macOS or Windows will warn you about an app it has
-not checked. That is because signing an app costs money every year, not because
-anything is wrong.
+On **Windows** the first time you open it you will be warned about an app that
+has not been checked. That is because signing an app costs money every year,
+not because anything is wrong. Click More info, then Run anyway.
 
-On **Windows**, click More info, then Run anyway.
+**There is no Mac download.** There was, and it did not work. macOS blocks apps
+it has not checked, signing one costs money every year, and the way people used
+to get past the warning, right-clicking and choosing Open, was removed in macOS
+15. Everybody who downloaded it hit a wall. Shipping something that does not
+open is worse than not shipping it.
 
-On **macOS 15 and newer** the old advice of right-clicking and choosing Open no
-longer works, and the warning gives you no way through. Do this instead. Double
-click the app, click Done on the warning, then open System Settings, go to
-Privacy & Security, scroll down to Security, and click **Open Anyway** next to
-the message about the app. Confirm, then open the app again.
+On a Mac, use either of these instead. Both work, and neither is gated.
 
-If you would rather use the Terminal, this does the same thing in one line, and
-you can drag the app into the window instead of typing its path:
-
-```bash
-xattr -dr com.apple.quarantine "/path/to/Overleaf Comments Export.app"
-```
-
-None of this applies to the Python install or the browser extension, which
-macOS does not gate.
+- The browser extension below, if you would rather not touch a terminal.
+- `pip install "overleaf-comments-export[gui,pdf]"`, then run
+  `overleaf-comments-export --gui` for the same window.
 
 **If you prefer a browser extension**, Chrome, Edge, and other Chromium
 browsers can run the exporter inside the Overleaf project you already have
@@ -267,6 +260,17 @@ change.
 
 Run `overleaf-comments-export --help` for the full list.
 
+A cookie passed as `--cookie` goes into your shell history, and on most systems
+it is visible to anyone who can run `ps` while the export is going. It is a live
+session, so prefer the environment variable, which the tool reads on its own:
+
+```bash
+OVERLEAF_SESSION="paste it here" overleaf-comments-export --project-url https://...
+```
+
+The window stores it only if you tick the box, in a file only your account can
+read.
+
 ## Stopping an export
 
 Press Stop in the window, or Ctrl-C on the command line. Nothing is written

{overleaf_comments_export-0.18.2 → overleaf_comments_export-0.18.4}/README.md

@@ -58,31 +58,24 @@ unzip it, and open it. There is nothing else to install, and no Python needed.
 
 | Your computer | Download |
 |---|---|
-| Mac | `OverleafCommentsExport-macOS.zip` |
 | Windows | `OverleafCommentsExport-Windows.zip` |
 | Linux | `OverleafCommentsExport-Linux.zip`, then `chmod +x "Overleaf Comments Export"` |
 
-The first time you open it, macOS or Windows will warn you about an app it has
-not checked. That is because signing an app costs money every year, not because
-anything is wrong.
+On **Windows** the first time you open it you will be warned about an app that
+has not been checked. That is because signing an app costs money every year,
+not because anything is wrong. Click More info, then Run anyway.
 
-On **Windows**, click More info, then Run anyway.
+**There is no Mac download.** There was, and it did not work. macOS blocks apps
+it has not checked, signing one costs money every year, and the way people used
+to get past the warning, right-clicking and choosing Open, was removed in macOS
+15. Everybody who downloaded it hit a wall. Shipping something that does not
+open is worse than not shipping it.
 
-On **macOS 15 and newer** the old advice of right-clicking and choosing Open no
-longer works, and the warning gives you no way through. Do this instead. Double
-click the app, click Done on the warning, then open System Settings, go to
-Privacy & Security, scroll down to Security, and click **Open Anyway** next to
-the message about the app. Confirm, then open the app again.
+On a Mac, use either of these instead. Both work, and neither is gated.
 
-If you would rather use the Terminal, this does the same thing in one line, and
-you can drag the app into the window instead of typing its path:
-
-```bash
-xattr -dr com.apple.quarantine "/path/to/Overleaf Comments Export.app"
-```
-
-None of this applies to the Python install or the browser extension, which
-macOS does not gate.
+- The browser extension below, if you would rather not touch a terminal.
+- `pip install "overleaf-comments-export[gui,pdf]"`, then run
+  `overleaf-comments-export --gui` for the same window.
 
 **If you prefer a browser extension**, Chrome, Edge, and other Chromium
 browsers can run the exporter inside the Overleaf project you already have
@@ -223,6 +216,17 @@ change.
 
 Run `overleaf-comments-export --help` for the full list.
 
+A cookie passed as `--cookie` goes into your shell history, and on most systems
+it is visible to anyone who can run `ps` while the export is going. It is a live
+session, so prefer the environment variable, which the tool reads on its own:
+
+```bash
+OVERLEAF_SESSION="paste it here" overleaf-comments-export --project-url https://...
+```
+
+The window stores it only if you tick the box, in a file only your account can
+read.
+
 ## Stopping an export
 
 Press Stop in the window, or Ctrl-C on the command line. Nothing is written

{overleaf_comments_export-0.18.2 → overleaf_comments_export-0.18.4}/overleaf_comments_export/annotate.py

@@ -80,6 +80,12 @@ def to_ascii(text: str) -> str:
     so nothing beyond ASCII may reach the file. Real reviewer comments contain
     all of these.
     """
+    # Most text is already ASCII, and everything below it is a no-op on such a
+    # string: 52 whole-string replaces of characters that cannot be there, a
+    # normalize, and two passes over every character. This is the hottest
+    # function in an export by some way, so the cheap check earns its line.
+    if text.isascii():
+        return text
     for bad, good in _UNICODE_FOLD.items():
         text = text.replace(bad, good)
     for bad, good in _GREEK.items():

{overleaf_comments_export-0.18.2 → overleaf_comments_export-0.18.4}/overleaf_comments_export/client.py

@@ -888,11 +888,6 @@ def _parse_cookie_string(pasted: str) -> dict[str, str]:
     return out or {"overleaf_session2": s}
 
 
-def looks_self_hosted(base_url: str) -> bool:
-    host = urlparse(base_url).hostname or ""
-    return not host.endswith("overleaf.com")
-
-
 def _decode_meta_content(raw: str) -> Any:
     """Best-effort decode of a <meta content="..."> value.
 

{overleaf_comments_export-0.18.2 → overleaf_comments_export-0.18.4}/overleaf_comments_export/gui.py

@@ -450,13 +450,6 @@ class App:
         body.pack(fill="both", expand=True)
         return body
 
-    def _hint_in(self, parent, text: str):
-        """A quiet line of explanation under whatever it belongs to."""
-        label = ttk.Label(parent, text=text, style="Hint.TLabel",
-                          font=self.font_small, wraplength=380, justify="left")
-        label.pack(anchor="w", pady=(3, 0))
-        return label
-
     def _hint(self, parent, text, row, col=1, span=2):
         lbl = ttk.Label(parent, text=text, style="Hint.TLabel", font=self.font_small,
                         wraplength=380, justify="left")

{overleaf_comments_export-0.18.2 → overleaf_comments_export-0.18.4}/overleaf_comments_export.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: overleaf-comments-export
-Version: 0.18.2
+Version: 0.18.4
 Summary: Export comment threads and tracked changes from an Overleaf project to Markdown + JSON, optimized for AI-agent consumption.
 Author-email: Shivang Gupta <47645533+Mangluu@users.noreply.github.com>
 License: MIT
@@ -102,31 +102,24 @@ unzip it, and open it. There is nothing else to install, and no Python needed.
 
 | Your computer | Download |
 |---|---|
-| Mac | `OverleafCommentsExport-macOS.zip` |
 | Windows | `OverleafCommentsExport-Windows.zip` |
 | Linux | `OverleafCommentsExport-Linux.zip`, then `chmod +x "Overleaf Comments Export"` |
 
-The first time you open it, macOS or Windows will warn you about an app it has
-not checked. That is because signing an app costs money every year, not because
-anything is wrong.
+On **Windows** the first time you open it you will be warned about an app that
+has not been checked. That is because signing an app costs money every year,
+not because anything is wrong. Click More info, then Run anyway.
 
-On **Windows**, click More info, then Run anyway.
+**There is no Mac download.** There was, and it did not work. macOS blocks apps
+it has not checked, signing one costs money every year, and the way people used
+to get past the warning, right-clicking and choosing Open, was removed in macOS
+15. Everybody who downloaded it hit a wall. Shipping something that does not
+open is worse than not shipping it.
 
-On **macOS 15 and newer** the old advice of right-clicking and choosing Open no
-longer works, and the warning gives you no way through. Do this instead. Double
-click the app, click Done on the warning, then open System Settings, go to
-Privacy & Security, scroll down to Security, and click **Open Anyway** next to
-the message about the app. Confirm, then open the app again.
+On a Mac, use either of these instead. Both work, and neither is gated.
 
-If you would rather use the Terminal, this does the same thing in one line, and
-you can drag the app into the window instead of typing its path:
-
-```bash
-xattr -dr com.apple.quarantine "/path/to/Overleaf Comments Export.app"
-```
-
-None of this applies to the Python install or the browser extension, which
-macOS does not gate.
+- The browser extension below, if you would rather not touch a terminal.
+- `pip install "overleaf-comments-export[gui,pdf]"`, then run
+  `overleaf-comments-export --gui` for the same window.
 
 **If you prefer a browser extension**, Chrome, Edge, and other Chromium
 browsers can run the exporter inside the Overleaf project you already have
@@ -267,6 +260,17 @@ change.
 
 Run `overleaf-comments-export --help` for the full list.
 
+A cookie passed as `--cookie` goes into your shell history, and on most systems
+it is visible to anyone who can run `ps` while the export is going. It is a live
+session, so prefer the environment variable, which the tool reads on its own:
+
+```bash
+OVERLEAF_SESSION="paste it here" overleaf-comments-export --project-url https://...
+```
+
+The window stores it only if you tick the box, in a file only your account can
+read.
+
 ## Stopping an export
 
 Press Stop in the window, or Ctrl-C on the command line. Nothing is written

{overleaf_comments_export-0.18.2 → overleaf_comments_export-0.18.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "overleaf-comments-export"
-version = "0.18.2"
+version = "0.18.4"
 description = "Export comment threads and tracked changes from an Overleaf project to Markdown + JSON, optimized for AI-agent consumption."
 readme = "README.md"
 license = { text = "MIT" }

{overleaf_comments_export-0.18.2 → overleaf_comments_export-0.18.4}/tests/test_annotate.py

@@ -235,3 +235,19 @@ def test_a_whole_annotated_document_is_ascii():
     threads = _t(content="η² was .21？ café \U0001f60a")
     out, _ = annotate_document("The result here", [_c("C001", 0, "The result")], threads)
     assert out.isascii()
+
+
+def test_ascii_text_takes_the_fast_path_and_is_unchanged():
+    """to_ascii is the hottest function in an export. The early return has to
+    give byte-identical output, or it trades correctness for speed."""
+    from overleaf_comments_export.annotate import to_ascii
+    plain = "Break this up. 50% of \\alpha & <b> ~ #1 {x} ^2 _y"
+    assert plain.isascii()
+    assert to_ascii(plain) == plain
+
+
+def test_non_ascii_still_folds():
+    from overleaf_comments_export.annotate import to_ascii
+    out = to_ascii("Prüfen Sie ρ und σ — 请检查")
+    assert out.isascii(), out
+    assert "Prufen" in out and "rho" in out and "sigma" in out