Add Create Interactive Picker For Set Of Subtasks as a Taskfile TIL

README.md

@@ -10,7 +10,7 @@ pairing with smart people at Hashrocket.
 
 For a steady stream of TILs, [sign up for my newsletter](https://visualmode.kit.com/newsletter).
 
-_1712 TILs and counting..._
+_1715 TILs and counting..._
 
 See some of the other learning resources I work on:
 
@@ -1412,6 +1412,7 @@ If you've learned something here, support my efforts writing daily TILs by
 - [Install Latest Version Of Ruby With asdf](ruby/install-latest-version-of-ruby-with-asdf.md)
 - [Invoking Rake Tasks Multiple Times](ruby/invoking-rake-tasks-multiple-times.md)
 - [IRB Has Built-In Benchmarking With Ruby 3](ruby/irb-has-built-in-benchmarking-with-ruby-3.md)
+- [Join URI Path Parts](ruby/join-uri-path-parts.md)
 - [Jump Out Of A Nested Context With Throw/Catch](ruby/jump-out-of-a-nested-context-with-throw-catch.md)
 - [Last Raised Exception In The Call Stack](ruby/last-raised-exception-in-the-call-stack.md)
 - [Limit Split](ruby/limit-split.md)
@@ -1533,6 +1534,7 @@ If you've learned something here, support my efforts writing daily TILs by
 
 ### Taskfile
 
+- [Create Interactive Picker For Set Of Subtasks](taskfile/create-interactive-picker-for-set-of-subtasks.md)
 - [Run A Task If It Meets Criteria](taskfile/run-a-task-if-it-meets-criteria.md)
 
 ### tmux
@@ -1568,6 +1570,7 @@ If you've learned something here, support my efforts writing daily TILs by
 - [Reset An Option Back To Its Default Value](tmux/reset-an-option-back-to-its-default-value.md)
 - [Set Environment Variables When Creating Session](tmux/set-environment-variables-when-creating-session.md)
 - [Set Session Specific Environment Variables](tmux/set-session-specific-environment-variables.md)
+- [Set Up Forwarding Prefix For Nested Session](tmux/set-up-forwarding-prefix-for-nested-session.md)
 - [Show The Current Value For An Option](tmux/show-the-current-value-for-an-option.md)
 - [Swap Split Panes](tmux/swap-split-panes.md)
 - [Switch To A Specific Session And Window](tmux/switch-to-a-specific-session-and-window.md)

ruby/join-uri-path-parts.md

@@ -0,0 +1,43 @@
+# Join URI Path Parts
+
+The
+[`URI.join`](https://ruby-doc.org/stdlib-2.5.1/libdoc/uri/rdoc/URI.html#method-c-join)
+method seems like a handy way to combine a base URL with some subpath. However,
+there are some subtle gotchas depending on where forward slashes appear in the
+two arguments.
+
+Let's first look at the, in my opinion, desired behavior:
+
+```ruby
+> URI.join("https://example.com/api/v1/", "users")
+=> #<URI::HTTPS https://example.com/api/v1/users>
+```
+
+The base URL has a trailing slash and the path that I want to join to it has no
+leading slash. The result is a path where `users` is joined to the end of the
+base URL. That's what I'm looking for.
+
+Now, let's see some variations on the above approach that give results that I
+wasn't expecting and don't want.
+
+```ruby
+> URI.join("https://example.com/api/v1", "/users") # 1
+=> #<URI::HTTPS https://example.com/users>
+> URI.join("https://example.com/api/v1", "users") # 2
+=> #<URI::HTTPS https://example.com/api/users>
+> URI.join("https://example.com/api/v1/", "/users") # 3
+=> #<URI::HTTPS https://example.com/users>
+```
+
+1. No trailing slash on the base URL. Leading slash on the path to join. The
+   path portion of the base URL is wiped out and `/users` is joined in.
+2. No trailing slash on the base URL. No leading slash on the path to join. The
+   `users` path replaces the last part of the path in the base URL.
+3. Both a trailing slash in the base URL and a leading slash in the path to
+   join. Same behavior as 1.
+
+I have two takeaways from this:
+- Use with caution. If I'm going to use `URI.join` for this purpose, I need to
+  be careful to only use the form in the first code block.
+- The `URI.join` method is probably meant to be primarily used to join a domain
+  (e.g. `http://example.com`) that has no path with some path segment.

taskfile/create-interactive-picker-for-set-of-subtasks.md

@@ -0,0 +1,74 @@
+# Create Interactive Picker For Set Of Subtasks
+
+For [my TIL repo](https://github.com/jbranchaud/til), I have a `Taskfile.yml`
+that defines a set of `notes:*` tasks for interacting with a `NOTES.md` file
+that lives in a private Git submodule.
+
+I wanted to make it easier on myself to not have to remember all the different
+`notes` subtasks, so I created a helper task to make it easy to see the options
+and run one.
+
+A summary of the Taskfile is shown below including the entirety of the `notes`
+task. That task will parse a listing of the available tasks (via `task --list`
+and some `sed` commands) and pass those to `fzf` to provide an interactive
+picker of the available subtasks.
+
+```yaml
+tasks:
+  notes:
+    desc: Interactive picker for notes tasks
+    cmds:
+      - |
+        TASK=$(task --list | grep "^\* notes:" | sed 's/^\* notes://' | sed 's/\s\+/ - /' | fzf --prompt="Select notes task: " --height=40% --reverse) || true
+        if [ -n "$TASK" ]; then
+          TASK_NAME=$(echo "$TASK" | awk '{print $1}' | sed 's/:$//')
+          task notes:$TASK_NAME
+        fi
+    interactive: true
+    silent: true
+
+  notes:edit:
+    ...
+
+  notes:sync:
+    ...
+
+  notes:open:
+    ...
+
+  notes:push:
+    ...
+
+  notes:status:
+    ...
+
+  notes:pull:
+    ...
+
+  notes:diff:
+    ...
+
+  notes:log:
+    ...
+```
+
+Now I can run the `notes` task to get a summary and interactive picker that
+looks like the following:
+
+```sh
+❯ task notes
+Select notes task: 
+  9/9
+> │                    Interactive picker for notes tasks
+  diff:                Show uncommitted changes in notes
+  edit:                All-in-one edit, commit, and push notes
+  log:                 Show recent commit history for notes
+  open:                Opens NOTES.md (syncs latest changes first) in default editor
+  pull:                Pull latest changes (alias for sync)
+  push:                Commit and push changes to notes submodule
+  status:              Check status of notes submodule
+  sync:                Sync latest changes from the notes submodule
+```
+
+It pulls in the subtask name and description. I can then use `fzf`'s navigation
+and filtering to narrow down and select the task I want to run.

tmux/set-up-forwarding-prefix-for-nested-session.md

@@ -0,0 +1,24 @@
+# Set Up Forwarding Prefix For Nested Session
+
+I use
+[`ctrl-z`](https://github.com/jbranchaud/dotfiles/blob/main/config/tmux/tmux.conf#L57)
+(instead of `ctrl-b`) for my tmux prefix key. I also have [`ctrl-z
+ctrl-z`](https://github.com/jbranchaud/dotfiles/blob/main/config/tmux/tmux.conf#L138-L139)
+configured to toggle back and forth between the previously visited window.
+
+With that in mind, I needed to set up a specific keybinding to send the prefix
+key to an inner (nested) tmux session. That's because sometimes, like with a
+tool such as `overmind`, you can end up connected to a tmux session while
+already within a tmux session.
+
+So, I have `Ctrl-z a` send the prefix key to the inner tmux session. This is
+what I added to my
+[`tmux.conf`](https://github.com/jbranchaud/dotfiles/blob/main/config/tmux/tmux.conf#L167-L168):
+
+```
+# send prefix to inner tmux session (C-z a)
+bind-key a send-prefix
+```
+
+Simply doing `Ctrl-z d` will detach me from the outer tmux session. If I want to
+detach from an inner tmux session, I can use my new keybinding -- `Ctrl-z a d`.