streamlit-mini-toolkit 0.1.0__py3-none-any.whl

mini_toolkit/tools/url_shortener.py

@@ -0,0 +1,29 @@
+from typing import Optional
+
+import requests
+import streamlit as st
+
+from core.net import normalize_url
+
+API = "https://tinyurl.com/api-create.php"
+
+
+def shorten_url(long_url: str) -> Optional[str]:
+    try:
+        response = requests.get(API, params={"url": long_url}, timeout=8)
+    except requests.RequestException:
+        return None
+    text = response.text.strip()
+    return text if response.ok and text.startswith("http") else None
+
+
+def render() -> None:
+    long_url = st.text_input("Long URL", placeholder="https://example.com/a/very/long/path?with=parameters")
+    if st.button("Shorten", type="primary", disabled=not long_url.strip()):
+        with st.spinner("Shortening…"):
+            short = shorten_url(normalize_url(long_url))
+        if short:
+            st.success("Done — copy your link below.")
+            st.code(short, language=None)
+        else:
+            st.error("TinyURL couldn't shorten that link. Check the URL and try again.")

mini_toolkit/tools/website_status.py

@@ -0,0 +1,39 @@
+import time
+from concurrent.futures import ThreadPoolExecutor
+
+import streamlit as st
+
+from core.net import fetch, normalize_url
+
+MAX_URLS = 25
+
+
+def check(url: str) -> dict:
+    url = normalize_url(url)
+    started = time.perf_counter()
+    try:
+        response = fetch(url, timeout=10)
+    except Exception as exc:
+        return {"URL": url, "Status": "🔴 Down", "Code": None, "Time (ms)": None, "Detail": str(exc)[:120]}
+    elapsed = round((time.perf_counter() - started) * 1000)
+    ok = response.status_code < 400
+    return {
+        "URL": url,
+        "Status": "🟢 Up" if ok else "🟠 Error",
+        "Code": response.status_code,
+        "Time (ms)": elapsed,
+        "Detail": response.reason,
+    }
+
+
+def render() -> None:
+    raw = st.text_area("URLs (one per line)", height=140, placeholder="example.com\nhttps://github.com")
+    urls = list(dict.fromkeys(u.strip() for u in raw.splitlines() if u.strip()))[:MAX_URLS]
+    if st.button("Check status", type="primary", disabled=not urls):
+        with st.spinner(f"Checking {len(urls)} URL{'s' if len(urls) != 1 else ''}…"):
+            with ThreadPoolExecutor(max_workers=8) as pool:
+                results = list(pool.map(check, urls))
+        up = sum(r["Status"].endswith("Up") for r in results)
+        st.metric("Online", f"{up} / {len(results)}")
+        st.dataframe(results, width="stretch", hide_index=True)
+    st.caption(f"Checks up to {MAX_URLS} URLs at a time.")

