streamdown 0.31.0__py3-none-any.whl → 0.33.0__py3-none-any.whl

streamdown/qwen3.md

@@ -0,0 +1,25 @@
+
+### **3. Integration Strategy**
+**Call Python from Bash for heavy tasks:**  
+```bash
+# Bash calls Python for UUID generation
+uuid=$(python3 -c "from uuid import uuid4; print(uuid4())")
+
+# Bash calls Python for structured logging
+python3 -c "
+from log_utils import log_input
+log_input('$(echo "$input" | sed 's/'\''/\\'\''/g')', '$pane_id')
+"
+```
+
+**Pass state between layers via env vars:**  
+```bash
+# Bash sets env vars
+export PANE_ID="$pane_id"
+export CAPTURE="$capture"
+
+# Python reads them
+import os
+pane_id = os.getenv("PANE_ID")
+```
+

streamdown/sd.py

@@ -37,6 +37,8 @@ from term_image.image import from_file, from_url
 import pygments.util
 from wcwidth import wcwidth
 from functools import reduce
+import textwrap
+import argparse
 from argparse import ArgumentParser
 from pygments import highlight
 from pygments.lexers import get_lexer_by_name
@@ -119,7 +121,12 @@ split_up = lambda line: re.findall(r'(\x1b[^m]*m|[^\x1b]*)', line)
 def gettmpdir():
     tmp_dir_all = os.path.join(tempfile.gettempdir(), "sd")
     os.makedirs(tmp_dir_all, mode=0o777, exist_ok=True)
-    tmp_dir = os.path.join(tmp_dir_all, str(os.getuid()))
+
+    if os.name != 'nt':
+        tmp_dir = os.path.join(tmp_dir_all, str(os.getuid()))
+    else:
+        tmp_dir = tmp_dir_all
+
     os.makedirs(tmp_dir, exist_ok=True)
     return tmp_dir
 
@@ -154,7 +161,7 @@ class ParseState:
         self.buffer = b''
         self.current_line = ''
         self.first_line = True
-        self.last_line_empty = False
+        self.last_line_empty = True
         self.is_pty = False
         self.is_exec = False
         self.maybe_prompt = False
@@ -1079,7 +1086,15 @@ def width_calc():
     ]
 
 def main():
-    parser = ArgumentParser(description="Streamdown - A Streaming markdown renderer for modern terminals.  Latest version: https://github.com/day50-dev/Streamdown")
+    parser = ArgumentParser(
+            formatter_class=argparse.RawDescriptionHelpFormatter, description=textwrap.dedent(f"""
+    Streamdown is a streaming markdown renderer for modern terminals.
+    https://github.com/day50-dev/Streamdown
+
+    paths:
+      config                {os.path.join(appdirs.user_config_dir('streamdown'), 'config.toml')}
+      logs                  {gettmpdir()}
+    """))
     parser.add_argument("filenameList", nargs="*", help="Input file to process (also takes stdin)")
     parser.add_argument("-l", "--loglevel", default="INFO", help="Set the logging level")
     parser.add_argument("-b", "--base", default=None, help="Set the hsv base: h,s,v")
@@ -1175,6 +1190,7 @@ def main():
             termios.tcsetattr(sys.stdin, termios.TCSADRAIN, state.terminal)
         logging.warning(f"Exception thrown: {type(ex)} {ex}")
         traceback.print_exc()
+        state.exit = 1
 
     if os.isatty(sys.stdout.fileno()) and state.Clipboard and state.code_buffer_raw:
         code = state.code_buffer_raw

streamdown/ss

