importsort-d

commit f23ea2703f61fe9efb59bf092c71c3dfe15b29c9
parent a5280797420210554540cfa26a89b2098cede2ab
Author: Friedel Schoen <[email protected]>
Date:   Sun, 23 Oct 2022 16:08:07 +0200

adding a page

Diffstat:
A
docs/index.md
 | 
91
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
M
src/sort.d
 | 
5
++++-

2 files changed, 95 insertions(+), 1 deletion(-)
diff --git a/docs/index.md b/docs/index.md
@@ -0,0 +1,90 @@
+# Sort Imports for [D](https://dlang.org/)
+
+<img src="assets/importsort-d.png" alt="logo" width="256" /> 
+
+`sortimport-d` can sort your dozens of `import`'s in a `.d` file (no matter where)
+
+## Installation
+
+## Prerequisite
+
+- [`dub`](https://dub.pm/)
+
+### 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.
+
+### 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] [-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 |
+
+## 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 (e. g. [Run on Save](https://marketplace.visualstudio.com/items?itemName=emeraldwalk.RunOnSave) on VSCode)
+- [ ] support multiple imports in one line (demilited by `;`)
+- [ ] stripping unused imports (maybe)
+
+## 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 wan't to see my code)
+
+## License
+
+This whole project is licensed under the beautiful terms of the `zlib-license`.
+
+Further information [here](LICENSE)
+
+> made with love and a lot of cat memes
+\ No newline at end of file
diff --git a/src/sort.d b/src/sort.d
@@ -81,6 +81,9 @@ struct Import {
 	/// spaces before the import (indentation)
 	string begin;
 
+	/// the newline
+	string end;
+
 	/// the string to sort
 	string sortBy() {
 		if (byAttribute && (public_ || static_))
@@ -136,7 +139,7 @@ void writeImports(File outfile, SortConfig config, Import[] matches) {
 					outfile.write(begin ~ ident.original);
 				}
 			}
-			outfile.writef(";%s", m.end);
+			outfile.writef(";", m.end);
 		}
 	}
 }