slack-ruby-client 2.1.0 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ea3cc0e5082af70d6b464bfcdf1b3c980380b356348818d2c98b9f9b1abe9be8
-  data.tar.gz: 39e8cc3adc65e06b34fb906face6f7eab61f6f5f5d265c7a3022d8ffc656b553
+  metadata.gz: 88d9fc4c82be7eb365f184eb9be4babf355c4422e7aa981a669c68df866fcd89
+  data.tar.gz: 6380fa106f4b05359bc4b0e8598aa02a4f2ab2bd6f31ff5fdb5f2e356c2ee76f
 SHA512:
-  metadata.gz: a1e9755f1a189388376479c74e616ec4dc035195f28ae861f9a8ae8bc0c3a6ea50b11dc00d814b870ea7f7ac5784cbe936a6a575ba70f5aeb86741338d83553f
-  data.tar.gz: 80255ba98558914d209543e0c7e2440cef49f8bac0873e62948f3d8d9e96e0b42b624517ead794724b913e4d5afbc6826de597084c63b8128be68f894b40a395
+  metadata.gz: 8d41b9da28c2e14c25567e4ab620779095cc0c0f12b633937e4e4f2aa7c69b482f13cb1b9ad0353576cd2f2bd1d8c710680115b70f2fae2ef68488b334ee759e
+  data.tar.gz: 1ac12afca5aa38457b9fc72da39662e0b301fa2fd4ffc7d5aefddca62dc7c5988193104356e4a5b16a8c6b9ec0b28adce52f7ceda2486982c85e7eba07fbfcac

data/.coveralls.yml

@@ -0,0 +1,2 @@
+service_name: github
+

data/.github/workflows/test.yml

@@ -35,3 +35,9 @@ jobs:
         run: |
           bundle install
           bundle exec rake
+      - name: Coveralls
+        uses: coverallsapp/github-action@master
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+      - name: Coveralls Finished
+        uses: coverallsapp/github-action@master

data/.github/workflows/update_api.yml

