pymport

About

A lightweight Python linter for checking unused imports in your Python files.

Features

• 🧹 Detects unused or shadowed imports that linters like ruff may miss
• 🚫 Use noqa comments to ignore imports you want to keep
• ⚙️ Minimalist CLI interface for easy integration in CI/CD pipelines
• 🐍 No external dependencies beyond the Python standard library
• ✅ 100% test coverage with automated tests
• 🔌 Provides pre‑commit hook integration for automated checks

A minimal typical example could be:

import os.path

print(os.curdir)

📦 Installation

To install pymport using pip, run the following command:

pip install pymport --upgrade

⚡ Quick Start

To run the linter on the current directory, use the following command:

pymport .

• This will check all Python files in the current directory and its subdirectories.

Command-Line Interface

Usage: pymport [FILE] [--help] [--quiet] [--ignore=DIR]

Output

When unused imports are detected, they will be reported in the following format:

path/to/file.py:LINE-NUMBER: UNUSED-IMPORT-NAME

Pre‑commit Integration

The linter can be easily integrated into your pre‑commit workflow.

Update your .pre-commit-config.yaml to include the pymport hook:

repos:
  - repo: https://github.com/rmoralespp/pymport
    rev: 0.0.6  # Use the latest commit hash or tag
    hooks:
      - id: pymport
        args: ["."]  # customize as needed
        pass_filenames: false  # needed if excluding files with --ignore

🛠️ Development

To contribute to the project, you can run the following commands for testing and documentation:

First, ensure you have the latest version of pip:

python -m pip install --upgrade pip

Running Tests

pip install --group=test --upgrade # Install test dependencies, skip if already installed
python -m pytest tests/ # Run all tests
python -m pytest tests/ --cov # Run tests with coverage

Running Linter

pip install --group=lint --upgrade  # Install lint dependencies, skip if already installed
ruff check . # Run linter

🗒️ License

This project is licensed under the MIT license.