+git-dsf

	new file:   .editorconfig
	new file:   .github/dependabot.yml
	new file:   .gitignore
	new file:   .gitmodules
	new file:   bin/diff-so-fancy
	new file:   bin/git-dsf
	new file:   diff-so-fancy
	new file:   docs/README.md
	new file:   zsh-diff-so-fancy.plugin.zsh

Author: ss-o

.editorconfig

@@ -0,0 +1,15 @@
+# Note: VIM users should use alternate marks [[[ and ]]] as the original ones can confuse nested substitutions, e.g.: ${${${VAR}}}
+# # Space or Tabs? https://stackoverflow.com/questions/35649847/objective-reasons-for-using-spaces-instead-of-tabs-for-indentation
+
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+charset = utf-8
+end_of_line = lf
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[**.{md,rst}]
+trim_trailing_whitespace = false

.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: "gitsubmodule"
+    directory: "/"
+    schedule:
+      interval: "daily"

.gitignore

@@ -0,0 +1,43 @@
+!Build/
+.last_cover_stats
+/META.yml
+/META.json
+/MYMETA.*
+*.o
+*.pm.tdy
+*.bs
+
+# A popular plugin manager's files
+._zi
+._zinit
+._zplugin
+.zi_lastupd
+.zinit_lastupd
+.zplugin_lstupd
+
+# Devel::Cover
+cover_db/
+
+# Devel::NYTProf
+nytprof.out
+
+# Dizt::Zilla
+/.build/
+
+# Module::Build
+_build/
+Build
+Build.bat
+
+# Module::Install
+inc/
+
+# ExtUitls::MakeMaker
+/blib/
+/_eumm/
+/*.gz
+/Makefile
+/Makefile.old
+/MANIFEST.bak
+/pm_to_blib
+/*.zip

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "diff-so-fancy"]
+	path = diff-so-fancy
+	url = https://github.com/so-fancy/diff-so-fancy

bin/diff-so-fancy

@@ -0,0 +1 @@
+../diff-so-fancy/diff-so-fancy

bin/git-dsf

@@ -0,0 +1,10 @@
+#!/usr/bin/env sh
+
+# Git will search $PATH for this file, when invoked by "git dsf ...".
+
+f() {
+    [ -z "$GIT_PREFIX" ] || \
+        cd "$GIT_PREFIX" && \
+            git diff --color "$@" | diff-so-fancy | less --tabs=4 -iRFX
+}
+f "$@"

diff-so-fancy

@@ -0,0 +1,49 @@
+<h1> ZI + diff-so-fancy</h1>
+
+# Introduction
+
+The project [so-fancy/diff-so-fancy](https://github.com/so-fancy/diff-so-fancy) integration with ZI.
+
+With this [ZI](https://github.com/z-shell/zi) plugin, you simply add two lines to `.zshrc`:
+
+```zsh
+zi ice as"program" pick"bin/git-dsf"
+zi light z-shell/zsh-diff-so-fancy
+```
+
+This will install `diff-so-fancy` on every account where you use Zshell, and automatically
+equip `git` with subcommand `dsf`. No need to use system package manager and to configure
+`git`. Of course, if you have the following standard line in your `.gitconfig`, it will
+still work normally:
+
+```
+[core]
+pager = diff-so-fancy | less -FXRi
+```
+
+(because this plugin adds `diff-so-fancy` to `$PATH`).
+
+Think about Puppet or Chef, i.e. about declarative approach to system configuration.
+In this case `.zshrc` is like a declarative setup guarding you will have `diff-so-fancy`
+on your accounts.
+
+# A Few Details
+
+[so-fancy/diff-so-fancy](https://github.com/so-fancy/diff-so-fancy) is cloned from
+Github as submodule. The plugin has `bin/git-dsf` script which adds subcommand `dsf`
+to git. That's basically everything needed: convenient way of installing (single Zsh
+plugin manager invocation), updating (Zsh plugin managers can easily update) and
+integrating with `git`.
+
+# Other plugin managers
+
+```zsh
+# Zplug
+zplug "z-shell/zsh-diff-so-fancy", as:command, use:"bin/"
+
+# Zgen
+zgen load z-shell/zsh-diff-so-fancy
+```
+
+Without `as"program"`-like functionality the `.plugin.zsh` file picks up setup
+and simulates adding a command to system, so `Zgen` and other can work.

docs/README.md

@@ -0,0 +1,14 @@
+# Use as"command" (or as"program") feature of your plugin manager (like Zplug
+# or ZI), this file will be then ignored. If no such feature is available
+# in your plugin manager, load this plugin normally, this file will then set
+# up $PATH for "git dsf" to work. This file can be also plainly sourced.
+
+# See following web page for explanation of the line "ZERO=...":
+# https://github.com/z-shell/zi/wiki/Zsh-Plugin-Standard
+
+0="${${ZERO:-${0:#$ZSH_ARGZERO}}:-${(%):-%N}}"
+local _pth="${0:h}/bin"
+
+if [[ -z "${path[(r)$_pth]}" ]]; then
+    path+=( "$_pth" )
+fi