slack-ruby-block-kit 0.16.0 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3e3c462f9ce5026a4b9121b70e19a956af86b3920635cc88499c3f4ee0b49c8d
-  data.tar.gz: c7a671b81c0f5653ad7d81f1e4c6e19e2464c79e8159ae8dd910e6690aad3d4d
+  metadata.gz: 122d7e0273762e60628682a4874b0c5c148312b3cc62e9659c0c42dff2f200d6
+  data.tar.gz: c5d1685745d2bf0bc12813e96ecd14c87a1a21fad9d81c27a29dac243891b1a9
 SHA512:
-  metadata.gz: b9a94934add60e950ac68cf1e00186e3cb9811a35d8a6f3d37b80afb09f0772075956941587030cbfe1ae6d4735582f0a1a7904482ff84b7dc694bae4624dbef
-  data.tar.gz: 9205b0d1d67a2e82b518f39b4cf056960bd71adc9d756592dfe2a803268017eb629f8f5fe63d6eed4f5abbf395a02ed395d453c673bd20e04085e472f0019051
+  metadata.gz: 6e9df8d14a98baff1b3783c159527277d9e25d61f8fd68ff113d2449ad447611f80d1b023950733c1d159345d3359f6fe08c6bd70254b085ffbfa77613abd97b
+  data.tar.gz: 3cd7a5724578d354345bfbe11014c37f8ce4d2515c59bfe2cfdd139aaee4fa8bd71418811abe59500c0bac3950d14bf91891053c247144df0d76b9f70142f165

data/.devcontainer/Dockerfile

@@ -0,0 +1 @@
+FROM mcr.microsoft.com/vscode/devcontainers/ruby:0-2.7

data/.devcontainer/devcontainer.json

@@ -0,0 +1,11 @@
+{
+	"name": "Ruby",
+	"build": {
+		"dockerfile": "Dockerfile"
+	},
+	"settings": {},
+	"extensions": [
+		"rebornix.Ruby"
+	],
+	"remoteUser": "vscode"
+}

data/.github/dependabot.yml

@@ -3,7 +3,8 @@ updates:
 - package-ecosystem: bundler
   directory: "/"
   schedule:
-    interval: daily
+    interval: weekly
+    day: thursday
   open-pull-requests-limit: 99
   reviewers:
   - CGA1123

data/.github/workflows/ci.yml

@@ -30,4 +30,5 @@ jobs:
       - run: bundle exec rubocop
       - run: bundle exec rspec --format progress
       - run: ./bin/deepsource report --analyzer test-coverage --key ruby --value-file ./coverage/.resultset.json
-        if: (github.event_name == 'push') || (github.event.pull_request.head.repo.full_name == github.repository) # don't run on forks which don't have access to DEEPSOURCE_DSN
+        # don't run on forks which don't have access to DEEPSOURCE_DSN
+        if: (env.DEEPSOURCE_DSN != '') && (github.event_name == 'push') || (github.event.pull_request.head.repo.full_name == github.repository) 

data/.github/workflows/release.yml

@@ -0,0 +1,31 @@
+name: Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      otp:
+        name: 'RubyGems OTP Code'
+        required: true
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 2.7
+      - name: Mask OTP
+        run: |
+          OTP=$(jq -r '.inputs.otp' $GITHUB_EVENT_PATH)
+          echo "::add-mask::$OTP"
+      - run: gem update --system
+      - run: git config --global user.email github-action@users.noreply.github.com
+      - run: git config --global user.name GitHub Actions
+      - run: git config --global user.password ${{ github.token }}
+      - run: bundle install
+      - run: bundle exec rake release
+        env:
+          GEM_HOST_API_KEY: ${{ secrets.RUBYGEMS_API_KEY }}
+          GEM_HOST_OTP_CODE: ${{ github.event.inputs.otp }}

data/.gitignore

@@ -1,4 +1,5 @@
-/.bundle/
+/.bundle
+/vendor/bundle
 /.yardoc
 /_yardoc/
 /coverage/

data/.rubocop.yml

@@ -83,5 +83,8 @@ Metrics/ClassLength:
 Metrics/CyclomaticComplexity:
   Max: 8
 
+Metrics/MethodLength:
+  Max: 25
+
 RSpec/ExampleLength:
-  Max: 6
+  Max: 25

data/CHANGELOG.md

@@ -8,7 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 
 ### Added
