chatgpt-md-converter 0.3.1__py3-none-any.whl → 0.3.3__py3-none-any.whl

chatgpt_md_converter-0.3.3.dist-info/METADATA

@@ -0,0 +1,170 @@
+Metadata-Version: 2.4
+Name: chatgpt_md_converter
+Version: 0.3.3
+Summary: A package for converting markdown to HTML for chat Telegram bots
+Home-page: https://github.com/Latand/formatter-chatgpt-telegram
+Author: Kostiantyn Kriuchkov
+Author-email: latand666@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+Dynamic: summary
+
+# ChatGPT Markdown to Telegram HTML Parser
+
+## Overview
+
+This project provides a solution for converting Telegram-style Markdown formatted text into HTML markup supported by the Telegram Bot API, specifically tailored for use in ChatGPT bots developed with the OpenAI API. It includes features for handling various Markdown elements and ensures proper tag closure, making it suitable for streaming mode applications.
+
+## Features
+
+- Converts Telegram-style Markdown syntax to Telegram-compatible HTML
+- Supports text styling:
+  - Bold: `**text**` → `<b>text</b>`
+  - Italic: `*text*` or `_text_` → `<i>text</i>`
+  - Underline: `__text__` → `<u>text</u>`
+  - Strikethrough: `~~text~~` → `<s>text</s>`
+  - Spoiler: `||text||` → `<span class="tg-spoiler">text</span>`
+  - Inline code: `` `code` `` → `<code>code</code>`
+- Handles nested text styling
+- Converts links: `[text](URL)` → `<a href="URL">text</a>`
+- Processes code blocks with language specification
+- Supports blockquotes:
+  - Regular blockquotes: `> text` → `<blockquote>text</blockquote>`
+  - Expandable blockquotes: `**> text` → `<blockquote expandable>text</blockquote>`
+- Automatically appends missing closing delimiters for code blocks
+- Escapes HTML special characters to prevent unwanted HTML rendering
+
+## Usage
+
+To use the Markdown to Telegram HTML Parser in your ChatGPT bot, integrate the provided Python functions into your bot's processing pipeline. Here is a brief overview of how to incorporate the parser:
+
+1. **Ensure Closing Delimiters**: Automatically appends missing closing delimiters for backticks to ensure proper parsing.
+
+2. **Extract and Convert Code Blocks**: Extracts Markdown code blocks, converts them to HTML `<pre><code>` format, and replaces them with placeholders to prevent formatting within code blocks.
+
+3. **Markdown to HTML Conversion**: Applies various regex substitutions and custom logic to convert supported Markdown formatting to Telegram-compatible HTML tags.
+
+4. **Reinsert Code Blocks**: Reinserts the previously extracted and converted code blocks back into the main text, replacing placeholders with the appropriate HTML content.
+
+Simply call the `telegram_format(text: str) -> str` function with your Markdown-formatted text as input to receive the converted HTML output ready for use with the Telegram Bot API.
+
+## Installation
+
+```sh
+pip install chatgpt-md-converter
+```
+
+## Example
+
+```python
+from chatgpt_md_converter import telegram_format
+
+# Basic formatting example
+text = """
+Here is some **bold**, __underline__, and `inline code`.
+This is a ||spoiler text|| and *italic*.
+
+Code example:
+print('Hello, world!')
+"""
+
+# Blockquotes example
+blockquote_text = """
+> Regular blockquote
+> Multiple lines
+
+**> Expandable blockquote
+> Hidden by default
+> Multiple lines
+"""
+
+formatted_text = telegram_format(text)
+formatted_blockquote = telegram_format(blockquote_text)
+
+print(formatted_text)
+print(formatted_blockquote)
+```
+
+### Output:
+
+```
+Here is some <b>bold</b>, <u>underline</u>, and <code>inline code</code>.
+This is a <span class="tg-spoiler">spoiler text</span> and <i>italic</i>.
+
+Code example:
+print('Hello, world!')
+
+<blockquote>Regular blockquote
+Multiple lines</blockquote>
+
+<blockquote expandable>Expandable blockquote
+Hidden by default
+Multiple lines</blockquote>
+```
+
+## Requirements
+
+- Python 3.x
+- No external libraries required (uses built-in `re` module for regex operations)
+
+## Contribution
+
+Feel free to contribute to this project by submitting pull requests or opening issues for bugs, feature requests, or improvements.
+
+## Prompting LLMs for Telegram-Specific Formatting
+
+> **Note**:
+> Since standard Markdown doesn't include Telegram-specific features like spoilers (`||text||`) and expandable blockquotes (`**> text`), you'll need to explicitly instruct LLMs to use these formats. Here's a suggested prompt addition to include in your system message or initial instructions:
+
+```
+When formatting your responses for Telegram, please use these special formatting conventions:
+
+1. For content that should be hidden as a spoiler (revealed only when users click):
+   Use: ||spoiler content here||
+   Example: This is visible, but ||this is hidden until clicked||.
+
+2. For lengthy explanations or optional content that should be collapsed:
+   Use: **> Expandable section title
+
+   > Content line 1
+   > Content line 2
+   > (Each line of the expandable blockquote should start with ">")
+
+3. Continue using standard markdown for other formatting:
+   - **bold text**
+   - _italic text_ or _italic text_
+   - **underlined text**
+   - ~~strikethrough~~
+   - `inline code`
+   - `code blocks`
+   - [link text](URL)
+
+Apply spoilers for:
+
+- Solution reveals
+- Potential plot spoilers
+- Sensitive information
+- Surprising facts
+
+Use expandable blockquotes for:
+
+- Detailed explanations
+- Long examples
+- Optional reading
+- Technical details
+- Additional context not needed by all users
+```
+
+You can add this prompt to your system message when initializing your ChatGPT interactions to ensure the model properly formats content for optimal display in Telegram.

{chatgpt_md_converter-0.3.1.dist-info → chatgpt_md_converter-0.3.3.dist-info}/RECORD

@@ -4,8 +4,8 @@ chatgpt_md_converter/extractors.py,sha256=RNwo57_6jCe-HoX5eCvvZcjSTc2uPax-6QEtXq
 chatgpt_md_converter/formatters.py,sha256=UbjRG7bLETIGDaFDbFybwW8dKYBMDmgLmIasJiw_j60,2304
 chatgpt_md_converter/helpers.py,sha256=2Nc9_s0HcLq79mBt7Hje19LzbO6z9mUNgayoMyWkIhI,874
 chatgpt_md_converter/telegram_formatter.py,sha256=L0ESIY1AOuRXdIto2lWR38zuYuIwlLBScGINMrm8VVk,4091
-chatgpt_md_converter-0.3.1.dist-info/licenses/LICENSE,sha256=SDr2jeP-s2g4vf17-jdLXrrqA4_mU7L_RtSJlv4Y2mk,1077
-chatgpt_md_converter-0.3.1.dist-info/METADATA,sha256=Oz1UdVaAe77WGG5AtJQQybJh5c2TjFD92fn9do7-N88,3718
-chatgpt_md_converter-0.3.1.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-chatgpt_md_converter-0.3.1.dist-info/top_level.txt,sha256=T2o7csVtZgr-Pwm83aSUkZn0humJmDFNqW38tRSsNqw,21
-chatgpt_md_converter-0.3.1.dist-info/RECORD,,
+chatgpt_md_converter-0.3.3.dist-info/licenses/LICENSE,sha256=SDr2jeP-s2g4vf17-jdLXrrqA4_mU7L_RtSJlv4Y2mk,1077
+chatgpt_md_converter-0.3.3.dist-info/METADATA,sha256=K4b1syQlvWh319Usada0rdP0ds0tYUkvKbn_r9-Z80w,5796
+chatgpt_md_converter-0.3.3.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+chatgpt_md_converter-0.3.3.dist-info/top_level.txt,sha256=T2o7csVtZgr-Pwm83aSUkZn0humJmDFNqW38tRSsNqw,21
+chatgpt_md_converter-0.3.3.dist-info/RECORD,,

chatgpt_md_converter-0.3.1.dist-info/METADATA

@@ -1,109 +0,0 @@
-Metadata-Version: 2.4
-Name: chatgpt_md_converter
-Version: 0.3.1
-Summary: A package for converting markdown to HTML for chat Telegram bots
-Home-page: https://github.com/Latand/formatter-chatgpt-telegram
-Author: Kostiantyn Kriuchkov
-Author-email: latand666@gmail.com
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: requires-python
-Dynamic: summary
-
-# ChatGPT Markdown to Telegram HTML Parser
-
-## Overview
-
-This project provides a solution for converting Markdown formatted text into HTML markup supported by the Telegram Bot API, specifically tailored for use in ChatGPT bots developed with the OpenAI API. It includes features for handling various Markdown elements and ensures proper tag closure, making it suitable for streaming mode applications.
-
-## Features
-
-- Converts Markdown syntax to Telegram-compatible HTML.
-- Supports inline code, bold, italic, underline, and strikethrough formatting.
-- Supports spoiler tags with `||text||` syntax.
-- Handles nested bold and italic formatting.
-- Converts Markdown links and lists to their HTML equivalents.
-- Processes code blocks with optional language specification, preserving formatting within `<pre><code>` tags.
-- Supports regular blockquotes (`>`) and expandable blockquotes (`**>`) for Telegram.
-- Automatically appends missing closing delimiters for code blocks.
-- Escapes HTML special characters to prevent unwanted HTML rendering outside code blocks.
-
-## Usage
-
-To use the Markdown to Telegram HTML Parser in your ChatGPT bot, integrate the provided Python functions into your bot's processing pipeline. Here is a brief overview of how to incorporate the parser:
-
-1. **Ensure Closing Delimiters**: Automatically appends missing closing delimiters for `` ` `` and ` ` ``` to ensure proper parsing.
-
-2. **Extract and Convert Code Blocks**: Extracts Markdown code blocks, converts them to HTML `<pre><code>` format, and replaces them with placeholders to prevent formatting within code blocks.
-
-3. **Markdown to HTML Conversion**: Applies various regex substitutions and custom logic to convert supported Markdown formatting to Telegram-compatible HTML tags.
-
-4. **Reinsert Code Blocks**: Reinserts the previously extracted and converted code blocks back into the main text, replacing placeholders with the appropriate HTML content.
-
-Simply call the `telegram_format(text: str) -> str` function with your Markdown-formatted text as input to receive the converted HTML output ready for use with the Telegram Bot API.
-
-## Installation
-
-You can install the package using pip:
-
-```sh
-pip install chatgpt-md-converter
-```
-
-## Example
-
-````python
-from chatgpt_md_converter import telegram_format
-
-# Basic formatting
-text = """
-Here is some **bold**, __underline__, and `inline code`.
-This is a ||spoiler text||.
-
-```python
-print('Hello, world!')
-````
-
-"""
-
-# Blockquotes
-
-blockquote_text = """
-
-> Regular blockquote
-> Multiple lines
-
-\*\*>Expandable blockquote
-
-> Hidden by default
-> Multiple lines
-> """
-
-formatted_text = telegram_format(text)
-formatted_blockquote = telegram_format(blockquote_text)
-
-print(formatted_text)
-print(formatted_blockquote)
-
-```
-
-## Requirements
-
-- Python 3.x
-- No external libraries required (uses built-in `re` module for regex operations)
-
-## Contribution
-
-Feel free to contribute to this project by submitting pull requests or opening issues for bugs, feature requests, or improvements.
-```