autopypack 1.2.0

Automatically installs missing Python libraries when running your code.

AutoPyPack

AutoPyPack is a zero-config tool that automatically installs missing Python packages in your project — whether you're running a script, a notebook, or from the command line.

✨ Works as both a CLI tool, an importable module, and supports magic commands inside Jupyter notebooks.

---

🚀 Features

• 📦 Automatically installs missing packages from import statements
• 🧠 Smart mapping from import names to PyPI package names
• 🛠️ Use it via CLI, Python, or inside Jupyter notebooks with %%autopypack magic
• 🔍 Detects local modules and standard libraries — no false installs
• 🧪 Includes dev tools for testing and linting

---

📦 Installation

Install from PyPI:

pip install autopypack

Or install from source:

git clone https://github.com/harshRaj1601/AutoPyPack
cd AutoPyPack
pip install -e .

---

🧠 Usage

✅ Method 1: As an importable module (auto-scans your script)

import AutoPyPack  # 👈 Automatically scans and installs packages

# Your usual imports
import numpy as np
import pandas as pd

Manual usage

import AutoPyPack

AutoPyPack.install()                        # Scan current directory
AutoPyPack.install("/path/to/project")      # Scan specific directory
AutoPyPack.scan_file("example.py")          # Scan a specific file

---

🧪 Method 2: Inside a Jupyter Notebook

Enable magic with a single import:

import AutoPyPack

Use it in a cell:

%%autopypack
import pandas as pd
import sklearn
print("All imported successfully!")

✨ AutoPyPack will:

• Detect missing packages in that cell
• Install them with pip
• Execute the cell code

---

🖥️ Method 3: As a CLI tool

Install missing packages in your project

autopypack install
autopypack i  # Short form

List all external packages

autopypack list
autopypack l  # Short form

Options

• --dir, -d: Target a specific directory (default: .)
• --quiet, -q: Suppress detailed logs (useful for scripts)

Example: generate requirements.txt

autopypack list --quiet > requirements.txt

---

⚙️ How it works

1. Scans .py or notebook cell for import statements
2. Identifies unique modules
3. Uses mappings.json to resolve correct package names
4. Installs anything missing via pip
5. Skips local modules and stdlib

---

🧪 Development Mode

Install dev tools:

pip install -e .  # Already includes pytest, black, flake8

Run tests:

pytest

---

🪪 License

MIT © Harsh Jaiswal

---

🔗 Links

• GitHub: AutoPyPack