slack_message 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 30f694caf399c0408dab35d5f63be0dc5a06b0c3611f3fd43a9533877f5ca7b1
-  data.tar.gz: 18a0dbd642a9b505ec21c114cf36fc36b9a4319c02a6f9fa057ac8abe6136957
+  metadata.gz: fb63c39ef18b4b6e6fb1d25e62300fcff41b759f3d59902c10423c306f892007
+  data.tar.gz: 499f1d885b3a00e60af92ff9d0ba17c19f59ba3b1468d178498d08802c9429dd
 SHA512:
-  metadata.gz: 2768ef640f9e2ba0d79227c14f38c4c3288a218464251be81d4f9d182814b1b4540588b16a834e1077d45ce77a82da716de63ebb4fd0de513a261f4da2dd5abf
-  data.tar.gz: a62d68742f30637398c4a337b9fd815c4b0f035aabe51a1d0be2693c3a72d2fbb8fcbe54cccd9c8e6983c44c1d199909f9e36792ba86d396764cf37549af2966
+  metadata.gz: b0bf20b89e6ce48e9accb2ccd475d5f999686804d3c952e6a8903958af2f7b1500011f6abd904abba5f2cf73d635498f8c1feae7e4d00aa021b3ab0b6c1a5baa
+  data.tar.gz: 42a8e2ecc5b6ca51ec1ab534e2a91bb500e352e26636f1a5671bf81244a40b321162bed30e1e7e0a78e53490575fbb0052c9d39fb108951f73425269cfafbab5

data/CHANGELOG.md

@@ -2,11 +2,16 @@
 
 ## [Unreleased]
 
+## [1.3.0] - 2021-09-27
+- Added ability to use custom names when posting.
+- Added ability to post images within sections.
+- Added warnings for potentially invalid URLs.
+
 ## [1.2.0] - 2021-09-26
 - Turns out gemspec was broken. Fixed that.
 
 ## [1.1.0] - 2021-09-26
