B *d@sdZddlmZddlmZmZddlmZmZddl m Z ddl m Z ddl mZmZd d d d d dgZGdd d eZGdd d edZGdddeZGdd d eZGdd d eZGdd d eZGdddeZdS)zV Input validation for a `Buffer`. (Validators will be called before accepting input.) ) annotations)ABCMetaabstractmethod)CallableOptional)run_in_executor_with_context)Document) FilterOrBool to_filterConditionalValidatorValidationError ValidatorThreadedValidatorDummyValidatorDynamicValidatorcs:eZdZdZd ddddfdd Zdd d d ZZS)r z Error raised by :meth:`.Validator.validate`. :param cursor_position: The cursor position where the error occurred. :param message: Text. rintstrNone)cursor_positionmessagereturncst|||_||_dS)N)super__init__rr)selfrr) __class__f/work/yifan.wang/ringdown/master-ringdown-env/lib/python3.7/site-packages/prompt_toolkit/validation.pyr!s zValidationError.__init__)rcCsd|jj|j|jS)Nz&{}(cursor_position={!r}, message={!r}))formatr__name__rr)rrrr__repr__&szValidationError.__repr__)rr)r __module__ __qualname____doc__rr! __classcell__rr)rrr sc@sNeZdZdZedddddZdddddZedd d d ddddZdS)ra Abstract base class for an input validator. A validator is typically created in one of the following two ways: - Either by overriding this class and implementing the `validate` method. - Or by passing a callable to `Validator.from_callable`. If the validation takes some time and needs to happen in a background thread, this can be wrapped in a :class:`.ThreadedValidator`. r r)documentrcCsdS)z Validate the input. If invalid, this should raise a :class:`.ValidationError`. :param document: :class:`~prompt_toolkit.document.Document` instance. Nr)rr&rrrvalidate;szValidator.validatecs*y||Wntk r$YnXdS)z Return a `Future` which is set when the validation is ready. This function can be overloaded in order to provide an asynchronous implementation. N)r'r )rr&rrrvalidate_asyncEszValidator.validate_async Invalid inputFzCallable[[str], bool]rbool) validate_func error_messagemove_cursor_to_endrcCs t|||S)aF Create a validator from a simple validate callable. E.g.: .. code:: python def is_valid(text): return text in ['hello', 'world'] Validator.from_callable(is_valid, error_message='Invalid input') :param validate_func: Callable that takes the input string, and returns `True` if the input is valid input. :param error_message: Message to be displayed if the input is invalid. :param move_cursor_to_end: Move the cursor to the end of the input, if the input is invalid. )_ValidatorFromCallable)clsr+r,r-rrr from_callablePszValidator.from_callableN)r)F) r r"r#r$rr'r( classmethodr0rrrrr.s    ) metaclassc@sBeZdZdZdddddddZdd d d Zd dd ddZdS)r.z0 Validate input from a simple callable. zCallable[[str], bool]rr*r)funcr,r-rcCs||_||_||_dS)N)r3r,r-)rr3r,r-rrrrnsz_ValidatorFromCallable.__init__)rcCsd|jdS)NzValidator.from_callable())r3)rrrrr!usz_ValidatorFromCallable.__repr__r )r&rcCs4||js0|jrt|j}nd}t||jddS)Nr)rr)r3textr-lenr r,)rr&indexrrrr'xs   z_ValidatorFromCallable.validateN)r r"r#r$rr!r'rrrrr.isr.c@s@eZdZdZdddddZdddd d Zdddd d Zd S)rz Wrapper that runs input validation in a thread. (Use this to prevent the user interface from becoming unresponsive if the input validation takes too much time.) rr) validatorrcCs ||_dS)N)r8)rr8rrrrszThreadedValidator.__init__r )r&rcCs|j|dS)N)r8r')rr&rrrr'szThreadedValidator.validatecs&ddfdd }t|IdHdS)z: Run the `validate` function in a thread. r)rcs S)N)r'r)r&rrrrun_validation_threadsz?ThreadedValidator.validate_async..run_validation_threadN)r)rr&r9r)r&rrr(sz ThreadedValidator.validate_asyncN)r r"r#r$rr'r(rrrrrsc@s eZdZdZdddddZdS)rz1 Validator class that accepts any input. r r)r&rcCsdS)Nr)rr&rrrr'szDummyValidator.validateN)r r"r#r$r'rrrrrsc@s2eZdZdZddddddZddd d d Zd S) r zq Validator that can be switched on/off according to a filter. (This wraps around another validator.) rr r)r8filterrcCs||_t||_dS)N)r8r r:)rr8r:rrrrszConditionalValidator.__init__r )r&rcCs|r|j|dS)N)r:r8r')rr&rrrr'szConditionalValidator.validateN)r r"r#r$rr'rrrrr sc@s@eZdZdZdddddZdddd d Zdddd d Zd S)rz Validator class that can dynamically returns any Validator. :param get_validator: Callable that returns a :class:`.Validator` instance. zCallable[[], Validator | None]r) get_validatorrcCs ||_dS)N)r;)rr;rrrrszDynamicValidator.__init__r )r&rcCs|p t}||dS)N)r;rr')rr&r8rrrr'szDynamicValidator.validatecs"|p t}||IdHdS)N)r;rr()rr&r8rrrr(szDynamicValidator.validate_asyncN)r r"r#r$rr'r(rrrrrsN)r$ __future__rabcrrtypingrrZprompt_toolkit.eventlooprr&r filtersr r __all__ Exceptionr rr.rrr rrrrrs&   ;