Command line options

You can list many options by running unimport –help

usage: unimport [-h] [--color {auto,always,never}] [--check] [-c PATH] [--disable-auto-discovery-config] [--include include] [--exclude exclude] [--gitignore] [--ignore-init]
                [--include-star-import] [-d] [-r | -p] [-v]
                [sources ...]

A linter, formatter for finding and removing unused import statements.

positional arguments:
  sources               Files and folders to find the unused imports.

options:
  -h, --help            show this help message and exit
  --color {auto,always,never}
                        Select whether to use color in the output. Defaults to `auto`.
  --check               Prints which file the unused imports are in.
  -c PATH, --config PATH
                        Read configuration from PATH.
  --disable-auto-discovery-config
                        Automatically pick up config options from setup.cfg if it is present in the project root else check and if it exists use pyproject.toml.
  --include include     File include pattern.
  --exclude exclude     File exclude pattern.
  --gitignore           Exclude .gitignore patterns. if present.
  --ignore-init         Ignore the __init__.py file.
  --include-star-import
                        Include star imports during scanning and refactor.
  -d, --diff            Prints a diff of all the changes unimport would make to a file.
  -r, --remove          Remove unused imports automatically.
  -p, --permission      Refactor permission after see diff.
  -v, --version         Prints version of unimport

Get rid of all unused imports 🥳

Sources¶

(optional: default the file directory you are in) -> Path(".")

You can give as many file or directory paths as you want.

Usage

• $ unimport
• $ unimport example
• $ unimport example example1 example2 example/example.py

Check¶

(optional: default False) Prints which file the unused imports are in.

Usage

• $ unimport
• $ unimport --check
• $ unimport --check --diff
• $ unimport --check --remove

Config¶

(optional: default the file directory you are in) -> Path(".")

Read configuration from PATH

Usage

• $ unimport --config path/to/pyproject.toml

Disable auto discovery config¶

(optional: default False)

Automatically pick up config options from setup.cfg if it is present in the project root else check and if it exists use pyproject.toml.

Usage

• $ unimport --disable-auto-discovery-config

Include¶

(optional: default ‘\.(py)$’) file include pattern

Usage

• $ unimport --include mypackage
• $ unimport --include "mypackage|tests

Exclude¶

(optional: default ‘^$’) file exclude pattern

Usage

• $ unimport --exclude __init__.py
• $ unimport --exclude "__init__.py|tests|.tox

Gitignore¶

(optional: default False)

It’s possible to skip .gitignore glob patterns.

Usage

• $ unimport --gitignore

Warning:

For more accurate results when using --gitignore parameter, please do not use Python Windows. For more information, please visit -> https://github.com/hakancelikdev/unimport/issues/240

Ignore init¶

(optional: default False)

Ignore the init.py file.

Usage

• $ unimport --ignore-init

Include star import¶

(optional: default False) Include star imports during scanning and refactor.

Usage

• $ unimport --include-star-import

Diff¶

(optional: default False) Prints a diff of all the changes unimport would make to a file.

Usage

• $ unimport -d
• $ unimport --diff

Remove¶

(optional: default False) remove unused imports automatically.

When the --diff and --check flags are not used, the --remove flag set as True If you still want to remove the imports, use the --remove flag.

Usage

• $ unimport -r
• $ unimport --remove

Permission¶

(optional: default False) Refactor permission after seeing the diff.

Usage

• $ unimport -p
• $ unimport --permission

Color¶

(optional: default auto) choices: (always, never, auto)

Select whether to use color in the output.

Usage

• unimport --color always
• unimport --color never
• unimport --color auto