---
id: aspy-refactor-imports
version: "3.0.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# aspy.refactor-imports — Utilities for refactoring imports in python-like syntax.

License: permissive · Maintenance: active · Downloads: 122.6K/mo

## What it is and what it does

aspy.refactor_imports provides utilities to parse and manipulate Python import statements as first-class objects. It lets you construct import objects from strings, split multi-import statements into individual ones, sort imports according to custom rules, and classify imports by type (FUTURE, BUILTIN, THIRD_PARTY, APPLICATION). The package is built on a single runtime dependency, cached-property, and supports Python 3.7 through 3.10 on CPython and PyPy.

The package is now maintained in legacy status: the author has rewritten and renamed it for version 4 and beyond. Existing code using aspy.refactor_imports will continue to work, but new projects should consider the renamed version instead. It remains useful for codebases already integrated with it or for tools that need fine-grained control over import parsing and sorting.

Use it for:

- Refactor import statements in a codebase to enforce consistent ordering and grouping conventions.
- Build linting or formatting tools that need to parse and manipulate imports programmatically.
- Classify imports by category (stdlib, third-party, local) to organize or validate import blocks.
- Split comma-separated import statements into individual import lines for readability.
- Sort imports according to custom rules (e.g., stdlib before third-party before application code).

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Parses, classifies, and manipulates Python import statements as structured objects, enabling programmatic refactoring of imports in code.

Yes, if you are maintaining or extending existing code that already uses aspy.refactor_imports. No, if starting a new project—use the renamed version instead. The package is stable and has no known vulnerabilities, but it is in legacy maintenance mode with no active development beyond bug fixes.

## Install

pip install aspy-refactor-imports
uv add aspy-refactor-imports
poetry add aspy-refactor-imports

## Installing aspy.refactor-imports

Before you install: Low friction: pure Python wheel with a single runtime dependency (cached-property). Maintenance is active with recent commits, though the latest release was in 2022; the package is stable but superseded by a newer version.

License in practice: MIT license permits commercial and private use with minimal restrictions—suitable for most projects.

Quickstart:

pip install aspy.refactor_imports

from aspy.refactor_imports.import_obj import FromImport
obj = FromImport.from_str('from foo import bar')
print(obj.to_text())

Verify before relying:

- Whether migration to the renamed version requires code changes
- Performance characteristics when processing large import blocks or many files

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 122.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

python import parsing, refactor imports programmatically, import statement manipulation, classify python imports, import sorting and splitting, import object construction, import-tooling, code-refactoring, legacy

[View on SkillFed](https://skillfed.io/packages/aspy-refactor-imports) · [View on PyPI](https://pypi.org/project/aspy-refactor-imports/)