Emojis: option to use custom mapping

Author: ComputerDaddyGuy

CHANGELOG.md

@@ -8,6 +8,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ---
 ## [0.0.6] - Unreleased
 
+### Added
+- Emojis: option to use custom mapping
+
 ### Changed
 - Child limit: do not print skipped children count
 - Max depth: do not print "max depth reached"

README.md

@@ -167,13 +167,13 @@ sorting/
 ```
 
 ## Emojis ❤️
-If your terminal supports them, you can choose to use emojis.
+You can choose to use default built-in emojis, or define your own emoji mapping.
 Folders use the 📂 emoji, and files will have an emoji depending on their extension (when applicable).
 
 ```java
 // Example: Emojis.java
 var prettyPrinter = FileTreePrettyPrinter.builder()
-    .customizeOptions(options -> options.withEmojis(true))
+    .customizeOptions(options -> options.withDefaultEmojis()) // or withEmojis(EmojiMapping) for custom mapping
     .build();
 ```
 
@@ -194,9 +194,6 @@ var prettyPrinter = FileTreePrettyPrinter.builder()
 └─ 🎬 file.avi
 ```
 
-> [!TIP]
-> *Idea for a future version: option to allow custom emoji mapping*
-
 ## Child limit
 You can set a fixed limit to the number of children displayed for each directory. Each directory and file that pass the filter (if set) counts for one.
 

ROADMAP.md

@@ -5,6 +5,7 @@
   - [x] Option: filtering
   - [x] Option: ordering
   - [x] Option: emojis
+  - [x] Option: custom emojis mapping
   - [x] Option: compact directories display
   - [x] Option: line extension (=additional text after the file name)
   - [x] Option: children limit (static & dynamic)
@@ -31,12 +32,10 @@
   - [x] Publish on Maven Central!
 
 ## To do
-- [ ] Option: hide number of skipped files and folders for child limit
-- [ ] Option: custom emojis
-- [ ] Rework/fix Github wiki to be up to date
+- [ ] Option: custom tree format
 
 ## Backlog / To analyze / To implement if requested
-- [ ] Option: custom tree format
+- [ ] Rework/fix Github wiki to be up to date
 - [ ] Refactor unit tests (custom assert?)
 - [ ] Option: color
 - [ ] Option: Filename decorator

src/example/java/io/github/computerdaddyguy/jfiletreeprettyprinter/example/Emojis.java

