Escape key

[metropt]

When I try to use escape key I notice a delay before clicked_back() is called. It is the only key where this happens.

@kb.add('escape')
def back_(event):
    clicked_back()

[jonathanslenders]

Yes, this is expected.

See: https://python-prompt-toolkit.readthedocs.io/en/master/pages/advanced_topics/key_bindings.html#binding-alt-something-option-something-or-meta-something
and https://python-prompt-toolkit.readthedocs.io/en/master/pages/advanced_topics/key_bindings.html#timeouts

(Maybe we should add a link to the docs linking these two sections together.)

[metropt]

Should I set the ttime to 0?

[drewarnett]

I'm writing a prompt-toolkit app that wants a fast response to escape due to tradition.(Something less than a second, 1/4 or better yet 1/10 second max.)

In application.py, Application.ttimeoutlen default is 0.5, and Application.timeoutlen is 0.5.

I tried reducing Application.ttimeoutlen, but delay was still around 1 second. Turns out that to get sub 1 second, also needed to reduce Application.timeoutlen to less than 1 as well. So, that's the complete answer.

Given the date, there's a good chance you've figured this out already.

I still need to do homework to figure out how to calculate safe values for given terminal speeds. (Hey, I might want to run my application over slow RS-232 or something goofy like that.) Portability is a high priority for me.

I propose adding something like this to the end of the Timeouts section in this doc: https://python-prompt-toolkit.readthedocs.io/en/master/pages/advanced_topics/key_bindings.html#timeouts

"Note: standalone escape keybinding response speed is determined by the values of both Application.timeoutlen as well as Application.ttimeoutlen."

Can discuss the possible text in this ticket, and I can submit via PR, or just close this ticket.

[drewarnett]

Candidate for label 'need-better-docs'?