Skip to main content

A tool for reordering import statements inside Python code blocks.

Project description

A tool for reordering import statements inside Python code blocks.

This project lives on github:

It also lives on pypi: *

Getting started

Common usage

‘reorder’ is an executable script:

$ --infile --outfile

is equivalent to:

$ < >

You may want to rewrite all files in a directory, say ‘/home/toto/project’:

$ for file in $(find '/home/toto/project') ; do reorder -i $file -o $file ; done
$ <run your test suite!>
$ git diff

of course, if you run the above, you are using version control so you can check the diff and revert modifications in case of trouble


The installation procedure is not very good for the moment but should work.

From source:

$ python install

From the internet (Pypi - ):

$ pip install nouvelordre

As a side note, I suggest installing in a virtualenv -this means running the following before installing as above, therefore not polluting your system:

$ virtualenv nouvelordre
$ cd nouvelordre
$ source ./bin/activate



--infile INFILE, -i INFILE            a Python source file, defaults to standard input
--outfile OUTFILE, -o OUTFILE         output, defaults to standard output
--dump, -d                            in case of failure, keep processing data in files
--version, -v                         prints version and exits


  • Blocks separated by anything (white line for instance) are considered separately.

  • Statements inside a block are reordered

  • Imports in one statement are reordered. Example:

    import sys, os


    import os
    import sys


    from module import b, a as f, c


    from module import a as f, b, c
  • Tries and avoid damaging your precious Python work (see below, Disaster avoidance)


  • This script will only handle first level statements (ie. not indented statements).

  • This script will not handle several “import module” for the same module in the same block.

  • Some files are not compilables by ast.parse() (help appreciated).



  • Python 2.6 at least (for ast)

  • Python 2.7 or python-argparse

Exit codes

  • 0 if all is well.

  • 129 if NotImplementedError (an import on the same line as another instruction, separated by ‘;’).

  • 130 if ast.parse was not able to compile the file.

Disaster avoidance

This software is not perfect and might kill your golden retriever or ruin your diploma but I have tried hard for this never to happen.

‘reorder’ performs 2 passes. Pass 1 is performed on the original input; pass 2 is performed on the result of pass 1. If any error occurred during either pass, the program exits and leaves your files untouched. If pass 1 and 2 would give a different result, the program exits and leaves your files untouched. This is not a 100% guarantee, but it ensures the file stays compilable and all optimizations were performed.

Just because I prefer my program to admit that it failed than to shred your beautiful Python source code.

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nouvelordre-0.1.tar.gz (18.2 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page