@@ -6,7 +6,7 @@ public class Emojis {
 
 	public static void main(String[] args) {
 		var prettyPrinter = FileTreePrettyPrinter.builder()
-			.customizeOptions(options -> options.withEmojis(true))
+			.customizeOptions(options -> options.withDefaultEmojis())
 			.build();
 		var tree = prettyPrinter.prettyPrint("src/example/resources/emojis");
 		System.out.println(tree);

src/example/java/io/github/computerdaddyguy/jfiletreeprettyprinter/example/ProjectStructure.java

@@ -87,7 +87,7 @@ public static void main(String[] args) {
 		var prettyPrinter = FileTreePrettyPrinter.builder()
 			.customizeOptions(
 				options -> options
-					.withEmojis(true) // Use emojis!
+					.withDefaultEmojis() // Use emojis!
 					.withCompactDirectories(true) // Inline directory chains: "src/main/java/..."
 					.filterDirectories(dirFilter)
 					.filterFiles(fileFilter)

src/main/java/io/github/computerdaddyguy/jfiletreeprettyprinter/PrettyPrintOptions.java

@@ -1,6 +1,7 @@
 package io.github.computerdaddyguy.jfiletreeprettyprinter;
 
 import io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.RenderingOptions;
+import io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.emoji.EmojiMapping;
 import io.github.computerdaddyguy.jfiletreeprettyprinter.scanner.ScanningOptions;
 import java.nio.file.Path;
 import java.nio.file.PathMatcher;
@@ -95,21 +96,28 @@ public PrettyPrintOptions withTreeFormat(TreeFormat treeFormat) {
 
 	// ---------- Emojis ----------
 
-	private boolean emojis = false;
+	private EmojiMapping emojiMapping = EmojiMapping.none();
 
 	@Override
-	public boolean areEmojisUsed() {
-		return emojis;
+	public EmojiMapping getEmojiMapping() {
+		return emojiMapping;
 	}
 
 	/**
-	 * Whether or not use emojis in directory/filename rendering. Not all terminals supports emojis.
-	 * Default is {@code false}.
+	 * Use default emojis for directory/filename rendering.
+	 */
+	public PrettyPrintOptions withDefaultEmojis() {
+		this.emojiMapping = EmojiMapping.createDefault();
+		return this;
+	}
+
+	/**
+	 * Use the given emojis mapping for directory/filename rendering.
 	 * 
-	 * @param useEmojis	{@code true} to use emojis, {@code false} otherwise.
+	 * @see EmojiMapping
 	 */
-	public PrettyPrintOptions withEmojis(boolean useEmojis) {
-		this.emojis = useEmojis;
+	public PrettyPrintOptions withEmojis(EmojiMapping mapping) {
+		this.emojiMapping = Objects.requireNonNull(mapping, "mapping is null");
 		return this;
 	}
 

…/renderer/file/DefaultFileFormatter.java …inter/renderer/DefaultFileFormatter.javasrc/main/java/io/github/computerdaddyguy/jfiletreeprettyprinter/renderer/file/DefaultFileFormatter.java renamed to src/main/java/io/github/computerdaddyguy/jfiletreeprettyprinter/renderer/DefaultFileFormatter.java src/main/java/io/github/computerdaddyguy/jfiletreeprettyprinter/renderer/file/DefaultFileFormatter.java renamed to src/main/java/io/github/computerdaddyguy/jfiletreeprettyprinter/renderer/DefaultFileFormatter.java

@@ -1,4 +1,4 @@
-package io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.file;
+package io.github.computerdaddyguy.jfiletreeprettyprinter.renderer;
 
 import io.github.computerdaddyguy.jfiletreeprettyprinter.scanner.TreeEntry.DirectoryEntry;
 import io.github.computerdaddyguy.jfiletreeprettyprinter.scanner.TreeEntry.FileEntry;

src/main/java/io/github/computerdaddyguy/jfiletreeprettyprinter/renderer/DefaultLineRenderer.java

@@ -2,7 +2,6 @@
 
 import io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.depth.Depth;
 import io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.depth.DepthFormatter;
-import io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.file.FileFormatter;
 import io.github.computerdaddyguy.jfiletreeprettyprinter.scanner.TreeEntry.DirectoryEntry;
 import io.github.computerdaddyguy.jfiletreeprettyprinter.scanner.TreeEntry.FileEntry;
 import io.github.computerdaddyguy.jfiletreeprettyprinter.scanner.TreeEntry.MaxDepthReachEntry;

…er/renderer/file/EmojiFileFormatter.java …printer/renderer/EmojiFileFormatter.javasrc/main/java/io/github/computerdaddyguy/jfiletreeprettyprinter/renderer/file/EmojiFileFormatter.java renamed to src/main/java/io/github/computerdaddyguy/jfiletreeprettyprinter/renderer/EmojiFileFormatter.java src/main/java/io/github/computerdaddyguy/jfiletreeprettyprinter/renderer/file/EmojiFileFormatter.java renamed to src/main/java/io/github/computerdaddyguy/jfiletreeprettyprinter/renderer/EmojiFileFormatter.java

@@ -1,5 +1,6 @@
-package io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.file;
+package io.github.computerdaddyguy.jfiletreeprettyprinter.renderer;
 
+import io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.emoji.EmojiMapping;
 import io.github.computerdaddyguy.jfiletreeprettyprinter.scanner.TreeEntry.DirectoryEntry;
 import io.github.computerdaddyguy.jfiletreeprettyprinter.scanner.TreeEntry.FileEntry;
 import io.github.computerdaddyguy.jfiletreeprettyprinter.scanner.TreeEntry.MaxDepthReachEntry;
@@ -22,7 +23,7 @@ public EmojiFileFormatter(FileFormatter decorated, EmojiMapping emojiMapping) {
 	}
 
 	private String getFileEmojiPrefix(Path p) {
-		var emoji = emojiMapping.getFileEmoji(p);
+		var emoji = emojiMapping.getPathEmoji(p);
 		return getEmojiPrefix(emoji);
 	}
 

…printer/renderer/file/FileFormatter.java …rettyprinter/renderer/FileFormatter.javasrc/main/java/io/github/computerdaddyguy/jfiletreeprettyprinter/renderer/file/FileFormatter.java renamed to src/main/java/io/github/computerdaddyguy/jfiletreeprettyprinter/renderer/FileFormatter.java src/main/java/io/github/computerdaddyguy/jfiletreeprettyprinter/renderer/file/FileFormatter.java renamed to src/main/java/io/github/computerdaddyguy/jfiletreeprettyprinter/renderer/FileFormatter.java

@@ -1,5 +1,6 @@
-package io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.file;
+package io.github.computerdaddyguy.jfiletreeprettyprinter.renderer;
 
+import io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.emoji.EmojiMapping;
 import io.github.computerdaddyguy.jfiletreeprettyprinter.scanner.TreeEntry.DirectoryEntry;
 import io.github.computerdaddyguy.jfiletreeprettyprinter.scanner.TreeEntry.FileEntry;
 import io.github.computerdaddyguy.jfiletreeprettyprinter.scanner.TreeEntry.MaxDepthReachEntry;
@@ -9,7 +10,7 @@
 import org.jspecify.annotations.NullMarked;
 
 @NullMarked
-public interface FileFormatter {
+interface FileFormatter {
 
 	String formatDirectoryBegin(DirectoryEntry dirEntry, List<Path> dirs);
 
@@ -23,10 +24,6 @@ static FileFormatter createDefault() {
 		return new DefaultFileFormatter();
 	}
 
-	static FileFormatter wrapWithEmojis(FileFormatter decorated) {
-		return wrapWithEmojis(decorated, EmojiMapping.createDefault());
-	}
-
 	static FileFormatter wrapWithEmojis(FileFormatter decorated, EmojiMapping emojiMapping) {
 		return new EmojiFileFormatter(decorated, emojiMapping);
 	}