Merge bc767a0ad3 into e2a8e815e9

README.md

@@ -10,7 +10,7 @@ pairing with smart people at Hashrocket.
 
 For a steady stream of TILs, [sign up for my newsletter](https://crafty-builder-6996.ck.page/e169c61186).
 
-_1567 TILs and counting..._
+_1569 TILs and counting..._
 
 See some of the other learning resources I work on:
 - [Ruby Operator Lookup](https://www.visualmode.dev/ruby-operators)
@@ -1009,6 +1009,7 @@ See some of the other learning resources I work on:
 - [Hash Slicing](rails/hash-slicing.md)
 - [Ignore Poltergeist JavaScript Errors](rails/ignore-poltergeist-javascript-errors.md)
 - [Include Devise Helpers In Your Controller Tests](rails/include-devise-helpers-in-your-controller-tests.md)
+- [Inspect Configuration Of Database Connection](rails/inspect-configuration-of-database-connection.md)
 - [Inspect Previous Changes To ActiveRecord Object](rails/inspect-previous-changes-to-activerecord-object.md)
 - [Link To The Current Page With Query Params](rails/link-to-the-current-page-with-query-params.md)
 - [List All Installable Rails Versions](rails/list-all-installable-rails-versions.md)
@@ -1825,6 +1826,7 @@ See some of the other learning resources I work on:
 - [Send A Message To A Discord Channel](workflow/send-a-message-to-a-discord-channel.md)
 - [Set Recurring Reminders In Slack](workflow/set-recurring-reminders-in-slack.md)
 - [Show Linting Errors In Zed](workflow/show-linting-errors-in-zed.md)
+- [Temporarily Hide CleanShot X Capture Previews](workflow/temporarily-hide-cleanshot-x-capture-previews.md)
 - [Toggle Between Stories In Storybook](workflow/toggle-between-stories-in-storybook.md)
 - [Update asdf Plugins With Latest Package Versions](workflow/update-asdf-plugins-with-latest-package-versions.md)
 - [View The PR For The Current GitHub Branch](workflow/view-the-pr-for-the-current-github-branch.md)

rails/inspect-configuration-of-database-connection.md

@@ -0,0 +1,45 @@
+# Inspect Configuration Of Database Connection
+
+There are a lot of factors that can effect the database configuration values.
+
+- What are the settings in each environment in `config/database.yml`?
+- Is there any dynamic ERB code in `config/database.yml`?
+- Is `DATABASE_URL` set in the current environment?
+- Is any other code overriding these settings?
+
+To check the current _configuration hash_ for the database connection at
+runtime, we can run the following statement:
+
+```ruby
+> ActiveRecord::Base.connection.pool.db_config.configuration_hash
+=>
+{:adapter=>"postgresql",
+ :encoding=>"unicode",
+ :host=>"::1",
+ :user=>"postgres",
+ :password=>"postgres",
+ :pool=>5,
+ :database=>"still_development",
+ :port=>9875}
+```
+
+In this case, I'm running the statement from the Rails console of my app's
+development environment.
+
+I could even access and print these values as part of debugging in a production
+environment with a rake task:
+
+```ruby
+# In lib/tasks/debug.rake
+namespace :debug do
+  task :db_config => :environment do
+    puts "==== Database Configuration Debug ===="
+    puts "DATABASE_URL: #{ENV['DATABASE_URL']}"
+    puts "Active Record Config: #{ActiveRecord::Base.connection.pool.db_config.configuration_hash}"
+    puts "Raw ENV dump:"
+    ENV.sort.each { |k,v| puts "#{k}: #{v}" if k.include?('DB') || k.include?('DATABASE') }
+  end
+end
+```
+
+[source](https://api.rubyonrails.org/classes/ActiveRecord/DatabaseConfigurations/HashConfig.html)

workflow/convert-an-epub-document-to-pdf-on-mac.md

@@ -6,7 +6,7 @@ convert it using the `ebook-convert` binary from `Calibre`.
 First, install `Calibre`:
 
 ```bash
-$ brew cask install calibre
+$ brew install --cask calibre
 ```
 
 Then convert your ePub using `ebook-convert`:

workflow/temporarily-hide-cleanshot-x-capture-previews.md

@@ -0,0 +1,14 @@
+# Temporarily Hide CleanShot X Capture Previews
+
+The _capture previews_ that CleanShot X provides are a useful part of my
+workflow. I often capture a screenshot or recording a bit in advance of needing
+to add it as, say, an attachment. The preview icons float off to the right of
+my screen, generally out of the way. As soon as I need them, I can annotate,
+drag-n-drop, etc.
+
+Sometimes, however, they do get in the way. But I'm not ready to dismiss them
+and I don't want to save them off to some folder buried in my file system.
+
+To temporarily slide the capture previews down off the screen, I can hit the
+shortcut `Ctrl+Opt+Cmd+H`. The arrow at the butto of the screen can be clicked
+to unhide them, or I can hit the same shortcut sequence to reveal them.