@@ -0,0 +1,76 @@
+name: Update API
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: "15 23 * * *"
+jobs:
+  update-api:
+    if: ${{ github.repository == 'slack-ruby/slack-ruby-client' }}
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          submodules: recursive
+          fetch-depth: 0
+      - name: Config git to rebase
+        run: git config --global pull.rebase true
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.2"
+          bundler-cache: true
+      - name: Update API from slack-api-ref
+        run: bundle exec rake slack:api:update
+      - name: Remove files added by setup-ruby
+        run: rm -rf vendor
+      - name: Get current date
+        id: date
+        run: echo "::set-output name=date::$(date +'%Y-%m-%d')"
+      - name: Get slack-api-ref ref
+        id: api-ref
+        run: echo "::set-output name=api-ref::$(git rev-parse --short HEAD:lib/slack/web/api/slack-api-ref)"
+      - name: GitHub App token
+        if: ${{ github.repository == 'slack-ruby/slack-ruby-client' }}
+        id: github_app_token
+        uses: tibdex/github-app-token@v1.6.0
+        with:
+          app_id: ${{ secrets.CI_APP_ID }}
+          private_key: ${{ secrets.CI_APP_PRIVATE_KEY }}
+          installation_id: 36985419
+      - name: Create pull request
+        id: cpr
+        uses: peter-evans/create-pull-request@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          commit-message: Update API from slack-api-ref@${{ steps.api-ref.outputs.api-ref }} (${{ steps.date.outputs.date }})
+          title: Update API from slack-api-ref@${{ steps.api-ref.outputs.api-ref }}
+          body: |
+            Update API from [slack-api-ref](https://github.com/slack-ruby/slack-api-ref).
+            Rev: ${{ steps.api-ref.outputs.api-ref }}
+            Date: ${{ steps.date.outputs.date }}
+          branch: automated-api-update
+          base: master
+          committer: slack-ruby-ci-bot <noreply@github.com>
+          author: slack-ruby-ci-bot <noreply@github.com>
+      - name: Update CHANGELOG
+        uses: jacobtomlinson/gha-find-replace@v3
+        if: ${{ steps.cpr.outputs.pull-request-number != '' }}
+        with:
+          include: CHANGELOG.md
+          find: "\\* Your contribution here."
+          replace: "* [#${{steps.cpr.outputs.pull-request-number}}](https://github.com/slack-ruby-client/pulls/${{steps.cpr.outputs.pull-request-number}}): Update API from [slack-api-ref@${{ steps.api-ref.outputs.api-ref }}](https://github.com/slack-ruby/slack-api-ref/commit/${{ steps.api-ref.outputs.api-ref }}) - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).\n* Your contribution here."
+      - name: Commit and Push
+        if: ${{ steps.cpr.outputs.pull-request-number != '' }}
+        run: |
+          git config --local user.name 'slack-ruby-ci-bot'
+          git config --local user.email 'noreply@github.com'
+          git config --local --unset-all http.https://github.com/.extraheader || true
+          AUTH=$(echo -n "x-access-token:${{ steps.github_app_token.outputs.token || secrets.GITHUB_TOKEN }}" | base64)
+          echo "::add-mask::${AUTH}"
+          git config --local http.https://github.com/.extraheader "AUTHORIZATION: basic ${AUTH}"
+          git add CHANGELOG.md
+          git commit --amend --no-edit
+          git push origin automated-api-update -f

data/.gitignore

@@ -6,3 +6,4 @@
 .rspec_status
 Gemfile.lock
 pkg
+coverage

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2022-10-02 05:05:29 UTC using RuboCop version 1.26.1.
+# on 2023-08-05 13:32:37 UTC using RuboCop version 1.26.1.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
@@ -13,10 +13,11 @@ Lint/ConstantDefinitionInBlock:
   Exclude:
     - 'lib/tasks/real_time.rake'
 
-# Offense count: 1
+# Offense count: 2
 # Configuration parameters: AllowComments, AllowEmptyLambdas.
 Lint/EmptyBlock:
   Exclude:
+    - 'spec/slack/real_time/concurrency/clients/async_spec.rb'
     - 'spec/support/real_time/concurrency/mock.rb'
 
 # Offense count: 1
@@ -46,17 +47,17 @@ Lint/RedundantCopDisableDirective:
 # Offense count: 12
 # Configuration parameters: IgnoredMethods, CountRepeatedAttributes.
 Metrics/AbcSize:
-  Max: 48
+  Max: 36
 
 # Offense count: 4
 # Configuration parameters: IgnoredMethods.
 Metrics/CyclomaticComplexity:
-  Max: 14
+  Max: 10
 
-# Offense count: 12
+# Offense count: 13
 # Configuration parameters: CountComments, CountAsOne, ExcludedMethods, IgnoredMethods.
 Metrics/MethodLength:
-  Max: 32
+  Max: 26
 
 # Offense count: 1
 # Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
@@ -66,13 +67,7 @@ Metrics/ParameterLists:
 # Offense count: 2
 # Configuration parameters: IgnoredMethods.
 Metrics/PerceivedComplexity:
-  Max: 16
-
-# Offense count: 1
-# Configuration parameters: MinSize.
-Performance/CollectionLiteralInLoop:
-  Exclude:
-    - 'lib/tasks/real_time.rake'
+  Max: 10
 
 # Offense count: 2
 # This cop supports safe auto-correction (--auto-correct).
@@ -86,41 +81,41 @@ Performance/StringInclude:
   Exclude:
     - 'lib/tasks/web.rake'
 
-# Offense count: 3
+# Offense count: 8
 # This cop supports safe auto-correction (--auto-correct).
 RSpec/ContextMethod:
   Exclude:
     - 'spec/slack/messages/formatting_spec.rb'
     - 'spec/slack/web/api/mixins/users_spec.rb'
 
-# Offense count: 74
+# Offense count: 82
 # Configuration parameters: Prefixes.
 # Prefixes: when, with, without
 RSpec/ContextWording:
   Enabled: false
 
-# Offense count: 63
+# Offense count: 65
 # Configuration parameters: CountAsOne.
 RSpec/ExampleLength:
   Max: 18
 
-# Offense count: 17
+# Offense count: 19
 # Configuration parameters: Include, CustomTransform, IgnoreMethods, SpecSuffixOnly.
 # Include: **/*_spec*rb*, **/spec/**/*
 RSpec/FilePath:
   Enabled: false
 
-# Offense count: 63
+# Offense count: 70
 # Configuration parameters: .
 # SupportedStyles: have_received, receive
 RSpec/MessageSpies:
   EnforcedStyle: receive
 
-# Offense count: 92
+# Offense count: 94
 RSpec/MultipleExpectations:
   Max: 5
 
-# Offense count: 5
+# Offense count: 7
 # Configuration parameters: AllowSubject.
 RSpec/MultipleMemoizedHelpers:
   Max: 9
@@ -131,7 +126,7 @@ RSpec/NamedSubject:
   Exclude:
     - 'spec/slack/web/api/mixins/conversations_list_spec.rb'
 
-# Offense count: 44
+# Offense count: 48
 RSpec/NestedGroups:
   Max: 6
 
@@ -177,7 +172,7 @@ Rake/Desc:
 Style/FormatStringToken:
   EnforcedStyle: unannotated
 
-# Offense count: 6
+# Offense count: 5
 # This cop supports safe auto-correction (--auto-correct).
 Style/GlobalStdStream:
   Exclude:
@@ -211,10 +206,3 @@ Style/OptionalBooleanParameter:
 Style/SlicingWithRange:
   Exclude:
     - 'lib/slack/web/api/mixins/ids.id.rb'
-
-# Offense count: 1
-# This cop supports unsafe auto-correction (--auto-correct-all).
-# Configuration parameters: Mode.
-Style/StringConcatenation:
-  Exclude:
-    - 'lib/tasks/real_time.rake'

data/CHANGELOG.md

@@ -1,6 +1,28 @@
+### 2.2.0 (2023/09/17)
+
+* [#458](https://github.com/slack-ruby/slack-ruby-client/pull/458): Add workflow for automatic API updates - [@duffn](https://github.com/duffn).
+* [#455](https://github.com/slack-ruby/slack-ruby-client/pull/455): Update Slack API: Added pagination to `team.accessLogs` and `AppsDatastore` methods - [@marfoldi](https://github.com/marfoldi).
+* [#454](https://github.com/slack-ruby/slack-ruby-client/pull/454): Added `Slack::Messages::Formatting#escape` - [@marfoldi](https://github.com/marfoldi).
+* [#452](https://github.com/slack-ruby/slack-ruby-client/pull/452): Automatically generate Web API multi-argument requirements from docs - [@jmanian](https://github.com/jmanian).
+* [#448](https://github.com/slack-ruby/slack-ruby-client/pull/448), [#453](https://github.com/slack-ruby/slack-ruby-client/pull/453): Automatically convert more Web API arguments to JSON-encoded strings - [@jmanian](https://github.com/jmanian).
+* [#465](https://github.com/slack-ruby-client/pulls/465): Update API from [slack-api-ref@878be8f](https://github.com/slack-ruby/slack-api-ref/commit/878be8f) - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
+* [#473](https://github.com/slack-ruby-client/pulls/473): Update API from [slack-api-ref@a29b520](https://github.com/slack-ruby/slack-api-ref/commit/a29b520) - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
+* [#474](https://github.com/slack-ruby-client/pulls/474): Update API from [slack-api-ref@629967e](https://github.com/slack-ruby/slack-api-ref/commit/629967e) - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
+* [#475](https://github.com/slack-ruby-client/pulls/475): Update API from [slack-api-ref@977dad5](https://github.com/slack-ruby/slack-api-ref/commit/977dad5) - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
+* [#476](https://github.com/slack-ruby-client/pulls/476): Update API from [slack-api-ref@d0b2989](https://github.com/slack-ruby/slack-api-ref/commit/d0b2989) - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
+* [#478](https://github.com/slack-ruby-client/pulls/478): Update API from [slack-api-ref@d797055](https://github.com/slack-ruby/slack-api-ref/commit/d797055) - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
+* [#480](https://github.com/slack-ruby-client/pulls/480): Add common message formatting utilities - [@chrisbloom7](https://github.com/chrisbloom7).
+* [#481](https://github.com/slack-ruby-client/pulls/481): Update API from [slack-api-ref@7c22d0b](https://github.com/slack-ruby/slack-api-ref/commit/7c22d0b) - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
+* [#488](https://github.com/slack-ruby-client/pulls/488): Update API from [slack-api-ref@a45def2](https://github.com/slack-ruby/slack-api-ref/commit/a45def2) - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
+* [#490](https://github.com/slack-ruby/slack-ruby-client/pull/490): Add changelog uri to gemspec - [@MatheusRich](https://github.com/MatheusRich).
+* [#491](https://github.com/slack-ruby/slack-ruby-client/pull/491): Added code coverage - [@dblock](https://github.com/dblock).
+* [#486](https://github.com/slack-ruby/slack-ruby-client/pull/486): Async handler support for Slack::RealTime::Config and Client - [@milestruecar](https://github.com/milestruecar).
+* [#489](https://github.com/slack-ruby-client/pulls/489): Update API from [slack-api-ref@0d3f0b6](https://github.com/slack-ruby/slack-api-ref/commit/0d3f0b6) - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
+* [#493](https://github.com/slack-ruby-client/pulls/493): Update API from [slack-api-ref@f2e768a](https://github.com/slack-ruby/slack-api-ref/commit/f2e768a) - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
+
 ### 2.1.0 (2023/03/17)
 
-* [#440](https://github.com/ruby-grape/slack-ruby-client/pull/440): Added Enterprise support [via TideLift](https://tidelift.com/subscription/request-a-demo?utm_source=rubygems-slack-ruby-client&utm_medium=referral&utm_campaign=enterprise) - [@dblock](https://github.com/dblock).
+* [#440](https://github.com/slack-ruby/slack-ruby-client/pull/440): Added Enterprise support [via TideLift](https://tidelift.com/subscription/request-a-demo?utm_source=rubygems-slack-ruby-client&utm_medium=referral&utm_campaign=enterprise) - [@dblock](https://github.com/dblock).
 * [#436](https://github.com/slack-ruby/slack-ruby-client/pull/436): Removed dependency on unused websocket-driver - [@blowfishpro](https://github.com/blowfishpro).
 * [#434](https://github.com/slack-ruby/slack-ruby-client/pull/434): Fixed incompatibility with Faraday >= 2.7.0 and GLI usage in the `slack` script - [@blowfishpro](https://github.com/blowfishpro).
 * [#446](https://github.com/slack-ruby/slack-ruby-client/pull/446): Added support for Ruby 3.2 - [@duffn](https://github.com/duffn).

data/CONTRIBUTING.md

@@ -63,38 +63,6 @@ Ruby style is enforced with [Rubocop](https://github.com/bbatsov/rubocop). Run `
 
 Make sure that `bundle exec rake` completes without errors.
 
-### Update Slack Web API
-
-Slack Web API is updated from https://github.com/slack-ruby/slack-api-ref, a maintained, machine-readable version of Slack API Docs, generated by scraping [api.slack.com](https://api.slack.com). To update the Web API from the latest definition run the following Rake task.
-
-```
-bundle exec rake slack:api:update
-```
-
-#### Patching Slack Web API
-
-Sometimes it's necessary to patch auto-generated Slack Web API methods. For example, we want to help clients with calling `to_json` on the `attachments` parameter sent to `chat_postMessage`. See [#20](https://github.com/slack-ruby/slack-ruby-client/issues/20).
-
-The broad steps are:
-1. Run `rake slack:api:update` to check that existing patches are still valid.
-    - If you run into a `failed to apply patch` error, the auto-generated methods likely drifted from the last patch. Follow the steps [below](#resolving-patch-errors).
-    - This may add new methods if the API has updated, please split them up into multiple PRs if so.
-2. Make a change to a generated file, for example `lib/slack/web/api/endpoints/chat.rb`.
-3. Generate a patch:
-    ```
-    git diff --no-color HEAD lib/slack/web/api/endpoints/chat.rb > lib/slack/web/api/patches/chat.added-support.patch
-    ```
-4. Run `rake slack:api:update` to ensure that the patch is cleanly applied. Implement a test for the added or modified functionality and commit the patch file.
-
-##### Resolving Patch Errors
-
-The auto-generated method files may drift overtime e.g. new arguments may be added or descriptions changed. Since previous patches were based on the older auto-generated files, git may be unable to apply them to the new files. Resolving them requires some good ol' splicing:
-1. Run `rake slack:api:update SKIP_PATCH=true` to create the raw auto-generated files. Commit the files that you are updating, so we can run `git diff` later.
-2. Go through the old patches for the files (e.g. in `lib/slack/web/api/patches/chat.added-support.patch`), copying code into the new files.
-    - Run `git apply --reject path/to/patch-file.patch` to see hunks that couldn't be applied.
-3. Continue with Step 2 [above](#patching-slack-web-api).
-
-
 ### Write Documentation
 
 Document any external behavior in the [README](README.md).
@@ -163,6 +131,41 @@ Go back to your pull request after a few minutes and see whether it passed muste
 ### Be Patient
 
 It's likely that your change will not be merged and that the nitpicky maintainers will ask you to do more, or fix seemingly benign problems. Hang on there!
+While you wait you can help with keeping the Slack Web API up to date, see [below](#update-slack-web-api).
+
+### Update Slack Web API
+
+Please make sure to [create a separate branch](#create-a-topic-branch) for your changes.
+
+Slack Web API is updated from https://github.com/slack-ruby/slack-api-ref, a maintained, machine-readable version of Slack API Docs, generated by scraping [api.slack.com](https://api.slack.com). To update the Web API from the latest definition run the following Rake task.
+
+```
+bundle exec rake slack:api:update
+```
+
+#### Patching Slack Web API
+
+Sometimes it's necessary to patch auto-generated Slack Web API methods. For example, we want to help clients with calling `to_json` on the `attachments` parameter sent to `chat_postMessage`. See [#20](https://github.com/slack-ruby/slack-ruby-client/issues/20).
+
+The broad steps are:
+1. Run `rake slack:api:update` to check that existing patches are still valid.
+    - If you run into a `failed to apply patch` error, the auto-generated methods likely drifted from the last patch. Follow the steps [below](#resolving-patch-errors).
+    - This may add new methods if the API has updated, please split them up into multiple PRs if so.
+2. Make a change to a generated file, for example `lib/slack/web/api/endpoints/chat.rb`.
+3. Generate a patch:
+    ```
+    git diff --no-color HEAD lib/slack/web/api/endpoints/chat.rb > lib/slack/web/api/patches/chat.added-support.patch
+    ```
+4. Run `rake slack:api:update` to ensure that the patch is cleanly applied. Implement a test for the added or modified functionality and commit the patch file.
+
+##### Resolving Patch Errors
+
+The auto-generated method files may drift overtime e.g. new arguments may be added or descriptions changed. Since previous patches were based on the older auto-generated files, git may be unable to apply them to the new files. Resolving them requires some good ol' splicing:
+1. Run `rake slack:api:update SKIP_PATCH=true` to create the raw auto-generated files. Commit the files that you are updating, so we can run `git diff` later.
+2. Go through the old patches for the files (e.g. in `lib/slack/web/api/patches/chat.added-support.patch`), copying code into the new files.
+    - Run `git apply --reject path/to/patch-file.patch` to see hunks that couldn't be applied.
+3. Continue with Step 2 [above](#patching-slack-web-api).
+
 
 ## Thank You
 

data/Gemfile

@@ -23,6 +23,8 @@ group :test do
   gem 'rubocop-performance'
   gem 'rubocop-rake'
   gem 'rubocop-rspec'
+  gem 'simplecov'
+  gem 'simplecov-lcov'
   gem 'timecop'
   gem 'vcr'
   gem 'webmock'

data/README.md

@@ -5,6 +5,7 @@ Slack Ruby Client
 [![Integration Tests](https://github.com/slack-ruby/slack-ruby-client/actions/workflows/integration_test.yml/badge.svg?branch=master)](https://github.com/slack-ruby/slack-ruby-client/actions/workflows/integration_test.yml)
 [![Tests](https://github.com/slack-ruby/slack-ruby-client/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/slack-ruby/slack-ruby-client/actions/workflows/test.yml)
 [![Code Climate](https://codeclimate.com/github/slack-ruby/slack-ruby-client/badges/gpa.svg)](https://codeclimate.com/github/slack-ruby/slack-ruby-client)
+[![Coverage Status](https://coveralls.io/repos/github/slack-ruby/slack-ruby-client/badge.svg?branch=master)](https://coveralls.io/github/slack-ruby/slack-ruby-client?branch=master)
 
 A Ruby client for the Slack [Web](https://api.slack.com/web), [RealTime Messaging](https://api.slack.com/rtm) and [Events](https://api.slack.com/events-api) APIs. Comes with a handy command-line client, too. If you are not familiar with these concepts, you might want to watch [this video](http://code.dblock.org/2016/03/11/your-first-slack-bot-service-video.html).
 
@@ -30,6 +31,7 @@ A Ruby client for the Slack [Web](https://api.slack.com/web), [RealTime Messagin
       - [Get User Info](#get-user-info)
       - [Search for a User](#search-for-a-user)
       - [Other](#other)
+    - [JSON Arguments](#json-arguments)
     - [Web Client Options](#web-client-options)
     - [Pagination Support](#pagination-support)
     - [Character Encoding](#character-encoding)
@@ -50,7 +52,15 @@ A Ruby client for the Slack [Web](https://api.slack.com/web), [RealTime Messagin
   - [Events API](#events-api)
     - [Configuring Slack::Events](#configuring-slackevents)
     - [Verifying the Request Signature](#verifying-the-request-signature)
-  - [Message Parsing](#message-parsing)
+  - [Message Handling](#message-handling)
+    - [Formatting Messages](#formatting-messages)
+      - [Date and time formatting](#date-and-time-formatting)
+      - [Channel ID formatting](#channel-id-formatting)
+      - [User ID formatting](#user-id-formatting)
+      - [URL formatting](#url-formatting)
+    - [Parsing Messages](#parsing-messages)
+      - [Unescaping message content](#unescaping-message-content)
+      - [Escaping message content](#escaping-message-content)
   - [Command-Line Client](#command-line-client)
     - [Authenticate with Slack](#authenticate-with-slack)
     - [Send a Message](#send-a-message)
@@ -71,7 +81,7 @@ A Ruby client for the Slack [Web](https://api.slack.com/web), [RealTime Messagin
 
 ## Stable Release
 
-You're reading the documentation for the **stable** release of slack-ruby-client, v2.1.0. See [UPGRADING](UPGRADING.md) when upgrading from an older version.
+You're reading the documentation for the **stable** release of slack-ruby-client, 2.2.0. See [UPGRADING](UPGRADING.md) when upgrading from an older version.
 
 ## Installation
 
@@ -210,6 +220,31 @@ client.users_search(user: 'dblock')
 
 Refer to the [Slack Web API Method Reference](https://api.slack.com/methods) for the list of all available functions.
 
+#### JSON Arguments
+
+The Web API expects certain arguments to be sent as JSON-encoded strings. With the client you can pass these args as ruby hashes or arrays and they will be converted automatically to JSON, or you can provide the JSON directly.
+
+```ruby
+# As ruby objects
+client.chat_postMessage(
+  channel: 'C123456',
+  text: 'Hello World',
+  blocks: [{type: 'section', text: {type: 'mrkdwn', text: 'Hello World'}}]
+)
+
+# As a JSON string
+client.chat_postMessage(
+  channel: 'C123456',
+  text: 'Hello World',
+  blocks: JSON.dump([{type: 'section', text: {type: 'mrkdwn', text: 'Hello World'}}])
+)
+client.chat_postMessage(
+  channel: 'C123456',
+  text: 'Hello World',
+  blocks: '[{"type":"section","text":{"type":"mrkdwn","text":"Hello World"}}]'
+)
+```
+
 #### Web Client Options
 
 You can configure the Web client either globally or via the initializer.
@@ -398,6 +433,7 @@ websocket_proxy | Connect via proxy, include `:origin` and `:headers`.
 start_options   | Options to pass to `rtm.connect`, default is `{ request: { timeout: 180 } }`.
 store_class     | Local store class, default is an in-memory `Slack::RealTime::Stores::Starter`.
 store_options   | Options to initialize the store, default is `{}`.
+async_handlers  | Option to run handlers asynchronously. Valid options are `:all` or `:none`, default is `:none`.
 logger          | Optional `Logger` instance that logs RealTime requests and socket data.
 
 Note that the RealTime client uses a Web client to obtain the WebSocket URL via [rtm.connect](https://api.slack.com/methods/rtm.connect). While `token` and `logger` options are passed down from the RealTime client, you may also configure Web client options via `Slack::Web::Client.configure` as described above.
@@ -557,33 +593,106 @@ Slack::Events::Request.new(http_request,
 
 The `verify!` call may raise `Slack::Events::Request::MissingSigningSecret`, `Slack::Events::Request::InvalidSignature` or `Slack::Events::Request::TimestampExpired` errors.
 
-### Message Parsing
+### Message Handling
+
+All text in Slack uses the same [system of formatting and escaping](https://api.slack.com/docs/formatting): chat messages, direct messages, file comments, etc. [Slack::Messages::Formatting](lib/slack/messages/formatting.rb) provides convenience methods to format and parse messages.
+
+#### Formatting Messages
+
+`Slack::Messages::Formatting` provides a number of methods for formatting objects that you can then embed in outgoing messages.
+
+##### Date and time formatting
+
+You can embed a pre-formatted date in a message as a string like any other text, but using Slack's date formatting allows you to display dates based on user preferences for dates and times, incorporating users' local time zones, and optionally using relative values like "yesterday", "today", or "tomorrow" when appropriate.
+
+```ruby
+date = Time.now
+
+# Display date as `YYYY-MM-DD HH:MM:SS`
+Slack::Messages::Formatting.date(date)
+  # => "<!date^1688150386^{date_num} {time_secs}|2023-06-30 18:39:46 +0000>"
+
+# Specify a different format
+# See https://api.slack.com/reference/surfaces/formatting#date-formatting for supported formats
+Slack::Messages::Formatting.date(date, format: 'date_long_pretty')
+  # => "<!date^1688150386^date_long_pretty|2023-06-30 18:39:46 +0000>"
+
+# Link your timestamp to a fully qualified URL
+Slack::Messages::Formatting.date(date, link: 'https://media.giphy.com/media/AcfTF7tyikWyroP0x7/giphy.gif')
+  # => "<!date^1688150386^{date_num} {time_secs}^https://media.giphy.com/media/AcfTF7tyikWyroP0x7/giphy.gif|2023-06-30 18:39:46 +0000>"
+
+# Specify custom fallback text to use if the client is unable to process the date
+Slack::Messages::Formatting.date(date, text: 'party time!')
+  # => "<!date^1688150386^{date_num} {time_secs}|party time!>"
+```
+
+##### Channel ID formatting
+
+If you already know the channel name you can just embed it in the message as `#some-channel`, but if you only have the ID you can embed it using special syntax which Slack will display as the channel name (while respecting channel visibility).
+
+```ruby
+channel_id = 'C0000000001'
+Slack::Messages::Formatting.channel_link(channel_id)
+  # => "<#C0000000001>"
+```
+
+##### User ID formatting
+
+If you already know the user name you can just embed it in the message as `@some_username`, but if you only have the ID you can embed it using special syntax which Slack will display as the user name.
+
+```ruby
+user_id = 'U0000000001'
+Slack::Messages::Formatting.user_link(user_id)
+  # => "<@U0000000001>"
+```
+
+##### URL formatting
 
-All text in Slack uses the same [system of escaping](https://api.slack.com/docs/formatting): chat messages, direct messages, file comments, etc. Use [Slack::Messages::Formatting](lib/slack/messages/formatting.rb) to unescape incoming messages. This comes handy, for example, you want to treat all input to a real time bot as plain text.
+Slack will automatically parse fully qualified URLs in messages, but you need special formatting to embed a link with different text.
 
 ```ruby
-Slack::Messages::Formatting.unescape('Hello &amp; &lt;world&gt;'))
+text = 'party time'
+url = 'https://media.giphy.com/media/AcfTF7tyikWyroP0x7/giphy.gif'
+Slack::Messages::Formatting.url_link(text, url)
+  # => "<https://media.giphy.com/media/AcfTF7tyikWyroP0x7/giphy.gif|party time>"
+```
+
+#### Parsing Messages
+
+`Slack::Messages::Formatting` also provides ways to escape or unescape messages. This comes handy, for example, you want to treat all input to a real time bot as plain text.
+
+##### Unescaping message content
+
+```ruby
+Slack::Messages::Formatting.unescape('Hello &amp; &lt;world&gt;')
   # => 'Hello & <world>'
-Slack::Messages::Formatting.unescape('Hey <@U024BE7LH|bob>, did you see my file?'))
+Slack::Messages::Formatting.unescape('Hey <@U024BE7LH|bob>, did you see my file?')
   # => 'Hey @bob, did you see my file?'
-Slack::Messages::Formatting.unescape('Hey <@U02BEFY4U>'))
+Slack::Messages::Formatting.unescape('Hey <@U02BEFY4U>')
   # => 'Hey @U02BEFY4U'
-Slack::Messages::Formatting.unescape('This message contains a URL <http://foo.com/>'))
+Slack::Messages::Formatting.unescape('This message contains a URL <http://foo.com/>')
   # => 'This message contains a URL http://foo.com/'
-Slack::Messages::Formatting.unescape('So does this one: <http://www.foo.com|www.foo.com>'))
+Slack::Messages::Formatting.unescape('So does this one: <http://www.foo.com|www.foo.com>')
   # => 'So does this one: www.foo.com'
-Slack::Messages::Formatting.unescape('<mailto:bob@example.com|Bob>'))
+Slack::Messages::Formatting.unescape('<mailto:bob@example.com|Bob>')
   # => 'Bob'
-Slack::Messages::Formatting.unescape('Hello <@U123|bob>, say hi to <!everyone> in <#C1234|general>'))
+Slack::Messages::Formatting.unescape('Hello <@U123|bob>, say hi to <!everyone> in <#C1234|general>')
   # => 'Hello @bob, say hi to @everyone in #general'
-Slack::Messages::Formatting.unescape('Hello <@U123|bob> &gt; file.txt'))
+Slack::Messages::Formatting.unescape('Hello <@U123|bob> &gt; file.txt')
   # => 'Hello @bob > file.txt'
-Slack::Messages::Formatting.unescape('“hello”'))
+Slack::Messages::Formatting.unescape('“hello”')
   # => '"hello"'
-Slack::Messages::Formatting.unescape('‘hello’'))
+Slack::Messages::Formatting.unescape('‘hello’')
   # => "'hello'"
 ```
 
+##### Escaping message content
+
+```ruby
+Slack::Messages::Formatting.escape('Hello & <world>')
+  # => 'Hello &amp; &lt;world&gt;'
+```
+
 ### Command-Line Client
 
 The slack command-line client returns JSON data from the Slack API.

data/bin/commands/admin_apps_activities.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Cli
+    class App
+      desc 'AdminAppsActivities methods.'
+      command 'admin_apps_activities' do |g|
+        g.desc 'Get logs for a specified team/org'
+        g.long_desc %( Get logs for a specified team/org )
+        g.command 'list' do |c|
+          c.flag 'app_id', desc: 'The ID of the app to get activities from.'
+          c.flag 'component_id', desc: "The component ID of log events to be returned. Will be 'FnXXXXXX' for functions, and 'WfXXXXXX' for worflows."
+          c.flag 'component_type', desc: "The component type of log events to be returned. Acceptable values are ('events_api', 'workflows', 'functions', 'tables')."
+          c.flag 'cursor', desc: "Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. See pagination for more detail."
+          c.flag 'limit', desc: 'The maximum number of items to return.'
+          c.flag 'log_event_type', desc: 'The event type of log events to be returned.'
+          c.flag 'max_date_created', desc: 'The latest timestamp of the log to retrieve (epoch microseconds).'
+          c.flag 'min_date_created', desc: 'The earliest timestamp of the log to retrieve (epoch microseconds).'
+          c.flag 'min_log_level', desc: "The minimum log level of the log events to be returned. Defaults to 'info'. Acceptable values (in order of relative importance from smallest to largest) are ('trace', 'debug', 'info', 'warn', 'error', 'fatal')."
+          c.flag 'sort_direction', desc: 'The direction you want the data sorted by (always by timestamp).'
+          c.flag 'source', desc: "The source of log events to be returned. Acceptable values are ('slack', 'developer')."
+          c.flag 'team_id', desc: 'The team who owns this log.'
+          c.flag 'trace_id', desc: 'The trace ID of log events to be returned.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_apps_activities_list(options))
+          end
+        end
+      end
+    end
+  end
+end

data/bin/commands/admin_apps_approved.rb

@@ -9,6 +9,7 @@ module Slack
         g.desc 'List approved apps for an org or workspace.'
         g.long_desc %( List approved apps for an org or workspace. )
         g.command 'list' do |c|
+          c.flag 'certified', desc: 'Limit the results to only include certified apps. When false, no certified apps will appear in the result.'
           c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
           c.flag 'enterprise_id', desc: '.'
           c.flag 'limit', desc: 'The maximum number of items to return. Must be between 1 - 1000 both inclusive.'

data/bin/commands/admin_apps_config.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Cli
+    class App
+      desc 'AdminAppsConfig methods.'
+      command 'admin_apps_config' do |g|
+        g.desc 'Look up the app config for connectors by their IDs'
+        g.long_desc %( Look up the app config for connectors by their IDs )
+        g.command 'lookup' do |c|
+          c.flag 'app_ids', desc: 'An array of app IDs to get app configs for.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_apps_config_lookup(options))
+          end
+        end
+
+        g.desc 'Set the app config for a connector'
+        g.long_desc %( Set the app config for a connector )
+        g.command 'set' do |c|
+          c.flag 'app_id', desc: 'The encoded app ID to set the app config for.'
+          c.flag 'domain_restrictions', desc: 'Domain restrictions for the app.'
+          c.flag 'workflow_auth_strategy', desc: 'The workflow auth permission.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_apps_config_set(options))
+          end
+        end
+      end
+    end
+  end
+end