Initial Commit

Author: jambhaleAnuj

.github/.gitignore

@@ -0,0 +1,29 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Virtual environments
+venv/
+.env/
+.env*/
+.venv/
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+
+# IDE / editor
+.vscode/
+.idea/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+
+# Python cache
+.pytest_cache/

.github/CONTRIBUTING.md

@@ -0,0 +1,62 @@
+# Contributing
+
+Thanks for your interest in improving this tiny utility! The goal is to keep it **small, dependency‑free, and easy to read**.
+
+## Guiding Principles
+
+- Single file (`size.py`) stays minimal
+- No third‑party dependencies
+- Cross‑platform friendliness (Windows, macOS, Linux)
+- Prefer clarity over micro‑optimizations unless a measurable win
+
+## Good Contribution Types
+
+- Documentation clarifications (README, FAQ, examples)
+- Reproducible bug fixes (with a short explanation of cause)
+- Tiny, optional flags (opened via issue first)
+- Improved edge‑case handling without adding complexity
+
+## Please Avoid
+
+- Adding packaging / installers / publishing logic
+- Large feature sets (interactive UI, progress bars, etc.)
+- Refactors that only rename things
+- Adding dependency managers or lock files
+
+## Workflow
+
+1. Fork the repo
+2. Create a branch: `feat/short-name` or `fix/short-name`
+3. Make your change (ensure script still runs with `python size.py`)
+4. Update docs if behavior changed
+5. Open a Pull Request describing the motivation
+
+## Reporting Issues
+
+Include:
+
+- OS + Python version (`python --version`)
+- Example of unexpected output
+- If possible, the directory layout or a redacted tree
+
+## Light Feature Requests
+
+Open an issue first. Some acceptable minimal ideas:
+
+- `--top N` to limit rows
+- `--min-mb X` threshold
+- Optional JSON output
+
+## Code Style
+
+- Standard library only
+- Keep functions short & purpose driven
+- Avoid premature abstraction
+
+## License
+
+By contributing you agree your code is released under the repository's MIT License.
+
+---
+
+Keep it lean. Happy hacking!

.github/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Anuj
+
+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.

README.md

