Ahsan Sheraz’s Post

🐍 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

Hi Ahsan Sheraz You should try out PyDoctor CLI, a developer-first CLI tool designed to analyze and diagnose the health of Python environments and projects. It’s also a great tool for Python projects. Btw, I also built it myself https://pypi.org/project/pydoctor-cli/

Finally, someone made a tool for the ''which python'' struggle...🙂

Hey man, that’s really awesome 👏

Awesome idea and great initiative 👏

Nice idea! Could save a lot of time ❤️

See more comments

To view or add a comment, sign in

Explore content categories