aboutsummaryrefslogtreecommitdiff
path: root/posts/mail.md
diff options
context:
space:
mode:
authorBradley Taunt <bt@btxx.org>2024-06-06 08:05:12 -0400
committerBradley Taunt <bt@btxx.org>2024-06-06 08:05:12 -0400
commit6b742c459266b18e2b375b35205ce8a6c02f0452 (patch)
treeb16fbb9a045e33dd6c97eb5ab72e6ff4d9237ea3 /posts/mail.md
Initial commit
Diffstat (limited to 'posts/mail.md')
-rw-r--r--posts/mail.md42
1 files changed, 42 insertions, 0 deletions
diff --git a/posts/mail.md b/posts/mail.md
new file mode 100644
index 0000000..9a58f8e
--- /dev/null
+++ b/posts/mail.md
@@ -0,0 +1,42 @@
+# Working with `git` Patches in Apple Mail
+
+2023-05-11
+
+> **Before we begin**: You could likely automate this process in a more streamlined way, but for most use cases this workflow should be fine.
+
+I recently covered how to [work with git email patches in Evolution on Linux](/git-patches), so I thought it would make sense to walk through a similar workflow for those using Apple Mail on MacOS. The idea is essentially the same, with just a little extra work involved.
+
+## Create a "Patches" Mailbox
+
+The first thing you'll need to do is make a new `Patches` mailbox folder inside your existing mail account. Once done, your default Mail sidebar should look similar to the following:
+
+<figure>
+ <img src="/public/images/apple-mail-1.png" alt="The Apple Mail sidebar with the Patches folder present">
+ <figcaption>The Apple Mail sidebar with the "Patches" folder present</figcaption>
+</figure>
+
+## Applying Patches
+
+Now navigate to the email message containing a `git` patch. Right-click and select *Move to* > *Patches*. Now in the sidebar, right-click your *Patches* folder and select *Export Mailbox...*. You'll be prompted to save this folder locally. I suggest having a top-level folder named **Patches** to make things consistent.
+
+Inside this folder you should see something similar to the following structure:
+
+<figure>
+ <img src="/public/images/apple-mail-2.png" alt="The contents of the saved Patches mailbox folder">
+ <figcaption>The contents of the saved Patches mailbox folder</figcaption>
+</figure>
+
+Once saved, open your terminal, navigate to the project you wish to apply this new patch to:
+
+```
+cd my-path/very-cool-project
+```
+
+and then run:
+
+```
+git apply ~/Patches/<saved-patches-mailbox-folder>/mbox
+```
+
+Congrats! You've successfully applied a git email patch through Apple Mail! Well, kind of. The terminal did most of the *real* work. Just be sure to periodically *purge* your local *Patches* folder to keep things clean!
+