feat: add month calendar

docs/examples/widgets/month_calendar.py

@@ -0,0 +1,29 @@
+import datetime
+
+from textual.app import App, ComposeResult
+from textual.binding import Binding
+from textual.widgets import MonthCalendar
+
+
+class MonthCalendarApp(App):
+    CSS = """
+    Screen {
+        align: center middle;
+    }
+    """
+
+    BINDINGS = [
+        Binding("ctrl+s", "toggle_show_other_months"),
+    ]
+
+    def compose(self) -> ComposeResult:
+        yield MonthCalendar(datetime.date(year=2021, month=6, day=3))
+
+    def action_toggle_show_other_months(self) -> None:
+        calendar = self.query_one(MonthCalendar)
+        calendar.show_other_months = not calendar.show_other_months
+
+
+if __name__ == "__main__":
+    app = MonthCalendarApp()
+    app.run()

src/textual/widgets/__init__.py

@@ -27,6 +27,7 @@
     from ._loading_indicator import LoadingIndicator
     from ._log import Log
     from ._markdown import Markdown, MarkdownViewer
+    from ._month_calendar import MonthCalendar
     from ._option_list import OptionList
     from ._placeholder import Placeholder
     from ._pretty import Pretty
@@ -66,6 +67,7 @@
     "Log",
     "Markdown",
     "MarkdownViewer",
+    "MonthCalendar",
     "OptionList",
     "Placeholder",
     "Pretty",

src/textual/widgets/__init__.pyi

@@ -17,6 +17,7 @@ from ._loading_indicator import LoadingIndicator as LoadingIndicator
 from ._log import Log as Log
 from ._markdown import Markdown as Markdown
 from ._markdown import MarkdownViewer as MarkdownViewer
+from ._month_calendar import MonthCalendar as MonthCalendar
 from ._option_list import OptionList as OptionList
 from ._placeholder import Placeholder as Placeholder
 from ._pretty import Pretty as Pretty