streamlit-mini-toolkit 0.1.0__tar.gz

streamlit_mini_toolkit-0.1.0/.gitignore

@@ -0,0 +1,21 @@
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+*.egg-info/
+
+# Streamlit
+.streamlit/secrets.toml
+
+# OS / editor
+.DS_Store
+.idea/
+.vscode/
+
+# Vercel
+.vercel
+
+# Packaging
+dist/
+build/

streamlit_mini_toolkit-0.1.0/.streamlit/config.toml

@@ -0,0 +1,16 @@
+[theme]
+base = "dark"
+primaryColor = "#5B8CFF"
+backgroundColor = "#0D1017"
+secondaryBackgroundColor = "#161A23"
+textColor = "#E7E9EE"
+font = "sans serif"
+
+[server]
+maxUploadSize = 50
+
+[browser]
+gatherUsageStats = false
+
+[client]
+toolbarMode = "minimal"

streamlit_mini_toolkit-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sarif Mia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

streamlit_mini_toolkit-0.1.0/PKG-INFO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.5
+Name: streamlit-mini-toolkit
+Version: 0.1.0
+Summary: 25 everyday utilities (image, document, text and web tools) in one Streamlit app.
+Project-URL: Homepage, https://github.com/sarif-mia/mini-toolkit
+Project-URL: Source, https://github.com/sarif-mia/mini-toolkit
+Project-URL: Tracker, https://github.com/sarif-mia/mini-toolkit/issues
+Author: Sarif Mia
+License-Expression: MIT
+License-File: LICENSE
+Keywords: image,pdf,qr-code,seo,streamlit,toolkit,utilities
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Requires-Dist: beautifulsoup4>=4.12
+Requires-Dist: fpdf2>=2.7.8
+Requires-Dist: gtts>=2.5
+Requires-Dist: pillow>=10.1
+Requires-Dist: pypdf>=4.0
+Requires-Dist: python-docx>=1.1
+Requires-Dist: qrcode>=7.4
+Requires-Dist: requests>=2.31
+Requires-Dist: streamlit-image-coordinates>=0.1.9
+Requires-Dist: streamlit>=1.50
+Provides-Extra: all
+Requires-Dist: docx2pdf>=0.1.8; (sys_platform != 'linux') and extra == 'all'
+Requires-Dist: opencv-python-headless>=4.8; extra == 'all'
+Requires-Dist: pdf2docx>=0.5.8; extra == 'all'
+Requires-Dist: pytesseract>=0.3.10; extra == 'all'
+Requires-Dist: pywin32; (sys_platform == 'win32') and extra == 'all'
+Requires-Dist: rembg[cpu]>=2.0.50; extra == 'all'
+Provides-Extra: bg
+Requires-Dist: rembg[cpu]>=2.0.50; extra == 'bg'
+Provides-Extra: docs
+Requires-Dist: docx2pdf>=0.1.8; (sys_platform != 'linux') and extra == 'docs'
+Requires-Dist: pdf2docx>=0.5.8; extra == 'docs'
+Requires-Dist: pywin32; (sys_platform == 'win32') and extra == 'docs'
+Provides-Extra: ocr
+Requires-Dist: opencv-python-headless>=4.8; extra == 'ocr'
+Requires-Dist: pytesseract>=0.3.10; extra == 'ocr'
+Description-Content-Type: text/markdown
+
+# 🧰 Mini Toolkit
+
+A collection of 25 everyday utilities — image editing, document conversion, text tools and website checks — in one fast, clean Streamlit app. No sign-up, no clutter.
+
+## Tools
+
+| Category | Tools |
+| --- | --- |
+| **Image** | Background Remover · Image Converter · Image Enhancer · Image Watermarker · Image Color Picker · QR Code Generator · OCR Text Extractor |
+| **Documents** | Document Converter (DOCX ↔ PDF ↔ TXT) · PDF Merge & Split · File Compressor · Resume Builder · Email Signature |
+| **Text & Security** | Text Utilities · Text to Speech · Hash Generator · Password Checker & Generator |
+| **Web & Developer** | Website Status · Page Speed Checker · SSL Certificate Checker · SEO Health Check · Website Image Downloader · URL Shortener · Website Change Tracker · GitHub Trending · Chat Alert Bot (Slack / Teams / Discord) |
+
+Every tool has its own shareable URL, e.g. `/?tool=qr-code`.
+
+## Install from PyPI
+
+```sh
+pip install streamlit-mini-toolkit          # core tools
+pip install "streamlit-mini-toolkit[all]"   # + background remover, OCR, DOCX/PDF conversion
+mini-toolkit                                # opens the app at http://localhost:8501
+```
+
+Pick extras individually if you prefer: `[bg]` (Background Remover), `[ocr]` (OCR Text Extractor), `[docs]` (DOCX ↔ PDF). Streamlit flags pass through, e.g. `mini-toolkit --server.port 8080`.
+
+## Quick start (from source)
+
+Requires Python 3.9+.
+
+```sh
+git clone https://github.com/sarif-mia/mini-toolkit.git
+cd mini-toolkit
+python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
+pip install -r requirements.txt
+streamlit run app.py
+```
+
+The app opens at <http://localhost:8501>.
+
+### System dependencies (optional)
+
+A few tools call external programs. Everything else works without them.
+
+| Feature | Needs |
+| --- | --- |
+| OCR Text Extractor | [Tesseract](https://tesseract-ocr.github.io/tessdoc/Installation.html) |
+| DOCX → PDF | [LibreOffice](https://www.libreoffice.org/) (or Microsoft Word on Windows/macOS) |
+
+On Debian/Ubuntu: `sudo xargs apt-get install -y < packages.txt`
+
+## Deployment
+
+### Streamlit Community Cloud (recommended, free)
+
+1. Go to [share.streamlit.io](https://share.streamlit.io) and sign in with GitHub.
+2. **Create app** → pick this repository, branch `master`, main file `app.py`.
+3. Deploy. `requirements.txt` and `packages.txt` are picked up automatically.
+
+### Docker (Render, Railway, Fly.io, Hugging Face Spaces, …)
+
+```sh
+docker build -t mini-toolkit .
+docker run -p 8501:8501 mini-toolkit
+```
+
+> **Why not Vercel?** Vercel runs short-lived serverless functions, while Streamlit needs a long-running server with a persistent WebSocket connection. Use one of the options above instead.
+
+### Optional secrets
+
+The Website Change Tracker can email change summaries. Add these to `.streamlit/secrets.toml` locally, or to your host's secrets settings:
+
+```toml
+smtp_server = "smtp.gmail.com"
+smtp_port = 587
+smtp_user = "you@example.com"
+smtp_pass = "app-password"
+```
+
+## Project structure
+
+```
+app.py               Entry point: page config, routing, home page
+core/
+  registry.py        List of tools and categories (add new tools here)
+  ui.py              Shared UI helpers (headers, uploads, ZIP export, footer)
+  net.py             Safe HTTP fetching for the web tools
+tools/               One module per tool, each exposing render()
+style/style.css      Custom styling
+.streamlit/          Theme and server config
+```
+
+### Adding a tool
+
+1. Create `tools/my_tool.py` with a `render()` function.
+2. Register it in `core/registry.py`:
+   ```python
+   Tool("my-tool", "My Tool", "🧪", "One-line description.", TEXT, "my_tool"),
+   ```
+
+Tools are imported lazily, so a missing optional dependency only affects that one tool.
+
+## License
+
+Distributed under the MIT License. See [`LICENSE`](LICENSE).
+
+---
+
+Built by [Sarif](https://sarifmiia.netlify.app/) · [GitHub](https://github.com/sarif-mia) · [LinkedIn](https://www.linkedin.com/in/sarif-mia/)

streamlit_mini_toolkit-0.1.0/README.md

@@ -0,0 +1,108 @@
+# 🧰 Mini Toolkit
+
+A collection of 25 everyday utilities — image editing, document conversion, text tools and website checks — in one fast, clean Streamlit app. No sign-up, no clutter.
+
+## Tools
+
+| Category | Tools |
+| --- | --- |
+| **Image** | Background Remover · Image Converter · Image Enhancer · Image Watermarker · Image Color Picker · QR Code Generator · OCR Text Extractor |
+| **Documents** | Document Converter (DOCX ↔ PDF ↔ TXT) · PDF Merge & Split · File Compressor · Resume Builder · Email Signature |
+| **Text & Security** | Text Utilities · Text to Speech · Hash Generator · Password Checker & Generator |
+| **Web & Developer** | Website Status · Page Speed Checker · SSL Certificate Checker · SEO Health Check · Website Image Downloader · URL Shortener · Website Change Tracker · GitHub Trending · Chat Alert Bot (Slack / Teams / Discord) |
+
+Every tool has its own shareable URL, e.g. `/?tool=qr-code`.
+
+## Install from PyPI
+
+```sh
+pip install streamlit-mini-toolkit          # core tools
+pip install "streamlit-mini-toolkit[all]"   # + background remover, OCR, DOCX/PDF conversion
+mini-toolkit                                # opens the app at http://localhost:8501
+```
+
+Pick extras individually if you prefer: `[bg]` (Background Remover), `[ocr]` (OCR Text Extractor), `[docs]` (DOCX ↔ PDF). Streamlit flags pass through, e.g. `mini-toolkit --server.port 8080`.
+
+## Quick start (from source)
+
+Requires Python 3.9+.
+
+```sh
+git clone https://github.com/sarif-mia/mini-toolkit.git
+cd mini-toolkit
+python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
+pip install -r requirements.txt
+streamlit run app.py
+```
+
+The app opens at <http://localhost:8501>.
+
+### System dependencies (optional)
+
+A few tools call external programs. Everything else works without them.
+
+| Feature | Needs |
+| --- | --- |
+| OCR Text Extractor | [Tesseract](https://tesseract-ocr.github.io/tessdoc/Installation.html) |
+| DOCX → PDF | [LibreOffice](https://www.libreoffice.org/) (or Microsoft Word on Windows/macOS) |
+
+On Debian/Ubuntu: `sudo xargs apt-get install -y < packages.txt`
+
+## Deployment
+
+### Streamlit Community Cloud (recommended, free)
+
+1. Go to [share.streamlit.io](https://share.streamlit.io) and sign in with GitHub.
+2. **Create app** → pick this repository, branch `master`, main file `app.py`.
+3. Deploy. `requirements.txt` and `packages.txt` are picked up automatically.
+
+### Docker (Render, Railway, Fly.io, Hugging Face Spaces, …)
+
+```sh
+docker build -t mini-toolkit .
+docker run -p 8501:8501 mini-toolkit
+```
+
+> **Why not Vercel?** Vercel runs short-lived serverless functions, while Streamlit needs a long-running server with a persistent WebSocket connection. Use one of the options above instead.
+
+### Optional secrets
+
+The Website Change Tracker can email change summaries. Add these to `.streamlit/secrets.toml` locally, or to your host's secrets settings:
+
+```toml
+smtp_server = "smtp.gmail.com"
+smtp_port = 587
+smtp_user = "you@example.com"
+smtp_pass = "app-password"
+```
+
+## Project structure
+
+```
+app.py               Entry point: page config, routing, home page
+core/
+  registry.py        List of tools and categories (add new tools here)
+  ui.py              Shared UI helpers (headers, uploads, ZIP export, footer)
+  net.py             Safe HTTP fetching for the web tools
+tools/               One module per tool, each exposing render()
+style/style.css      Custom styling
+.streamlit/          Theme and server config
+```
+
+### Adding a tool
+
+1. Create `tools/my_tool.py` with a `render()` function.
+2. Register it in `core/registry.py`:
+   ```python
+   Tool("my-tool", "My Tool", "🧪", "One-line description.", TEXT, "my_tool"),
+   ```
+
+Tools are imported lazily, so a missing optional dependency only affects that one tool.
+
+## License
+
+Distributed under the MIT License. See [`LICENSE`](LICENSE).
+
+---
+
+Built by [Sarif](https://sarifmiia.netlify.app/) · [GitHub](https://github.com/sarif-mia) · [LinkedIn](https://www.linkedin.com/in/sarif-mia/)

streamlit_mini_toolkit-0.1.0/app.py

@@ -0,0 +1,111 @@
+"""Mini Toolkit — a collection of everyday utilities in one Streamlit app.
+
+Run locally with:  streamlit run app.py
+"""
+import html
+import traceback
+
+import streamlit as st
+
+from core.registry import CATEGORIES, TOOLS, TOOLS_BY_SLUG, Tool, tools_in
+from core.ui import footer, load_css, tool_header
+
+st.set_page_config(page_title="Mini Toolkit", page_icon="🧰", layout="wide", initial_sidebar_state="collapsed")
+load_css()
+
+
+def open_tool(slug=None) -> None:
+    if slug:
+        st.query_params["tool"] = slug
+    else:
+        st.query_params.clear()
+
+
+def render_sidebar(active=None) -> None:
+    with st.sidebar:
+        st.button("🏠  All tools", on_click=open_tool, width="stretch", type="primary" if active is None else "secondary")
+        for category in CATEGORIES:
+            st.markdown(f"<div class='nav-heading'>{category}</div>", unsafe_allow_html=True)
+            for tool in tools_in(category):
+                st.button(
+                    f"{tool.icon}  {tool.name}",
+                    key=f"nav_{tool.slug}",
+                    on_click=open_tool,
+                    args=(tool.slug,),
+                    width="stretch",
+                    type="primary" if active and active.slug == tool.slug else "tertiary",
+                )
+
+
+def tool_card(tool: Tool) -> None:
+    with st.container(border=True):
+        st.markdown(
+            f"""
+            <div class="tool-card">
+                <div class="tool-card-icon">{tool.icon}</div>
+                <div class="tool-card-title">{html.escape(tool.name)}</div>
+                <div class="tool-card-desc">{html.escape(tool.description)}</div>
+            </div>
+            """,
+            unsafe_allow_html=True,
+        )
+        st.button("Open", key=f"open_{tool.slug}", on_click=open_tool, args=(tool.slug,), width="stretch")
+
+
+def render_home() -> None:
+    st.markdown(
+        f"""
+        <section class="hero">
+            <span class="hero-badge">{len(TOOLS)} free tools · no sign-up</span>
+            <h1>Everyday tools, <span class="accent">one place.</span></h1>
+            <p>Edit images, convert documents, check websites and more — right in your browser.</p>
+        </section>
+        """,
+        unsafe_allow_html=True,
+    )
+
+    query = st.text_input("Search tools", placeholder="🔎  Search tools — e.g. pdf, qr, background", label_visibility="collapsed").strip().lower()
+    if query:
+        matches = [t for t in TOOLS if query in f"{t.name} {t.description} {t.category}".lower()]
+        if not matches:
+            st.info(f"No tools match “{query}”.")
+            return
+        sections = {"Search results": matches}
+    else:
+        sections = {category: tools_in(category) for category in CATEGORIES}
+
+    for title, tools in sections.items():
+        subtitle = CATEGORIES.get(title, f"{len(tools)} match{'es' if len(tools) != 1 else ''}")
+        st.markdown(f"<div class='category-heading'><div class='category-title'>{title}</div><span>{subtitle}</span></div>", unsafe_allow_html=True)
+        # Build row by row so cards keep their order when columns stack on mobile.
+        for row in range(0, len(tools), 4):
+            for col, tool in zip(st.columns(4), tools[row:row + 4]):
+                with col:
+                    tool_card(tool)
+
+
+def render_tool(tool: Tool) -> None:
+    st.button("← All tools", on_click=open_tool, key="back_home", type="tertiary")
+    tool_header(tool.icon, tool.name, tool.description)
+    try:
+        tool.load()()
+    except Exception as exc:  # keep one broken tool from blanking the whole page
+        st.error(f"Something went wrong in {tool.name}: {exc}")
+        with st.expander("Technical details"):
+            st.code(traceback.format_exc())
+
+
+def main() -> None:
+    slug = st.query_params.get("tool")
+    tool = TOOLS_BY_SLUG.get(slug) if slug else None
+    render_sidebar(tool)
+    if slug and not tool:
+        st.warning(f"Unknown tool “{slug}”. Showing all tools instead.")
+    if tool:
+        render_tool(tool)
+    else:
+        render_home()
+    footer()
+
+
+main()

streamlit_mini_toolkit-0.1.0/core/__init__.py

@@ -0,0 +1 @@
+"""Shared building blocks for the Mini Toolkit app."""

streamlit_mini_toolkit-0.1.0/core/net.py

@@ -0,0 +1,56 @@
+"""HTTP helpers for the web tools.
+
+All outbound requests go through :func:`fetch`, which normalises the URL and
+refuses to reach private or loopback addresses, so a publicly hosted copy of the
+app can't be used to probe the host's internal network.
+"""
+from __future__ import annotations
+
+import ipaddress
+import socket
+from urllib.parse import urlparse
+
+import requests
+
+USER_AGENT = "Mozilla/5.0 (compatible; MiniToolkit/2.0; +https://github.com/sarif-mia/mini-toolkit)"
+DEFAULT_TIMEOUT = 10
+
+
+class UnsafeURLError(ValueError):
+    pass
+
+
+def normalize_url(url: str) -> str:
+    url = url.strip()
+    if url and not url.startswith(("http://", "https://")):
+        url = "https://" + url
+    return url
+
+
+def ensure_public_url(url: str) -> str:
+    """Return the normalised URL, or raise if it is malformed or points at a private address."""
+    url = normalize_url(url)
+    host = urlparse(url).hostname
+    if not host:
+        raise UnsafeURLError("Please enter a valid URL, e.g. https://example.com")
+    try:
+        infos = socket.getaddrinfo(host, None)
+    except socket.gaierror:
+        raise UnsafeURLError(f"Could not resolve host '{host}'.")
+    for info in infos:
+        ip = ipaddress.ip_address(info[4][0])
+        if ip.is_private or ip.is_loopback or ip.is_link_local or ip.is_reserved or ip.is_multicast:
+            raise UnsafeURLError(f"'{host}' resolves to a private address and can't be checked.")
+    return url
+
+
+def fetch(url: str, timeout: float = DEFAULT_TIMEOUT, max_redirects: int = 5, **kwargs) -> requests.Response:
+    """GET a public URL, re-validating every redirect hop."""
+    headers = {"User-Agent": USER_AGENT, **kwargs.pop("headers", {})}
+    for _ in range(max_redirects + 1):
+        url = ensure_public_url(url)
+        response = requests.get(url, timeout=timeout, headers=headers, allow_redirects=False, **kwargs)
+        if not response.is_redirect:
+            return response
+        url = requests.compat.urljoin(url, response.headers["Location"])
+    raise requests.TooManyRedirects(f"Exceeded {max_redirects} redirects.")

streamlit_mini_toolkit-0.1.0/core/pdf.py

@@ -0,0 +1,12 @@
+"""Helpers for generating PDFs with fpdf2's built-in fonts."""
+
+# Built-in PDF fonts only cover Latin-1, so map common typographic characters
+# to ASCII equivalents and replace anything else instead of crashing.
+_TYPOGRAPHIC = str.maketrans({
+    "–": "-", "—": "-", "‘": "'", "’": "'",
+    "“": '"', "”": '"', "•": "*", "…": "...", " ": " ",
+})
+
+
+def pdf_safe(text: str) -> str:
+    return text.translate(_TYPOGRAPHIC).encode("latin-1", errors="replace").decode("latin-1")

streamlit_mini_toolkit-0.1.0/core/registry.py

@@ -0,0 +1,75 @@
+"""Central registry of every tool in the toolkit.
+
+Each tool points at a module in ``tools/`` that exposes a ``render()`` function.
+Modules are imported lazily, so a missing optional dependency only affects the
+tool that needs it instead of taking down the whole app.
+"""
+from __future__ import annotations
+
+import importlib
+from dataclasses import dataclass
+from typing import Callable, Dict, List
+
+
+@dataclass(frozen=True)
+class Tool:
+    slug: str
+    name: str
+    icon: str
+    description: str
+    category: str
+    module: str
+
+    def load(self) -> Callable[[], None]:
+        return importlib.import_module(f"tools.{self.module}").render
+
+
+IMAGE = "Image"
+DOCUMENT = "Documents"
+TEXT = "Text & Security"
+WEB = "Web & Developer"
+
+CATEGORIES: Dict[str, str] = {
+    IMAGE: "Edit, convert and analyse images.",
+    DOCUMENT: "Convert, merge and create documents.",
+    TEXT: "Transform text, hashes and passwords.",
+    WEB: "Inspect websites and automate small tasks.",
+}
+
+TOOLS: List[Tool] = [
+    # Image
+    Tool("background-remover", "Background Remover", "🪄", "Remove image backgrounds with AI models.", IMAGE, "background_remover"),
+    Tool("image-converter", "Image Converter", "🔁", "Convert images between PNG, JPG, WEBP, BMP and TIFF.", IMAGE, "image_converter"),
+    Tool("image-enhancer", "Image Enhancer", "✨", "Adjust brightness, contrast, colour and sharpness.", IMAGE, "image_enhancer"),
+    Tool("image-watermarker", "Image Watermarker", "💧", "Stamp a text watermark onto your images.", IMAGE, "image_watermarker"),
+    Tool("color-picker", "Image Color Picker", "🎨", "Click an image to get exact HEX and RGB values.", IMAGE, "color_picker"),
+    Tool("qr-code", "QR Code Generator", "🔳", "Create QR codes for links, contacts and Wi-Fi.", IMAGE, "qr_code"),
+    Tool("ocr", "OCR Text Extractor", "📝", "Extract text from images and screenshots.", IMAGE, "ocr"),
+    # Documents
+    Tool("document-converter", "Document Converter", "📄", "Convert between DOCX, PDF and TXT.", DOCUMENT, "document_converter"),
+    Tool("pdf-tools", "PDF Merge & Split", "📑", "Combine PDFs or extract pages from one.", DOCUMENT, "pdf_tools"),
+    Tool("file-compressor", "File Compressor", "🗜️", "Zip files or shrink image file sizes.", DOCUMENT, "file_compressor"),
+    Tool("resume-builder", "Resume Builder", "🧾", "Build a resume and cover letter as PDF or DOCX.", DOCUMENT, "resume_builder"),
+    Tool("email-signature", "Email Signature", "✒️", "Design an HTML email signature.", DOCUMENT, "signature"),
+    # Text & Security
+    Tool("text-utilities", "Text Utilities", "🔤", "Count words, change case and clean up text.", TEXT, "text_utilities"),
+    Tool("text-to-speech", "Text to Speech", "🔊", "Turn text into downloadable MP3 audio.", TEXT, "text_to_speech"),
+    Tool("hash-generator", "Hash Generator", "#️⃣", "Compute MD5 and SHA hashes of text or files.", TEXT, "hash_generator"),
+    Tool("password-checker", "Password Checker", "🛡️", "Score password strength and get tips.", TEXT, "password_checker"),
+    # Web & Developer
+    Tool("website-status", "Website Status", "🌐", "Check whether one or many sites are up.", WEB, "website_status"),
+    Tool("page-speed", "Page Speed Checker", "⚡", "Measure server response and download time.", WEB, "page_speed"),
+    Tool("ssl-checker", "SSL Certificate Checker", "🔒", "Inspect certificate validity and expiry.", WEB, "ssl_checker"),
+    Tool("seo-health", "SEO Health Check", "🔍", "Audit titles, meta tags and headings.", WEB, "seo_health"),
+    Tool("image-downloader", "Website Image Downloader", "🖼️", "Collect every image on a page as a ZIP.", WEB, "image_downloader"),
+    Tool("url-shortener", "URL Shortener", "🔗", "Shorten long links with TinyURL.", WEB, "url_shortener"),
+    Tool("change-tracker", "Website Change Tracker", "🔔", "Diff a page against its last snapshot.", WEB, "change_tracker"),
+    Tool("github-trending", "GitHub Trending", "📈", "Discover fast-rising GitHub repositories.", WEB, "github_trending"),
+    Tool("chat-alert", "Chat Alert Bot", "💬", "Send messages to Slack or Teams webhooks.", WEB, "chat_alert"),
+]
+
+TOOLS_BY_SLUG: Dict[str, Tool] = {tool.slug: tool for tool in TOOLS}
+
+
+def tools_in(category: str) -> List[Tool]:
+    return [tool for tool in TOOLS if tool.category == category]

streamlit_mini_toolkit-0.1.0/core/ui.py

@@ -0,0 +1,90 @@
+"""Reusable Streamlit UI helpers shared across tools."""
+from __future__ import annotations
+
+import html
+import io
+import zipfile
+from pathlib import Path
+from typing import Iterable, List, Optional, Tuple
+
+import streamlit as st
+
+MAX_UPLOAD_MB = 10
+STYLE_PATH = Path(__file__).resolve().parent.parent / "style" / "style.css"
+GITHUB_URL = "https://github.com/sarif-mia/mini-toolkit"
+
+
+def load_css() -> None:
+    st.markdown(f"<style>{STYLE_PATH.read_text(encoding='utf-8')}</style>", unsafe_allow_html=True)
+
+
+def tool_header(icon: str, title: str, description: str) -> None:
+    st.markdown(
+        f"""
+        <div class="tool-header">
+            <div class="tool-header-icon">{icon}</div>
+            <div>
+                <h1>{html.escape(title)}</h1>
+                <p>{html.escape(description)}</p>
+            </div>
+        </div>
+        """,
+        unsafe_allow_html=True,
+    )
+
+
+def section(title: str) -> None:
+    st.markdown(f"<div class='section-title'>{html.escape(title)}</div>", unsafe_allow_html=True)
+
+
+def footer() -> None:
+    st.markdown(
+        f"""
+        <footer class="app-footer">
+            <span>Mini Toolkit · built by <a href="https://sarifmiia.netlify.app/" target="_blank" rel="noopener">Sarif</a></span>
+            <span class="footer-links">
+                <a href="{GITHUB_URL}" target="_blank" rel="noopener">GitHub</a>
+                <a href="https://www.linkedin.com/in/sarif-mia/" target="_blank" rel="noopener">LinkedIn</a>
+                <a href="mailto:sarif@lovegenbd.com">Contact</a>
+            </span>
+        </footer>
+        """,
+        unsafe_allow_html=True,
+    )
+
+
+def sanitize_filename(name: str) -> str:
+    stem = "".join(c if c.isalnum() or c in "-_" else "_" for c in Path(name).stem)
+    return stem or "file"
+
+
+def image_uploader(key: str, types: Iterable[str] = ("png", "jpg", "jpeg", "webp", "bmp", "tiff")) -> List:
+    """Multi-image uploader that drops files above the size limit with a warning."""
+    files = st.file_uploader(
+        f"Upload images (max {MAX_UPLOAD_MB} MB each)",
+        type=list(types),
+        accept_multiple_files=True,
+        key=key,
+    ) or []
+    accepted = []
+    for f in files:
+        if f.size > MAX_UPLOAD_MB * 1024 ** 2:
+            st.warning(f"{f.name} is {f.size / 1024 ** 2:.1f} MB and was skipped (limit {MAX_UPLOAD_MB} MB).")
+        else:
+            accepted.append(f)
+    return accepted
+
+
+def build_zip(entries: Iterable[Tuple[str, bytes]]) -> bytes:
+    buffer = io.BytesIO()
+    with zipfile.ZipFile(buffer, "w", zipfile.ZIP_DEFLATED) as zf:
+        for name, data in entries:
+            zf.writestr(name, data)
+    return buffer.getvalue()
+
+
+def missing_dependency(package: str, extra: Optional[str] = None) -> None:
+    message = f"This tool needs the `{package}` package, which isn't installed on this server."
+    if extra:
+        message += f" {extra}"
+    st.error(message)

streamlit_mini_toolkit-0.1.0/mini_toolkit/__init__.py

@@ -0,0 +1,3 @@
+"""Mini Toolkit — everyday utilities in one Streamlit app."""
+
+__version__ = "0.1.0"