import-future-annotations

Tool that checks presence of import from __future__ import annotations in python files and adds it if it's missing.

Installation

pip install import-future-annotations

Usage

import-future-annotations takes filenames as positional arguments.

Additional options:

• --check-only: Don't modify files, only check. If script is applicable to any given file, the exit status code will be 1.
• --allow-empty: Add import to empty python files aswell.

As a pre-commit hook

See pre-commit for instructions

Sample .pre-commit-config.yaml:

-   repo: https://github.com/mbroton/import-future-annotations
    rev: v0.1.0
    hooks:
    -   id: import-future-annotations

How does it work?

file.py before:

import os
import sys

...

Run pre-commit hook or execute command:

> import-future-annotations file.py
Adding annotations import to file.py

file.py after:

+ from __future__ import annotations
import os
import sys

It will be added always on top of the file. It won't add any blank lines, so I suggest to use/place it before reorder_python_imports hook.