feature: add Slide.is_hidden read/write property

Add the ability to get and set whether a slide is hidden from the
presentation. Maps to the `show` attribute on the `<p:sld>` element,
where show="0" means the slide is hidden.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: MHoroszowski

features/sld-slide.feature

@@ -14,6 +14,22 @@ Feature: slide properties
       | an overridden         |
 
 
+  Scenario Outline: Slide.is_hidden
+    Given a slide having <hidden-or-visible> visibility
+     Then slide.is_hidden is <value>
+
+    Examples: Slide.is_hidden cases
+      | hidden-or-visible | value |
+      | visible           | False |
+      | hidden            | True  |
+
+
+  Scenario: Slide.is_hidden setter
+    Given a slide having visible visibility
+     When I assign True to slide.is_hidden
+     Then slide.is_hidden is True
+
+
   Scenario Outline: Slide.follow_master_background
     Given a Slide object having <default-or-overridden> background as slide
      Then slide.follow_master_background is <value>

features/steps/slide.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from behave import given, then
+from behave import given, then, when
 from helpers import test_pptx
 
 from pptx import Presentation
@@ -28,6 +28,12 @@ def given_a_slide(context):
     context.slide = presentation.slides[0]
 
 
+@given("a slide having {visibility} visibility")
+def given_a_slide_having_visibility(context, visibility):
+    slide_idx = {"visible": 0, "hidden": 1}[visibility]
+    context.slide = Presentation(test_pptx("sld-slide-hidden")).slides[slide_idx]
+
+
 @given("a slide having a notes slide")
 def given_a_slide_having_a_notes_slide(context):
     context.slide = Presentation(test_pptx("sld-notes")).slides[0]
@@ -96,6 +102,14 @@ def given_a_SlideMaster_object_as_slide(context):
     context.slide = context.slide_master = prs.slide_masters[0]
 
 
+# when ====================================================
+
+
+@when("I assign {value} to slide.is_hidden")
+def when_I_assign_value_to_slide_is_hidden(context, value):
+    context.slide.is_hidden = {"True": True, "False": False}[value]
+
+
 # then ====================================================
 
 
@@ -136,6 +150,13 @@ def then_slide_background_is_a_Background_object(context):
     assert cls_name == "_Background", "slide.background is a %s object" % cls_name
 
 
+@then("slide.is_hidden is {value}")
+def then_slide_is_hidden_is_value(context, value):
+    expected_value = {"True": True, "False": False}[value]
+    actual_value = context.slide.is_hidden
+    assert actual_value is expected_value, "slide.is_hidden is %s" % actual_value
+
+
 @then("slide.follow_master_background is {value}")
 def then_slide_follow_master_background_is_value(context, value):
     expected_value = {"True": True, "False": False}[value]

features/steps/test_files/sld-slide-hidden.pptx

@@ -7,7 +7,7 @@
 from pptx.oxml import parse_from_template, parse_xml
 from pptx.oxml.dml.fill import CT_GradientFillProperties
 from pptx.oxml.ns import nsdecls
-from pptx.oxml.simpletypes import XsdString
+from pptx.oxml.simpletypes import XsdBoolean, XsdString
 from pptx.oxml.xmlchemy import (
     BaseOxmlElement,
     Choice,
@@ -164,6 +164,9 @@ class CT_Slide(_BaseSlideElement):
     clrMapOvr = ZeroOrOne("p:clrMapOvr", successors=_tag_seq[2:])
     timing = ZeroOrOne("p:timing", successors=_tag_seq[4:])
     del _tag_seq
+    show: bool = OptionalAttribute(  # pyright: ignore[reportAssignmentType]
+        "show", XsdBoolean, default=True
+    )
 
     @classmethod
     def new(cls) -> CT_Slide:

src/pptx/oxml/slide.py

@@ -178,6 +178,18 @@ class Slide(_BaseSlide):
 
     part: SlidePart  # pyright: ignore[reportIncompatibleMethodOverride]
 
+    @property
+    def is_hidden(self) -> bool:
+        """`True` if this slide is hidden from the presentation, `False` otherwise.
+
+        Assigning `True` causes the slide to be hidden. Assigning `False` makes the slide visible.
+        """
+        return not self._element.show
+
+    @is_hidden.setter
+    def is_hidden(self, value: bool) -> None:
+        self._element.show = not value
+
     @property
     def follow_master_background(self):
         """|True| if this slide inherits the slide master background.

src/pptx/slide.py

@@ -309,6 +309,36 @@ def it_provides_access_to_its_background(self, background_fixture):
         _BaseSlide_background_.assert_called_once_with()
         assert background is background_
 
+    @pytest.mark.parametrize(
+        ("sld_cxml", "expected_value"),
+        [
+            ("p:sld/p:cSld", False),
+            ("p:sld{show=1}/p:cSld", False),
+            ("p:sld{show=0}/p:cSld", True),
+            ("p:sld{show=false}/p:cSld", True),
+            ("p:sld{show=true}/p:cSld", False),
+        ],
+    )
+    def it_knows_whether_it_is_hidden(self, sld_cxml: str, expected_value: bool):
+        slide = Slide(element(sld_cxml), None)
+        assert slide.is_hidden is expected_value
+
+    @pytest.mark.parametrize(
+        ("sld_cxml", "new_value", "expected_cxml"),
+        [
+            ("p:sld/p:cSld", True, "p:sld{show=0}/p:cSld"),
+            ("p:sld/p:cSld", False, "p:sld/p:cSld"),
+            ("p:sld{show=0}/p:cSld", False, "p:sld/p:cSld"),
+            ("p:sld{show=0}/p:cSld", True, "p:sld{show=0}/p:cSld"),
+        ],
+    )
+    def it_can_change_whether_it_is_hidden(
+        self, sld_cxml: str, new_value: bool, expected_cxml: str
+    ):
+        slide = Slide(element(sld_cxml), None)
+        slide.is_hidden = new_value
+        assert slide._element.xml == xml(expected_cxml)
+
     def it_knows_whether_it_follows_the_mstr_bkgd(self, follow_get_fixture):
         slide, expected_value = follow_get_fixture
         follows = slide.follow_master_background