pytpro 0.2.4__tar.gz → 0.2.7__tar.gz

{pytpro-0.2.4 → pytpro-0.2.7}/PKG-INFO

@@ -1,21 +1,25 @@
 Metadata-Version: 2.4
 Name: pytpro
-Version: 0.2.4
-Summary: A simple Python tools package by Ibrahim Akhlaq
+Version: 0.2.7
+Summary: Lightweight Python library for math, randomness, HTML, Markdown, CSS, and JS rendering — clean and minimal.
 Author: Ibrahim Akhlaq
 Author-email: ibakhlaq@gmail.com
+Keywords: python,tools,utilities,python tools,python utilities,math,random,utility,mathematics,randomness,random number,random numbers,random number generator,random number generators,random number generators python,html,css,javascript,markdown,markdown preview,markdown previewer,markdown previewer python
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Requires-Python: >=3.6
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: tkhtmlview
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
 Dynamic: description
 Dynamic: description-content-type
+Dynamic: keywords
 Dynamic: license-file
+Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
@@ -23,12 +27,38 @@ Dynamic: summary
   <img src="https://i.postimg.cc/BjSmyvYv/download.png" width="200" alt="pytpro logo">
 </p>
 
-
-<h1 align="center">Pytpro</h1>
+<p align="center">
+  <img src="https://i.postimg.cc/s2PM4pyd/pyt.png" width="140" alt="pytpro heading">
+</p>
 
 **pytpro** is a lightweight Python package by Ibrahim Akhlaq that provides powerful utility functions for math, randomness, and HTML rendering. It's clean, minimal, and built to feel like magic.
 ---
+
+# 🖥️ Example Usage
+
+```python
+import pytpro
+
+pytpro.add(2, 3)
+pytpro.square(6)
+pytpro.pi()
+pytpro.htmlcssjs("<h1>Hello!</h1><p>This is raw HTML.</p>")
+```
+
+# 🖥️ Instructions to install:
+
+To install locally from your project directory, open PowerShell or terminal and run:
+
+```bash
+pip install pytpro
+```
+
 # API REFERENCE
+
+- disclaimer: Some of the output examples in the API reference cannot be rendered in PYPI, so screenshots of the actual results were provided. Keep in mind that the output may differ slightly from the actual results, as I had to resize the images in some cases.
+
+---
+
 ## 🚀 Features
 ### ➕ Math Functions:
 - `add(a, b):`
@@ -179,7 +209,7 @@ py.caption("Hello World!")
 ```HTML
 <p style='font-size: 0.9em; color: gray;'>Hello World!</p>
 ```
-- <p style='font-size: 0.9em; color: gray;'>Hello World!</p>
+<p align="left"><img src='https://i.postimg.cc/hjRzR2D5/caption.png' width='90' alt='Hello World!'></p>
 
 ### `htmlcssjs(html_fragment)`
 You can use the `htmlcssjs()` function to render raw HTML, CSS, and Javascript code.
