Ahsan Sheraz’s Post

pywho - A debugging painkiller for Python developers What is pywho? pywho is a zero-dependency Python CLI that explains your environment, traces imports, and detects module shadowing. It supports JSON output, runs cross-platform Pain point: Debugging Python issues usually means checking the interpreter, virtualenv, sys.path, pip, and import resolution separately. That is slow, repetitive, and often leads to “works on my machine” problems. Target audience: All Python developers. GitHub repo: https://lnkd.in/dMvz9PYM PyPI package: https://lnkd.in/dM72_8rs Docs site here. https://lnkd.in/dCvUBAeu ♻️ Resharing to support the community #Python #PythonDeveloper #Debugging Python Valley Python #DeveloperTools #OpenSource Python Coding Python #SoftwareEngineering #BackendDevelopment Python Software Foundation #DevTools

View profile for Ahsan Sheraz

🐍 I built a Python CLI tool (Fully powered by AI) that solves a problem every developer has faced. You know the drill: ❌ “Works on my machine” — but breaks everywhere else ❌ "which python" → points to the wrong interpreter ❌ "import json" silently loads your "json.py" instead of the real one ❌ “Is my venv even active? Which one? What type?” ❌ Debugging environment issues by running 6 different commands and piecing together the puzzle These are the exact pain points that made me build pywho. 🔧 One command. Full picture. pip install pywho pywho gives you: ✅ Which Python interpreter you're running (version, path, compiler, architecture) ✅ Virtual environment status — detects venv, virtualenv, uv, conda, poetry, pipenv ✅ Package manager detection ✅ Full "sys.path" with index numbers ✅ All "site-packages" directories 🔍 Import tracing — ever wondered WHY "import requests" loaded that file? pywho trace requests Shows you the exact search order Python followed, which paths it checked, and where it finally found the module. ⚠️ Shadow scanning — the silent bug killer pywho scan . Scans your entire project for files like "json.py", "math.py", or "logging.py" that accidentally shadow stdlib or installed packages. These bugs can take hours to debug. "pywho" finds them in seconds. 💡 What makes it different? I looked for existing tools and found: - "pip inspect" → JSON-only, no shadow detection, no import tracing - "python -v" → unreadable verbose output - "flake8-builtins" → only catches builtin name shadowing - "ModuleGuard" → academic research tool, not a practical CLI - Linters like "pylint" → catch some shadows but don’t trace resolution paths No tool combines all three: • Environment inspection • Import tracing • Shadow scanning pywho is the first to bring them together. 🏗 Built with quality in mind - 🧪 149 tests, 98% branch coverage - 💻 Cross-platform: Linux, macOS, Windows - 🐍 Python 3.9 – 3.14 - 📦 Zero dependencies (pure stdlib) - ⚡ CI with 20 automated checks per PR - 🔒 Read-only — no filesystem writes, no network calls The best debugging tool is the one you don’t have to think about. Next time someone says “it works on my machine”, just ask them to run: pywho …and paste the output. Done. 🎯 ⭐ GitHub: https://lnkd.in/dMvz9PYM Would love your feedback! What other pain points do you hit with Python environments? 👇 #Python #OpenSource #DevTools #CLI #DeveloperTools #SoftwareEngineering #Debugging #PythonDev #pywho

To view or add a comment, sign in

Explore content categories