aspy.refactor-imports

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 on this page — 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

aspy-refactor-imports on PyPI

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

Evidence: aspy.refactor_imports-3.0.2-py2.py3-none-any.whl

Tags

More Software Development packages