o pfL@sdZddlmZmZddlZddlZddlmZejr%ddlm Z m Z m Z gdZ ej Gdd d ejeZd d Zd d ZddZedfddZdS)ziAbstract I/O mode container. Mode strings are used in in `~fs.base.FS.open` and `~fs.base.FS.openbin`. )print_functionunicode_literalsN)Text) FrozenSetSetUnion)Modecheck_readablecheck_writablevalidate_openbin_modec@seZdZdZddZddZddZdd Zd d Zd d Z e dfddZ ddZ e ddZe ddZe ddZe ddZe ddZe ddZe dd Ze d!d"Ze d#d$Zd%S)&r aAn abstraction for I/O modes. A mode object provides properties that can be used to interrogate the `mode strings `_ used when opening files. Example: >>> mode = Mode('rb') >>> mode.reading True >>> mode.writing False >>> mode.binary True >>> mode.text False cCs||_|dS)zCreate a new `Mode` instance. Arguments: mode (str): A *mode* string, as used by `io.open`. Raises: ValueError: If the mode string is invalid. N)_modevalidate)selfmoder@/home/ertert/spirit/venv/lib/python3.10/site-packages/fs/mode.py__init__-s z Mode.__init__cCs d|jS)Nz Mode({!r}))formatr rrrr__repr__;s z Mode.__repr__cCs|jS)N)r rrrr__str__?sz Mode.__str__cCst|tsJ||jvS)z+Check if a mode contains a given character.) isinstancerr )r characterrrr __contains__Cs zMode.__contains__cCstjr |jddS|jS)zGet a mode string for the current platform. Currently, this just removes the 'x' on PY2 because PY2 doesn't support exclusive mode. xw)sixPY2r replacerrrr to_platformIszMode.to_platformcCs$|dd}d|vr|S|dS)zvGet a *binary* mode string for the current platform. This removes the 't' and adds a 'b' if needed. tb)r r)rr rrrto_platform_binSszMode.to_platform_binzrwxtab+cCs^|j}|s td||std||ddvrtdd|vr+d|vr-tdd Sd S) zpValidate the mode string. Raises: ValueError: if the mode contains invalid chars. mode must not be empty%mode '{}' contains invalid charactersrrwxaz*mode must start with 'r', 'w', 'x', or 'a'r!r#z)mode can't be binary ('b') and text ('t')N)r ValueError issupersetr)r _valid_charsrrrrr]s  z Mode.validatecCs|d|vr tddS)zValidate a mode for opening a binary file. Raises: ValueError: if the mode contains invalid chars. r!zmode must be binaryN)rr(rrrr validate_binoszMode.validate_bincCsd|vp d|vp d|vS)z/`bool`: `True` if the mode would create a file.arrrrrrrcreate{sz Mode.createcCd|vpd|vS)z+`bool`: `True` if the mode permits reading.r+rrrrrreadingz Mode.readingcCs d|vpd|vpd|vpd|vS)z+`bool`: `True` if the mode permits writing.rr,r0rrrrrrwritings z Mode.writingcCd|vS)z-`bool`: `True` if the mode permits appending.r,rrrrr appendingzMode.appendingcCr4)z<`bool`: `True` if the mode permits both reading and writing.r0rrrrrupdatingr6z Mode.updatingcCr.)z;`bool`: `True` if the mode would truncate an existing file.rrrrrrrtruncater2z Mode.truncatecCr4)z6`bool`: `True` if the mode require exclusive creation.rrrrrr exclusiver6zMode.exclusivecCr4)z*`bool`: `True` if a mode specifies binary.r#rrrrrbinaryr6z Mode.binarycCsd|vpd|vS)z(`bool`: `True` if a mode specifies text.r!r#rrrrrtextr2z Mode.textN)__name__ __module__ __qualname____doc__rrrrr r$ frozensetrr+propertyr-r1r3r5r7r8r9r:r;rrrrr s8          r cC t|jS)zCheck a mode string allows reading. Arguments: mode (str): A mode string, e.g. ``"rt"`` Returns: bool: `True` if the mode allows reading. )r r1rrrrr  r cCrB)zCheck a mode string allows writing. Arguments: mode (str): A mode string, e.g. ``"wt"`` Returns: bool: `True` if the mode allows writing. )r r3rCrrrr rDr cCs t|dS)zCheck ``mode`` parameter of `~fs.base.FS.open` is valid. Arguments: mode (str): Mode parameter. Raises: `ValueError` if mode is not valid. N)r rCrrrvalidate_open_modes rEzrwxab+cCsLd|vrtd|std|ddvrtd||s$td|dS) zCheck ``mode`` parameter of `~fs.base.FS.openbin` is valid. Arguments: mode (str): Mode parameter. Raises: `ValueError` if mode is not valid. r!ztext mode not valid in openbinr%rr'z)mode must start with 'r', 'w', 'a' or 'x'r&N)r(r)r)rr*rrrr s   r )r? __future__rrtypingr_typingr TYPE_CHECKINGrrr__all__python_2_unicode_compatible Containerr r r rEr@r rrrrs