textual-timepiece 0.3.0

Various time related widgets & functionality for Textual.

Textual Timepiece

Various time management related widgets for the Textual framework.

Documentation | Changelog | PyPi

Demo

Try the widgets out beforehand with uv:

uvx --from textual-timepiece demo

Install

pip install textual-timepiece

uv add textual-timepiece

poetry add textual-timepiece

[!NOTE] Requires whenever as an additional dependency.

Quick Start

DatePicker

from textual.app import App, ComposeResult
from textual_timepiece.pickers import DatePicker
from whenever import Date

class DatePickerApp(App[None]):
    def compose(self) -> ComposeResult:
        yield DatePicker(Date.today_in_system_tz())

if __name__ == "__main__":
    DatePickerApp().run()

DateTimePicker

from textual.app import App, ComposeResult
from textual_timepiece.pickers import DateTimePicker
from whenever import SystemDateTime

class DateTimePickerApp(App[None]):
    def compose(self) -> ComposeResult:
        yield DateTimePicker(SystemDateTime.now().local())

if __name__ == "__main__":
    DateTimePickerApp().run()

• More examples can be found here.

Included Widgets

• DatePicker
• DurationPicker
• TimePicker
• DateTimePicker
• DateRangePicker
• DateTimeRangePicker
• ActivityHeatmap
• HeatmapManager
• And more to come...

License

MIT. Check LICENSE for more information.