import名を at から atk に変更

Author: gottadiveintopython

README.md

@@ -37,13 +37,13 @@ It's not easy to understand.
 If you use `asynctkinter`, the code above will become:
 
 ```python
-import asynctkinter as at
+import asynctkinter as atk
 
 async def what_you_want_to_do(clock, label):
     print('A')
     await clock.sleep(1)
     print('B')
-    await at.event(label, '<Button>')
+    await atk.event(label, '<Button>')
     print('C')
 
 nursery.start(what_you_want_to_do(...))
@@ -62,25 +62,25 @@ pip install "asynctkinter>=0.4,<0.5"
 
 ```python
 import tkinter as tk
-import asynctkinter as at
+import asynctkinter as atk
 
 
-async def main(*, clock: at.Clock, root: tk.Tk):
+async def main(*, clock: atk.Clock, root: tk.Tk):
     label = tk.Label(root, text='Hello', font=('', 80))
     label.pack()
 
     # waits for 2 seconds to elapse
     await clock.sleep(2)
 
     # waits for a label to be pressed
-    event = await at.event(label, '<Button>')
+    event = await atk.event(label, '<Button>')
     print(f"pos: {event.x}, {event.y}")
 
     # waits for either 5 seconds to elapse or a label to be pressed.
     # i.e. waits at most 5 seconds for a label to be pressed
