Metadata-Version: 2.1
Name: simp
Version: 1.0.2
Summary: Sort imports simply
Home-page: https://github.com/rec/simp
Author: Tom Ritchford
Author-email: tom@swirly.com
License: MIT
Keywords: documentation
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Utilities
Requires-Dist: myers

simp.py
-------

Usage
=====

.. code-block:: bash

       simp.py [-h] [--commit] [--dry_run] [--fail] [targets [targets ...]]

Description
===========

Sort the import directives in Python files, excluding __future__.

Positional arguments
====================

``targets``
  One or more Python files or directories with Python files.
  Without arguments, runs simp on the current directory.

Optional arguments
==================

``-h``, ``--help``
  Show this help message and exit

``--commit``, ``-c``
  Git commit the changes

``--dry_run``, ``-d``
  If set, do not make the changes to the Python files, but just
  list the diffs.

``--fail``, ``-f``
  If set, the program fails if any changes need to be made. This
  is useful for a commit hook to check if all imports are sorted.


Comments
========

I wanted to sort my Python includes with no fuss. ``simp`` finds the first block
of unindented import statements, and sorts them. Any comments between import
lines bubble up to the top in their original order.

(automatically generated by `doks <https://github.com/rec/doks/>`_ on 2020-11-01T14:22:18.849238)


