streamdown 0.14.0__tar.gz → 0.16.0__tar.gz

{streamdown-0.14.0 → streamdown-0.16.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: streamdown
-Version: 0.14.0
+Version: 0.16.0
 Summary: A streaming markdown renderer for modern terminals with syntax highlighting
 Project-URL: Homepage, https://github.com/kristopolous/Streamdown
 Project-URL: Bug Tracker, https://github.com/kristopolous/Streamdown/issues
@@ -23,47 +23,49 @@ Requires-Python: >=3.8
 Requires-Dist: appdirs
 Requires-Dist: pygments
 Requires-Dist: pylatexenc
+Requires-Dist: term-image
 Requires-Dist: toml
 Description-Content-Type: text/markdown
 
-# Streamdown
+<p align="center">
+<img src=https://github.com/user-attachments/assets/0468eac0-2a00-4e98-82ca-09e6ac679357/>
+<br/>
+<a href=https://pypi.org/project/streamdown><img src=https://badge.fury.io/py/streamdown.svg/></a>
+</p>
 
-[![PyPI version](https://badge.fury.io/py/streamdown.svg)](https://badge.fury.io/py/streamdown)
-
-I needed a streaming Markdown renderer and I couldn't find one. So here we go. From the ground up. It's a bad idea but it has to be done.
-
-[sd demo](https://github.com/user-attachments/assets/48dba6fa-2282-4be9-8087-a2ad8e7c7d12)
-
-This will work with [simonw's llm](https://github.com/simonw/llm) unlike with [richify.py](https://github.com/gianlucatruda/richify) which rerenders the whole buffer and blocks with an elipses or [glow](https://github.com/charmbracelet/glow) which buffers everything, this streams and does exactly what it says.
-
-## Some Features
+The streaming markdown renderer for the terminal that rocks!
+Streamdown works with [simonw's llm](https://github.com/simonw/llm) along with any other streaming markdown. You even get full readline and keyboard navigation support.
+```bash
+$ pip install streamdown
+```
+![Streamdown is Amazing](https://github.com/user-attachments/assets/268cb340-78cc-4df0-a773-c5ac95eceeeb)
 
-### Provides clean copyable code for long code blocks and short terminals. 
-![copyable](https://github.com/user-attachments/assets/4a3539c5-b5d1-4d6a-8bce-032724d8909d)
+### Provides clean copyable code for long code lines
+You may have noticed *inferior* renderers inject line breaks when copying code that wraps around. We're better and now you are too!
+![Handle That Mandle](https://github.com/user-attachments/assets/a27aa70c-f691-4796-84f0-c2eb18c7de23)
 
-### Supports images, why not?
+### Supports images
 Here's kitty and alacritty. Try to do that in glow...
-![doggie](https://github.com/user-attachments/assets/9a392929-b6c2-4204-b257-e09305acb7af)
+![doggie](https://github.com/user-attachments/assets/81c43983-68cd-40c1-b1d5-aa3a52004504)
 
-### Does OSC 8 links for modern terminals (and optionally OSC 52 for clipboard)
+### Supports hyperlinks (OSC 8) and clipboard (OSC 52)
 [links.webm](https://github.com/user-attachments/assets/a5f71791-7c58-4183-ad3b-309f470c08a3)
 
-### Doesn't consume characters like _ and * as style when they are in `blocks like this` because `_they_can_be_varaiables_`
-![dunder](https://github.com/user-attachments/assets/d41d7fec-6dec-4387-b53d-f2098f269a5e)
-
-### Tables are carefully supported
+### Supports tables
 ![table](https://github.com/user-attachments/assets/dbe3d13e-6bac-4f45-bf30-f1857ed98898)
 
+As well as everything else...
+![dunder](https://github.com/user-attachments/assets/d41d7fec-6dec-4387-b53d-f2098f269a5e)
+
 ### Colors are highly (and quickly) configurable for people who care a lot, or just a little.
-![configurable](https://github.com/user-attachments/assets/04b36749-4bb8-4c14-9758-84eb6e19b704)
+![configurable](https://github.com/user-attachments/assets/19ca2ec9-8ea1-4a79-87ca-8352789269fe)
 
 ### Has a [Plugin](https://github.com/kristopolous/Streamdown/tree/main/streamdown/plugins) system to extend the parser and renderer.
 For instance, here is the [latex plugin](https://github.com/kristopolous/Streamdown/blob/main/streamdown/plugins/latex.py) doing math inside a table:
 ![calc](https://github.com/user-attachments/assets/0b0027ca-8ef0-4b4a-b4ae-e36ff623a683)
 
 
-## Configuration
-
+## TOML Configuration 
 
 Streamdown uses a TOML configuration file located at `~/.config/streamdown/config.toml` (following the XDG Base Directory Specification). If this file does not exist upon first run, it will be created with default values. 
 
@@ -84,7 +86,7 @@ Defines the base Hue (H), Saturation (S), and Value (V) from which all other pal
 *   `Width` (integer, default: `0`): Along with the `Margin`, `Width` specifies the base width of the content, which when set to 0, means use the terminal width. See [#6](https://github.com/kristopolous/Streamdown/issues/6) for more details
 *   `PrettyPad` (boolean, default: `false`): Uses a unicode vertical pad trick to add a half height background to code blocks. This makes copy/paste have artifacts. See [#2](https://github.com/kristopolous/Streamdown/issues/2). I like it on. But that's just me
 *   `ListIndent` (integer, default: `2`): This is the recursive indent for the list styles.
-*   `Syntax` (string, default `monokai`): This the syntax [highlighting theme which come via pygments](https://pygments.org/styles/).
+*   `Syntax` (string, default `monokai`): This is the syntax [highlighting theme which come via pygments](https://pygments.org/styles/).
 
 Example:
 ```toml
@@ -113,7 +115,7 @@ Width = 120
 Timeout = 1.0
 ```
 
-## Invocation
+## Command Line
 The most exciting feature here is `--exec` with it you can do full readline support like this:
 
      $ sd --exec "llm chat"
@@ -143,10 +145,8 @@ Do this
 
     $ ./streamdown/sd.py tests/*md
 
-Certainly room for improvement and I'll probably continue to make them
-
 ## Install from source
-At least one of these should work, hopefully
+After the git clone least one of these should work, hopefully. it's using the modern uv pip tool.
 
     $ pipx install -e .
     $ pip install -e .

{streamdown-0.14.0 → streamdown-0.16.0}/README.md

@@ -1,41 +1,42 @@
-# Streamdown
-
-[![PyPI version](https://badge.fury.io/py/streamdown.svg)](https://badge.fury.io/py/streamdown)
-
-I needed a streaming Markdown renderer and I couldn't find one. So here we go. From the ground up. It's a bad idea but it has to be done.
-
-[sd demo](https://github.com/user-attachments/assets/48dba6fa-2282-4be9-8087-a2ad8e7c7d12)
-
-This will work with [simonw's llm](https://github.com/simonw/llm) unlike with [richify.py](https://github.com/gianlucatruda/richify) which rerenders the whole buffer and blocks with an elipses or [glow](https://github.com/charmbracelet/glow) which buffers everything, this streams and does exactly what it says.
-
-## Some Features
+<p align="center">
+<img src=https://github.com/user-attachments/assets/0468eac0-2a00-4e98-82ca-09e6ac679357/>
+<br/>
+<a href=https://pypi.org/project/streamdown><img src=https://badge.fury.io/py/streamdown.svg/></a>
+</p>
+
+The streaming markdown renderer for the terminal that rocks!
+Streamdown works with [simonw's llm](https://github.com/simonw/llm) along with any other streaming markdown. You even get full readline and keyboard navigation support.
+```bash
+$ pip install streamdown
+```
+![Streamdown is Amazing](https://github.com/user-attachments/assets/268cb340-78cc-4df0-a773-c5ac95eceeeb)
 
-### Provides clean copyable code for long code blocks and short terminals. 
-![copyable](https://github.com/user-attachments/assets/4a3539c5-b5d1-4d6a-8bce-032724d8909d)
+### Provides clean copyable code for long code lines
+You may have noticed *inferior* renderers inject line breaks when copying code that wraps around. We're better and now you are too!
+![Handle That Mandle](https://github.com/user-attachments/assets/a27aa70c-f691-4796-84f0-c2eb18c7de23)
 
-### Supports images, why not?
+### Supports images
 Here's kitty and alacritty. Try to do that in glow...
-![doggie](https://github.com/user-attachments/assets/9a392929-b6c2-4204-b257-e09305acb7af)
+![doggie](https://github.com/user-attachments/assets/81c43983-68cd-40c1-b1d5-aa3a52004504)
 
-### Does OSC 8 links for modern terminals (and optionally OSC 52 for clipboard)
+### Supports hyperlinks (OSC 8) and clipboard (OSC 52)
 [links.webm](https://github.com/user-attachments/assets/a5f71791-7c58-4183-ad3b-309f470c08a3)
 
-### Doesn't consume characters like _ and * as style when they are in `blocks like this` because `_they_can_be_varaiables_`
-![dunder](https://github.com/user-attachments/assets/d41d7fec-6dec-4387-b53d-f2098f269a5e)
-
-### Tables are carefully supported
+### Supports tables
 ![table](https://github.com/user-attachments/assets/dbe3d13e-6bac-4f45-bf30-f1857ed98898)
 
+As well as everything else...
+![dunder](https://github.com/user-attachments/assets/d41d7fec-6dec-4387-b53d-f2098f269a5e)
+
 ### Colors are highly (and quickly) configurable for people who care a lot, or just a little.
-![configurable](https://github.com/user-attachments/assets/04b36749-4bb8-4c14-9758-84eb6e19b704)
+![configurable](https://github.com/user-attachments/assets/19ca2ec9-8ea1-4a79-87ca-8352789269fe)
 
 ### Has a [Plugin](https://github.com/kristopolous/Streamdown/tree/main/streamdown/plugins) system to extend the parser and renderer.
 For instance, here is the [latex plugin](https://github.com/kristopolous/Streamdown/blob/main/streamdown/plugins/latex.py) doing math inside a table:
 ![calc](https://github.com/user-attachments/assets/0b0027ca-8ef0-4b4a-b4ae-e36ff623a683)
 
 
-## Configuration
-
+## TOML Configuration 
 
 Streamdown uses a TOML configuration file located at `~/.config/streamdown/config.toml` (following the XDG Base Directory Specification). If this file does not exist upon first run, it will be created with default values. 
 
@@ -56,7 +57,7 @@ Defines the base Hue (H), Saturation (S), and Value (V) from which all other pal
 *   `Width` (integer, default: `0`): Along with the `Margin`, `Width` specifies the base width of the content, which when set to 0, means use the terminal width. See [#6](https://github.com/kristopolous/Streamdown/issues/6) for more details
 *   `PrettyPad` (boolean, default: `false`): Uses a unicode vertical pad trick to add a half height background to code blocks. This makes copy/paste have artifacts. See [#2](https://github.com/kristopolous/Streamdown/issues/2). I like it on. But that's just me
 *   `ListIndent` (integer, default: `2`): This is the recursive indent for the list styles.
-*   `Syntax` (string, default `monokai`): This the syntax [highlighting theme which come via pygments](https://pygments.org/styles/).
+*   `Syntax` (string, default `monokai`): This is the syntax [highlighting theme which come via pygments](https://pygments.org/styles/).
 
 Example:
 ```toml
@@ -85,7 +86,7 @@ Width = 120
 Timeout = 1.0
 ```
 
-## Invocation
+## Command Line
 The most exciting feature here is `--exec` with it you can do full readline support like this:
 
      $ sd --exec "llm chat"
@@ -115,10 +116,8 @@ Do this
 
     $ ./streamdown/sd.py tests/*md
 
-Certainly room for improvement and I'll probably continue to make them
-
 ## Install from source
-At least one of these should work, hopefully
+After the git clone least one of these should work, hopefully. it's using the modern uv pip tool.
 
     $ pipx install -e .
     $ pip install -e .

streamdown-0.16.0/assets/logo.svg

@@ -0,0 +1,116 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Generator: visioncortex VTracer -->
+
+<svg
+   id="svg"
+   version="1.1"
+   style="display:block"
+   viewBox="0 0 389.90754 91.487504"
+   sodipodi:docname="logo.svg"
+   width="389.90753"
+   height="91.487503"
+   inkscape:version="1.4 (e7c3feb100, 2024-10-09)"
+   inkscape:export-filename="logo.png"
+   inkscape:export-xdpi="96"
+   inkscape:export-ydpi="96"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <defs
+     id="defs14" />
+  <sodipodi:namedview
+     id="namedview14"
+     pagecolor="#ffffff"
+     bordercolor="#000000"
+     borderopacity="0.25"
+     inkscape:showpageshadow="2"
+     inkscape:pageopacity="0.0"
+     inkscape:pagecheckerboard="0"
+     inkscape:deskcolor="#d1d1d1"
+     inkscape:zoom="7.6562156"
+     inkscape:cx="84.702421"
+     inkscape:cy="45.126733"
+     inkscape:window-width="1239"
+     inkscape:window-height="1080"
+     inkscape:window-x="515"
+     inkscape:window-y="-2"
+     inkscape:window-maximized="0"
+     inkscape:current-layer="svg" />
+  <path
+     d="m 53.95,0 h 3.9 l 2.925,0.65 2.4375,0.8125 2.6,1.1375 2.6,1.4625 2.1125,1.4625 1.95,1.4625 1.625,1.4625 1.95,1.7875 1.1375,1.1375 1.1375,1.3 2.1125,2.6 1.3,1.7875 1.625,2.1125 0.975,1.3 1.3,0.65 2.6,0.975 5.2,2.6 2.925,1.7875 2.7625,1.95 2.1125,1.7875 1.7875,1.4625 2.925,2.925 1.4625,1.7875 1.3,1.4625 1.95,2.7625 1.7875,2.925 1.95,3.7375 2.1125,5.3625 1.1375,4.0625 0.975,3.4125 1.4625,2.4375 0.8125,1.625 0.325,1.1375 0.1625,2.1125 -0.65,2.6 -1.4625,2.6 -1.4625,1.7875 -1.7875,1.7875 -2.7625,2.1125 -2.1125,1.3 -3.4125,1.95 -2.6,1.3 -3.4125,1.4625 -3.4125,1.1375 -4.55,0.975 -4.225,0.65 -5.0375,0.325 -4.225,-0.1625 -2.7625,-0.325 -2.4375,1.4625 -2.6,1.4625 -2.7625,0.975 -2.925,0.65 H 62.075 L 60.125,91 57.85,89.8625 56.7125,88.725 55.9,87.1 l -0.4875,-2.4375 -3.0875,-0.975 -1.7875,-0.975 -1.625,-1.3 L 47.45,79.3 46.8,77.5125 46.475,75.4 v -2.925 l -1.4625,-1.7875 -1.95,-2.275 -1.3,-1.625 -1.95,-2.275 -1.4625,-1.625 -1.1375,-1.3 L 35.75,59.9625 34.2875,58.3375 32.825,56.55 32.0125,55.7375 v -0.325 h -0.325 l -1.1375,-1.3 -1.3,-0.65 -1.625,0.1625 -1.95,0.8125 -2.275,1.3 -3.7375,1.7875 -3.25,1.4625 -3.575,1.3 -3.0875,0.65 H 6.175 L 4.0625,60.45 3.0875,59.9625 2.1125,58.825 1.4625,57.0375 V 54.925 L 1.95,52.4875 3.25,48.5875 4.875,44.85 6.6625,41.4375 7.8,39.325 l -0.1625,-1.3 -1.3,-2.6 -2.275,-4.55 -1.95,-4.55 L 0.975,22.9125 0.325,20.15 0,17.7125 V 14.625 l 0.65,-1.7875 1.1375,-1.4625 0.975,-0.65 0.8125,-0.1625 h 1.7875 l 2.7625,0.65 2.6,1.1375 2.6,1.4625 2.6,1.7875 2.1125,1.625 2.1125,1.7875 2.4375,2.275 1.95,1.95 1.1375,1.3 2.1125,2.275 1.7875,2.275 c 0.275719,0.499267 0.393174,0.632565 0.65,0.975 l 0.65,0.325 1.1375,0.8125 0.975,0.1625 2.6,-1.1375 2.7625,-1.625 2.6,-1.4625 0.975,-0.4875 v -1.625 l 0.325,-1.95 0.65,-1.3 1.1375,-1.1375 1.7875,-1.1375 1.7875,-1.3 0.325,-0.4875 V 16.25 L 47.125,12.1875 46.9625,10.725 V 7.15 L 47.45,4.7125 48.5875,2.7625 49.725,1.625 52,0.4875 Z"
+     style="fill:#fbb034;stroke-width:0.1625"
+     id="path1"
+     sodipodi:nodetypes="cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc" />
+  <path
+     d="m 4.0625,13.8125 h 1.3 l 2.1125,0.65 2.7625,1.3 3.9,2.6 1.625,1.3 2.275,1.7875 0.8125,0.8125 4.55,4.55 1.1375,1.3 2.1125,2.4375 1.7875,2.275 0.65,0.8125 1.4625,0.975 0.4875,0.1625 h 2.4375 l 2.6,-1.1375 1.7875,-0.975 3.9,-2.275 4.225,-2.275 L 49.725,26.325 52,25.5125 56.0625,24.375 60.45,23.4 66.1375,22.75 68.575,22.5875 h 6.0125 l 3.4125,0.325 5.0375,0.975 1.7875,0.4875 0.1625,0.65 -2.1125,0.8125 -2.6,1.3 -2.925,2.1125 -2.4375,2.275 -1.1375,1.4625 -1.625,2.1125 -1.625,2.7625 -1.3,2.7625 -0.8125,3.4125 -0.1625,5.3625 -0.325,2.4375 -0.8125,2.6 -1.4625,3.0875 -0.325,1.7875 0.1625,1.95 0.325,1.625 0.325,0.1625 h -0.325 l 0.1625,0.4875 -2.6,-0.65 -1.7875,-0.325 h -4.225 l -2.6,0.4875 -2.1125,0.8125 h -0.325 v 0.325 l -1.4625,0.975 -0.65,0.325 v 0.325 L 49.4,66.625 47.775,68.9 47.45,68.7375 v -0.325 l -0.65,-0.325 -2.1125,-1.95 -1.95,-1.95 L 41.275,62.4 39.65,60.2875 37.8625,58.0125 36.075,55.7375 33.9625,53.1375 32.825,52.1625 32.0125,51.35 30.225,50.2125 29.7375,50.05 h -1.95 l -1.4625,0.325 -2.6,1.4625 -1.625,0.975 -3.4125,1.7875 -3.25,1.3 -3.4125,1.1375 -3.9,0.65 -2.6,-0.1625 -0.65,-0.65 v -1.95 L 5.525,52 l 1.1375,-3.25 0.65,-1.4625 1.3,-2.6 1.95,-3.25 0.65,-1.4625 v -2.1125 l -0.65,-1.625 L 8.775,32.825 7.15,29.7375 6.0125,27.3 4.3875,22.75 3.7375,20.6375 3.4125,18.85 3.25,15.7625 3.575,14.3 Z"
+     style="fill:#faaa36;stroke-width:0.1625"
+     id="path2" />
+  <path
+     d="m 53.95,0 h 3.9 l 2.925,0.65 2.4375,0.8125 2.6,1.1375 2.6,1.4625 2.1125,1.4625 1.95,1.4625 1.625,1.4625 1.95,1.7875 1.1375,1.1375 1.1375,1.3 2.1125,2.6 1.3,1.7875 1.625,2.1125 0.975,1.3 1.3,0.65 2.6,0.975 5.2,2.6 2.925,1.7875 2.7625,1.95 2.1125,1.7875 1.7875,1.4625 2.925,2.925 1.4625,1.7875 1.3,1.4625 1.95,2.7625 1.7875,2.925 1.95,3.7375 2.1125,5.3625 1.1375,4.0625 0.975,3.4125 1.4625,2.4375 0.8125,1.625 0.325,1.1375 0.1625,2.1125 -0.65,2.6 -1.4625,2.6 -1.4625,1.7875 -1.7875,1.7875 -2.7625,2.1125 -2.1125,1.3 -3.4125,1.95 -2.6,1.3 -3.4125,1.4625 -3.4125,1.1375 -4.55,0.975 -4.225,0.65 -5.0375,0.325 -4.225,-0.1625 -2.7625,-0.325 -2.4375,1.4625 -2.6,1.4625 -2.7625,0.975 -2.925,0.65 H 62.075 L 60.125,91 57.85,89.8625 56.7125,88.725 55.9,87.1 l -0.4875,-2.4375 -3.0875,-0.975 -1.7875,-0.975 -1.625,-1.3 L 47.45,79.3 46.8,77.5125 46.475,75.4 v -2.925 l -1.4625,-1.7875 -1.95,-2.275 -1.3,-1.625 -1.95,-2.275 -1.4625,-1.625 -1.1375,-1.3 L 35.75,59.9625 34.2875,58.3375 32.825,56.55 32.0125,55.7375 v -0.325 h -0.325 l -1.1375,-1.3 -1.3,-0.65 -1.625,0.1625 -1.95,0.8125 -2.275,1.3 -3.7375,1.7875 -3.25,1.4625 -3.575,1.3 -3.0875,0.65 H 6.175 L 4.0625,60.45 3.0875,59.9625 2.1125,58.825 1.4625,57.0375 V 54.925 L 1.95,52.4875 3.25,48.5875 4.875,44.85 6.6625,41.4375 7.8,39.325 l -0.1625,-1.3 -1.3,-2.6 -2.275,-4.55 -1.95,-4.55 L 0.975,22.9125 0.325,20.15 0,17.7125 V 14.625 l 0.65,-1.7875 1.1375,-1.4625 0.975,-0.65 0.8125,-0.1625 h 1.7875 l 2.7625,0.65 2.6,1.1375 2.6,1.4625 2.6,1.7875 2.1125,1.625 2.1125,1.7875 2.4375,2.275 1.95,1.95 1.1375,1.3 2.1125,2.275 1.7875,2.275 0.325,0.65 c 0.351718,0.267784 0.216666,0.216666 0.325,0.325 l 0.65,0.325 1.1375,0.8125 0.975,0.1625 2.6,-1.1375 2.7625,-1.625 2.6,-1.4625 0.975,-0.4875 v -1.625 l 0.325,-1.95 0.65,-1.3 1.1375,-1.1375 1.7875,-1.1375 1.7875,-1.3 0.325,-0.4875 V 16.25 L 47.125,12.1875 46.9625,10.725 V 7.15 L 47.45,4.7125 48.5875,2.7625 49.725,1.625 52,0.4875 Z M 4.0625,13.8125 3.575,14.3 3.25,16.25 l 0.1625,2.6 0.4875,2.275 1.7875,5.3625 1.3,2.925 1.625,3.25 1.625,2.925 0.8125,1.625 0.1625,0.65 v 2.1125 l -1.3,2.6 L 8.45,45.0125 6.9875,47.775 5.3625,52.4875 4.875,54.925 v 1.95 l 0.65,0.65 2.6,0.1625 3.9,-0.65 4.7125,-1.625 3.25,-1.4625 3.575,-1.95 1.7875,-1.1375 1.3,-0.65 1.1375,-0.1625 h 1.95 l 1.625,0.8125 1.3,0.975 0.8125,0.8125 1.625,1.7875 2.1125,2.7625 2.1125,2.6 1.95,2.6 2.1125,2.4375 2.6,2.6 1.1375,0.975 c 0.238154,0.3062 0.308617,0.308617 0.4875,0.4875 l 0.8125,-0.8125 1.4625,-2.1125 0.325,-0.1625 c -0.0044,-0.457005 0.238774,-0.444387 0.65,-0.65 l 1.4625,-0.975 1.4625,-0.8125 1.625,-0.4875 1.95,-0.325 h 4.225 l 3.0875,0.65 2.275,0.8125 0.975,0.4875 0.4875,0.1625 v 1.1375 l -0.4875,0.65 -1.4625,-0.1625 -3.575,-0.8125 h -4.225 l -2.7625,0.65 -1.95,0.8125 -1.4625,1.1375 -1.3,1.625 -0.975,1.95 -0.325,1.4625 v 2.7625 l 0.4875,1.7875 0.65,1.1375 1.625,1.4625 1.7875,0.8125 L 57.2,81.575 61.5875,81.25 64.35,80.6 66.3,79.7875 68.0875,78.65 l 1.625,-1.4625 1.95,-1.95 0.65,-0.8125 0.65,0.325 h 0.975 l 0.1625,0.975 -1.3,1.7875 -1.625,2.275 -1.625,1.625 v 0.325 l 2.1125,0.8125 3.4125,0.975 2.6,0.4875 4.55,0.325 h 4.225 l 5.525,-0.65 3.7375,-0.8125 4.3875,-1.4625 3.9,-1.625 3.0875,-1.4625 0.975,-0.65 -0.65,-0.325 L 105.3,76.7 104,75.8875 h -0.325 l -0.325,-0.65 -0.975,-1.3 -0.1625,-0.8125 0.8125,-0.1625 1.625,1.1375 1.4625,0.65 0.65,0.1625 h 2.925 l 1.95,-0.4875 2.275,-1.1375 1.625,-1.3 1.3,-1.4625 1.1375,-2.275 0.1625,-0.65 v -2.275 l -0.325,-0.975 -1.3,-1.95 -0.975,-1.625 -0.65,-1.7875 -0.8125,-3.9 -1.3,-3.9 -1.625,-3.9 L 110.175,45.5 109.2,43.875 108.55,42.7375 106.4375,39.65 104.65,37.5375 104,36.5625 103.5125,36.075 c -0.32419,-0.296348 -0.34673,-0.309086 -0.65,-0.65 l -0.65,-0.8125 -0.8125,-0.65 -0.1625,-0.325 c -0.30502,-0.235862 -0.21667,-0.216666 -0.325,-0.325 l -1.625,-1.3 C 99.166039,31.822798 98.921706,31.646706 98.8,31.525 98.439053,31.259572 98.321876,31.176382 98.15,31.0375 L 96.3625,29.9 l -2.6,-1.625 -2.6,-1.4625 L 87.75,25.35 83.6875,24.05 79.625,23.2375 76.5375,22.75 74.5875,22.5875 H 68.575 l -5.6875,0.4875 -4.0625,0.65 -5.2,1.3 -3.0875,0.975 -3.25,1.4625 -4.7125,2.4375 -3.9,2.275 -2.6,1.4625 -2.6,1.1375 h -2.4375 l -1.3,-0.65 L 28.925,33.3125 27.625,31.85 26.1625,30.0625 24.375,27.95 22.9125,26.325 18.85,22.2625 18.0375,21.45 15.4375,19.3375 13,17.55 9.9125,15.6 7.475,14.4625 5.3625,13.8125 Z"
+     style="fill:#253949;stroke-width:0.1625;fill-opacity:1"
+     id="path3"
+     sodipodi:nodetypes="ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc" />
+  <path
+     d="m 4.0625,13.8125 h 1.3 l 2.1125,0.65 2.7625,1.3 3.9,2.6 1.625,1.3 2.275,1.7875 0.8125,0.8125 4.55,4.55 1.1375,1.3 2.1125,2.4375 1.7875,2.275 0.4875,0.4875 -0.1625,0.4875 -0.4875,0.325 v 0.325 l -0.8125,0.65 v 0.4875 L 26.975,36.075 26.65,36.725 H 26.325 L 26,37.5375 l -0.325,0.65 V 39 l -0.65,0.8125 0.325,0.1625 -0.325,0.325 -0.325,3.25 0.1625,2.4375 0.325,0.8125 0.65,2.6 0.1625,1.1375 -2.7625,1.625 -3.575,1.95 -3.7375,1.625 -3.9,1.3 -3.9,0.65 -2.6,-0.1625 -0.65,-0.65 v -1.95 L 5.525,52 l 1.1375,-3.25 0.65,-1.4625 1.3,-2.6 1.95,-3.25 0.65,-1.4625 v -2.1125 l -0.65,-1.625 L 8.775,32.825 7.15,29.7375 6.0125,27.3 4.3875,22.75 3.7375,20.6375 3.4125,18.85 3.25,15.7625 3.575,14.3 Z"
+     style="fill:#faa428;stroke-width:0.1625"
+     id="path4" />
+  <path
+     d="m 90.675,45.9875 h 2.1125 l 2.6,0.65 1.625,0.65 2.1125,1.4625 0.4875,0.4875 c 0.208101,0.306981 0.238774,0.444387 0.65,0.65 L 101.725,52 l 0.8125,1.7875 0.65,2.6 v 3.575 l -0.65,2.4375 -1.1375,2.275 -0.975,1.3 -0.975,1.1375 -2.1125,1.4625 -2.275,0.975 -1.3,0.325 h -2.925 L 88.4,69.225 86.125,68.0875 84.6625,66.95 83.2,65.4875 81.9,63.375 81.0875,61.5875 80.6,59.475 v -3.7375 l 0.65,-2.4375 1.1375,-2.275 1.4625,-1.7875 1.4625,-1.3 2.4375,-1.3 z"
+     style="fill:#263d50;stroke-width:0.1625"
+     id="path5"
+     sodipodi:nodetypes="ccccccccccccccccccccccccccccccccc" />
+  <path
+     d="m 72.6375,22.5875 h 1.95 l 3.4125,0.325 5.0375,0.975 1.7875,0.4875 0.1625,0.65 -2.1125,0.8125 -2.6,1.3 -2.925,2.1125 -2.4375,2.275 -1.1375,1.4625 -1.625,2.1125 -1.625,2.7625 -1.3,2.7625 -0.8125,3.4125 -0.1625,5.3625 -0.325,2.4375 -0.8125,2.6 -1.4625,3.0875 -0.325,1.7875 0.1625,1.95 0.325,1.625 0.325,0.1625 h -0.325 l 0.1625,0.4875 -2.6,-0.65 -1.7875,-0.325 h -4.225 l -1.3,0.1625 L 55.9,62.4 l 0.65,-0.1625 -0.1625,-0.65 h 0.325 l -0.325,-1.4625 v -3.9 l 0.4875,-1.625 1.3,-2.7625 0.8125,-1.95 0.975,-2.925 0.1625,-0.975 0.1625,-4.7125 0.325,-2.4375 L 61.425,36.725 62.4,34.775 63.5375,33.3125 65,31.525 l 1.95,-1.95 1.3,-1.1375 1.1375,-1.1375 1.4625,-1.7875 1.4625,-2.275 z"
+     style="fill:#f27b3f;stroke-width:0.1625"
+     id="path6" />
+  <path
+     d="M 54.925,3.0875 H 57.2 l 2.6,0.4875 3.0875,1.1375 1.3,0.65 1.3,0.4875 1.7875,1.1375 2.275,1.625 2.1125,1.625 2.7625,2.6 0.975,1.1375 0.8125,0.8125 c 0.216312,0.279081 0.216666,0.216667 0.325,0.325 l 1.1375,1.7875 1.4625,1.95 0.325,0.975 -0.65,0.1625 -3.0875,-0.325 H 68.25 l -4.875,0.4875 -4.3875,0.65 -5.85,1.4625 -3.575,1.3 -3.7375,1.625 h -0.65 v -0.975 l 0.8125,-0.975 2.6,-1.4625 1.625,-1.3 0.975,-1.4625 0.1625,-0.65 v -1.95 l -0.975,-4.55 -0.1625,-1.625 V 6.5 l 0.65,-1.4625 1.3,-0.975 1.3,-0.65 z"
+     style="fill:#fcb031;stroke-width:0.1625"
+     id="path7"
+     sodipodi:nodetypes="ccccccccccccccccccccccccccccccccccccccc" />
+  <path
+     d="m 68.575,22.5875 h 4.0625 l -0.325,0.975 -1.7875,2.6 -2.4375,2.6 -2.6,2.4375 -1.4625,1.625 -1.4625,1.95 -1.3,2.6 -0.65,2.275 -0.1625,2.1125 -0.1625,4.225 -0.65,2.6 -1.1375,3.0875 -1.3,2.6 -0.4875,1.1375 -0.1625,0.8125 v 3.9 l 0.1625,1.4625 h -0.325 l 0.325,0.8125 -1.3,0.4875 -2.4375,0.8125 -0.65,0.1625 v 0.325 L 51.35,64.5125 51.1875,63.375 50.7,63.2125 50.5375,62.725 50.2125,62.5625 50.375,61.75 49.5625,61.9125 v -0.325 L 49.075,61.425 49.725,61.2625 49.8875,61.1 49.4,60.775 l -0.1625,-0.1625 -0.325,0.325 -0.325,-0.65 -0.1625,-0.8125 -0.1625,-1.4625 0.325,-2.6 0.325,-1.4625 0.8125,-1.7875 0.975,-2.6 0.8125,-1.7875 0.325,-1.3 V 44.2 l -0.325,-2.4375 v -2.275 L 52,37.05 l 1.1375,-2.4375 1.1375,-1.95 0.975,-1.1375 1.4625,-1.7875 2.1125,-2.1125 0.8125,-0.975 h 0.325 l 0.325,-0.8125 0.975,-1.4625 0.1625,-0.975 1.4625,-0.325 z"
+     style="fill:#faaf38;stroke-width:0.1625"
+     id="path8" />
+  <path
+     d="m 60.45,23.4 h 0.975 l 0.1625,0.65 -0.975,1.625 -0.65,0.975 -0.65,0.65 -0.65,0.65 -1.95,1.95 -0.975,1.3 -0.65,0.8125 -0.975,1.1375 -0.975,1.625 -0.975,2.275 -0.4875,2.4375 v 2.275 L 52,44.2 v 2.275 l -0.4875,1.625 -1.1375,2.6 -0.975,2.6 -0.4875,0.975 -0.1625,1.1375 -0.325,2.6 v 1.4625 l 0.325,0.1625 -0.1625,0.65 0.325,0.1625 0.1625,0.1625 0.4875,0.975 v 0.325 l 0.65,0.65 0.4875,0.1625 0.1625,0.4875 0.325,0.1625 0.325,0.8125 -0.1625,0.65 -0.8125,0.65 h -0.325 v 0.325 L 49.4,66.625 47.775,68.9 47.45,68.7375 v -0.325 l -0.65,-0.325 -2.1125,-1.95 -1.95,-1.95 -1.4625,-1.7875 -0.1625,-0.325 1.3,0.1625 0.1625,-0.65 -0.325,-0.65 -0.4875,-0.65 L 41.275,58.6625 40.625,57.2 40.3,54.6 40.95,52 l 1.1375,-2.275 1.625,-2.6 0.65,-1.7875 0.1625,-0.975 V 42.575 l -0.4875,-3.7375 0.1625,-2.925 0.65,-2.4375 0.4875,-0.8125 0.975,-1.625 1.3,-1.625 L 49.4,27.3 49.5625,26.975 h 0.325 V 26.65 l 0.975,-0.8125 5.2,-1.4625 z"
+     style="fill:#f07640;stroke-width:0.1625"
+     id="path9"
+     sodipodi:nodetypes="cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc" />
+  <path
+     d="m 38.35,32.3375 0.325,0.1625 -0.325,3.25 -0.325,5.6875 -0.4875,3.0875 -0.8125,1.95 -1.7875,3.0875 V 50.05 l -0.8125,0.8125 -0.65,1.3 -0.325,0.1625 -1.7875,-1.4625 -1.625,-0.8125 h -1.95 L 26,50.375 25.5125,49.075 24.8625,46.15 24.7,45.5 24.5375,43.0625 24.8625,40.3 l 0.325,-0.975 0.325,-0.65 0.1625,-0.65 0.65,-1.3 0.65,-0.975 c 0.137171,-0.150279 0.216667,-0.433333 0.325,-0.65 l 0.65,-0.65 c 0.148224,-0.179928 0.08941,-0.268234 0.1625,-0.4875 l 0.975,-0.325 1.4625,0.975 0.4875,0.1625 h 2.4375 l 2.6,-1.1375 1.7875,-0.975 z"
+     style="fill:#f17840;stroke-width:0.1625"
+     id="path10"
+     sodipodi:nodetypes="ccccccccccccccccccccccccccccccccccc" />
+  <path
+     d="m 91,47.775 h 1.625 l 2.1125,0.4875 2.275,1.1375 1.95,1.7875 1.4625,2.275 0.65,1.7875 0.325,1.95 -0.1625,2.925 -0.8125,2.6 -0.1625,0.325 h -0.325 L 100.1,62.075 V 58.9875 L 99.45,56.875 98.475,55.25 97.5,54.1125 l -0.8125,-0.65 -0.8125,-0.65 -2.1125,-0.65 H 91.325 l -1.7875,0.65 -1.4625,1.1375 -0.975,1.3 -0.8125,1.7875 -0.325,1.3 V 60.45 l 0.65,2.1125 0.975,1.625 0.975,1.1375 1.3,0.975 1.625,0.8125 1.625,0.4875 v 0.1625 h -2.6 l -2.6,-0.8125 -2.275,-1.625 -1.4625,-1.7875 -1.3,-2.6 -0.4875,-2.275 v -2.275 l 0.65,-2.6 0.975,-1.7875 1.625,-1.95 1.625,-1.1375 1.95,-0.8125 z"
+     style="fill:#efe8d8;stroke-width:0.1625"
+     id="path11"
+     sodipodi:nodetypes="ccccccccccccccccccccccccccccccccccccccccccccccc" />
+  <path
+     d="m 117.65,18.85 h 2.1125 l 1.7875,0.65 1.625,1.4625 0.8125,1.7875 0.1625,1.3 -0.325,1.95 -0.975,1.625 -1.3,1.1375 -1.7875,0.65 h -1.95 l -1.7875,-0.65 -1.1375,-0.8125 -0.975,-1.4625 -0.4875,-1.1375 v -2.4375 l 0.65,-1.625 1.1375,-1.3 1.95,-0.975 z m 1.7875,3.0875 -0.4875,0.325 -0.1625,0.65 0.4875,0.65 h 0.8125 l 0.325,-0.325 v -0.975 l -0.4875,-0.325 z"
+     style="fill:#1c354a;stroke-width:0.1625"
+     id="path12" />
+  <path
+     d="m 74.1,75.725 0.65,0.325 0.4875,0.65 1.3,0.4875 0.975,0.1625 1.95,0.4875 0.325,0.4875 0.8125,0.4875 0.325,0.65 0.8125,0.8125 0.4875,0.4875 0.4875,0.4875 1.1375,2.275 0.325,0.4875 v 0.325 h -1.95 l -4.55,-0.325 -3.4125,-0.65 -4.0625,-1.3 -0.65,-0.325 0.325,-0.65 1.625,-1.625 1.625,-2.4375 z"
+     style="fill:#e7683e;stroke-width:0.1625"
+     id="path13"
+     sodipodi:nodetypes="cccccccccccccccccccccccc" />
+  <path
+     d="m 124.63749,40.7875 h 2.1125 l 1.4625,0.8125 0.975,1.3 0.1625,0.4875 v 2.275 l -0.65,1.3 -1.1375,0.975 -1.625,0.4875 -1.4625,-0.1625 -1.625,-0.975 -0.8125,-1.1375 -0.325,-1.3 0.1625,-1.4625 0.8125,-1.4625 1.4625,-0.975 z m 0.975,2.275 -0.1625,0.1625 v 0.8125 l 0.1625,0.1625 h 0.8125 l 0.1625,-0.8125 -0.325,-0.325 z"
+     style="fill:#1c354a;stroke-width:0.1625"
+     id="path14" />
+  <text
+     xml:space="preserve"
+     style="font-size:29.1586px;font-family:'Familjen Grotesk';-inkscape-font-specification:'Familjen Grotesk';text-align:start;writing-mode:lr-tb;direction:ltr;text-anchor:start;fill:#fbb034;fill-opacity:1;stroke:#253949;stroke-width:0.665;stroke-opacity:1;stroke-dasharray:none"
+     x="199.5256"
+     y="49.812157"
+     id="text28"
+     transform="scale(0.75332836,1.3274424)"><tspan
+       sodipodi:role="line"
+       id="tspan28"
+       x="199.5256"
+       y="49.812157"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Sixtyfour;-inkscape-font-specification:Sixtyfour;fill:#fbb034;fill-opacity:1;stroke:#253949;stroke-width:0.665;stroke-opacity:1;stroke-dasharray:none">Streamdown_</tspan></text>
+</svg>

{streamdown-0.14.0 → streamdown-0.16.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "streamdown"
-version = "0.14.0"
+version = "0.16.0"
 description = "A streaming markdown renderer for modern terminals with syntax highlighting"
 readme = "README.md"
 requires-python = ">=3.8"
@@ -31,6 +31,7 @@ dependencies = [
     "appdirs",
     "toml",
     "pylatexenc",
+    'term-image'
 ]
 
 [project.urls]

{streamdown-0.14.0 → streamdown-0.16.0}/streamdown/sd.py

@@ -22,10 +22,10 @@ import subprocess
 import traceback
 import colorsys
 import base64
-import importlib
 from io import BytesIO
 from term_image.image import from_file, from_url
 import pygments.util
+from functools import reduce
 from argparse import ArgumentParser
 from pygments import highlight
 from pygments.lexers import get_lexer_by_name
@@ -91,8 +91,8 @@ KEYCODE_RE = re.compile(r'\x1B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])')
 
 visible = lambda x: re.sub(ANSIESCAPE, "", x)
 visible_length = lambda x: len(visible(x))
-
 extract_ansi_codes = lambda text: re.findall(ESCAPE, text)
+remove_ansi = lambda line, codeList: reduce(lambda line, code: line.replace(code, ''), codeList, line)
 
 def debug_write(text):
     if state.Logging:
@@ -271,6 +271,7 @@ def code_wrap(text_in):
 
     return (indent, res)
 
+
 # This marvelously obscure code "compacts" long lines of repetitive ANSI format strings by
 # removing duplicates. Here's how it works
 def ansi_collapse(codelist, inp):
@@ -567,9 +568,10 @@ def parse(stream):
         # <code><pre>
         #
         if not state.in_code:
-            code_match = re.match(r"\s*```\s*([^\s]+|$)$", line)
+            code_match = re.match(r"^\s*```\s*([^\s]+|$)\s*$", line)
             if code_match:
                 state.in_code = Code.Backtick
+                state.code_indent = len(line) - len(line.lstrip())
                 state.code_language = code_match.group(1) or 'Bash'
 
             elif state.CodeSpaces and last_line_empty_cache and not state.in_list:
@@ -594,6 +596,7 @@ def parse(stream):
 
         if state.in_code:
             try:
+                # This is turning it OFF
                 if not state.code_first_line and (
                         (                     state.in_code == Code.Backtick and     line.strip() == "```"  ) or
                         (state.CodeSpaces and state.in_code == Code.Spaces   and not line.startswith('    '))
@@ -623,9 +626,7 @@ def parse(stream):
                     state.emit_flush = True
                     yield RESET
 
-
                     if code_type == Code.Backtick:
-                        state.code_indent = len(line) - len(line.lstrip())
                         continue
                     else:
                         # otherwise we don't want to consume
@@ -665,6 +666,10 @@ def parse(stream):
                     # then naively search back until our visible_lengths() match. This is not fast and there's certainly smarter
                     # ways of doing it but this thing is way trickery than you think
                     highlighted_code = highlight(state.code_buffer + tline, lexer, formatter)
+
+                    # Sometimes the highlighter will do things like a full reset or a background reset.
+                    # This is not what we want
+                    highlighted_code = re.sub(r"\033\[39(;00|)m", '', highlighted_code)
     
                     # Since we are streaming we ignore the resets and newlines at the end
                     if highlighted_code.endswith(FGRESET + "\n"):

{streamdown-0.14.0 → streamdown-0.16.0}/tests/chunk-buffer.sh

@@ -1,5 +1,5 @@
 #!/bin/bash
-TIMEOUT=${TIMEOUT:-0.01}
+TIMEOUT=${TIMEOUT:-0.35}
 
 while [[ $# -gt 0 ]]; do
     echo "## File: $1"

streamdown-0.16.0/tests/pythonvgo.md

@@ -0,0 +1,187 @@
+# Python vs. Go: Let's get ready to rumble!
+![](https://9ol.es/tmp/pvgo_512.jpg)
+
+Python and Go (Golang) are both popular programming languages, but they cater to different needs and philosophies. Here's a detailed comparison:
+
+
+**Python:** 
+
+* **Strengths:** 
+    * **Readability:**  Known for its clean and easy-to-understand syntax, emphasizing code readability.  
+    * **Large Ecosystem:** Vast library support for data science, machine learning, web development, scripting, and more.  Packages like NumPy, Pandas, Django, and Flask make complex tasks simpler.  
+    * **Rapid Development:** Its dynamic typing and interpreted nature allow for quick prototyping and development.
+    * **Dynamic Typing:**  The interpreter infers data types at runtime, simplifying code (but potentially hiding errors).  
+    * **Versatility:**  Can be used for a wide range of applications – web backends, data analysis, machine learning, automation, scripting, testing, and more.  
+    * **Community:** Huge and active community providing ample support, tutorials, and resources.  
+* **Weaknesses:**
+    * **Performance:** Being an interpreted language, Python is generally slower than compiled languages like Go.  
+    * **Global Interpreter Lock (GIL):**  Limits true multi-threading in CPU-bound operations.  
+    * **Error Handling:**  Runtime errors can be more common because of dynamic typing.  
+    * **Memory Consumption:**  Typically has higher memory overhead compared to Go due to its object model and dynamic typing.
+
+**Go:**
+
+* **Strengths:**
+    * **Performance:** Compiled language that produces efficient, native machine code. Generally much faster than Python.
+    * **Concurrency:**  Built-in support for concurrency through Goroutines (lightweight threads) and Channels, making it easy to write concurrent and parallel programs. 
+    * **Static Typing:** Helps catch errors at compile-time.
+    * **Garbage Collection:** Automatic memory management reduces the risk of memory leaks.
+    * **Simplicity:** Designed to be a simple language with a relatively small number of keywords.  Focuses on getting things done efficiently.
+    * **Scalability:**  Well-suited for building scalable network services and distributed systems.
+    * **Tooling:** Excellent built-in tooling for testing, formatting, and dependency management.
+* **Weaknesses:**
+    * **Learning Curve:**  Can be slightly steeper than Python initially, particularly regarding concurrency concepts.
+    * **Error Handling:** Explicit error handling (returning errors as values) can lead to verbose code.  (While necessary, it's less concise than Python's `try...except`)
+    * **Generics (Relatively New):**  Generics were only added in Go 1.18 (released in 2022).  Prior to that, code reusability for different types was more challenging.
+    * **Smaller Ecosystem:**  While rapidly growing, Go’s ecosystem is still smaller than Python's, particularly in specialized areas like data science.
+
+**Use Cases:**
+
+* **Python:** Data science, machine learning, web development (Django, Flask), scripting, automation, prototyping, and educational purposes.
+* **Go:** Cloud infrastructure (Docker, Kubernetes), network services, distributed systems, command-line tools, DevOps, and high-performance backend services.
+
+
+
+## Code Examples:
+
+**1. Hello World:**
+
+**Python:**
+```python
+print("Hello, World!")
+```
+
+**Go:**
+```go
+package main
+
+import "fmt"
+
+func main() {
+	fmt.Println("Hello, World!")
+}
+```
+
+**2.  Simple Web Server:**
+
+**Python (using Flask):**
+```python
+from flask import Flask
+
+app = Flask(__name__)
+
+@app.route("/")
+def hello_world():
+    return "<p>Hello, World!</p>"
+
+if __name__ == '__main__':
+    app.run(debug=True)
+```
+
+**Go (using net/http):**
+```go
+package main
+
+import (
+	"fmt"
+	"net/http"
+)
+
+func handler(w http.ResponseWriter, r *http.Request) {
+	fmt.Fprintf(w, "Hello, World!")
+}
+
+func main() {
+	http.HandleFunc("/", handler)
+	fmt.Println("Server listening on port 8080")
+	http.ListenAndServe(":8080", nil)
+}
+```
+
+**3. Concurrent Processing (Simple):**
+
+**Python (using threading - limited by GIL):**
+
+```python
+import threading
+
+def process_task(task_id):
+    print(f"Task {task_id} started")
+    # Simulate some work
+    import time
+    time.sleep(2)
+    print(f"Task {task_id} completed")
+
+tasks = [1, 2, 3]
+threads = []
+
+for task in tasks:
+    thread = threading.Thread(target=process_task, args=(task,))
+    threads.append(thread)
+    thread.start()
+
+for thread in threads:
+    thread.join()
+
+print("All tasks completed.")
+```
+
+**Go (using Goroutines and Channels):**
+
+```go
+package main
+
+import (
+	"fmt"
+	"sync"
+)
+
+func processTask(taskID int, wg *sync.WaitGroup) {
+	defer wg.Done() // Decrement the WaitGroup counter when the goroutine completes.
+	fmt.Printf("Task %d started\n", taskID)
+	// Simulate some work
+	//time.Sleep(2 * time.Second) // Go uses time.Second, etc.
+	fmt.Printf("Task %d completed\n", taskID)
+}
+
+func main() {
+	var wg sync.WaitGroup
+	tasks := []int{1, 2, 3}
+
+	for _, task := range tasks {
+		wg.Add(1) // Increment the WaitGroup counter for each goroutine.
+		go processTask(task, &wg)
+	}
+
+	wg.Wait()
+	fmt.Println("All tasks completed.")
+}
+```
+
+
+## Comparative Table of Features:
+
+| Feature             | Python                           | Go (Golang)                  |
+|----------------------|----------------------------------|-------------------------------|
+| **Typing**          | Dynamic, strong                  | Static, strong                |
+| **Compilation**     | Interpreted                      | Compiled                      |
+| **Performance**      | Generally slower                | Generally faster              |
+| **Concurrency**       | Through threads (GIL limited)   | Goroutines & Channels (built-in) |
+| **Error Handling**   | Exceptions (try-except)           | Explicit error values          |
+| **Memory Management**| Automatic (Garbage Collection)   | Automatic (Garbage Collection) |
+| **Syntax**           | Readable, concise               | Simple, explicit               |
+| **Ecosystem**        | Huge, mature                   | Growing, focused               |
+| **Learning Curve**    | Easier                           | Moderate                      |
+| **Generics**          | Present                          | Added in 1.18 (relatively new)|
+| **Typical Use Cases**| Data science, web dev, scripting | Cloud, networking, system programming |
+| **Community**        | Very large, active               | Growing, dedicated            |
+| **Object Orientation**| Full support                    | Structs with methods, interfaces|
+
+
+
+**In Summary:**
+
+* **Choose Python if:** You need rapid development, a large ecosystem of libraries, or are focused on data science, machine learning, or scripting.  Readability and ease of use are priorities.
+
+* **Choose Go if:** You need high performance, concurrency, scalability, and are building infrastructure, network services, or command-line tools.  Deterministic error handling and a simple, efficient language are key.
+