-- Added new `Layout::Actions#checkboxes` method (#96 by @ryanwilsonperkin)
+- N/A
 
 ### Changed
 - N/A
@@ -25,40 +25,59 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Security
 - N/A
 
+## [0.19.0] - 2022-09-05
 
-[Unreleased]: https://github.com/CGA1123/slack-ruby-block-kit/compare/v0.16.0...HEAD
+### Added
+- Added `Slack::BlockKit::Layout::Video` (#152 by @jcat4)
 
+This adds support for Slack's new Video Block.
 
----
+See: https://api.slack.com/reference/block-kit/blocks#video
 
 
-## [0.16.0] - 2021-06-23
+## [0.18.0] - 2022-08-26
 
-This release contains a breaking change on the `Layout::Actions` interface.
+### Added
+- `Slack::BlockKit::Layout::Input#Timepicker`
+- `Slack::BlockKit::Layout::Actions#timepicker`
+- `Slack::BlockKit::Layout::Section#timepicker`
 
-### Removed
-- `Layout::Actions#converstation_select` (use `#conversation_select` instead) (#97 by @ryanwilsonperkin)
+### Changed
+- `Slack::BlockKit::Element::Timepicker.initialize` now accepts `initial:`, `emoji:`, `placeholder:`
+- Rename `Slack::BlockKit::Element::DatePicker` to `Datepicker`
+- Rename `Slack::BlockKit::Layout::Actions#date_picker` to `#datepicker`
+- Rename `Slack::BlockKit::Layout::Section#date_picker` to `#datepicker`
+- `Slack::BlockKit::Blocks#input` now supports passing through the `optional:` parameter (@sophieklm)
 
-### Fixed
-- Fixed name of method in `Layout::Actions` to be `conversation_select` (#97 by @ryanwilsonperkin)
+### Removed
+- `Slack::BlockKit::Element::Timepicker#placeholder`
+- `Slack::BlockKit::Element::Timepicker#initial_time`
 
 
-[0.16.0]: https://github.com/CGA1123/slack-ruby-block-kit/compare/v0.15.0...v0.16.0
+## [0.17.0] - 2021-06-28
 
+### Added
+- `Slack::BlockKit::Formatting` with utility functions for Slack text formatting (#98 by @CGA1123)
 
----
 
+## [0.16.0] - 2021-06-23
 
-## [0.15.0] - 2021-06-14
+This release contains a breaking change on the `Layout::Actions` interface.
 
 ### Added
-- Support `dispatch_action` and `dispatch_action_config` (#94 by @deecewan)
+- Added new `Layout::Actions#checkboxes` method (#96 by @ryanwilsonperkin)
+
+### Removed
+- `Layout::Actions#converstation_select` (use `#conversation_select` instead) (#97 by @ryanwilsonperkin)
 
+### Fixed
+- Fixed name of method in `Layout::Actions` to be `conversation_select` (#97 by @ryanwilsonperkin)
 
-[0.15.0]: https://github.com/CGA1123/slack-ruby-block-kit/compare/v0.14.1...v0.15.0
 
+## [0.15.0] - 2021-06-14
 
----
+### Added
+- Support `dispatch_action` and `dispatch_action_config` (#94 by @deecewan)
 
 
 ## [0.14.1] - 2021-05-05
@@ -67,24 +86,12 @@ This release contains a breaking change on the `Layout::Actions` interface.
 - Allow Layout::Section to render without `text` (#87 by @pbendersky)
 
 
-[0.14.1]: https://github.com/CGA1123/slack-ruby-block-kit/compare/v0.14.0...v0.14.1
-
-
----
-
-
 ## [0.14.0] - 2021-02-06
 
 ### Added
 - `Slack::BlockKit::Blocks#header` (#74 by @rspeicher)
 
 
-[0.14.0]: https://github.com/CGA1123/slack-ruby-block-kit/compare/v0.13.0...v0.14.0
-
-
----
-
-
 ## [0.13.0] - 2020-12-29
 
 ### Added
@@ -96,12 +103,6 @@ This release contains a breaking change on the `Layout::Actions` interface.
 - Development dependencies now managed by bundler via Gemfile, rather than in gemspec
 
 
-[0.13.0]: https://github.com/CGA1123/slack-ruby-block-kit/compare/v0.12.0...v0.13.0
-
-
----
-
-
 ## [0.12.0] - 2020-10-06
 
 ### Added
@@ -113,12 +114,6 @@ This release contains a breaking change on the `Layout::Actions` interface.
 - `Slack::BlockKit::Element::StaticSelect#initial`, use the `initial:` keyword on `#option`
 
 
-[0.12.0]: https://github.com/CGA1123/slack-ruby-block-kit/compare/v0.11.0...v0.12.0
-
-
----
-
-
 ## [0.11.0] - 2020-10-03
 
 ### Added
@@ -131,12 +126,6 @@ This release contains a breaking change on the `Layout::Actions` interface.
 - Ruby2.7 kwarg deprecation warnings
 
 
-[0.11.0]: https://github.com/CGA1123/slack-ruby-block-kit/compare/v0.10.0...v0.11.0
-
-
----
-
-
 ## [0.10.0] - 2020-09-11
 
 ### Added
@@ -146,12 +135,15 @@ This release contains a breaking change on the `Layout::Actions` interface.
 - Fixed initial options in multi select blocks (#46 by @caalberts)
 
 
+[Unreleased]: https://github.com/CGA1123/slack-ruby-block-kit/compare/v0.19.0...HEAD
+[0.19.0]: https://github.com/CGA1123/slack-ruby-block-kit/compare/v0.18.0...v0.19.0
+[0.18.0]: https://github.com/CGA1123/slack-ruby-block-kit/compare/v0.17.0...v0.18.0
+[0.17.0]: https://github.com/CGA1123/slack-ruby-block-kit/compare/v0.16.0...v0.17.0
+[0.16.0]: https://github.com/CGA1123/slack-ruby-block-kit/compare/v0.15.0...v0.16.0
+[0.15.0]: https://github.com/CGA1123/slack-ruby-block-kit/compare/v0.14.1...v0.15.0
+[0.14.1]: https://github.com/CGA1123/slack-ruby-block-kit/compare/v0.14.0...v0.14.1
+[0.14.0]: https://github.com/CGA1123/slack-ruby-block-kit/compare/v0.13.0...v0.14.0
+[0.13.0]: https://github.com/CGA1123/slack-ruby-block-kit/compare/v0.12.0...v0.13.0
+[0.12.0]: https://github.com/CGA1123/slack-ruby-block-kit/compare/v0.11.0...v0.12.0
+[0.11.0]: https://github.com/CGA1123/slack-ruby-block-kit/compare/v0.10.0...v0.11.0
 [0.10.0]: https://github.com/CGA1123/slack-ruby-block-kit/compare/v0.9.0...v0.10.0
-
-
----
-
-See [releases] for previous changes.
-
-
-[releases]: https://github.com/CGA1123/slack-ruby-block-kit/releases

data/Gemfile

@@ -9,10 +9,10 @@ gem 'faraday', '~> 1'
 gem 'pry', '~> 0.14'
 gem 'rake', '~> 13'
 gem 'rspec', '~> 3'
-gem 'rspec_junit_formatter', '~> 0.4'
+gem 'rspec_junit_formatter', '~> 0.5'
 
-gem 'codecov', '~> 0.5', require: false
+gem 'codecov', '~> 0.6', require: false
 gem 'rubocop', '~> 1', require: false
-gem 'rubocop-rake', '~> 0.5', require: false
+gem 'rubocop-rake', '~> 0.6', require: false
 gem 'rubocop-rspec', '~> 2', require: false
 gem 'simplecov', '~> 0.21', require: false

data/Gemfile.lock

@@ -1,98 +1,110 @@
 PATH
   remote: .
   specs:
-    slack-ruby-block-kit (0.16.0)
+    slack-ruby-block-kit (0.19.0)
+      zeitwerk (~> 2.6)
 
 GEM
   remote: https://rubygems.org/
   specs:
     ast (2.4.2)
-    codecov (0.5.2)
+    codecov (0.6.0)
       simplecov (>= 0.15, < 0.22)
     coderay (1.1.3)
-    diff-lcs (1.4.4)
-    docile (1.3.5)
-    dotenv (2.7.6)
-    faraday (1.4.2)
+    diff-lcs (1.5.0)
+    docile (1.4.0)
+    dotenv (2.8.1)
+    faraday (1.10.2)
       faraday-em_http (~> 1.0)
       faraday-em_synchrony (~> 1.0)
       faraday-excon (~> 1.1)
+      faraday-httpclient (~> 1.0)
+      faraday-multipart (~> 1.0)
       faraday-net_http (~> 1.0)
-      faraday-net_http_persistent (~> 1.1)
-      multipart-post (>= 1.2, < 3)
+      faraday-net_http_persistent (~> 1.0)
+      faraday-patron (~> 1.0)
+      faraday-rack (~> 1.0)
+      faraday-retry (~> 1.0)
       ruby2_keywords (>= 0.0.4)
     faraday-em_http (1.0.0)
     faraday-em_synchrony (1.0.0)
     faraday-excon (1.1.0)
+    faraday-httpclient (1.0.1)
+    faraday-multipart (1.0.4)
+      multipart-post (~> 2)
     faraday-net_http (1.0.1)
-    faraday-net_http_persistent (1.1.0)
+    faraday-net_http_persistent (1.2.0)
+    faraday-patron (1.0.0)
+    faraday-rack (1.0.0)
+    faraday-retry (1.0.3)
     method_source (1.0.0)
-    multipart-post (2.1.1)
-    parallel (1.20.1)
-    parser (3.0.1.1)
+    multipart-post (2.2.3)
+    parallel (1.22.1)
+    parser (3.1.2.0)
       ast (~> 2.4.1)
     pry (0.14.1)
       coderay (~> 1.1)
       method_source (~> 1.0)
-    rainbow (3.0.0)
-    rake (13.0.3)
-    regexp_parser (2.1.1)
+    rainbow (3.1.1)
+    rake (13.0.6)
+    regexp_parser (2.3.1)
     rexml (3.2.5)
-    rspec (3.10.0)
-      rspec-core (~> 3.10.0)
-      rspec-expectations (~> 3.10.0)
-      rspec-mocks (~> 3.10.0)
-    rspec-core (3.10.1)
-      rspec-support (~> 3.10.0)
-    rspec-expectations (3.10.1)
+    rspec (3.11.0)
+      rspec-core (~> 3.11.0)
+      rspec-expectations (~> 3.11.0)
+      rspec-mocks (~> 3.11.0)
+    rspec-core (3.11.0)
+      rspec-support (~> 3.11.0)
+    rspec-expectations (3.11.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.10.0)
-    rspec-mocks (3.10.2)
+      rspec-support (~> 3.11.0)
+    rspec-mocks (3.11.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.10.0)
-    rspec-support (3.10.2)
-    rspec_junit_formatter (0.4.1)
+      rspec-support (~> 3.11.0)
+    rspec-support (3.11.0)
+    rspec_junit_formatter (0.5.1)
       rspec-core (>= 2, < 4, != 2.12.0)
-    rubocop (1.17.0)
+    rubocop (1.28.2)
       parallel (~> 1.10)
-      parser (>= 3.0.0.0)
+      parser (>= 3.1.0.0)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml
-      rubocop-ast (>= 1.7.0, < 2.0)
+      rubocop-ast (>= 1.17.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 1.4.0, < 3.0)
-    rubocop-ast (1.7.0)
-      parser (>= 3.0.1.1)
-    rubocop-rake (0.5.1)
-      rubocop
-    rubocop-rspec (2.4.0)
+    rubocop-ast (1.17.0)
+      parser (>= 3.1.1.0)
+    rubocop-rake (0.6.0)
       rubocop (~> 1.0)
-      rubocop-ast (>= 1.1.0)
+    rubocop-rspec (2.10.0)
+      rubocop (~> 1.19)
     ruby-progressbar (1.11.0)
-    ruby2_keywords (0.0.4)
+    ruby2_keywords (0.0.5)
     simplecov (0.21.2)
       docile (~> 1.1)
       simplecov-html (~> 0.11)
       simplecov_json_formatter (~> 0.1)
     simplecov-html (0.12.3)
-    simplecov_json_formatter (0.1.2)
-    unicode-display_width (2.0.0)
+    simplecov_json_formatter (0.1.3)
+    unicode-display_width (2.1.0)
+    zeitwerk (2.6.0)
 
 PLATFORMS
   ruby
   x86_64-darwin-19
+  x86_64-linux
 
 DEPENDENCIES
-  codecov (~> 0.5)
+  codecov (~> 0.6)
   dotenv (~> 2)
   faraday (~> 1)
   pry (~> 0.14)
   rake (~> 13)
   rspec (~> 3)
-  rspec_junit_formatter (~> 0.4)
+  rspec_junit_formatter (~> 0.5)
   rubocop (~> 1)
-  rubocop-rake (~> 0.5)
+  rubocop-rake (~> 0.6)
   rubocop-rspec (~> 2)
   simplecov (~> 0.21)
   slack-ruby-block-kit!

data/README.md

@@ -95,3 +95,15 @@ See [issues](https://github.com/CGA1123/slack-ruby-block-kit/issues) if you want
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Releasing
+
+Releasing is automated via the `.github/workflows/release.yml` which allows for
+an OTP code to be passed in to authorize the release with MFA. If GitHub
+Actions is running slow it might take another attempt to make sure the OTP code
+is still valid when the workflow tries to push.
+
+- Update `CHANGELOG` for the latest version (remember to update the comparison links + add in an `Unreleased` section again)
+- Update `lib/slack/block_kit/version.rb` and run `bundle` to update the `Gemfile.lock`
+- Push that!
+- Run the `Release` workflow

data/lib/slack/block_kit/blocks.rb

@@ -55,6 +55,19 @@ module Slack
         append(block)
       end
 
+      def video(alt_text:, thumbnail_url:, video_url:, title:, description:, **optional_args)
+        block = Layout::Video.new(
+          alt_text: alt_text,
+          thumbnail_url: thumbnail_url,
+          video_url: video_url,
+          title: title,
+          description: description,
+          **optional_args
+        )
+
+        append(block)
+      end
+
       def section(block_id: nil)
         block = Layout::Section.new(block_id: block_id)
 
@@ -63,12 +76,13 @@ module Slack
         append(block)
       end
 
-      def input(label:, hint: nil, block_id: nil, dispatch_action: nil)
+      def input(label:, hint: nil, block_id: nil, dispatch_action: nil, optional: nil)
         block = Layout::Input.new(
           label: label,
           hint: hint,
           block_id: block_id,
-          dispatch_action: dispatch_action
+          dispatch_action: dispatch_action,
+          optional: optional
         )
 
         yield(block) if block_given?

data/lib/slack/block_kit/element/{date_picker.rb → datepicker.rb}

@@ -9,7 +9,7 @@ module Slack
       # Date picker elements can be used inside of section and actions blocks.
       #
       # https://api.slack.com/reference/messaging/block-elements#datepicker
-      class DatePicker
+      class Datepicker
         include Composition::ConfirmationDialog::Confirmable
 
         TYPE = 'datepicker'

data/lib/slack/block_kit/element/timepicker.rb

@@ -15,25 +15,14 @@ module Slack
 
         TYPE = 'timepicker'
 
-        def initialize(action_id:)
-          @placeholder, @initial_time = nil
+        def initialize(action_id:, placeholder: nil, initial: nil, emoji: nil)
+          @placeholder = placeholder_text(placeholder, emoji) if placeholder
+          @initial_time = initial
           @action_id = action_id
 
           yield(self) if block_given?
         end
 
-        def placeholder(text:, emoji: nil)
-          @placeholder = Composition::PlainText.new(text: text, emoji: emoji)
-
-          self
-        end
-
-        def initial_time(time_str)
-          @initial_time = time_str
-
-          self
-        end
-
         def as_json(*)
           {
             type: TYPE,
@@ -43,6 +32,14 @@ module Slack
             confirm: confirm&.as_json
           }.compact
         end
+
+        private
+
+        def placeholder_text(text, emoji)
+          return unless text
+
+          Composition::PlainText.new(text: text, emoji: emoji)
+        end
       end
     end
   end

data/lib/slack/block_kit/formatting.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+module Slack
+  module BlockKit
+    # Formatting contains some utility functions to help formatting text
+    #
+    # See: https://api.slack.com/reference/surfaces/formatting
+    module Formatting
+      extend self # rubocop:disable Style/ModuleFunction
+
+      DATE_FORMAT_TOKENS = [
+        # 2014-02-18
+        DATE_NUM = '{date_num}',
+
+        # February 18th, 2014
+        DATE = '{date}',
+
+        # Feb 18, 2014
+        DATE_SHORT = '{date_short}',
+
+        # Tuesday, February 18th, 2014
+        DATE_LONG = '{date_long}',
+
+        # February 18th, 2014 but uses "yesterday", "today", or "tomorrow"
+        # where
+        # appropriate
+        DATE_PRETTY = '{date_pretty}',
+
+        # Feb 18, 2014 but uses "yesterday", "today", or "tomorrow" where
+        # appropriate
+        DATE_SHORT_PRETTY = '{date_short_pretty}',
+
+        # Tuesday, February 18th, 2014 but uses "yesterday", "today", or
+        # "tomorrow" where appropriate
+        DATE_LONG_PRETTY = '{date_long_pretty}',
+
+        # 6:39 AM or 6:39 PM / 06:39 or 18:39 (depending on user preferences)
+        TIME = '{time}',
+
+        # 6:39:45 AM 6:39:42 PM / 06:39:45 or 18:39:42 (depending on user
+        # preferences)
+        TIME_SECS = '{time_secs}'
+      ].freeze
+
+      # Format a URL
+      #
+      # See: https://api.slack.com/reference/surfaces/formatting#links
+      def link(url, link_text: nil)
+        "<#{[url, link_text].compact.join('|')}>"
+      end
+
+      # Format a mailto link
+      #
+      # See: https://api.slack.com/reference/surfaces/formatting#links
+      def mailto(address, link_text: nil)
+        "<mailto:#{[address, link_text].compact.join('|')}>"
+      end
+
+      # Link a public channel
+      #
+      # See: https://api.slack.com/reference/surfaces/formatting#linking-channels
+      def channel(identifier)
+        "<##{identifier}>"
+      end
+
+      # Mention a user
+      #
+      # See: https://api.slack.com/reference/surfaces/formatting#mentioning-users
+      def user(identifier)
+        "<@#{identifier}>"
+      end
+
+      # Mention a group
+      #
+      # See: https://api.slack.com/reference/surfaces/formatting#mentioning-groups
+      def group(identifier)
+        "<!subteam^#{identifier}>"
+      end
+
+      # Mention @here (all active users in the current channel)
+      #
+      # See: https://api.slack.com/reference/surfaces/formatting#special-mentions
+      def at_here
+        # additional "|here" is for supporting very old mobile clients apparently!
+        '<!here|here>'
+      end
+
+      # Mention @channel (all users in the current channel)
+      #
+      # See: https://api.slack.com/reference/surfaces/formatting#special-mentions
+      def at_channel
+        '<!channel>'
+      end
+
+      # Mention @everyone (all users in #general)
+      #
+      # See: https://api.slack.com/reference/surfaces/formatting#special-mentions
+      def at_everyone
+        '<!everyone>'
+      end
+
+      # Localise a UNIX timestamp to the user's local timezone
+      #
+      # See: https://api.slack.com/reference/surfaces/formatting#date-formatting
+      def date(timestamp, token_string:, link: nil, fallback_text: nil)
+        datetime_str = [timestamp, token_string, link].compact.join('^')
+        str = [datetime_str, fallback_text].compact.join('|')
+
+        "<!date^#{str}>"
+      end
+
+      # Escape special characters (<,>,&) with their HTML entity code so
+      # Slack's text parsers knows to interpret them as literals.
+      #
+      # See: https://api.slack.com/reference/surfaces/formatting#escaping
+      def escape(text)
+        text
+          .gsub('&', '&amp;')
+          .gsub('>', '&gt;')
+          .gsub('<', '&lt;')
+      end
+    end
+  end
+end

data/lib/slack/block_kit/layout/actions.rb

@@ -59,8 +59,21 @@ module Slack
           append(element)
         end
 
-        def date_picker(action_id:, placeholder: nil, initial: nil, emoji: nil)
-          element = Element::DatePicker.new(
+        def datepicker(action_id:, placeholder: nil, initial: nil, emoji: nil)
+          element = Element::Datepicker.new(
+            placeholder: placeholder,
+            action_id: action_id,
+            initial: initial,
+            emoji: emoji
+          )
+
+          yield(element) if block_given?
+
+          append(element)
+        end
+
+        def timepicker(action_id:, placeholder: nil, initial: nil, emoji: nil)
+          element = Element::Timepicker.new(
             placeholder: placeholder,
             action_id: action_id,
             initial: initial,

data/lib/slack/block_kit/layout/input.rb

@@ -79,7 +79,7 @@ module Slack
         end
 
         def datepicker(action_id:, placeholder: nil, initial: nil, emoji: nil)
-          @element = Element::DatePicker.new(
+          @element = Element::Datepicker.new(
             action_id: action_id,
             placeholder: placeholder,
             initial: initial,
@@ -91,6 +91,19 @@ module Slack
           self
         end
 
+        def timepicker(action_id:, placeholder: nil, initial: nil, emoji: nil)
+          @element = Element::Timepicker.new(
+            action_id: action_id,
+            placeholder: placeholder,
+            emoji: emoji,
+            initial: initial
+          )
+
+          yield(@element) if block_given?
+
+          self
+        end
+
         def multi_channels_select(placeholder:, action_id:, initial: nil, emoji: nil, max_selected_items: nil)
           @element = Element::MultiChannelsSelect.new(
             placeholder: placeholder,

data/lib/slack/block_kit/layout/section.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative './section/multi_select_elements'
-
 module Slack
   module BlockKit
     module Layout
@@ -94,8 +92,21 @@ module Slack
           accessorise(element)
         end
 
-        def date_picker(action_id:, placeholder: nil, initial: nil, emoji: nil)
-          element = Element::DatePicker.new(
+        def datepicker(action_id:, placeholder: nil, initial: nil, emoji: nil)
+          element = Element::Datepicker.new(
+            placeholder: placeholder,
+            action_id: action_id,
+            initial: initial,
+            emoji: emoji
+          )
+
+          yield(element) if block_given?
+
+          accessorise(element)
+        end
+
+        def timepicker(action_id:, placeholder: nil, initial: nil, emoji: nil)
+          element = Element::Timepicker.new(
             placeholder: placeholder,
             action_id: action_id,
             initial: initial,

data/lib/slack/block_kit/layout/video.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Slack
+  module BlockKit
+    module Layout
+      # A video block is designed to embed videos in all app surfaces
+      # (e.g. link unfurls, messages, modals, App Home)  — anywhere you can put blocks!
+      # To use the video block within your app, you must have the links.embed:write scope.
+      #
+      # https://api.slack.com/reference/messaging/blocks#context
+      class Video
+        TYPE = 'video'
+
+        def initialize(alt_text:, thumbnail_url:, video_url:, title:, description:, **optional_args)
+          @alt_text = alt_text
+          @thumbnail_url = thumbnail_url
+          @video_url = video_url
+          @author_name = optional_args[:author_name]
+          @block_id = optional_args[:block_id]
+          @provider_icon_url = optional_args[:provider_icon_url]
+          @provider_name = optional_args[:provider_name]
+          @title_url = optional_args[:title_url]
+          @description = Composition::PlainText.new(
+            text: description,
+            emoji: optional_args[:emoji]
+          )
+          @title = Composition::PlainText.new(
+            text: title,
+            emoji: optional_args[:emoji]
+          )
+        end
+
+        def as_json(*)
+          {
+            type: TYPE,
+            alt_text: @alt_text,
+            thumbnail_url: @thumbnail_url,
+            video_url: @video_url,
+            author_name: @author_name,
+            block_id: @block_id,
+            provider_icon_url: @provider_icon_url,
+            provider_name: @provider_name,
+            title_url: @title_url,
+            description: @description.as_json,
+            title: @title.as_json
+          }.compact
+        end
+      end
+    end
+  end
+end

data/lib/slack/block_kit/version.rb

@@ -2,6 +2,6 @@
 
 module Slack
   module BlockKit
-    VERSION = '0.16.0'
+    VERSION = '0.19.0'
   end
 end

data/lib/slack/block_kit.rb

@@ -8,12 +8,6 @@ module Slack
 
     module Layout; end
 
-    Dir[File.join(__dir__, 'block_kit', 'composition', '*.rb')].sort.each { |file| require file }
-    Dir[File.join(__dir__, 'block_kit', 'element', '*.rb')].sort.each { |file| require file }
-    Dir[File.join(__dir__, 'block_kit', 'layout', '*.rb')].sort.each { |file| require file }
-    Dir[File.join(__dir__, 'block_kit', '*.rb')].sort.each { |file| require file }
-    Dir[File.join(__dir__, 'surfaces', '*.rb')].sort.each { |file| require file }
-
     module_function
 
     def blocks

data/lib/slack/surfaces/modal.rb

@@ -57,7 +57,7 @@ module Slack
         self
       end
 
-      def as_json(*) # rubocop:disable Metrics/MethodLength
+      def as_json(*)
         {
           type: TYPE,
           blocks: @blocks.as_json,

data/lib/slack-ruby-block-kit.rb

@@ -1,3 +1,14 @@
 # frozen_string_literal: true
 
-require_relative './slack/block_kit'
+require 'zeitwerk'
+
+loader = Zeitwerk::Loader.new
+loader.tag = 'slack-ruby-block-kit'
+loader.push_dir(__dir__)
+loader.ignore(__FILE__)
+loader.inflector.inflect('version' => 'VERSION')
+loader.setup
+
+require 'slack/block_kit'
+
+loader.eager_load

data/{bin → script}/console

@@ -10,4 +10,4 @@ require 'slack-ruby-block-kit'
 require 'faraday'
 require 'pry'
 
-Pry.start
+binding.pry # rubocop:disable Lint/Debugger

data/script/lint

@@ -0,0 +1,3 @@
+#!/bin/bash
+
+bundle exec rubocop -A

data/script/test

@@ -0,0 +1,3 @@
+#!/bin/bash
+
+bundle exec rake

data/slack-ruby-block-kit.gemspec

@@ -1,8 +1,6 @@
 # frozen_string_literal: true
 
-lib = File.expand_path('lib', __dir__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'slack/block_kit/version'
+require_relative 'lib/slack/block_kit/version'
 
 Gem::Specification.new do |spec|
   spec.name          = 'slack-ruby-block-kit'
@@ -20,4 +18,8 @@ Gem::Specification.new do |spec|
   end
   spec.require_paths = ['lib']
   spec.required_ruby_version = '>= 2.5'
+  spec.metadata = {
+    'rubygems_mfa_required' => 'true'
+  }
+  spec.add_dependency 'zeitwerk', '~> 2.6'
 end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: slack-ruby-block-kit
 version: !ruby/object:Gem::Version
-  version: 0.16.0
+  version: 0.19.0
 platform: ruby
 authors:
 - Christian Gregg
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-06-23 00:00:00.000000000 Z
-dependencies: []
+date: 2022-09-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
 description: 
 email:
 - c_arlt@hotmail.com
@@ -18,8 +32,11 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".deepsource.toml"
+- ".devcontainer/Dockerfile"
+- ".devcontainer/devcontainer.json"
 - ".github/dependabot.yml"
 - ".github/workflows/ci.yml"
+- ".github/workflows/release.yml"
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
@@ -29,7 +46,6 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
-- bin/console
 - lib/slack-ruby-block-kit.rb
 - lib/slack/block_kit.rb
 - lib/slack/block_kit/blocks.rb
@@ -44,7 +60,7 @@ files:
 - lib/slack/block_kit/element/channels_select.rb
 - lib/slack/block_kit/element/checkboxes.rb
 - lib/slack/block_kit/element/conversations_select.rb
-- lib/slack/block_kit/element/date_picker.rb
+- lib/slack/block_kit/element/datepicker.rb
 - lib/slack/block_kit/element/external_select.rb
 - lib/slack/block_kit/element/image.rb
 - lib/slack/block_kit/element/multi_channels_select.rb
@@ -58,6 +74,7 @@ files:
 - lib/slack/block_kit/element/static_select.rb
 - lib/slack/block_kit/element/timepicker.rb
 - lib/slack/block_kit/element/users_select.rb
+- lib/slack/block_kit/formatting.rb
 - lib/slack/block_kit/layout/actions.rb
 - lib/slack/block_kit/layout/context.rb
 - lib/slack/block_kit/layout/divider.rb
@@ -66,15 +83,20 @@ files:
 - lib/slack/block_kit/layout/input.rb
 - lib/slack/block_kit/layout/section.rb
 - lib/slack/block_kit/layout/section/multi_select_elements.rb
+- lib/slack/block_kit/layout/video.rb
 - lib/slack/block_kit/version.rb
 - lib/slack/surfaces/home.rb
 - lib/slack/surfaces/message.rb
 - lib/slack/surfaces/modal.rb
+- script/console
+- script/lint
+- script/test
 - slack-ruby-block-kit.gemspec
 homepage: https://github.com/CGA1123/slack-ruby-block-kit
 licenses:
 - MIT
-metadata: {}
+metadata:
+  rubygems_mfa_required: 'true'
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -90,7 +112,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.3.21
 signing_key: 
 specification_version: 4
 summary: A ruby wrapper for Slack's Block Kit