@@ -190,6 +220,9 @@ py.htmlcssjs("""
 <style>
 button {
     background-color: red;
+    border: none;
+    border-radius: 4px;
+    padding: 15px 32px;
     color: white;
 }
 </style>
@@ -208,6 +241,9 @@ button {
 <style>
 button {
     background-color: red;
+    border: none;
+    border-radius: 4px;
+    padding: 15px 32px;
     color: white;
 }
 </style>
@@ -220,14 +256,9 @@ button {
   }
 </script>
 ```
-- <style>
-button {
-    background-color: red;
-    color: white;
-}
-</style>
-<button onclick='click()'>Hello World!</button>
-<p id="output">{javascript is not supported in PYPI}</p>
+<p>
+<img src="https://i.postimg.cc/NfyFK8rf/pypi2.png" width="230" alt="button">
+</p>
 
 ### Alert Boxes
 #### `alertbox_red(text)`
@@ -302,37 +333,14 @@ This is a paragraph with **bold**, *italic*, and `inline code`.
 <h1> Hello World!</h1>
 <p>This is a paragraph with <strong>bold</strong>, <em>italic</em>, and <code>inline code</code>.</p>
 ```
-- <p style="font-size: 30px;font-weight: 2905; ">Hello World!</p>
-
-  This is a paragraph with **bold**, *italic*, and `inline code`.
+- <h1>Hello World!</h1>
+  <p> This is a paragraph with <strong>bold</strong>, <em>italic</em>, and <code>inline code</code>.</p>
 
 For more information about Markdown formatting and its syntax, see the [Markdown documentation](https://www.markdownguide.org/), [cheat sheet](https://www.markdownguide.org/cheat-sheet/), [basic syntax](https://www.markdownguide.org/basic-syntax/), or [extended syntax](https://www.markdownguide.org/extended-syntax/).
 ---
-<p style="text-align: center !important;
-           font-size: 50px;
-              color: #838383ff;
-              font-weight: bold;
-              font-family: sans-serif;
-              text-align: center ">Pytpro</p>
-
-# 🖥️ Example Usage
-
-```python
-import pytpro
 
-pytpro.add(2, 3)
-pytpro.square(6)
-pytpro.pi()
-pytpro.htmlcssjs("<h1>Hello!</h1><p>This is raw HTML.</p>")
-```
-
-# 🖥️ Instructions to install:
-
-To install locally from your project directory, open PowerShell or terminal and run:
+<h1 align="center">Pytpro</h1>
 
-```bash
-pip install pytpro
-```
 <pre>
  _______  ___    ___ ________  _______    _________    ________
 |   ___  \\  \  /  /|__    __||   ___  \ |   ___   | /  ______  \

{pytpro-0.2.4 → pytpro-0.2.7}/README.md

@@ -2,12 +2,38 @@
   <img src="https://i.postimg.cc/BjSmyvYv/download.png" width="200" alt="pytpro logo">
 </p>
 
-
-<h1 align="center">Pytpro</h1>
+<p align="center">
+  <img src="https://i.postimg.cc/s2PM4pyd/pyt.png" width="140" alt="pytpro heading">
+</p>
 
 **pytpro** is a lightweight Python package by Ibrahim Akhlaq that provides powerful utility functions for math, randomness, and HTML rendering. It's clean, minimal, and built to feel like magic.
 ---
+
+# 🖥️ Example Usage
+
+```python
+import pytpro
+
+pytpro.add(2, 3)
+pytpro.square(6)
+pytpro.pi()
+pytpro.htmlcssjs("<h1>Hello!</h1><p>This is raw HTML.</p>")
+```
+
+# 🖥️ Instructions to install:
+
+To install locally from your project directory, open PowerShell or terminal and run:
+
+```bash
+pip install pytpro
+```
+
 # API REFERENCE
+
+- disclaimer: Some of the output examples in the API reference cannot be rendered in PYPI, so screenshots of the actual results were provided. Keep in mind that the output may differ slightly from the actual results, as I had to resize the images in some cases.
+
+---
+
 ## 🚀 Features
 ### ➕ Math Functions:
 - `add(a, b):`
@@ -158,7 +184,7 @@ py.caption("Hello World!")
 ```HTML
 <p style='font-size: 0.9em; color: gray;'>Hello World!</p>
 ```
-- <p style='font-size: 0.9em; color: gray;'>Hello World!</p>
+<p align="left"><img src='https://i.postimg.cc/hjRzR2D5/caption.png' width='90' alt='Hello World!'></p>
 
 ### `htmlcssjs(html_fragment)`
 You can use the `htmlcssjs()` function to render raw HTML, CSS, and Javascript code.
@@ -169,6 +195,9 @@ py.htmlcssjs("""
 <style>
 button {
     background-color: red;
+    border: none;
+    border-radius: 4px;
+    padding: 15px 32px;
     color: white;
 }
 </style>
@@ -187,6 +216,9 @@ button {
 <style>
 button {
     background-color: red;
+    border: none;
+    border-radius: 4px;
+    padding: 15px 32px;
     color: white;
 }
 </style>
@@ -199,14 +231,9 @@ button {
   }
 </script>
 ```
-- <style>
-button {
-    background-color: red;
-    color: white;
-}
-</style>
-<button onclick='click()'>Hello World!</button>
-<p id="output">{javascript is not supported in PYPI}</p>
+<p>
+<img src="https://i.postimg.cc/NfyFK8rf/pypi2.png" width="230" alt="button">
+</p>
 
 ### Alert Boxes
 #### `alertbox_red(text)`
@@ -281,37 +308,14 @@ This is a paragraph with **bold**, *italic*, and `inline code`.
 <h1> Hello World!</h1>
 <p>This is a paragraph with <strong>bold</strong>, <em>italic</em>, and <code>inline code</code>.</p>
 ```
-- <p style="font-size: 30px;font-weight: 2905; ">Hello World!</p>
-
-  This is a paragraph with **bold**, *italic*, and `inline code`.
+- <h1>Hello World!</h1>
+  <p> This is a paragraph with <strong>bold</strong>, <em>italic</em>, and <code>inline code</code>.</p>
 
 For more information about Markdown formatting and its syntax, see the [Markdown documentation](https://www.markdownguide.org/), [cheat sheet](https://www.markdownguide.org/cheat-sheet/), [basic syntax](https://www.markdownguide.org/basic-syntax/), or [extended syntax](https://www.markdownguide.org/extended-syntax/).
 ---
-<p style="text-align: center !important;
-           font-size: 50px;
-              color: #838383ff;
-              font-weight: bold;
-              font-family: sans-serif;
-              text-align: center ">Pytpro</p>
-
-# 🖥️ Example Usage
-
-```python
-import pytpro
 
-pytpro.add(2, 3)
-pytpro.square(6)
-pytpro.pi()
-pytpro.htmlcssjs("<h1>Hello!</h1><p>This is raw HTML.</p>")
-```
-
-# 🖥️ Instructions to install:
-
-To install locally from your project directory, open PowerShell or terminal and run:
+<h1 align="center">Pytpro</h1>
 
-```bash
-pip install pytpro
-```
 <pre>
  _______  ___    ___ ________  _______    _________    ________
 |   ___  \\  \  /  /|__    __||   ___  \ |   ___   | /  ______  \

{pytpro-0.2.4 → pytpro-0.2.7}/pytpro/__init__.py

@@ -75,7 +75,7 @@ __all__ = [
     "markdown",
 ]
 
-__version__ = "0.2.4"
+__version__ = "0.2.7"
 __copyright__ = "Copyright (c) 2023 Ibrahim Akhlaq"
 __credits__ = ["Ibrahim Akhlaq"]
 __maintainer__ = "Ibrahim Akhlaq"

pytpro-0.2.7/pytpro/markdown.py

@@ -0,0 +1,342 @@
+import re
+from main import htmlcssjs as html
+import html as html_lib
+
+_css_injected = False
+
+def markdown(md_text: str):
+    global _css_injected
+    if not _css_injected:
+        html("""
+        <style>
+            pre code, code, pre, blockquote, table, th, td {
+                border: 1px solid #ccc;
+            }
+            pre, code, pre code {
+                background-color: #efefef !important;
+                border-radius: 4px;
+                font-family: monospace;
+                font-size: 0.95em;
+                overflow-x: auto;
+                border: none !important;
+            }
+            .hljs {
+                display: block;
+                overflow-x: auto;
+                padding: 10px 16px;
+                background: #efefef;
+                color: #333;
+                border-radius: 4px;
+                margin: 16px 0;
+            }
+            pre {
+                background-color: #efefef !important;
+                margin: 0 0 17px 0;
+            }
+            code {
+                padding: 2px 6px;
+            }
+            blockquote {
+                position: relative;
+                padding: 12px 16px 12px 24px;
+                background-color: #efefef;
+                border-radius: 4px;
+                color: #333;
+                font-size: 17px;
+                margin: 16px 0;
+            }
+            blockquote::before {
+                content: '';
+                position: absolute;
+                top: 0;
+                bottom: 0;
+                left: 0;
+                width: 6px;
+                background-color: #595959;
+                border-radius: 4px;
+            }
+            ul, ol, p, blockquote, table {
+                margin-bottom: 12px;
+            }
+            table {
+                border-collapse: collapse;
+                width: 100%;
+            }
+            th, td {
+                padding: 6px 12px;
+                text-align: left;
+            }
+        </style>
+        <link rel="stylesheet"
+              href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/styles/github.min.css">
+        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/highlight.min.js"></script>
+        <script>setTimeout(() => hljs.highlightAll(), 100);</script>
+        """)
+        _css_injected = True
+
+    # --- Sanitize Input ---
+    md_text = html_lib.unescape(md_text)
+
+    # Remove dangerous tags and attributes (same as before)
+    md_text = re.sub(r'<\s*script[^>]*?>.*?<\s*/\s*script\s*>', '', md_text, flags=re.DOTALL | re.IGNORECASE)
+    md_text = re.sub(r'<\s*/?\s*script[^>]*?>', '', md_text, flags=re.IGNORECASE)
+    md_text = re.sub(r'<\s*(iframe|object|embed|svg)[^>]*?>.*?<\s*/\s*\1\s*>', '', md_text, flags=re.DOTALL | re.IGNORECASE)
+    md_text = re.sub(r'<\s*/?\s*(iframe|object|embed|svg)[^>]*?>', '', md_text, flags=re.IGNORECASE)
+    md_text = re.sub(r'\son\w+\s*=\s*"[^"]*"', '', md_text, flags=re.IGNORECASE)
+    md_text = re.sub(r"\son\w+\s*=\s*'[^']*'", '', md_text, flags=re.IGNORECASE)
+    md_text = re.sub(r'(["\'])\s*javascript:[^"\']*\1', r'\1\1', md_text, flags=re.IGNORECASE)
+    md_text = re.sub(r'(["\'])\s*data:[^"\']*\1', r'\1\1', md_text, flags=re.IGNORECASE)
+
+    lines = md_text.strip('\n').split('\n')
+
+    # States
+    in_code_block = False
+    code_block = []
+    language = 'plaintext'
+
+    list_stack = []  # stack of ('ul' or 'ol', indent_level)
+    table_rows = []
+    in_table = False
+    html_out = []
+
+    def close_all_lists(min_indent=0):
+        # Close lists in stack with indent >= min_indent
+        while list_stack and list_stack[-1][1] >= min_indent:
+            tag, _ = list_stack.pop()
+            html_out.append(f'</{tag}>')
+
+    def close_table():
+        nonlocal in_table, table_rows
+        if in_table:
+            if len(table_rows) > 1:
+                header = table_rows[0]
+                align_line = table_rows[1]
+
+                aligns = []
+                # Parse alignment row
+                for cell in [c.strip() for c in align_line.split('|')]:
+                    if cell.startswith(':') and cell.endswith(':'):
+                        aligns.append('center')
+                    elif cell.startswith(':'):
+                        aligns.append('left')
+                    elif cell.endswith(':'):
+                        aligns.append('right')
+                    else:
+                        aligns.append(None)
+
+                table_rows.pop(1)  # Remove align row
+
+                # Build table html
+                html_out.append('<table>')
+                html_out.append('<thead><tr>')
+                header_cells = [c.strip() for c in header.split('|')]
+                for i, cell in enumerate(header_cells):
+                    align_attr = f' style="text-align:{aligns[i]}"' if i < len(aligns) and aligns[i] else ''
+                    html_out.append(f'<th{align_attr}>{cell}</th>')
+                html_out.append('</tr></thead><tbody>')
+
+                for row in table_rows[1:]:
+                    html_out.append('<tr>')
+                    cells = [c.strip() for c in row.split('|')]
+                    # Pad cells if missing
+                    while len(cells) < len(header_cells):
+                        cells.append('')
+                    for i, cell in enumerate(cells):
+                        align_attr = f' style="text-align:{aligns[i]}"' if i < len(aligns) and aligns[i] else ''
+                        html_out.append(f'<td{align_attr}>{cell}</td>')
+                    html_out.append('</tr>')
+                html_out.append('</tbody></table>')
+            else:
+                # Not a valid table, output rows as paragraphs
+                for row in table_rows:
+                    html_out.append(f'<p>{row}</p>')
+            table_rows = []
+            in_table = False
+
+    def inline_format(text):
+        # Escape HTML
+        from html import escape
+        text = escape(text)
+
+        # Escaping markdown chars with backslash
+        text = re.sub(r'\\([\\`\*_\{\}\[\]\(\)#\+\-\.\!~>])', r'\1', text)
+
+        # Links: [text](url "optional title")
+        # Support optional title in quotes
+        def repl_link(m):
+            text, url, title = m.group(1), m.group(2), m.group(4)
+            title_attr = f' title="{escape(title)}"' if title else ''
+            url = url.strip()
+            return f'<a href="{escape(url)}"{title_attr} target="_blank" rel="noopener noreferrer">{text}</a>'
+
+        text = re.sub(r'\[([^\]]+)\]\(\s*([^\s\)]+)(\s+"([^"]+)")?\s*\)', repl_link, text)
+
+        # Images: ![alt](url "optional title")
+        def repl_img(m):
+            alt, url, title = m.group(1), m.group(2), m.group(4)
+            title_attr = f' title="{escape(title)}"' if title else ''
+            return f'<img src="{escape(url.strip())}" alt="{escape(alt)}"{title_attr} />'
+
+        text = re.sub(r'!\[([^\]]*)\]\(\s*([^\s\)]+)(\s+"([^"]+)")?\s*\)', repl_img, text)
+
+        # Strikethrough
+        text = re.sub(r'~~(.*?)~~', r'<del>\1</del>', text)
+
+        # Bold + Italic (***text***)
+        text = re.sub(r'\*\*\*(.+?)\*\*\*', r'<strong><em>\1</em></strong>', text)
+
+        # Bold (**text**)
+        text = re.sub(r'\*\*(.+?)\*\*', r'<strong>\1</strong>', text)
+
+        # Italic (*text*)
+        text = re.sub(r'\*(.+?)\*', r'<em>\1</em>', text)
+
+        # Inline code (`code`)
+        text = re.sub(r'`(.+?)`', r'<code>\1</code>', text)
+
+        # Convert two spaces at line end into <br>
+        text = re.sub(r'  $', r'<br>', text)
+
+        return text
+    blockquote_level = 0
+    paragraph_lines = []
+
+    def flush_paragraph():
+        nonlocal paragraph_lines
+        if paragraph_lines:
+            html_out.append(f'<p>{" ".join(paragraph_lines)}</p>')
+            paragraph_lines = []
+
+    for idx, line in enumerate(lines):
+        line_rstrip = line.rstrip('\r\n')
+
+        # Code block toggle
+        if line_rstrip.startswith("```"):
+            flush_paragraph()
+            close_all_lists()
+            close_table()
+            if not in_code_block:
+                in_code_block = True
+                language = line_rstrip[3:].strip()
+                code_block = []
+            else:
+                from html import escape
+                code_html = escape('\n'.join(code_block))
+                html_out.append(f'<pre><code class="hljs language-{language}">{code_html}</code></pre>')
+                in_code_block = False
+            continue
+        # Inside your main loop, replace this blockquote handling part:
+
+        m = re.match(r'^(>+)\s+(.*)', line)
+        if m:
+            flush_paragraph()
+            close_all_lists()
+            close_table()
+            new_level = len(m.group(1))
+            content = inline_format(m.group(2).strip())
+
+            # Adjust blockquote level:
+            while blockquote_level < new_level:
+                html_out.append('<blockquote>')
+                blockquote_level += 1
+            while blockquote_level > new_level:
+                html_out.append('</blockquote>')
+                blockquote_level -= 1
+            
+            html_out.append(content)
+            continue
+        else:
+            # Close all blockquotes if we leave blockquote lines
+            while blockquote_level > 0:
+                html_out.append('</blockquote>')
+                blockquote_level -= 1
+        # Tables
+        if re.match(r'^\s*\|.*\|\s*$', line):
+            flush_paragraph()
+            if not in_table:
+                close_all_lists()
+                in_table = True
+                table_rows = []
+            table_rows.append(line.strip())
+            continue
+        else:
+            if in_table:
+                flush_paragraph()
+                close_table()
+
+        # Horizontal rules
+        if re.match(r'^([\*\-_]\s?){3,}$', line.strip()):
+            flush_paragraph()
+            close_all_lists()
+            close_table()
+            html_out.append('<hr>')
+            continue
+
+        # Headings
+        m = re.match(r'^(#{1,6})\s+(.*)', line)
+        if m:
+            flush_paragraph()
+            close_all_lists()
+            close_table()
+            level = len(m.group(1))
+            content = inline_format(m.group(2).strip())
+            html_out.append(f'<h{level}>{content}</h{level}>')
+            continue
+
+        # Ordered list detection with indentation for nesting
+        m = re.match(r'^(\s*)(\d+)\.\s+(.*)', line)
+        if m:
+            flush_paragraph()
+            close_table()
+            indent = len(m.group(1).replace('\t', '    '))
+            # Close lists with indent >= current
+            close_all_lists(min_indent=indent)
+            if not list_stack or list_stack[-1][0] != 'ol' or list_stack[-1][1] < indent:
+                html_out.append('<ol>')
+                list_stack.append(('ol', indent))
+            item_text = inline_format(m.group(3).strip())
+            html_out.append(f'<li>{item_text}</li>')
+            continue
+
+        # Unordered list detection with indentation for nesting
+        m = re.match(r'^(\s*)[-*+]\s+(.*)', line)
+        if m:
+            flush_paragraph()
+            close_table()
+            indent = len(m.group(1).replace('\t', '    '))
+            close_all_lists(min_indent=indent)
+            if not list_stack or list_stack[-1][0] != 'ul' or list_stack[-1][1] < indent:
+                html_out.append('<ul>')
+                list_stack.append(('ul', indent))
+
+            item_text = inline_format(m.group(2).strip())
+
+            # Task list support
+            task_match = re.match(r'^\[( |x|X)\]\s+(.*)', item_text)
+            if task_match:
+                checked = 'checked' if task_match.group(1).lower() == 'x' else ''
+                item_text = task_match.group(2)
+                html_out.append(f'<li><input type="checkbox" disabled {checked}/> {item_text}</li>')
+            else:
+                html_out.append(f'<li>{item_text}</li>')
+            continue
+
+        # Not list, close any open lists at this indent
+        close_all_lists()
+
+        # ... inside your main loop, instead of the old paragraph handling:
+
+        if not line.strip():
+            flush_paragraph()
+        else:
+            paragraph_lines.append(inline_format(line.strip()))
+
+        # Also, before any block elements (headings, lists, blockquotes, code blocks, tables, horizontal rules),
+        # call flush_paragraph() to close any open paragraph.
+
+        # At the very end of the loop, after processing all lines, call:
+    flush_paragraph()
+    close_all_lists()
+    close_table()
+
+    html('\n'.join(html_out))

{pytpro-0.2.4 → pytpro-0.2.7}/pytpro.egg-info/PKG-INFO

@@ -1,21 +1,25 @@
 Metadata-Version: 2.4
 Name: pytpro
-Version: 0.2.4
-Summary: A simple Python tools package by Ibrahim Akhlaq
+Version: 0.2.7
+Summary: Lightweight Python library for math, randomness, HTML, Markdown, CSS, and JS rendering — clean and minimal.
 Author: Ibrahim Akhlaq
 Author-email: ibakhlaq@gmail.com
+Keywords: python,tools,utilities,python tools,python utilities,math,random,utility,mathematics,randomness,random number,random numbers,random number generator,random number generators,random number generators python,html,css,javascript,markdown,markdown preview,markdown previewer,markdown previewer python
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Requires-Python: >=3.6
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: tkhtmlview
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
 Dynamic: description
 Dynamic: description-content-type
+Dynamic: keywords
 Dynamic: license-file
+Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
@@ -23,12 +27,38 @@ Dynamic: summary
   <img src="https://i.postimg.cc/BjSmyvYv/download.png" width="200" alt="pytpro logo">
 </p>
 
-
-<h1 align="center">Pytpro</h1>
+<p align="center">
+  <img src="https://i.postimg.cc/s2PM4pyd/pyt.png" width="140" alt="pytpro heading">
+</p>
 
 **pytpro** is a lightweight Python package by Ibrahim Akhlaq that provides powerful utility functions for math, randomness, and HTML rendering. It's clean, minimal, and built to feel like magic.
 ---
+
+# 🖥️ Example Usage
+
+```python
+import pytpro
+
+pytpro.add(2, 3)
+pytpro.square(6)
+pytpro.pi()
+pytpro.htmlcssjs("<h1>Hello!</h1><p>This is raw HTML.</p>")
+```
+
+# 🖥️ Instructions to install:
+
+To install locally from your project directory, open PowerShell or terminal and run:
+
+```bash
+pip install pytpro
+```
+
 # API REFERENCE
+
+- disclaimer: Some of the output examples in the API reference cannot be rendered in PYPI, so screenshots of the actual results were provided. Keep in mind that the output may differ slightly from the actual results, as I had to resize the images in some cases.
+
+---
+
 ## 🚀 Features
 ### ➕ Math Functions:
 - `add(a, b):`
@@ -179,7 +209,7 @@ py.caption("Hello World!")
 ```HTML
 <p style='font-size: 0.9em; color: gray;'>Hello World!</p>
 ```
-- <p style='font-size: 0.9em; color: gray;'>Hello World!</p>
+<p align="left"><img src='https://i.postimg.cc/hjRzR2D5/caption.png' width='90' alt='Hello World!'></p>
 
 ### `htmlcssjs(html_fragment)`
 You can use the `htmlcssjs()` function to render raw HTML, CSS, and Javascript code.
@@ -190,6 +220,9 @@ py.htmlcssjs("""
 <style>
 button {
     background-color: red;
+    border: none;
+    border-radius: 4px;
+    padding: 15px 32px;
     color: white;
 }
 </style>
@@ -208,6 +241,9 @@ button {
 <style>
 button {
     background-color: red;
+    border: none;
+    border-radius: 4px;
+    padding: 15px 32px;
     color: white;
 }
 </style>
@@ -220,14 +256,9 @@ button {
   }
 </script>
 ```
-- <style>
-button {
-    background-color: red;
-    color: white;
-}
-</style>
-<button onclick='click()'>Hello World!</button>
-<p id="output">{javascript is not supported in PYPI}</p>
+<p>
+<img src="https://i.postimg.cc/NfyFK8rf/pypi2.png" width="230" alt="button">
+</p>
 
 ### Alert Boxes
 #### `alertbox_red(text)`
@@ -302,37 +333,14 @@ This is a paragraph with **bold**, *italic*, and `inline code`.
 <h1> Hello World!</h1>
 <p>This is a paragraph with <strong>bold</strong>, <em>italic</em>, and <code>inline code</code>.</p>
 ```
-- <p style="font-size: 30px;font-weight: 2905; ">Hello World!</p>
-
-  This is a paragraph with **bold**, *italic*, and `inline code`.
+- <h1>Hello World!</h1>
+  <p> This is a paragraph with <strong>bold</strong>, <em>italic</em>, and <code>inline code</code>.</p>
 
 For more information about Markdown formatting and its syntax, see the [Markdown documentation](https://www.markdownguide.org/), [cheat sheet](https://www.markdownguide.org/cheat-sheet/), [basic syntax](https://www.markdownguide.org/basic-syntax/), or [extended syntax](https://www.markdownguide.org/extended-syntax/).
 ---
-<p style="text-align: center !important;
-           font-size: 50px;
-              color: #838383ff;
-              font-weight: bold;
-              font-family: sans-serif;
-              text-align: center ">Pytpro</p>
-
-# 🖥️ Example Usage
-
-```python
-import pytpro
 
-pytpro.add(2, 3)
-pytpro.square(6)
-pytpro.pi()
-pytpro.htmlcssjs("<h1>Hello!</h1><p>This is raw HTML.</p>")
-```
-
-# 🖥️ Instructions to install:
-
-To install locally from your project directory, open PowerShell or terminal and run:
+<h1 align="center">Pytpro</h1>
 
-```bash
-pip install pytpro
-```
 <pre>
  _______  ___    ___ ________  _______    _________    ________
 |   ___  \\  \  /  /|__    __||   ___  \ |   ___   | /  ______  \

{pytpro-0.2.4 → pytpro-0.2.7}/pytpro.egg-info/SOURCES.txt

@@ -7,4 +7,5 @@ pytpro/markdown.py
 pytpro.egg-info/PKG-INFO
 pytpro.egg-info/SOURCES.txt
 pytpro.egg-info/dependency_links.txt
+pytpro.egg-info/requires.txt
 pytpro.egg-info/top_level.txt

pytpro-0.2.7/pytpro.egg-info/requires.txt

@@ -0,0 +1 @@
+tkhtmlview

pytpro-0.2.7/setup.py

@@ -0,0 +1,51 @@
+from setuptools import setup, find_packages
+import sys
+
+if sys.version_info < (3, 6):
+    print("❌ To use this module, you need Python 3.6 or newer.")
+    sys.exit(1)
+
+with open("README.md", encoding="utf-8") as f:
+    long_description = f.read()
+
+setup(
+    name="pytpro",
+    version="0.2.7",
+    description="Lightweight Python library for math, randomness, HTML, Markdown, CSS, and JS rendering — clean and minimal.",
+    long_description= long_description,
+    long_description_content_type="text/markdown",
+    author="Ibrahim Akhlaq",
+    author_email="ibakhlaq@gmail.com",
+    packages=find_packages(),
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires=">=3.6",
+    install_requires=[
+        "tkhtmlview",
+    ],
+    keywords=["python",
+               "tools",
+                "utilities",
+                "python tools",
+                "python utilities",
+                "math",
+                "random",
+                "utility",
+                "mathematics",
+                "randomness",
+                "random number",
+                "random numbers",
+                "random number generator",
+                "random number generators",
+                "random number generators python",
+                "html",
+                "css",
+                "javascript",
+                "markdown",
+                "markdown preview",
+                "markdown previewer",
+                "markdown previewer python",]
+)

pytpro-0.2.4/pytpro/markdown.py

@@ -1,179 +0,0 @@
-import re
-from main import htmlcssjs as html
-
-_css_injected = False
-
-def markdown(md_text: str):
-    global _css_injected
-    if not _css_injected:
-        html("""
-        <style>
-            pre code, code, pre, blockquote {
-                border: 1px;
-            }
-            pre, code, pre code {
-                background-color: #efefef !important;
-                border: 0px solid rgba(128, 128, 128, 0.2);
-                border-radius: 4px;
-                font-family: monospace;
-                font-size: 0.95em;
-                overflow-x: auto;
-            }
-            .hljs {
-                display: block;
-                overflow-x: auto;
-                padding: 10px 16px;
-                background: #efefef;
-                color: #333;
-                border-radius: 4px;
-                margin: 16px 0;
-            }
-            pre code {
-                background-color: transparent !important;
-                border: none !important;
-            }
-            pre {
-                background-color: #efefef !important;
-                margin: 0;
-                margin-bottom: 17px;
-                margin-top: 17px;
-            }
-            code {
-                padding: 2px 6px;
-            }
-            blockquote {
-                position: relative;
-                padding: 12px 16px 12px 24px;
-                background-color: #efefef;
-                border-radius: 4px;
-                color: #333;
-                font-size: 17px;
-                margin: 16px 0;
-            }
-
-            blockquote::before {
-                content: '';
-                position: absolute;
-                top: 0;
-                bottom: 0;
-                left: 0;
-                width: 6px;
-                background-color: #595959;
-                border-radius: 4px;
-            }
-
-            ul, p, blockquote {
-                margin-bottom: 12px;
-            }
-        </style>
-        <link rel="stylesheet"
-              href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/styles/github.min.css">
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/highlight.min.js"></script>
-        <script>setTimeout(() => hljs.highlightAll(), 100);</script>
-        """)
-        _css_injected = True
-
-    lines = md_text.strip().split('\n')
-    in_code_block = False
-    in_list = False
-    code_block = []
-    html_out = []
-    language = ''
-
-    def close_list():
-        nonlocal in_list
-        if in_list:
-            html_out.append('</ul>')
-            in_list = False
-
-    for line in lines:
-        line = line.rstrip()
-
-        # Code block toggle
-        if line.startswith("```"):
-            if not in_code_block:
-                in_code_block = True
-                language = line[3:].strip()
-                code_block = []
-            else:
-                from html import escape
-
-                code_html = escape('\n'.join(code_block))
-                html_out.append(f'<pre><code class="hljs language-{language}">{code_html}</code></pre>')
-
-                in_code_block = False
-            continue
-
-        if in_code_block:
-            code_block.append(line)
-            continue
-
-        # Horizontal rules
-        if re.match(r'^([\*\-_]\s?){3,}$', line.strip()):
-            close_list()
-            html_out.append('<hr>')
-            continue
-
-        # Headings
-        if re.match(r'^#{1,6} ', line):
-            close_list()
-            level = len(line.split(' ')[0])
-            content = line[level+1:].strip()
-            html_out.append(f"<h{level}>{content}</h{level}>")
-            continue
-
-        # Blockquotes
-        if line.startswith('> '):
-            close_list()
-            content = line[2:].strip()
-            html_out.append(f"<blockquote>{content}</blockquote>")
-            continue
-
-        # Unordered Lists
-        if re.match(r'^[-*+] ', line):
-            if not in_list:
-                in_list = True
-                html_out.append('<ul>')
-            item = re.sub(r'^[-*+] ', '', line)
-            # Inline formatting
-            item = re.sub(r'\*\*\*(.*?)\*\*\*', r'<strong><em>\1</em></strong>', item)
-            item = re.sub(r'\*\*(.*?)\*\*', r'<strong>\1</strong>', item)
-            item = re.sub(r'\*(.*?)\*', r'<em>\1</em>', item)
-            item = re.sub(r'`(.*?)`', r'<code>\1</code>', item)
-            html_out.append(f"<li>{item}</li>")
-            continue
-        else:
-            close_list()
-
-        # Inline formatting for normal paragraphs
-        formatted = line
-        formatted = re.sub(r'\*\*\*(.*?)\*\*\*', r'<strong><em>\1</em></strong>', formatted)
-        formatted = re.sub(r'\*\*(.*?)\*\*', r'<strong>\1</strong>', formatted)
-        formatted = re.sub(r'\*(.*?)\*', r'<em>\1</em>', formatted)
-        formatted = re.sub(r'`(.*?)`', r'<code>\1</code>', formatted)
-
-        html_out.append(f"<p>{formatted}</p>")
-
-    close_list()
-    html('\n'.join(html_out))
-
-markdown(
-    """
-# Heading 1
-## Heading 2
-### Heading 3
-#### Heading 4
-##### Heading 5
-###### Heading 6
-This is a paragraph with **bold**, *italic*, and `inline code`.
-- List item 1
-- List item 2
-> Blockquote
-```python
-print('Hello, world!')
-```
-```html
-<h1>Hello, world!</h1>
-```
-    """
-)

pytpro-0.2.4/setup.py

@@ -1,29 +0,0 @@
-from setuptools import setup, find_packages
-import sys
-
-if sys.version_info < (3, 6):
-    print("❌ To use this module, you need Python 3.6 or newer.")
-    sys.exit(1)
-
-with open("README.md", encoding="utf-8") as f:
-    long_description = f.read()
-
-setup(
-    name="pytpro",
-    version="0.2.4",
-    description="A simple Python tools package by Ibrahim Akhlaq",
-    long_description=long_description,
-    long_description_content_type="text/markdown",
-    author="Ibrahim Akhlaq",
-    author_email="ibakhlaq@gmail.com",
-    packages=find_packages(),
-    classifiers=[
-        "Programming Language :: Python :: 3",
-        "License :: OSI Approved :: MIT License",
-        "Operating System :: OS Independent",
-    ],
-    python_requires=">=3.6",
-    install_requires=[
-        "",
-    ],
-)