Metadata-Version: 2.4
Name: tk_digital_time_picker
Version: 0.1.0
Summary: A tkinter widget
Project-URL: Homepage, https://github.com/yannprada/tk_time_picker
Project-URL: Issues, https://github.com/yannprada/tk_time_picker/issues
Author-email: Yannick Pradayrol <pradayrol.yannick@gmail.com>
License-Expression: GPL-3.0-only
License-File: LICENSE
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.13.3
Description-Content-Type: text/markdown

# TimePicker

tkinter widget.

Button that displays time in `HH:MM:SS` format. When clicked, opens a window to edit time.

Methods:
```python
TimePicker.__str__()				# -> str: format 'HH:MM:SS'
TimePicker.get_seconds()			# -> int: total seconds
TimePicker.set_value(value: str)	# value format: 'HH:MM:SS'
TimePicker.set_value(value: list)	# value: [h, m, s]
TimePicker.set_value(value: tuple)	# value: (h, m, s)
```

## Demo

```python
import tkinter as tk

from tk_digital_time_picker import TimePicker


root = tk.Tk()
root.title('TimePicker testing')
root.geometry('300x300+1000+200')
root.configure(bg='grey')

TimePicker(root, hours=12, minutes=34, seconds=56).pack()

picker = TimePicker(root, hours_limit=100)
picker.pack()

picker.set_value([1, 2, 3])
print(picker)				# > 01:02:03

picker.set_value('99:59:59')
print(picker)				# > 99:59:59

picker.seconds += 1
print(picker)				# > 00:00:00

picker.minutes += 120
print(picker)				# > 02:00:00

picker.hours *= 3
print(picker)				# > 06:00:00

print(picker.get_seconds())	# > 21600

root.mainloop()
```

![TimePicker test](https://raw.githubusercontent.com/yannprada/tk_time_picker/refs/heads/master/demo.png "TimePicker test")
