importsort-d 0.3.2

Sort Imports for D

sortimport-d can sort your dozens of import's in a .d file (no matter where)

Installation

Prerequisite

• dub

Building from HEAD

Get the repository with git and compile everything with dub

$ git clone https://github.com/friedelschoen/importsort-d
$ cd importsort-d
$ dub build

If everything went fine, there should be a binary at bin/importsort-d.

Copy this into a directory included in $PATH (/usr/bin for example) to make this command work globally.

$ sudo cp bin/importsort-d /usr/bin/

or add this into your .bashrc, .zshrc, etc.

export PATH=$PATH:"<path/to/importsort-d>/bin/" # on bash or zsh
fish_add_path "<path/to/importsort-d>/bin/"     # on fish-shell

Building with DUB

$ dub fetch importsort-d
$ dub run importsort-d -- --help

This won't install the command globally, you always have to run dub run importsort-d <args>

Usage

$ importsort-d [-h] [-v] [-r] [-m] [-i] [-o <out>] [-k] [-a] [-r] <input...>

input may be omitted or set to - to read from STDIN

| option | description | | --------------------- | ---------------------------------------------- | | -h, --help | prints a help message | | -v, --verbose | prints useful debug messages | | | | | -k, --keep | keeps the line as-is instead of formatting | | -a, --attribute | public and static imports first | | -b, --binding | sorts by binding rather then the original | | -m, --merge | merge imports which uses same file | | | | | -r, --recursive | recursively search in directories | | -i, --inline | changes the input | | -o, --output <path> | writes to path rather then writing to STDOUT |

Documentation

Look at the documentation at dpldocs.info, if you want to use this project in code.

FAQ

How to add importsort-d to Visual Studio Code?

There's a plugin called Run on Save. You can install it and set importsort-d as an onSave-hook:

...
"emeraldwalk.runonsave": {
    "commands": [
        {
            "cmd": "importsort-d -i ${file}",
            "match": "\\.d$"
        }
    ]
},
...

How to add importsort-d to VIM/NeoVIM?

Just add this to your .vimrc or init.vim

:autocmd BufWritePost * silent !importsort-d -i <afile>

Are cats cool?

Yes

ToDo's

• [x] recursive searching (v0.2.0)
• [x] merge imports (v0.3.0)
• [ ] watch-mode (struggling with save-timings - can clear files)
• you can add importsort-d into your onSave-hooks
• [ ] support multiple imports in one line (demilited by ;)
• [ ] stripping unused imports (maybe)

you got some ideas? Issue them!

Changelog

v0.1.0

• the very first version
• not a lot is implemented

v0.2.0

• added --recursive (see above)
• option --keep becomes disabling formatting
• option --inline doen't copy the original but creates a *.new and renames it afterwards
• option --original becomes --binding and sorts by original by default
• refactoring code

v0.3.0

• added --merge (see above)

v0.3.1

• added documentation for contributers (or people who really want to see my code)

License

This whole project is licensed under the beautiful terms of the zlib-license.

Further information here.

made with love and a lot of cat memes