Find dir where certain dir or file exists

README.md

@@ -1013,6 +1013,30 @@ $ basename ~/Pictures/Downloads/
 Downloads
 ```
 
+## Find parent directory that contains a certain file or directory
+
+**Example Function:**
+
+```sh
+parent_find() {
+  [[ $1 == '/' ]] && return 1
+
+  [[ -e "$1/$2" ]] && printf '%s\n' "$1" && return 0
+
+  parent_find "$(dirname "$(realpath "$1")")" "$2"
+}
+```
+
+**Example Usage:**
+
+```shell
+$ pwd
+/home/black/Projects/awesome/src/assets
+
+$ parent_find "$PWD" .git
+/home/black/Projects/awesome/
+```
+
 <!-- CHAPTER END -->
 
 <!-- CHAPTER START -->

test.sh

@@ -109,6 +109,16 @@ test_basename() {
     assert_equals "$result" "1.jpg"
 }
 
+test_parent_find() {
+  local dir="$PWD/"
+
+  cd ./manuscript/
+
+  assert_equals "$dir" "$(parent_find "$PWD" .git)"
+
+  cd ../
+}
+
 test_hex_to_rgb() {
     result="$(hex_to_rgb "#FFFFFF")"
     assert_equals "$result" "255 255 255"