B 't\@sRdZddlmZddlZddlZddlmZddlmZdgZ Gddde Z dS) a5 Similar to `PyOS_InputHook` of the Python API. Some eventloops can have an inputhook to allow easy integration with other event loops. When the eventloop of prompt-toolkit is idle, it can call such a hook. This hook can call another eventloop that runs for a short while, for instance to keep a graphical user interface responsive. It's the responsibility of this hook to exit when there is input ready. There are two ways to detect when input is ready: - Call the `input_is_ready` method periodically. Quit when this returns `True`. - Add the `fileno` as a watch to the external eventloop. Quit when file descriptor becomes readable. (But don't read from it.) Note that this is not the same as checking for `sys.stdin.fileno()`. The eventloop of prompt-toolkit allows thread-based executors, for example for asynchronous autocompletion. When the completion for instance is ready, we also want prompt-toolkit to gain control again in order to display that. An alternative to using input hooks, is to create a custom `EventLoop` class that controls everything. )unicode_literalsN) is_windows) select_fdsInputHookContextc@s8eZdZdZddZddZddZdd Zd d Zd S) rz0 Given as a parameter to the inputhook. cCsd|_t\|_|_dS)N)_input_is_readyospipe_r_w)selfr Alib/python3.7/site-packages/prompt_toolkit/eventloop/inputhook.py__init__(szInputHookContext.__init__cCs |jddS)z6 Return True when the input is ready. F)wait)r)r r r rinput_is_ready,szInputHookContext.input_is_readycCs|jS)z\ File descriptor that will become ready when the event loop needs to go on. )r )r r r rfileno2szInputHookContext.filenocsts tt|st_fdd}tj|d|y(ts\tjgddt jdWnt k rYnXd_dS)aH Call the inputhook. (Called by a prompt-toolkit eventloop.) :param input_is_ready_func: A callable which returns True when there is input ready for the main event loop to process. This means that we should quit our input hook. This callable takes a boolean `wait`. Wen `True` this needs to be a blocking call which only returns when there is input ready. :param inputhook: This is a callable that runs the inputhook. This function should take this object (the `InputHookContext`) as input. csddtjddS)NT)rx)rwriter r )input_is_ready_funcr r rthreadJs z/InputHookContext.call_inputhook..thread)targetN)Ztimeouti) callableAssertionErrorr threadingZThreadstartrrr rreadOSError)r rZ inputhookrr )rr rcall_inputhook8s   zInputHookContext.call_inputhookcCs.|jrt|jt|jd|_|_dS)z% Clean up resources. N)r rcloser )r r r rrjs  zInputHookContext.closeN) __name__ __module__ __qualname____doc__rrrrrr r r rr$s 2) r#Z __future__rrrZprompt_toolkit.utilsrZselectr__all__objectrr r r rs