-    tasks = await at.wait_any(
+    tasks = await atk.wait_any(
         clock.sleep(5),
-        at.event(label, '<Button>'),
+        atk.event(label, '<Button>'),
     )
     if tasks[0].finished:
         print("Timeout")
@@ -90,21 +90,21 @@ async def main(*, clock: at.Clock, root: tk.Tk):
 
     # same as the above
     async with clock.move_on_after(5) as timeout_tracker:
-        event = await at.event(label, '<Button>')
+        event = await atk.event(label, '<Button>')
         print(f"The label got pressed. (pos: {event.x}, {event.y})")
     if timeout_tracker.finished:
         print("Timeout")
 
     # waits for both 5 seconds to elapse and a label to be pressed.
-    tasks = await at.wait_all(
+    tasks = await atk.wait_all(
         clock.sleep(5),
-        at.event(label, '<Button>'),
+        atk.event(label, '<Button>'),
     )
 
     # nests as you want.
     tasks = await ak.wait_all(
-        at.event(label, '<Button>'),
-        at.wait_any(
+        atk.event(label, '<Button>'),
+        atk.wait_any(
             clock.sleep(5),
             ...,
         ),
@@ -113,7 +113,7 @@ async def main(*, clock: at.Clock, root: tk.Tk):
 
 
 if __name__ == "__main__":
-    at.run(main)
+    atk.run(main)
 ```
 
 ### threading
@@ -123,11 +123,11 @@ thus threads may be the best way to perform them without blocking the main threa
 
 ```python
 from concurrent.futures import ThreadPoolExecuter
-import asynctkinter as at
+import asynctkinter as atk
 
 executer = ThreadPoolExecuter()
 
-async def async_fn(clock: at.Clock):
+async def async_fn(clock: atk.Clock):
     # create a new thread, run a function inside it, then
     # wait for the completion of that thread
     r = await clock.run_in_thread(thread_blocking_operation, polling_interval=1.0)
@@ -144,9 +144,9 @@ so you can catch them like you do in synchronous code:
 
 ```python
 import requests
-import asynctkinter as at
+import asynctkinter as atk
 
-async def async_fn(clock: at.Clock):
+async def async_fn(clock: atk.Clock):
     try:
         r = await clock.run_in_thread(lambda: requests.get('htt...', timeout=10), ...)
     except requests.Timeout:

examples/animation_using_sleep.py

@@ -1,8 +1,8 @@
 import tkinter as tk
-import asynctkinter as at
+import asynctkinter as atk
 
 
-async def main(*, clock: at.Clock, root: tk.Tk):
+async def main(*, clock: atk.Clock, root: tk.Tk):
     root.title("Looping Animation")
     root.geometry('800x200')
     label = tk.Label(root, text='Hello', font=('', 80))
@@ -22,4 +22,4 @@ async def main(*, clock: at.Clock, root: tk.Tk):
 
 
 if __name__ == "__main__":
-    at.run(main)
+    atk.run(main)

examples/bmi_calculator.py

@@ -4,7 +4,7 @@
 from tkinter import ttk
 from tkinter import messagebox
 
-import asynctkinter as at
+import asynctkinter as atk
 
 
 class App:
@@ -15,10 +15,10 @@ async def main(self, *, clock, root):
         while True:
             await self.run_bmi_calculator(clock, root)
 
-    async def run_bmi_calculator(self, clock: at.Clock, root: tk.Tk):
+    async def run_bmi_calculator(self, clock: atk.Clock, root: tk.Tk):
         scene = self.title_scene
         scene.pack(in_=root, expand=True, fill='both')
-        await at.event(scene.children['start_button'], '<Button>')
+        await atk.event(scene.children['start_button'], '<Button>')
         scene.pack_forget()
 
         scene = self.input_scene
@@ -39,10 +39,10 @@ async def run_bmi_calculator(self, clock: at.Clock, root: tk.Tk):
         scene.pack(in_=root, expand=True, fill='both')
         scene.children['top_label']['text'] = f'Your BMI is {bmi:.2f}\nYou are'
         scene.children['bottom_label']['text'] = result
-        await at.wait_any(clock.sleep(3), at.event(root, '<Button>'))
+        await atk.wait_any(clock.sleep(3), atk.event(root, '<Button>'))
         scene.children['top_label']['text'] = ''
         scene.children['bottom_label']['text'] = 'bye'
-        await at.wait_any(clock.sleep(3), at.event(root, '<Button>'))
+        await atk.wait_any(clock.sleep(3), atk.event(root, '<Button>'))
         scene.pack_forget()
 
     def init_style(self):
@@ -76,7 +76,7 @@ async def ask_input(msg):
             entry.delete(0, tk.END)
             entry.focus()
             while True:
-                await at.event(entry, '<Return>')
+                await atk.event(entry, '<Return>')
                 text = entry.get()
                 try:
                     value = float(text)
@@ -102,4 +102,4 @@ def result_scene(self) -> ttk.Frame:
 
 
 if __name__ == '__main__':
-    at.run(App().main)
+    atk.run(App().main)

examples/event.py

@@ -1,18 +1,18 @@
 import tkinter as tk
-import asynctkinter as at
+import asynctkinter as atk
 
 
-async def main(*, clock: at.Clock, root: tk.Tk):
+async def main(*, clock: atk.Clock, root: tk.Tk):
     root.title("Event")
     root.geometry('800x400')
     label = tk.Label(root, font=('', 40))
     label.pack(expand=True, fill='both')
     while True:
         label['text'] = 'Click anywhere!'
-        e = await at.event(label, '<Button>')
+        e = await atk.event(label, '<Button>')
         label['text'] = f'You clicked at pos ({e.x}, {e.y})'
         await clock.sleep(1.5)
 
 
 if __name__ == "__main__":
-    at.run(main)
+    atk.run(main)

examples/event_with_filter.py

@@ -1,29 +1,29 @@
 import tkinter as tk
-import asynctkinter as at
+import asynctkinter as atk
 
 
-async def main(*, clock: at.Clock, root: tk.Tk):
+async def main(*, clock: atk.Clock, root: tk.Tk):
     root.title("Filtering Event")
     root.geometry('900x400')
     label = tk.Label(root, font=('', 40))
     label.pack(expand=True, fill='both')
     while True:
         label['text'] = 'Press the left mouse button!!'
-        await at.event(label, '<Button-1>')
+        await atk.event(label, '<Button-1>')
         label['text'] = 'One more time'
-        await at.event(label, '<Button>', filter=lambda e: e.num == 1)
+        await atk.event(label, '<Button>', filter=lambda e: e.num == 1)
         label['text'] = 'Nice!!'
 
         await clock.sleep(1.5)
 
         label['text'] = 'Press the right mouse button!!'
-        await at.event(label, '<Button-3>')
+        await atk.event(label, '<Button-3>')
         label['text'] = 'One more time'
-        await at.event(label, '<Button>', filter=lambda e: e.num == 3)
+        await atk.event(label, '<Button>', filter=lambda e: e.num == 3)
         label['text'] = 'Great!!'
 
         await clock.sleep(1.5)
 
 
 if __name__ == "__main__":
-    at.run(main)
+    atk.run(main)

examples/move_on_after.py

@@ -1,8 +1,8 @@
 import tkinter as tk
-import asynctkinter as at
+import asynctkinter as atk
 
 
-async def main(*, clock: at.Clock, root: tk.Tk):
+async def main(*, clock: atk.Clock, root: tk.Tk):
     root.title("Appying a time limit to a code block")
     root.geometry('400x400')
     label = tk.Label(root, font=('', 80))
@@ -20,4 +20,4 @@ async def main(*, clock: at.Clock, root: tk.Tk):
 
 
 if __name__ == "__main__":
-    at.run(main)
+    atk.run(main)

examples/network_io.py

@@ -1,15 +1,15 @@
 import tkinter as tk
 import requests
 
-import asynctkinter as at
+import asynctkinter as atk
 
 
-async def main(*, clock: at.Clock, root: tk.Tk):
+async def main(*, clock: atk.Clock, root: tk.Tk):
     root.title("HTTP Request")
     root.geometry('1000x400')
     label = tk.Label(root, text='Press to start a HTTP request', font=('', 40))
     label.pack(expand=True)
-    await at.event(label, '<Button>')
+    await atk.event(label, '<Button>')
     label['text'] = 'waiting for the server to respond...'
     res = await clock.run_in_thread(
         lambda: requests.get("https://httpbin.org/delay/2"),
@@ -20,4 +20,4 @@ async def main(*, clock: at.Clock, root: tk.Tk):
 
 
 if __name__ == '__main__':
-    at.run(main)
+    atk.run(main)

examples/network_io_with_animation.py

@@ -2,11 +2,11 @@
 from tkinter import ttk
 import requests
 
-import asynctkinter as at
+import asynctkinter as atk
 from progress_spinner import run_progress_spinner
 
 
-async def main(*, clock: at.Clock, root: tk.Tk):
+async def main(*, clock: atk.Clock, root: tk.Tk):
     root.title("HTTP request + loading animation")
     root.geometry('720x480')
     bg = root.cget("bg")
@@ -22,18 +22,18 @@ async def main(*, clock: at.Clock, root: tk.Tk):
     canvas = tk.Canvas(root, bg=bg, height=200, width=200)
     canvas.pack(expand=True)
 
-    await at.event(button, "<Button>")
+    await atk.event(button, "<Button>")
 
-    lw = 20
-    async with at.run_as_daemon(
+    lw = 20  # line width
+    async with atk.run_as_daemon(
         run_progress_spinner(
             lw, lw, canvas.winfo_width() - lw, canvas.winfo_height() - lw,
             clock=clock, draw_target=canvas, line_width=lw,
         ),
     ):
         session = requests.Session()
         button['text'] = 'cancel'
-        async with at.move_on_when(at.event(button, "<Button>")) as cancel_tracker:
+        async with atk.move_on_when(atk.event(button, "<Button>")) as cancel_tracker:
             label['text'] = 'first request...'
             await clock.run_in_thread(
                 lambda: session.get("https://httpbin.org/delay/2"),
@@ -49,10 +49,10 @@ async def main(*, clock: at.Clock, root: tk.Tk):
 
     label['text'] = 'cancelled' if cancel_tracker.finished else 'all requests done'
     button['text'] = 'close'
-    await at.event(button, "<Button>")
+    await atk.event(button, "<Button>")
     await clock.sleep(0)
     root.destroy()
 
 
 if __name__ == '__main__':
-    at.run(main)
+    atk.run(main)

examples/painter1.py

@@ -4,10 +4,10 @@
 '''
 
 import tkinter as tk
-import asynctkinter as at
+import asynctkinter as atk
 
 
-async def main(*, clock: at.Clock, root: tk.Tk):
+async def main(*, clock: atk.Clock, root: tk.Tk):
     root.title("Painter")
     root.geometry('800x800')
     canvas = tk.Canvas(root, bg='white')
@@ -18,7 +18,7 @@ async def main(*, clock: at.Clock, root: tk.Tk):
         3: draw_oval,
     }
     while True:
-        e_press = await at.event(canvas, '<Button>')
+        e_press = await atk.event(canvas, '<Button>')
         command = button2command.get(e_press.num)
         if command is not None:
             await command(canvas, e_press)
@@ -28,8 +28,8 @@ async def draw_rect(canvas: tk.Canvas, e_press: tk.Event):
     ox, oy = e_press.x, e_press.y
     rect = canvas.create_rectangle(ox, oy, ox, oy, outline='orange', width=3)
     async with (
-        at.move_on_when(at.event(canvas, '<ButtonRelease>', filter=lambda e: e.num == e_press.num)),
-        at.event_freq(canvas, '<Motion>') as mouse_motion,
+        atk.move_on_when(atk.event(canvas, '<ButtonRelease>', filter=lambda e: e.num == e_press.num)),
+        atk.event_freq(canvas, '<Motion>') as mouse_motion,
     ):
         while True:
             e = await mouse_motion()
@@ -41,8 +41,8 @@ async def draw_oval(canvas: tk.Canvas, e_press: tk.Event):
     oval = canvas.create_oval(ox, oy, ox, oy, outline='blue', width=3)
     bbox = canvas.create_rectangle(ox, oy, ox, oy, outline='black', dash=(3, 3))
     async with (
-        at.move_on_when(at.event(canvas, '<ButtonRelease>', filter=lambda e: e.num == e_press.num)),
-        at.event_freq(canvas, '<Motion>') as mouse_motion,
+        atk.move_on_when(atk.event(canvas, '<ButtonRelease>', filter=lambda e: e.num == e_press.num)),
+        atk.event_freq(canvas, '<Motion>') as mouse_motion,
     ):
         while True:
             e = await mouse_motion()
@@ -52,4 +52,4 @@ async def draw_oval(canvas: tk.Canvas, e_press: tk.Event):
 
 
 if __name__ == '__main__':
-    at.run(main)
+    atk.run(main)