Merge branch 'main' into docs-audit

Author: lukegalbraithrussell

docs/reference/models/blocks/block_elements.html

@@ -3392,7 +3392,7 @@ <h3>Inherited members</h3>
 
         @property
         def attributes(self) -&gt; Set[str]:  # type: ignore[override]
-            return super().attributes.union({&#34;timestamp&#34;, &#34;format&#34;, &#34;url&#34;, &#34;fallback&#34;})
+            return super().attributes.union({&#34;timestamp&#34;, &#34;format&#34;, &#34;url&#34;, &#34;fallback&#34;, &#34;style&#34;})
 
         def __init__(
             self,
@@ -3401,6 +3401,7 @@ <h3>Inherited members</h3>
             format: str,
             url: Optional[str] = None,
             fallback: Optional[str] = None,
+            style: Optional[Union[dict, &#34;RichTextElementParts.TextStyle&#34;]] = None,
             **others: dict,
         ):
             super().__init__(type=self.type)
@@ -3409,40 +3410,45 @@ <h3>Inherited members</h3>
             self.format = format
             self.url = url
             self.fallback = fallback
+            self.style = style
 
     class Broadcast(RichTextElement):
         type = &#34;broadcast&#34;
 
         @property
         def attributes(self) -&gt; Set[str]:  # type: ignore[override]
-            return super().attributes.union({&#34;range&#34;})
+            return super().attributes.union({&#34;range&#34;, &#34;style&#34;})
 
         def __init__(
             self,
             *,
             range: str,  # channel, here, ..
+            style: Optional[Union[dict, &#34;RichTextElementParts.TextStyle&#34;]] = None,
             **others: dict,
         ):
             super().__init__(type=self.type)
             show_unknown_key_warning(self, others)
             self.range = range
+            self.style = style
 
     class Color(RichTextElement):
         type = &#34;color&#34;
 
         @property
         def attributes(self) -&gt; Set[str]:  # type: ignore[override]
-            return super().attributes.union({&#34;value&#34;})
+            return super().attributes.union({&#34;value&#34;, &#34;style&#34;})
 
         def __init__(
             self,
             *,
             value: str,
+            style: Optional[Union[dict, &#34;RichTextElementParts.TextStyle&#34;]] = None,
             **others: dict,
         ):
             super().__init__(type=self.type)
             show_unknown_key_warning(self, others)
-            self.value = value</code></pre>
+            self.value = value
+            self.style = style</code></pre>
 </details>
 <div class="desc"></div>
 <h3>Class variables</h3>

docs/reference/models/blocks/index.html

@@ -6410,7 +6410,7 @@ <h3>Inherited members</h3>
 
         @property
         def attributes(self) -&gt; Set[str]:  # type: ignore[override]
-            return super().attributes.union({&#34;timestamp&#34;, &#34;format&#34;, &#34;url&#34;, &#34;fallback&#34;})
+            return super().attributes.union({&#34;timestamp&#34;, &#34;format&#34;, &#34;url&#34;, &#34;fallback&#34;, &#34;style&#34;})
 
         def __init__(
             self,
@@ -6419,6 +6419,7 @@ <h3>Inherited members</h3>
             format: str,
             url: Optional[str] = None,
             fallback: Optional[str] = None,
+            style: Optional[Union[dict, &#34;RichTextElementParts.TextStyle&#34;]] = None,
             **others: dict,
         ):
             super().__init__(type=self.type)
@@ -6427,40 +6428,45 @@ <h3>Inherited members</h3>
             self.format = format
             self.url = url
             self.fallback = fallback
+            self.style = style
 
     class Broadcast(RichTextElement):
         type = &#34;broadcast&#34;
 
         @property
         def attributes(self) -&gt; Set[str]:  # type: ignore[override]
-            return super().attributes.union({&#34;range&#34;})
+            return super().attributes.union({&#34;range&#34;, &#34;style&#34;})
 
         def __init__(
             self,
             *,
             range: str,  # channel, here, ..
+            style: Optional[Union[dict, &#34;RichTextElementParts.TextStyle&#34;]] = None,
             **others: dict,
         ):
             super().__init__(type=self.type)
             show_unknown_key_warning(self, others)
             self.range = range
+            self.style = style
 
     class Color(RichTextElement):
         type = &#34;color&#34;
 
         @property
         def attributes(self) -&gt; Set[str]:  # type: ignore[override]
-            return super().attributes.union({&#34;value&#34;})
+            return super().attributes.union({&#34;value&#34;, &#34;style&#34;})
 
         def __init__(
             self,
             *,
             value: str,
+            style: Optional[Union[dict, &#34;RichTextElementParts.TextStyle&#34;]] = None,
             **others: dict,
         ):
             super().__init__(type=self.type)
             show_unknown_key_warning(self, others)
-            self.value = value</code></pre>
+            self.value = value
+            self.style = style</code></pre>
 </details>
 <div class="desc"></div>
 <h3>Class variables</h3>

slack_sdk/models/blocks/block_elements.py

@@ -2234,7 +2234,7 @@ class Date(RichTextElement):
 
         @property
         def attributes(self) -> Set[str]:  # type: ignore[override]
-            return super().attributes.union({"timestamp", "format", "url", "fallback"})
+            return super().attributes.union({"timestamp", "format", "url", "fallback", "style"})
 
         def __init__(
             self,
@@ -2243,6 +2243,7 @@ def __init__(
             format: str,
             url: Optional[str] = None,
             fallback: Optional[str] = None,
+            style: Optional[Union[dict, "RichTextElementParts.TextStyle"]] = None,
             **others: dict,
         ):
             super().__init__(type=self.type)
@@ -2251,37 +2252,42 @@ def __init__(
             self.format = format
             self.url = url
             self.fallback = fallback
+            self.style = style
 
     class Broadcast(RichTextElement):
         type = "broadcast"
 
         @property
         def attributes(self) -> Set[str]:  # type: ignore[override]
-            return super().attributes.union({"range"})
+            return super().attributes.union({"range", "style"})
 
         def __init__(
             self,
             *,
             range: str,  # channel, here, ..
+            style: Optional[Union[dict, "RichTextElementParts.TextStyle"]] = None,
             **others: dict,
         ):
             super().__init__(type=self.type)
             show_unknown_key_warning(self, others)
             self.range = range
+            self.style = style
 
     class Color(RichTextElement):
         type = "color"
 
         @property
         def attributes(self) -> Set[str]:  # type: ignore[override]
-            return super().attributes.union({"value"})
+            return super().attributes.union({"value", "style"})
 
         def __init__(
             self,
             *,
             value: str,
+            style: Optional[Union[dict, "RichTextElementParts.TextStyle"]] = None,
             **others: dict,
         ):
             super().__init__(type=self.type)
             show_unknown_key_warning(self, others)
             self.value = value
+            self.style = style

slack_sdk/web/async_chat_stream.py

@@ -86,6 +86,15 @@ def __init__(
         self._stream_ts: Optional[str] = None
         self._buffer_size = buffer_size
 
+    @property
+    def ts(self) -> Optional[str]:
+        """The message timestamp of the stream.
+
+        Returns None until the first flush (when chat.startStream is called).
+        Can be used with chat.update as a fallback if the stream expires server-side.
+        """
+        return self._stream_ts
+
     async def append(
         self,
         *,

slack_sdk/web/chat_stream.py

@@ -76,6 +76,15 @@ def __init__(
         self._stream_ts: Optional[str] = None
         self._buffer_size = buffer_size
 
+    @property
+    def ts(self) -> Optional[str]:
+        """The message timestamp of the stream.
+
+        Returns None until the first flush (when chat.startStream is called).
+        Can be used with chat.update as a fallback if the stream expires server-side.
+        """
+        return self._stream_ts
+
     def append(
         self,
         *,

tests/slack_sdk/web/test_chat_stream.py

@@ -262,6 +262,22 @@ def test_streams_with_authorship_args(self):
             self.assertEqual(start_request.get("icon_emoji"), "abacus")
             self.assertNotIn("icon_url", start_request)
 
+    def test_ts_property_is_none_before_flush_and_set_after(self):
+        streamer = self.client.chat_stream(
+            buffer_size=5,
+            channel="C0123456789",
+            thread_ts="123.000",
+            recipient_team_id="T0123456789",
+            recipient_user_id="U0123456789",
+        )
+        self.assertIsNone(streamer.ts)
+
+        streamer.append(markdown_text="hello!")
+        self.assertEqual(streamer.ts, "123.123")
+
+        streamer.stop()
+        self.assertEqual(streamer.ts, "123.123")
+
     def test_streams_errors_when_appending_to_an_unstarted_stream(self):
         streamer = self.client.chat_stream(
             channel="C0123456789",

tests/slack_sdk_async/web/test_async_chat_stream.py

@@ -244,6 +244,23 @@ async def test_streams_a_chunk_message(self):
                 '[{"text": "\\n", "type": "markdown_text"}, {"text": ":space_invader:", "type": "markdown_text"}]',
             )
 
+    @async_test
+    async def test_ts_property_is_none_before_flush_and_set_after(self):
+        streamer = await self.client.chat_stream(
+            buffer_size=5,
+            channel="C0123456789",
+            thread_ts="123.000",
+            recipient_team_id="T0123456789",
+            recipient_user_id="U0123456789",
+        )
+        self.assertIsNone(streamer.ts)
+
+        await streamer.append(markdown_text="hello!")
+        self.assertEqual(streamer.ts, "123.123")
+
+        await streamer.stop()
+        self.assertEqual(streamer.ts, "123.123")
+
     @async_test
     async def test_streams_errors_when_appending_to_an_unstarted_stream(self):
         streamer = await self.client.chat_stream(