streamlit_mini_toolkit-0.1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,42 @@
+mini_toolkit/__init__.py,sha256=jdSYdcJbRTNJmTKlfNjKsG1SZ8jqsjfACwDKLveBdjk,87
+mini_toolkit/__main__.py,sha256=bYt9eEaoRQWdejEHFD8REx9jxVEdZptECFsV7F49Ink,30
+mini_toolkit/cli.py,sha256=mkLiQ1MY2nQz_w0jm-nOxKbKBK67hG_z0SuGh-9HTxI,1253
+mini_toolkit/app.py,sha256=SmNRjQCn5tBJbXre0Hk3X_XYGVtmKuz0jCanrUblg08,4066
+mini_toolkit/core/__init__.py,sha256=KeMW6i_R-Uhs1P1gtson3kI4OlC6rEnDJ3RpOhqJvLQ,55
+mini_toolkit/core/net.py,sha256=_Yv9uVqcHVS24ziQrdXqdtOR6fE9LNB8D_Kngu69jT8,2079
+mini_toolkit/core/pdf.py,sha256=jD_94CLbs1RqKHiXVJy8SddAC28MGpVVAbfHsTnboEs,491
+mini_toolkit/core/registry.py,sha256=TPtzYtjhFN735STVnS7KbWMzNWCkHj7e8hL8hsC4KC0,4364
+mini_toolkit/core/ui.py,sha256=ZTOFUlNvVpiEKf8T15E1_YtrqwnsnDnix_YQ8OmZkIg,2917
+mini_toolkit/streamlit_config.toml,sha256=Id7klNaTibgWijXvNi7U8Zvqmt1-eb7vRMoVZz-VCNc,253
+mini_toolkit/style/style.css,sha256=kZOOFW-hrVxKBE5cKiBO1eeMrrM12X3sCWdTgOYxXlo,5158
+mini_toolkit/tools/__init__.py,sha256=4qFWYnLos7YC39ghfp2EcoQtxgtaRe8pWXpn3wpmjHU,85
+mini_toolkit/tools/background_remover.py,sha256=S5J5uGOPCkmVPP1yCbNHpVOABOj3dKWP3JU3KBgfG18,2316
+mini_toolkit/tools/change_tracker.py,sha256=81Oeef0up4lgd7SeW0MNJ4M2ILwFkdh123AVIZd3f7s,3530
+mini_toolkit/tools/chat_alert.py,sha256=2KXW94DnjWWUXAD82uINNUzHK5yar-Kjaxx7W3Fi_Vg,1778
+mini_toolkit/tools/color_picker.py,sha256=0_ti0osWwwOY1slXDMX9qrnPpOgOF0asySvsPPNn3WU,1435
+mini_toolkit/tools/document_converter.py,sha256=kmAGAO2XqTdta80hkwhJTbtMPk2qQaCNXY7M_oZLDaU,4003
+mini_toolkit/tools/file_compressor.py,sha256=4O0c-X4DUTKXizHX2fr1fAq690BQppovzEml93RntTM,2939
+mini_toolkit/tools/github_trending.py,sha256=QfA8nxup1lLOnM6SG8Z4uhYY0oLa6N2gNNECcVSWOsA,2101
+mini_toolkit/tools/hash_generator.py,sha256=SHE31moSoR5Vvv7aEjFTyGQyMuf6QS_oNckw-DaNCcI,1361
+mini_toolkit/tools/image_converter.py,sha256=5OWaFKog-Iv7mIugKcwIcunA5kIwyiEIFYsMqwQKIM8,2344
+mini_toolkit/tools/image_downloader.py,sha256=AQ6lKLNzdMYhbzjidShgCABwBvi4EobDc83hLeMkXGs,2362
+mini_toolkit/tools/image_enhancer.py,sha256=QnqJAqacAQNgxKwHxJSbhAOHjDh6ehbC2uLEDeodGVg,2027
+mini_toolkit/tools/image_watermarker.py,sha256=7jkSDuNmrPLmI2Mjt-DK38YHejjaoYAcQv6Ntj0WaPI,2483
+mini_toolkit/tools/ocr.py,sha256=4oX0zNNvQPQpXD0L-cvBdqyYByDXS91IqaEd6LVE5BE,3310
+mini_toolkit/tools/page_speed.py,sha256=APakz_ycPr8bOqdf0d-JvT6_8V1rVTX3EFMBEY7ARuw,1717
+mini_toolkit/tools/password_checker.py,sha256=WBX5DP0F2FTij6i_NDrctMoLqeYjQIXlu0v0PkXgA5U,2200
+mini_toolkit/tools/pdf_tools.py,sha256=AZdzDp0y8ztXMZ_rRo6ezUg77awrvxx8XAFR_n2zFM0,2786
+mini_toolkit/tools/qr_code.py,sha256=cmVvofZOPdvcFkFrV0LPhYw9xW7JqNpaelmoR_TZMVY,3221
+mini_toolkit/tools/resume_builder.py,sha256=TRLL399eLqbDz1X6MqP8YgKavYsizROh4qVL6DxtkKs,17597
+mini_toolkit/tools/seo_health.py,sha256=8fwLPGqWDAEIsL72iDEJzDrZ9_ZnZRQ29SFWWFIU6_0,3269
+mini_toolkit/tools/signature.py,sha256=pRJ13QJdOFovrpRDAQhcrlr4vVkaZVBCM4NcTLlo_FA,3996
+mini_toolkit/tools/ssl_checker.py,sha256=bbCDGQ-WFwXIsA9FOZIqLFXu9ro2cXQ18ADQUsfS5oo,2551
+mini_toolkit/tools/text_to_speech.py,sha256=r45zSSsiBpmocnPoveuvHedEKPcAq3iADEFIYTYnr1c,1187
+mini_toolkit/tools/text_utilities.py,sha256=VYpNVyKA5GPl8VVxc9sGsR8wVrR_90Ai_pKyx8CqP9I,1400
+mini_toolkit/tools/url_shortener.py,sha256=0Osk8H-pnVaOuVb2O3M7uyld8FLJDNIKkNcyoA_lAv0,970
+mini_toolkit/tools/website_status.py,sha256=JvTs0nLdKHamLEBhaLOLJJJPNFnK8nPMMmokdodLGJ0,1450
+streamlit_mini_toolkit-0.1.0.dist-info/METADATA,sha256=Z7dSbd2QTis5nnGLknif1VYuUA4vRoWTfkI_1jj5w00,5815
+streamlit_mini_toolkit-0.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+streamlit_mini_toolkit-0.1.0.dist-info/entry_points.txt,sha256=_-pAJ0nnBJ8iWjUxMiqeg_9s6ZJgPlvVFTQhcSXy-Hw,55
+streamlit_mini_toolkit-0.1.0.dist-info/licenses/LICENSE,sha256=ahCDv8oyJulKJT1dR0tAwVdV8igmw_DvQNd6JW1qfPg,1066
+streamlit_mini_toolkit-0.1.0.dist-info/RECORD,,

streamlit_mini_toolkit-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

streamlit_mini_toolkit-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mini-toolkit = mini_toolkit.cli:main

streamlit_mini_toolkit-0.1.0.dist-info/licenses/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.