@@ -0,0 +1 @@
+*   **Model Card:**  Always read the model card on the Hugging Face Hub ([https://huggingface.co/microsoft/bitnet-b1.58-2B-4T](https://huggingface.co/microsoft/bitnet-b1.58-2B-4T)) for important information about the model, its intended use, limitations, and potential biases.

streamdown/ss1

@@ -0,0 +1,42 @@
+    *   `model.safetensors`: The name of the file you want to download.  You'll need to know the exact filename.  You can find the files in the model repository on the Hugging Face Hub website ([https://huggingface.co/microsoft/bitnet-b1.58-2B-4T](https://huggingface.co/microsoft/bitnet-b1.58-2B-4T)).  Look under the "Files and versions" tab.  `safetensors` is the preferred format for model weights now.  If it's a `.bin` file, you can download that instead.
+    *   `--local-dir ./bitnet-b1.58-2B-4T`:  The directory to save the file to.
+
+*   **Download using `transformers` library (recommended for most use cases):**
+
+    The `transformers` library provides a convenient way to download and cache models.  This is often the easiest approach if you're using the model with `transformers`.  You don't *directly* use the `huggingface-cli` for this, but it's worth knowing.
+
+    ```python
+    from transformers import AutoModelForCausalLM, AutoTokenizer
+
+    model_name = "microsoft/bitnet-b1.58-2B-4T"
+
+    tokenizer = AutoTokenizer.from_pretrained(model_name)
+    model = AutoModelForCausalLM.from_pretrained(model_name)
+
+    # The model and tokenizer will be downloaded and cached in your
+    # transformers cache directory (usually ~/.cache/huggingface/transformers).
+    ```
+
+    This approach automatically handles downloading the necessary files and caching them for future use.  It also handles the correct file formats and configurations.
+
+**4.  Checking the Download**
+
+After the download completes, verify that the files are in the specified directory.  You can use `ls` (Linux/macOS) or `dir` (Windows) to list the contents of the directory.
+
+**Important Considerations:**
+
+*   **Disk Space:**  The `bitnet-b1.58-2B-4T` model is quite large (several gigabytes).  Make sure you have enough free disk space before downloading.
+*   **Network Connection:**  A stable and fast internet connection is essential for a smooth download.
+*   **Caching:** The Hugging Face Hub and `transformers` library use caching to avoid re-downloading models unnecessarily.  The default cache directory is usually `~/.cache/huggingface/transformers`.
+*   **File Formats:**  Models are often stored in `safetensors` or `.bin` formats.  `safetensors` is generally preferred for security and performance.
+*   **Model Card:**  Always read the model card on the Hugging Face Hub ([https://huggingface.co/microsoft/bitnet-b1.58-2B-4T](https://huggingface.co/microsoft/bitnet-b1.58-2B-4T)) for important information about the model, its intended use, limitations, and potential biases.
+*   **Gated Models:** Some models require you to accept terms of use before you can download them.  The `huggingface-cli login` command will guide you through this process if necessary.
+
+**Example Workflow (Recommended):**
+
+1.  `huggingface-cli login` (if not already logged in)
+2.  Use the `transformers` library in a Python script to download and load the model (as shown in the example above).  This is the most convenient and reliable method for most use cases.
+
+Let me know if you have any other questions or if you'd like help with a specific task related to this model!
+
+> 

{streamdown-0.31.0.dist-info → streamdown-0.33.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: streamdown
-Version: 0.31.0
+Version: 0.33.0
 Summary: A streaming markdown renderer for modern terminals with syntax highlighting
 Project-URL: Homepage, https://github.com/day50-dev/Streamdown
 Project-URL: Bug Tracker, https://github.com/day50-dev/Streamdown/issues
@@ -39,7 +39,7 @@ Description-Content-Type: text/markdown
 
 Streamdown works with any streaming markdown such as [simonw's llm](https://github.com/simonw/llm) or even something basic like curl. 
 
-It just works. 
+It's designed for compatibility with the wide variety of markdown from various LLM models. 
 
 It supports standard piping and files as arguments like any normal pager but can also run as a wrapper so you retain full keyboard interactivity. Arrow keys, control, alt, all still work.
 ```bash
@@ -97,7 +97,7 @@ It is designed for AI and can be used to do parser based sophisticated pipelines
 You can also just use it like a normal person.
 ## Configuration 
 
-It's located at `~/.config/streamdown/config.toml` in Linux and `~/Library/Application Support/streamdown/config.toml` in macOS. If this file does not exist upon first run, it will be created with default values. 
+The location it's stored is platform specific and can be seen with the `-h` flag. If this file does not exist upon first run, it will be created with default values. 
 
 Here are the sections:
 
@@ -138,7 +138,7 @@ Controls optional features:
 *   `CodeSpaces` (boolean, default: `true`): Enables detection of code blocks indented with 4 spaces. Set to `false` to disable this detection method (triple-backtick blocks still work).
 *   `Clipboard` (boolean, default: `true`): Enables copying the last code block encountered to the system clipboard using OSC 52 escape sequences upon exit. Set to `false` to disable.
 *   `Logging` (boolean, default: `false`): Enables logging to tmpdir (/tmp/sd) of the raw markdown for debugging and bug reporting. The logging uses an emoji as a record separator so the actual streaming delays can be simulated and replayed. If you use the `filename` based invocation, that is to say, `sd <filename>`, this type of logging is always off.
-*   `Savebrace` (boolean, default: `true`): Saves the code blocks of a conversation to the append file `/tmp/sd/savebrace` so you can fzf or whatever you want through it. See how it's used in my [llmehelp](https://github.com/kristopolous/llmehelp) scripts, specifically `screen-query` and `sd-picker`.
+*   `Savebrace` (boolean, default: `true`): Saves the code blocks of a conversation to the append file `$TMP/sd/$UID/savebrace` so you can `fzf` or whatever you want through it. See how it's used in DAY50's [sidechat](https://github.com/day50-dev/sidechat).
 
 Example:
 ```toml
@@ -154,7 +154,7 @@ The most exciting feature here is `--exec` with it you can do full readline supp
 $ sd --exec "llm chat"
 ```
 
-And now you have all your readline stuff. It's pretty great. (Also see the Day50 shellwrap project.)
+And now you have all your readline stuff. It's pretty great. (Also see the DAY50 shellwrap project.)
 
 It's also worth noting that things like the `-c` aren't "broken" with regard to file input. You can do something like this:
 
@@ -168,7 +168,12 @@ To override the margin.
 usage: sd [-h] [-l LOGLEVEL] [-b BASE] [-c CONFIG] [-w WIDTH] [-e EXEC]
           [-s SCRAPE] [filenameList ...]
 
-Streamdown - A Streaming markdown renderer for modern terminals
+Streamdown is a streaming markdown renderer for modern terminals.
+https://github.com/day50-dev/Streamdown
+
+paths:
+  config                /home/chris/.config/streamdown/config.toml
+  logs                  /tmp/sd/1000
 
 positional arguments:
   filenameList          Input file to process (also takes stdin)
@@ -185,8 +190,11 @@ optional arguments:
   -e EXEC, --exec EXEC  Wrap a program EXEC for more 'proper' i/o handling
   -s SCRAPE, --scrape SCRAPE
                         Scrape code snippets to a directory SCRAPE
+  -v, --version         Show version information
 ```
 
+**Note**: Some features are not supported on some OSs. Please file a ticket if you need a feature on your platform that isn't working.
+
 ## Demo
 Do this
 

streamdown-0.33.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+streamdown/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+streamdown/qwen3.md,sha256=1e7ELkK-quwUeOmBDwXodFH-DlnfAcQWj32rjK6Zex4,542
+streamdown/sd.py,sha256=jdMBN1iQ-L-t4h2yjETGS97s-6e50BEFv4C14ToS5AM,44961
+streamdown/ss,sha256=sel_phpaecrw6WGIHRLROsD7BFShf0rSDHheflwdUn8,277
+streamdown/ss1,sha256=CUVf86_2zeAle2oQCeTfWYqtHBrAFR_UgvptuYMQzFU,3151
+streamdown/plugins/README.md,sha256=KWqYELs9WkKJmuDzYv3cvPlZMkArsNCBUe4XDoTLjLA,1143
+streamdown/plugins/latex.py,sha256=xZMGMdx_Sw4X1piZejXFHfEG9qazU4fGeceiMI0h13Y,648
+streamdown-0.33.0.dist-info/METADATA,sha256=Xq6ccpX4MUuXKwXOAVWV09WXuqYdEpTj52-QRVQZB9E,10216
+streamdown-0.33.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+streamdown-0.33.0.dist-info/entry_points.txt,sha256=HroKFsFMGf_h9PRTE96NjvjJQWupMW5TGP5RGUr1O_Q,74
+streamdown-0.33.0.dist-info/licenses/LICENSE.MIT,sha256=SnY46EPirUsF20dZDR8HpyVgS2_4Tjxuc6f-4OdqO7U,1070
+streamdown-0.33.0.dist-info/RECORD,,

streamdown-0.31.0.dist-info/RECORD

@@ -1,9 +0,0 @@
-streamdown/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-streamdown/sd.py,sha256=HE5ajd-afganv6xGuZv6RsCpYgaxY7qk9qB-BAM7nxQ,44599
-streamdown/plugins/README.md,sha256=KWqYELs9WkKJmuDzYv3cvPlZMkArsNCBUe4XDoTLjLA,1143
-streamdown/plugins/latex.py,sha256=xZMGMdx_Sw4X1piZejXFHfEG9qazU4fGeceiMI0h13Y,648
-streamdown-0.31.0.dist-info/METADATA,sha256=tIowHrsBcZyoMCExO0OW61iTEQmQTKEt_FSn6FrMEZQ,9892
-streamdown-0.31.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-streamdown-0.31.0.dist-info/entry_points.txt,sha256=HroKFsFMGf_h9PRTE96NjvjJQWupMW5TGP5RGUr1O_Q,74
-streamdown-0.31.0.dist-info/licenses/LICENSE.MIT,sha256=SnY46EPirUsF20dZDR8HpyVgS2_4Tjxuc6f-4OdqO7U,1070
-streamdown-0.31.0.dist-info/RECORD,,