-- Expanded the README significantly w/ usage instructions
+- Expanded the README significantly w/ usage instructions.
 - Added lots of error handling to requests.
 
 ## [1.0.0] - 2021-09-25

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    slack_message (1.0.0)
+    slack_message (1.2.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -6,6 +6,14 @@ API](https://app.slack.com/block-kit-builder/) to make it easy to read and
 write messages to slack in your ruby application. It has zero dependencies and
 is built to be opinionated to keep your configuration needs low.
 
+Posting a message to Slack should be this easy:
+
+```ruby
+SlackMessage.post_to('#general') do
+  text "We did it @here! :thumbsup:"
+end
+```
+
 To install, just add `slack_message` to your bundle and you're ready to go.
 
 
@@ -63,11 +71,11 @@ end
 
 ### Usage
 
-Basic usage is pretty straightforward:
+As mentioned at the top, posting a message to Slack is dang easy:
 
 ```ruby
 SlackMessage.post_to('#general') do
-  text "We did it! :thumbsup:"
+  text "We did it @here! :thumbsup:"
 end
 ```
 
@@ -130,7 +138,7 @@ SlackMessage is able to build all kinds of rich messages for you, and has been
 a real joy to use for the author at least. To understand a bit more about the
 possibilities of blocks, see Slack's [Block Kit
 Builder](https://app.slack.com/block-kit-builder/) to understand the structure
-better:
+better. There are lots of options:
 
 ```ruby
 SlackMessage.post_to('#general') do
@@ -174,6 +182,15 @@ SlackMessage.post_to('#general', as: :sidekiq_bot) do
 end
 ```
 
+You can also use a custom name when sending a message:
+
+```ruby
+SlackMessage.post_to('#general') do
+  bot_name "CoffeeBot"
+
+  text ":coffee::clock: Time to take a break!"
+end
+```
 
 What it Doesn't Do
 ------------
@@ -190,7 +207,8 @@ DSL to include more of the block API itself.
 Also, some behaviors that are still planned but not yet added:
 
 * allow custom http_options in configuration
-* allow custom slack username per built message
+* more of BlockKit's options
+* any interactive elements at all (I don't understand them yet)
 
 Contributing
 ------------

data/lib/slack_message/configuration.rb

@@ -29,17 +29,19 @@ module SlackMessage::Configuration
 
   def self.add_profile(handle = :default, name:, url:)
     if @@profiles.include?(handle)
-      warn("WARNING: Overriding profile '#{handle}' in SlackMessage config")
+      warn "WARNING: Overriding profile '#{handle}' in SlackMessage config"
     end
 
     @@profiles[handle] = { name: name, url: url, handle: handle }
   end
 
-  def self.profile(handle)
+  def self.profile(handle, custom_name: nil)
     unless @@profiles.include?(handle)
       raise ArgumentError, "Unknown SlackMessage profile '#{handle}'."
     end
 
-    @@profiles[handle]
+    @@profiles[handle].tap do |profile|
+      profile[:name] = custom_name if !custom_name.nil?
+    end
   end
 end

data/lib/slack_message/dsl.rb

@@ -1,9 +1,10 @@
 class SlackMessage::Dsl
-  attr_reader :body, :default_section
+  attr_reader :body, :default_section, :custom_bot_name
 
   def initialize
     @body = []
     @default_section = Section.new
+    @custom_bot_name = nil
   end
 
   # allowable top-level entities within a block
@@ -38,12 +39,26 @@ class SlackMessage::Dsl
 
   def text(*args); default_section.text(*args); end
   def link_button(*args); default_section.link_button(*args); end
+  def image(*args); default_section.image(*args); end
   def blank_line(*args); default_section.blank_line(*args); end
   def link(*args); default_section.link(*args); end
   def list_item(*args); default_section.list_item(*args); end
 
   # end delegation
 
+  # custom bot name
+
+  def bot_name(name)
+    @custom_bot_name = name
+  end
+
+  # end bot name
+
+  def render
+    finalize_default_section
+    @body
+  end
+
   private
 
   # when doing things that would generate new top-levels, first try
@@ -56,11 +71,6 @@ class SlackMessage::Dsl
     @default_section = Section.new
   end
 
-  def render
-    finalize_default_section
-    @body
-  end
-
   class Section
     attr_reader :body
 
@@ -80,6 +90,15 @@ class SlackMessage::Dsl
 
     # styles:  default, primary, danger
     def link_button(label, target, style: :primary)
+      if !@body[:accessory].nil?
+        previous_type = @body[:accessory][:type]
+        warn "WARNING: Overriding previous #{previous_type} in section to use link_button instead: #{label}"
+      end
+
+      unless /(^|\s)((https?:\/\/)?[\w-]+(\.[\w-]+)+\.?(:\d+)?(\/\S*)?)/i =~ target
+        warn "WARNING: Passing a probably-invalid URL to link button #{label} (url: '#{target}')"
+      end
+
       config = {
         accessory: {
           type: "button",
@@ -99,6 +118,24 @@ class SlackMessage::Dsl
       @body.merge!(config)
     end
 
+    def image(url, alt_text: nil)
+      if !@body[:accessory].nil?
+        previous_type = @body[:accessory][:type]
+        warn "WARNING: Overriding previous #{previous_type} in section to use image instead: #{url}"
+      end
+
+      config = {
+        accessory: {
+          type: "image",
+          image_url: url
+        }
+      }
+
+      config[:accessory][:alt_text] = alt_text if !alt_text.nil?
+
+      @body.merge!(config)
+    end
+
     # for markdown links
     def link(label, target)
       "<#{target}|#{label}>"

data/lib/slack_message.rb

@@ -16,11 +16,14 @@ module SlackMessage
   end
 
   def self.post_to(target, as: :default, &block)
-    payload = build(&block)
-    profile = Configuration.profile(as)
+    payload = Dsl.new.tap do |instance|
+      instance.instance_eval(&block)
+    end
+
+    profile = Configuration.profile(as, custom_name: payload.custom_bot_name)
     target  = user_id_for(target) if target =~ /^\S{1,}@\S{2,}\.\S{2,}$/
 
-    Api.post(payload, target, profile)
+    Api.post(payload.render, target, profile)
   end
 
   def self.build(&block)

data/slack_message.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |gem|
   gem.name        = 'slack_message'
-  gem.version     = "1.2.0"
+  gem.version     = "1.3.0"
   gem.summary     = "A nice DSL for composing rich messages in Slack"
   gem.authors     = ["Joe Mastey"]
   gem.email       = 'hello@joemastey.com'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: slack_message
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Joe Mastey
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-09-26 00:00:00.000000000 Z
+date: 2021-09-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec