slackblocks 3.2.0__tar.gz → 4.0.0__tar.gz

{slackblocks-3.2.0 → slackblocks-4.0.0}/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to `slackblocks` are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.0.0] — 2026-11-14
+
+- Coordinate the ten-language 4.0.0 release with shared contract 1.6.0. Supported runtime floors are unchanged. See the 4.0.0 migration guide for Go imports, sparse-setting types and stricter validation.
+
+- Require non-empty numeric display labels in both plain and data tables, matching the isolated Slack validation probe.
+
+- Preserve skipped columns in sparse table column settings through native APIs and supported parsers. Null entries count toward the existing 20-column-settings limit.
+- Reject non-finite numeric cells while preserving arbitrary-size Python integers.
+
+- Add numeric plain-table cells and enforce Slack’s documented 10,000-character per-table and message-wide limits (spec 1.6.0). Count displayed cell text as Unicode code points, including composed blocks and attachments; ragged rows and partial column settings remain valid. Previously accepted over-limit tables now fail validation. Supported runtime floors are unchanged.
+
 ## [3.2.0] — 2026-10-31
 
 - Add native layout blocks, rows and items with typed widths/alignment, closed child and fallback roles, checked nesting and receiving-surface validation (spec 1.5.0).

{slackblocks-3.2.0 → slackblocks-4.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: slackblocks
-Version: 3.2.0
+Version: 4.0.0
 Summary: Python wrapper for the Slack Blocks API
 Project-URL: Homepage, https://github.com/nicklambourne/slackblocks
 Project-URL: Repository, https://github.com/nicklambourne/slackblocks
@@ -55,7 +55,7 @@ This release conforms to the shared cross-language slackblocks specification.
 pip install slackblocks
 ```
 
-`slackblocks 2.x` requires Python 3.10 or newer. Users on Python 3.8 / 3.9 should pin to the `1.x` line — see the [Compatibility](https://nicklambourne.github.io/slackblocks/usage/compatibility) page.
+`slackblocks 4.x` requires Python 3.10 or newer. Users on Python 3.8 / 3.9 should pin to the `1.x` line — see the [Compatibility](https://nicklambourne.github.io/slackblocks/usage/compatibility) page.
 
 ## Quickstart
 

{slackblocks-3.2.0 → slackblocks-4.0.0}/README.md

@@ -28,7 +28,7 @@ This release conforms to the shared cross-language slackblocks specification.
 pip install slackblocks
 ```
 
-`slackblocks 2.x` requires Python 3.10 or newer. Users on Python 3.8 / 3.9 should pin to the `1.x` line — see the [Compatibility](https://nicklambourne.github.io/slackblocks/usage/compatibility) page.
+`slackblocks 4.x` requires Python 3.10 or newer. Users on Python 3.8 / 3.9 should pin to the `1.x` line — see the [Compatibility](https://nicklambourne.github.io/slackblocks/usage/compatibility) page.
 
 ## Quickstart
 

{slackblocks-3.2.0 → slackblocks-4.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "slackblocks"
-version = "3.2.0"
+version = "4.0.0"
 description = "Python wrapper for the Slack Blocks API"
 authors = [
     { name = "Nicholas Lambourne", email = "dev@ndl.im" },
@@ -58,7 +58,7 @@ docs = [
 ]
 
 [build-system]
-requires = ["hatchling<1.33"]
+requires = ["hatchling<1.34"]
 build-backend = "hatchling.build"
 
 [tool.ruff]

{slackblocks-3.2.0 → slackblocks-4.0.0}/slackblocks/__init__.py

@@ -131,7 +131,7 @@ name = "slackblocks"
 
 # The version of the shared conformance spec (spec/SPEC.md) this
 # implementation conforms to.
-SPEC_VERSION: str = "1.5.0"
+SPEC_VERSION: str = "1.6.0"
 
 # Literal exports are visible to strict external type checkers.
 __all__ = [

{slackblocks-3.2.0 → slackblocks-4.0.0}/slackblocks/_limits.py

@@ -159,6 +159,10 @@ TABLE_ROWS_MAX_ITEMS = 100
 TABLE_COLUMNS_MAX_ITEMS = 20
 # table.column_settings.max_items
 TABLE_COLUMN_SETTINGS_MAX_ITEMS = 20
+# table.content.max_length
+TABLE_CONTENT_MAX_LENGTH = 10000
+# table.total_content.max_length
+TABLE_TOTAL_CONTENT_MAX_LENGTH = 10000
 # data_table.rows.min_items
 DATA_TABLE_ROWS_MIN_ITEMS = 2
 # data_table.rows.max_items

{slackblocks-3.2.0 → slackblocks-4.0.0}/slackblocks/blocks.py

@@ -59,6 +59,7 @@ from slackblocks._limits import (
     SECTION_TEXT_MAX_LENGTH,
     TABLE_COLUMN_SETTINGS_MAX_ITEMS,
     TABLE_COLUMNS_MAX_ITEMS,
+    TABLE_CONTENT_MAX_LENGTH,
     TABLE_ROWS_MAX_ITEMS,
     VIDEO_ALT_TEXT_MAX_LENGTH,
     VIDEO_AUTHOR_NAME_MAX_LENGTH,
@@ -163,6 +164,7 @@ ALLOWED_INPUT_ELEMENTS = (
 
 ALLOWED_TABLE_CELL_ELEMENTS = (
     RawText,
+    RawNumber,
     RichTextList,
     RichTextCodeBlock,
     RichTextQuote,
@@ -416,7 +418,8 @@ class DividerBlock(Block):
 
 class FileBlock(Block):
     """
-    Displays a remote file (e.g. a PDF).
+    A retrieved remote-file representation (e.g. a PDF), not an outgoing message block.
+    Register and share remote files with the Files API, then read back this representation.
 
     For details on how remote files are exposed to Slack, see
     <https://api.slack.com/messaging/files#adding>.
@@ -818,21 +821,22 @@ class TableBlock(Block):
     A `TableBlock` displays data in a table format.
 
     Args:
-        rows: a list of lists of `RawText` or `RichTextObject` objects.
-        column_settings: a list of `ColumnSettings` objects.
+        rows: a list of lists of `RawText`, `RawNumber` or `RichTextObject` objects.
+        column_settings: settings for leading columns; omitted trailing columns use Slack defaults.
         block_id: you can use this field to provide a deterministic identifier for the block.
 
     Throws:
-        InvalidUsageError: when items in `rows` are not `RawText` or `RichTextObject` objects.
+        InvalidUsageError: when items in `rows` are not `RawText`, `RawNumber` or `RichTextObject` objects.
         InvalidUsageError: when the number of rows is greater than 100.
         InvalidUsageError: when the number of columns in a row is greater than 20.
         InvalidUsageError: when the number of column_settings is greater than 20.
+        LengthError: when displayed cell text exceeds 10,000 Unicode code points.
     """
 
     def __init__(
         self,
-        rows: list[list[RawText | RichTextObject]],
-        column_settings: list[ColumnSettings] | None = None,
+        rows: list[list[RawText | RawNumber | RichTextObject]],
+        column_settings: list[ColumnSettings | None] | None = None,
         block_id: str | None = None,
     ) -> None:
         super().__init__(type_=BlockType.TABLE, block_id=block_id)
@@ -858,7 +862,13 @@ class TableBlock(Block):
             self.rows.append(validated_row)
         if column_settings and len(column_settings) > TABLE_COLUMN_SETTINGS_MAX_ITEMS:
             raise LengthError("`column_settings` can have a maximum of 20 items.")
+        if column_settings is not None:
+            for setting in column_settings:
+                if setting is not None and not isinstance(setting, ColumnSettings):
+                    raise TypeMismatchError("Column settings must be ColumnSettings or None.")
         self.column_settings = column_settings
+        if _text_character_count(self._resolve()["rows"]) > TABLE_CONTENT_MAX_LENGTH:
+            raise LengthError("Table cell text exceeds the 10,000-character limit.")
 
     def _resolve(self) -> dict[str, Any]:
         return resolve(
@@ -869,14 +879,14 @@ class TableBlock(Block):
             }
         )
 
-    def _resolve_cell(self, cell: RawText | RichTextObject) -> dict[str, Any]:
+    def _resolve_cell(self, cell: RawText | RawNumber | RichTextObject) -> dict[str, Any]:
         """
         Resolve a table cell to its JSON representation.
 
-        RawText cells are resolved directly.
+        RawText and RawNumber cells are resolved directly.
         RichTextObject cells are wrapped in a rich_text structure.
         """
-        if isinstance(cell, RawText):
+        if isinstance(cell, (RawText, RawNumber)):
             return cell._resolve()
         else:
             # Wrap RichTextObject in rich_text structure
@@ -1098,7 +1108,10 @@ class CardBlock(Block):
         title: the card's title (max 150 chars). Can be a string or `Text` object.
         subtitle: the card's subtitle (max 150 chars). Can be a string or `Text` object.
         body: the card's body text (max 200 chars). Can be a string or `Text` object.
-        actions: up to three `Button` elements presented as card actions.
+        actions: up to three `Button` elements, serialized in the supplied order.
+            Slack right-aligns buttons with primary last. With two buttons,
+            danger precedes the other button in that group; with three,
+            danger sits at the card's far left.
         slack_icon: a `SlackIcon` naming a Slack-provided icon. Cannot be
             combined with `icon`.
         subtext: additional text displayed at the bottom of the card
@@ -1406,8 +1419,11 @@ class DataTableBlock(Block):
             for cell in row:
                 if not isinstance(cell, RawText | RawNumber | RichTextBlock):
                     raise TypeMismatchError("Unsupported data table cell type.")
-                if isinstance(cell, RawText) and len(cell.text) < DATA_TABLE_CELL_TEXT_MIN_LENGTH:
-                    raise LengthError("Data table raw text cells cannot be empty.")
+                if (
+                    isinstance(cell, RawText | RawNumber)
+                    and len(cell.text) < DATA_TABLE_CELL_TEXT_MIN_LENGTH
+                ):
+                    raise LengthError("Data table raw text and numeric labels cannot be empty.")
         if any(isinstance(cell, RichTextBlock) for cell in rows[0]):
             raise TypeMismatchError("Data table header cells cannot contain rich text.")
         self.page_size = validate_int(
@@ -1443,12 +1459,18 @@ class DataTableBlock(Block):
 
 def _text_character_count(value: Any) -> int:
     if isinstance(value, dict):
-        return sum(
-            len(nested)
-            if key == "text" and isinstance(nested, str)
-            else _text_character_count(nested)
-            for key, nested in value.items()
-        )
+        if value.get("type") in {"raw_text", "raw_number", "text", "link"}:
+            text = value.get("text")
+            return len(text) if isinstance(text, str) else 0
+        if value.get("type") in {
+            "rich_text",
+            "rich_text_section",
+            "rich_text_list",
+            "rich_text_quote",
+            "rich_text_preformatted",
+        }:
+            return _text_character_count(value.get("elements", []))
+        return 0
     if isinstance(value, list):
         return sum(_text_character_count(item) for item in value)
     return 0

{slackblocks-3.2.0 → slackblocks-4.0.0}/slackblocks/messages.py

@@ -21,6 +21,7 @@ from slackblocks._limits import (
     MESSAGE_BLOCKS_MAX_ITEMS,
     MESSAGE_CHANNEL_MIN_LENGTH,
     MESSAGE_DATA_VISUALIZATIONS_MAX_ITEMS,
+    TABLE_TOTAL_CONTENT_MAX_LENGTH,
 )
 from slackblocks._surfaces import validate_surface_blocks
 from slackblocks.utils import coerce_to_list, validate_string_nonnull
@@ -74,6 +75,13 @@ def _validate_message_totals(
             f"Markdown block text ({markdown} characters) exceeds the message-wide limit of "
             f"{MARKDOWN_TOTAL_TEXT_MAX_LENGTH} characters."
         )
+    table = sum(
+        _text_character_count(block["rows"])
+        for block in rendered_blocks
+        if block.get("type") == "table"
+    )
+    if table > TABLE_TOTAL_CONTENT_MAX_LENGTH:
+        raise LengthError("Table cell text exceeds the message-wide 10,000-character limit.")
     data_table = sum(
         _text_character_count(block["rows"])
         for block in rendered_blocks
@@ -99,9 +107,11 @@ class _MessagePayloadMixin:
         raise NotImplementedError
 
     def to_dict(self) -> dict[str, Any]:
+        """Return a fresh Slack-shaped dictionary, validating the resolved payload."""
         return self._resolve()
 
     def json(self) -> str:
+        """Return the validated Slack-shaped payload as indented JSON."""
         return dumps(self._resolve(), indent=4)
 
     def __repr__(self) -> str:
@@ -111,6 +121,7 @@ class _MessagePayloadMixin:
         return self._resolve()[item]
 
     def keys(self) -> list[str]:
+        """Return the serialized field names for mapping-style SDK argument unpacking."""
         return list(self._resolve().keys())
 
 
@@ -184,7 +195,7 @@ class Message(BaseMessage):
             automatically unfurl.
         metadata: optional message metadata, including `event_type` and `event_payload`.
     Throws:
-        InvalidUsageException: in the event that the items passed to `blocks`
+        InvalidUsageError: in the event that the items passed to `blocks`
             are not valid [`Blocks`](/slackblocks/latest/reference/blocks).
     """
 

{slackblocks-3.2.0 → slackblocks-4.0.0}/slackblocks/modals.py

@@ -26,7 +26,9 @@ class Modal(ModalView):
         return dumps(self._resolve(), indent=4)
 
     def to_dict(self) -> dict[str, Any]:
+        """Return a fresh Slack-shaped dictionary, validating the resolved payload."""
         return self._resolve()
 
     def json(self) -> str:
+        """Return the validated Slack-shaped payload as indented JSON."""
         return dumps(self._resolve(), indent=4)

{slackblocks-3.2.0 → slackblocks-4.0.0}/slackblocks/objects.py

@@ -6,6 +6,7 @@ See: <https://api.slack.com/reference/block-kit/composition-objects>.
 
 from __future__ import annotations
 
+import math
 import re
 from abc import ABC, abstractmethod
 from enum import Enum
@@ -19,7 +20,6 @@ from slackblocks._limits import (
     CONFIRMATION_TEXT_MAX_LENGTH,
     CONFIRMATION_TITLE_MAX_LENGTH,
     CONVERSATION_FILTER_INCLUDE_MIN_ITEMS,
-    DATA_TABLE_CELL_TEXT_MIN_LENGTH,
     DATA_VISUALIZATION_AXIS_LABEL_MAX_LENGTH,
     DATA_VISUALIZATION_CATEGORIES_MAX_ITEMS,
     DATA_VISUALIZATION_CATEGORIES_MIN_ITEMS,
@@ -130,7 +130,7 @@ class Text(CompositionObject):
             names, user names will not automatically be rendered as links.
 
     Throws:
-        InvalidUsageException: if the provided `text` fails validation.
+        InvalidUsageError: if the provided `text` fails validation.
     """
 
     def __init__(
@@ -641,7 +641,7 @@ class ConversationFilter(CompositionObject):
         exclude_bot_users: whether to remove bot users from the list of conversations.
 
     Throws:
-        InvalidUsageException: in the event that the user provides none of `include`,
+        InvalidUsageError: in the event that the user provides none of `include`,
             `exclude_external_shared_channels`, or `exclude_bot_users` arguments.
     """
 
@@ -907,7 +907,7 @@ class RawText:
             escaped into text format (e.g. `:smile:`).
 
     Throws:
-        InvalidUsageException: if the provided `text` fails validation.
+        InvalidUsageError: if the provided `text` fails validation.
     """
 
     def __init__(
@@ -931,14 +931,14 @@ class RawText:
 
 class RawNumber(RenderableMixin):
     """
-    A numeric cell for a
+    A numeric cell for a table or
     [`DataTableBlock`](/slackblocks/latest/reference/blocks/#blocks.DataTableBlock).
 
     See: <https://docs.slack.dev/reference/block-kit/blocks/data-table-block>.
 
     Args:
         value: the numeric value Slack uses for sorting and display.
-        text: the non-empty text Slack displays in the cell.
+        text: the non-empty text Slack displays.
 
     Throws:
         InvalidUsageError: if any of the provided arguments fail validation.
@@ -947,11 +947,11 @@ class RawNumber(RenderableMixin):
     def __init__(self, value: int | float, text: str) -> None:
         if isinstance(value, bool) or not isinstance(value, int | float):
             raise TypeMismatchError("`value` must be a number.")
+        if isinstance(value, float) and not math.isfinite(value):
+            raise InvalidUsageError("`value` must be finite.")
         self.type = "raw_number"
         self.value = value
-        self.text = validate_string_nonnull(
-            text, field_name="text", min_length=DATA_TABLE_CELL_TEXT_MIN_LENGTH
-        )
+        self.text = validate_string_nonnull(text, field_name="text", min_length=1)
 
     def _resolve(self) -> dict[str, Any]:
         return {"type": self.type, "value": self.value, "text": self.text}

{slackblocks-3.2.0 → slackblocks-4.0.0}/slackblocks/views.py

@@ -106,6 +106,7 @@ class View:
         )
 
     def to_dict(self) -> dict[str, Any]:
+        """Return a fresh Slack-shaped dictionary, validating the resolved payload."""
         return self._resolve()
 
     def __repr__(self) -> str:

{slackblocks-3.2.0 → slackblocks-4.0.0}/uv.lock

@@ -1695,7 +1695,7 @@ wheels = [
 
 [[package]]
 name = "slackblocks"
-version = "3.2.0"
+version = "4.0.0"
 source = { editable = "." }
 
 [package.dev-dependencies]