chat-export 0.9.2__tar.gz → 0.9.3__tar.gz

{chat_export-0.9.2/chat_export.egg-info → chat_export-0.9.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chat-export
-Version: 0.9.2
+Version: 0.9.3
 Summary: Convert WhatsApp chat exports to HTML format
 Author-email: matlon GmbH <software@matlon.ch>
 License: MIT License
@@ -60,7 +60,7 @@ Dynamic: license-file
 This tool converts a WhatsApp chat export into two HTML formats: one with inline media (such as images, videos, and audio files) and a compact version with media links.
 
 
-Video Tutorial (still refers to the previously used tool name instead of `chat-export`):  
+Video Tutorial (still refers to the previously used tool name instead of `chat-export`, doesn't cover new features like the non-interactive CLI mode yet):  
 [![YouTube](https://img.youtube.com/vi/s1dMO8pjkC8/0.jpg)](https://www.youtube.com/watch?v=s1dMO8pjkC8)"
 
 ## Binary Release Downloads
@@ -101,7 +101,28 @@ You can for example save it on Google Drive or Dropbox or send it to yourself wi
 
 3. **Install and Run the Tool:** 
 
-   **Option 1: Install via pip (Recommended)**
+### Option 1: Download Binary Executables: Easy for non-technical users
+
+   If you don't know what Python is and just want to use the tool without having to deal with technical details, you can download the binary executables.
+   
+   - For Windows, download [chat-export.exe](https://github.com/mtln/chat-export/releases/latest/download/chat-export.exe).
+
+   Because the .exe is unsigned, you will see a warning, but after clicking on "More Information" you should have the option to run it anyway. An EV code signing certificate for Windows costs a lot. If I get enough donations, I will buy one, so I can release signed exe files.
+
+   - For Mac, download [chat-export-installer.pkg](https://github.com/mtln/chat-export/releases/latest/download/chat-export-installer.pkg)
+
+   Once installed on Mac:
+
+   1. Open the **Terminal** app (e.g. by typing "terminal" in Spotlight Search).
+   2. Type: `chat-export`
+    
+   This will start the chat export tool from anywhere in the terminal.
+
+   To uninstall `chat-export` from Mac, open the Terminal and run: `sudo rm /usr/local/bin/chat-export`
+
+   The executables have been built with pyinstaller.
+
+### Option 2: Install via pip
    
    If you have Python installed, you can install chat-export as a command-line tool:
    ```
@@ -122,43 +143,57 @@ You can for example save it on Google Drive or Dropbox or send it to yourself wi
    pip install chat-export[windows]
    ```
    
-   
-   
+      
    *Note: Without these optional dependencies, the tool will fall back to command-line input for file selection or use tkinter (if available) for file dialogs. If you're planning to use the tool in non-interactive mode, you don't need to install these dependencies.*
    
    After installation, you can run it from anywhere in your terminal:
-   
+
    ```
    chat-export
+   ```
+
+   or
+   ```
    chat-export --help
    ```
-   
+
    To uninstall:
    ```
    pip uninstall chat-export
    ```
 
-   **Option 2: Download Binary Executables**
-   
-   - For Windows, download [chat-export.exe](https://github.com/mtln/chat-export/releases/latest/download/chat-export.exe).
-
-   Because the .exe is unsigned, you will see a warning, but after clicking on "More Information" you should have the option to run it anyway. An EV code signing certificate for Windows costs a lot. If I get enough donations, I will buy one, so I can release signed exe files.
+#### Using uv tool instead of pip
+If you have uv installed, you can use `uv tool install` instead of `pip install`. This is perfect for tools like chat-export because it will install the dependencies in a virtual environment and not in the global environment - while still making the tool available globally in your shell / path. 
 
-   - For Mac, download [chat-export-installer.pkg](https://github.com/mtln/chat-export/releases/latest/download/chat-export-installer.pkg)
+```
+uv tool install chat-export[windows]
+or
+uv tool install chat-export[macos]
+or just 
+uv tool install chat-export
+
+uninstall with:
+uv tool uninstall chat-export
+```
 
-   Once installed on Mac:
-   1. Open the **Terminal** app (e.g. by typing "terminal" in Spotlight Search).
-   2. Type: `chat-export`
-    
-   This will start the chat export tool from anywhere in the terminal.
+   ```
 
-   To uninstall `chat-export` from Mac, open the Terminal and run: `sudo rm /usr/local/bin/chat-export`
+#### Using uv tool instead of pip
+   If you have uv installed, you can use `uv tool install` instead of `pip install`. This is perfect for tools like chat-export because it will install the dependencies in a virtual environment and not in the global environment - while still making the tool available globally in your shell / path. 
 
-   The executables have been built with pyinstaller.
+   
+   `uv tool install chat-export[windows]` 
+   or 
+   `uv tool install chat-export[macos]` 
+   or just 
+   `uv tool install chat-export` 
+   uninstall with: 
+   `uv tool uninstall chat-export`
+   
 
-   **Option 3: Run Directly (No Installation)**
+###Option 3: Run Directly (No Installation)
    
-   If Python is installed on your Windows, Mac or Linux computer, run the tool directly (no installation required) with the following command:
+   If Python is installed on your Windows, Mac or Linux computer, run the tool directly (no pip installation required, no venv required, no additional dependencies required because it's just vanilla standard lib Python in a single scriptfile, always run the latest up to date version directly from GitHub) with the following command:
      ```
      python -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/mtln/chat-export/refs/heads/main/main.py').read().decode())"
      ```
@@ -167,11 +202,14 @@ You can for example save it on Google Drive or Dropbox or send it to yourself wi
      python3 -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/mtln/chat-export/refs/heads/main/main.py').read().decode())"
      ```
 
-**Usage**
+## Usage
 
 The tool supports both interactive and non-interactive modes:
 
 ### Interactive Mode (Default)
+
+Just run `chat-export` in your terminal.
+
 **CLI Parameters:**
 
 `-o, --output-dir`: Base directory where the chat folder will be created (optional, default: current directory)

{chat_export-0.9.2 → chat_export-0.9.3}/README.md

@@ -3,7 +3,7 @@
 This tool converts a WhatsApp chat export into two HTML formats: one with inline media (such as images, videos, and audio files) and a compact version with media links.
 
 
-Video Tutorial (still refers to the previously used tool name instead of `chat-export`):  
+Video Tutorial (still refers to the previously used tool name instead of `chat-export`, doesn't cover new features like the non-interactive CLI mode yet):  
 [![YouTube](https://img.youtube.com/vi/s1dMO8pjkC8/0.jpg)](https://www.youtube.com/watch?v=s1dMO8pjkC8)"
 
 ## Binary Release Downloads
@@ -44,7 +44,28 @@ You can for example save it on Google Drive or Dropbox or send it to yourself wi
 
 3. **Install and Run the Tool:** 
 
-   **Option 1: Install via pip (Recommended)**
+### Option 1: Download Binary Executables: Easy for non-technical users
+
+   If you don't know what Python is and just want to use the tool without having to deal with technical details, you can download the binary executables.
+   
+   - For Windows, download [chat-export.exe](https://github.com/mtln/chat-export/releases/latest/download/chat-export.exe).
+
+   Because the .exe is unsigned, you will see a warning, but after clicking on "More Information" you should have the option to run it anyway. An EV code signing certificate for Windows costs a lot. If I get enough donations, I will buy one, so I can release signed exe files.
+
+   - For Mac, download [chat-export-installer.pkg](https://github.com/mtln/chat-export/releases/latest/download/chat-export-installer.pkg)
+
+   Once installed on Mac:
+
+   1. Open the **Terminal** app (e.g. by typing "terminal" in Spotlight Search).
+   2. Type: `chat-export`
+    
+   This will start the chat export tool from anywhere in the terminal.
+
+   To uninstall `chat-export` from Mac, open the Terminal and run: `sudo rm /usr/local/bin/chat-export`
+
+   The executables have been built with pyinstaller.
+
+### Option 2: Install via pip
    
    If you have Python installed, you can install chat-export as a command-line tool:
    ```
@@ -65,43 +86,57 @@ You can for example save it on Google Drive or Dropbox or send it to yourself wi
    pip install chat-export[windows]
    ```
    
-   
-   
+      
    *Note: Without these optional dependencies, the tool will fall back to command-line input for file selection or use tkinter (if available) for file dialogs. If you're planning to use the tool in non-interactive mode, you don't need to install these dependencies.*
    
    After installation, you can run it from anywhere in your terminal:
-   
+
    ```
    chat-export
+   ```
+
+   or
+   ```
    chat-export --help
    ```
-   
+
    To uninstall:
    ```
    pip uninstall chat-export
    ```
 
-   **Option 2: Download Binary Executables**
-   
-   - For Windows, download [chat-export.exe](https://github.com/mtln/chat-export/releases/latest/download/chat-export.exe).
-
-   Because the .exe is unsigned, you will see a warning, but after clicking on "More Information" you should have the option to run it anyway. An EV code signing certificate for Windows costs a lot. If I get enough donations, I will buy one, so I can release signed exe files.
+#### Using uv tool instead of pip
+If you have uv installed, you can use `uv tool install` instead of `pip install`. This is perfect for tools like chat-export because it will install the dependencies in a virtual environment and not in the global environment - while still making the tool available globally in your shell / path. 
 
-   - For Mac, download [chat-export-installer.pkg](https://github.com/mtln/chat-export/releases/latest/download/chat-export-installer.pkg)
+```
+uv tool install chat-export[windows]
+or
+uv tool install chat-export[macos]
+or just 
+uv tool install chat-export
+
+uninstall with:
+uv tool uninstall chat-export
+```
 
-   Once installed on Mac:
-   1. Open the **Terminal** app (e.g. by typing "terminal" in Spotlight Search).
-   2. Type: `chat-export`
-    
-   This will start the chat export tool from anywhere in the terminal.
+   ```
 
-   To uninstall `chat-export` from Mac, open the Terminal and run: `sudo rm /usr/local/bin/chat-export`
+#### Using uv tool instead of pip
+   If you have uv installed, you can use `uv tool install` instead of `pip install`. This is perfect for tools like chat-export because it will install the dependencies in a virtual environment and not in the global environment - while still making the tool available globally in your shell / path. 
 
-   The executables have been built with pyinstaller.
+   
+   `uv tool install chat-export[windows]` 
+   or 
+   `uv tool install chat-export[macos]` 
+   or just 
+   `uv tool install chat-export` 
+   uninstall with: 
+   `uv tool uninstall chat-export`
+   
 
-   **Option 3: Run Directly (No Installation)**
+###Option 3: Run Directly (No Installation)
    
-   If Python is installed on your Windows, Mac or Linux computer, run the tool directly (no installation required) with the following command:
+   If Python is installed on your Windows, Mac or Linux computer, run the tool directly (no pip installation required, no venv required, no additional dependencies required because it's just vanilla standard lib Python in a single scriptfile, always run the latest up to date version directly from GitHub) with the following command:
      ```
      python -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/mtln/chat-export/refs/heads/main/main.py').read().decode())"
      ```
@@ -110,11 +145,14 @@ You can for example save it on Google Drive or Dropbox or send it to yourself wi
      python3 -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/mtln/chat-export/refs/heads/main/main.py').read().decode())"
      ```
 
-**Usage**
+## Usage
 
 The tool supports both interactive and non-interactive modes:
 
 ### Interactive Mode (Default)
+
+Just run `chat-export` in your terminal.
+
 **CLI Parameters:**
 
 `-o, --output-dir`: Base directory where the chat folder will be created (optional, default: current directory)

{chat_export-0.9.2 → chat_export-0.9.3/chat_export.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chat-export
-Version: 0.9.2
+Version: 0.9.3
 Summary: Convert WhatsApp chat exports to HTML format
 Author-email: matlon GmbH <software@matlon.ch>
 License: MIT License
@@ -60,7 +60,7 @@ Dynamic: license-file
 This tool converts a WhatsApp chat export into two HTML formats: one with inline media (such as images, videos, and audio files) and a compact version with media links.
 
 
-Video Tutorial (still refers to the previously used tool name instead of `chat-export`):  
+Video Tutorial (still refers to the previously used tool name instead of `chat-export`, doesn't cover new features like the non-interactive CLI mode yet):  
 [![YouTube](https://img.youtube.com/vi/s1dMO8pjkC8/0.jpg)](https://www.youtube.com/watch?v=s1dMO8pjkC8)"
 
 ## Binary Release Downloads
@@ -101,7 +101,28 @@ You can for example save it on Google Drive or Dropbox or send it to yourself wi
 
 3. **Install and Run the Tool:** 
 
-   **Option 1: Install via pip (Recommended)**
+### Option 1: Download Binary Executables: Easy for non-technical users
+
+   If you don't know what Python is and just want to use the tool without having to deal with technical details, you can download the binary executables.
+   
+   - For Windows, download [chat-export.exe](https://github.com/mtln/chat-export/releases/latest/download/chat-export.exe).
+
+   Because the .exe is unsigned, you will see a warning, but after clicking on "More Information" you should have the option to run it anyway. An EV code signing certificate for Windows costs a lot. If I get enough donations, I will buy one, so I can release signed exe files.
+
+   - For Mac, download [chat-export-installer.pkg](https://github.com/mtln/chat-export/releases/latest/download/chat-export-installer.pkg)
+
+   Once installed on Mac:
+
+   1. Open the **Terminal** app (e.g. by typing "terminal" in Spotlight Search).
+   2. Type: `chat-export`
+    
+   This will start the chat export tool from anywhere in the terminal.
+
+   To uninstall `chat-export` from Mac, open the Terminal and run: `sudo rm /usr/local/bin/chat-export`
+
+   The executables have been built with pyinstaller.
+
+### Option 2: Install via pip
    
    If you have Python installed, you can install chat-export as a command-line tool:
    ```
@@ -122,43 +143,57 @@ You can for example save it on Google Drive or Dropbox or send it to yourself wi
    pip install chat-export[windows]
    ```
    
-   
-   
+      
    *Note: Without these optional dependencies, the tool will fall back to command-line input for file selection or use tkinter (if available) for file dialogs. If you're planning to use the tool in non-interactive mode, you don't need to install these dependencies.*
    
    After installation, you can run it from anywhere in your terminal:
-   
+
    ```
    chat-export
+   ```
+
+   or
+   ```
    chat-export --help
    ```
-   
+
    To uninstall:
    ```
    pip uninstall chat-export
    ```
 
-   **Option 2: Download Binary Executables**
-   
-   - For Windows, download [chat-export.exe](https://github.com/mtln/chat-export/releases/latest/download/chat-export.exe).
-
-   Because the .exe is unsigned, you will see a warning, but after clicking on "More Information" you should have the option to run it anyway. An EV code signing certificate for Windows costs a lot. If I get enough donations, I will buy one, so I can release signed exe files.
+#### Using uv tool instead of pip
+If you have uv installed, you can use `uv tool install` instead of `pip install`. This is perfect for tools like chat-export because it will install the dependencies in a virtual environment and not in the global environment - while still making the tool available globally in your shell / path. 
 
-   - For Mac, download [chat-export-installer.pkg](https://github.com/mtln/chat-export/releases/latest/download/chat-export-installer.pkg)
+```
+uv tool install chat-export[windows]
+or
+uv tool install chat-export[macos]
+or just 
+uv tool install chat-export
+
+uninstall with:
+uv tool uninstall chat-export
+```
 
-   Once installed on Mac:
-   1. Open the **Terminal** app (e.g. by typing "terminal" in Spotlight Search).
-   2. Type: `chat-export`
-    
-   This will start the chat export tool from anywhere in the terminal.
+   ```
 
-   To uninstall `chat-export` from Mac, open the Terminal and run: `sudo rm /usr/local/bin/chat-export`
+#### Using uv tool instead of pip
+   If you have uv installed, you can use `uv tool install` instead of `pip install`. This is perfect for tools like chat-export because it will install the dependencies in a virtual environment and not in the global environment - while still making the tool available globally in your shell / path. 
 
-   The executables have been built with pyinstaller.
+   
+   `uv tool install chat-export[windows]` 
+   or 
+   `uv tool install chat-export[macos]` 
+   or just 
+   `uv tool install chat-export` 
+   uninstall with: 
+   `uv tool uninstall chat-export`
+   
 
-   **Option 3: Run Directly (No Installation)**
+###Option 3: Run Directly (No Installation)
    
-   If Python is installed on your Windows, Mac or Linux computer, run the tool directly (no installation required) with the following command:
+   If Python is installed on your Windows, Mac or Linux computer, run the tool directly (no pip installation required, no venv required, no additional dependencies required because it's just vanilla standard lib Python in a single scriptfile, always run the latest up to date version directly from GitHub) with the following command:
      ```
      python -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/mtln/chat-export/refs/heads/main/main.py').read().decode())"
      ```
@@ -167,11 +202,14 @@ You can for example save it on Google Drive or Dropbox or send it to yourself wi
      python3 -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/mtln/chat-export/refs/heads/main/main.py').read().decode())"
      ```
 
-**Usage**
+## Usage
 
 The tool supports both interactive and non-interactive modes:
 
 ### Interactive Mode (Default)
+
+Just run `chat-export` in your terminal.
+
 **CLI Parameters:**
 
 `-o, --output-dir`: Base directory where the chat folder will be created (optional, default: current directory)

{chat_export-0.9.2 → chat_export-0.9.3}/main.py

@@ -286,7 +286,7 @@ def windows_file_picker():
 
 
 
-version = "0.9.2"
+version = "0.9.3"
 
 donate_link = "https://donate.stripe.com/3csfZLaIj5JE6dO4gg"
 
@@ -455,6 +455,44 @@ class MessageParser:
         except (ValueError, AttributeError):
             return None
 
+    @staticmethod
+    def trim_zero_widths(text: str) -> str:
+        """Trim harmless zero-width characters from the start and end of a string.
+
+        Safe to strip: ZWSP, ZWNJ, ZWJ, BOM.
+        Does NOT strip directional controls like LRM, RLM, FSI, PDI, etc.
+        """
+
+        SAFE_ZERO_WIDTHS = "\u200B\u200C\u200D\uFEFF"  # ZWSP, ZWNJ, ZWJ, BOM
+        return text.strip(SAFE_ZERO_WIDTHS).strip()
+
+
+    @staticmethod
+    def mark_invisible_chars(text: str) -> str:
+        """Replace zero-width and directional Unicode control chars with ASCII markers."""
+
+        replacements = {
+            "\u200B": ":ZWSP:",   # Zero Width Space
+            "\u200C": ":ZWNJ:",   # Zero Width Non-Joiner
+            "\u200D": ":ZWJ:",    # Zero Width Joiner
+            "\uFEFF": ":BOM:",    # Zero Width No-Break Space / BOM
+
+            "\u200E": ":LRM:",    # Left-to-Right Mark
+            "\u200F": ":RLM:",    # Right-to-Left Mark
+            "\u2066": ":LRI:",    # Left-to-Right Isolate
+            "\u2067": ":RLI:",    # Right-to-Left Isolate
+            "\u2068": ":FSI:",    # First Strong Isolate
+            "\u2069": ":PDI:",    # Pop Directional Isolate
+
+            "\u202A": ":LRE:",    # Left-to-Right Embedding
+            "\u202B": ":RLE:",    # Right-to-Left Embedding
+            "\u202C": ":PDF:",    # Pop Directional Formatting
+            "\u202D": ":LRO:",    # Left-to-Right Override
+            "\u202E": ":RLO:",    # Right-to-Left Override
+        }
+
+        return "".join(replacements.get(ch, ch) for ch in text)
+
     def get_senders(self, chat_content):
         """Extract all unique senders from chat content."""
         senders = set()
@@ -463,6 +501,8 @@ class MessageParser:
             match = pattern.match(line)
             if match:
                 sender = match.group(2)
+                sender = self.trim_zero_widths(sender)
+                sender = self.mark_invisible_chars(sender)
                 senders.add(sender)
         return sorted(list(senders))
 
@@ -585,6 +625,8 @@ class MessageParser:
 
             if match:
                 timestamp, sender, content = match.groups()
+                sender = self.trim_zero_widths(sender)
+                sender = self.mark_invisible_chars(sender)
                 messages.append(Message.create_with_context(
                     timestamp=timestamp,
                     sender=sender,

{chat_export-0.9.2 → chat_export-0.9.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "chat-export"
-version = "0.9.2"
+version = "0.9.3"
 description = "Convert WhatsApp chat exports to HTML format"
 readme = "README.md"
 license = {file = "LICENSE"}