@@ -0,0 +1,128 @@
+# python-package-size-analyzer
+
+Find and list installed Python packages sorted by size (largest first) so you can quickly identify heavy dependencies to uninstall or move to a virtual environment.
+
+## Why This Script?
+
+- **Single-file, zero dependencies** – pure Python stdlib only.
+- **Fast insight** – instant overview of what is bloating your global / root Python installation.
+- **Actionable output** – largest packages first so you can prune immediately.
+- **Portable** – works anywhere standard `site` module is available (Windows, macOS, Linux).
+
+> Unique Selling Point: You do _not_ need to install anything (no `pip install` step). Just run it.
+
+## Features
+
+- Recursively calculates total on-disk size for each package directory under all discovered `site-packages` locations
+- Human‑readable MB output, aligned in a clean table
+- Sorts automatically (largest → smallest)
+- Ignores unreadable files gracefully (permission or transient I/O errors)
+
+## Quick Start
+
+```bash
+python size.py
+```
+
+Example output:
+
+```
+Package                                     Size (MB)
+----------------------------------------------------
+numpy                                          137.42
+pandas                                          62.77
+matplotlib                                      35.19
+scipy                                           31.04
+pip                                             12.11
+setuptools                                      11.45
+...                                             ...
+```
+
+(Your numbers will differ based on what is installed.)
+
+## When To Use This
+
+- Before committing a base Docker image – trim unnecessary global packages
+- Cleaning up a bloated system Python install on Windows
+- Auditing a CI agent or build server
+- Deciding which libraries to move into a virtual environment
+
+## How It Works
+
+The script:
+
+1. Uses `site.getsitepackages()` (or falls back to `site.getusersitepackages()`)
+2. Walks every directory directly inside each detected `site-packages`
+3. Sums file sizes with `os.walk`
+4. Outputs a sorted table (descending by size)
+
+No heuristics, no partial sampling – full recursive byte size per package directory.
+
+## SEO-Friendly Keywords (contextual)
+
+Python package size analyzer, list largest python packages, site-packages disk usage, python dependency bloat, remove large python packages, clean global python install, python script no dependencies, package size audit.
+
+## Uninstalling Large Packages (Manual Examples)
+
+Once you identify large packages you don't need globally:
+
+```bash
+pip uninstall package_name
+```
+
+Or prefer isolating heavy libs:
+
+```bash
+python -m venv venv
+venv\Scripts\activate  # Windows
+pip install big_package_only_when_needed
+```
+
+## FAQ
+
+**Q: Does it follow symlinks?**  
+A: It traverses directories as presented by `os.walk`; typical site-packages rarely use large symlinks. Symlinked entries count the file they point to if resolved by the OS.
+
+**Q: Will this break anything?**  
+A: It is read-only; it only walks and sums file sizes.
+
+**Q: Can I export JSON?**  
+A: Not in this minimal version (by design). You can pipe to a file and parse manually if needed.
+
+**Q: Why not use `pip list --format=...`?**  
+A: `pip` does not provide recursive on-disk size summaries out-of-the-box.
+
+## Lightweight Extensibility Ideas (Optional)
+
+If you fork it, you could add:
+
+- `--top N` flag
+- `--min-mb` filter
+- CSV / JSON output
+- Total cumulative size banner
+  Keep changes minimal to preserve the zero-dependency ethos.
+
+## Contributing
+
+This is intentionally small. Feel free to open:
+
+- Clear bug reports (unexpected size anomalies, cross-platform edge cases)
+- Tiny PRs improving readability of documentation
+
+Please avoid feature bloat.
+
+## License
+
+MIT – see `LICENSE` file.
+
+## Badge Zone
+
+_(Badges kept minimal to avoid noise)_
+
+![Python](https://img.shields.io/badge/Python-Stdlib%20Only-blue)
+![Maintenance](https://img.shields.io/badge/Maintained-Yes-green)
+![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
+
+---
+
+If this helped you reclaim disk space, consider starring the repo so others can discover it.

output_sample.txt

@@ -0,0 +1,17 @@
+Package                                     Size (MB)
+----------------------------------------------------
+numpy                                          137.42
+pandas                                          62.77
+matplotlib                                      35.19
+scipy                                           31.04
+pip                                             12.11
+setuptools                                      11.45
+charset_normalizer                               9.12
+idna                                            2.20
+requests                                        2.08
+certifi                                         1.69
+wheel                                           1.10
+urllib3                                         0.92
+six                                             0.83
+colorama                                        0.06
+...                                             ...

size.py

@@ -0,0 +1,41 @@
+import os
+import sys
+import site
+
+def get_package_size(path):
+    total_size = 0
+    for dirpath, _, filenames in os.walk(path):
+        for f in filenames:
+            try:
+                fp = os.path.join(dirpath, f)
+                if os.path.isfile(fp):
+                    total_size += os.path.getsize(fp)
+            except OSError:
+                pass
+    return total_size
+
+def main():
+    # Find the site-packages directory
+    site_packages_dirs = site.getsitepackages() if hasattr(site, "getsitepackages") else [site.getusersitepackages()]
+    package_sizes = []
+
+    for site_dir in site_packages_dirs:
+        if not os.path.isdir(site_dir):
+            continue
+        for item in os.listdir(site_dir):
+            item_path = os.path.join(site_dir, item)
+            if os.path.isdir(item_path):
+                size_mb = get_package_size(item_path) / (1024 * 1024)
+                package_sizes.append((item, size_mb))
+
+    # Sort from largest to smallest
+    package_sizes.sort(key=lambda x: x[1], reverse=True)
+
+    # Print results
+    print(f"{'Package':<40} {'Size (MB)':>10}")
+    print("-" * 52)
+    for name, size in package_sizes:
+        print(f"{name:<40} {size:>10.2f}")
+
+if __name__ == "__main__":
+    main()