o Q`w@sdZddlmZddlmZddlZddlZddlmZejr)ddlm Z m Z m Z gdZ ej Gd d d ejeZd d Zd dZddZedfddZdS)ziAbstract I/O mode container. Mode strings are used in in `~fs.base.FS.open` and `~fs.base.FS.openbin`. )print_function)unicode_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 a$An abstraction for I/O modes. A mode object provides properties that can be used to interrogate the `mode strings `_ used when opening files. Arguments: mode (str): A *mode* string, as used by `io.open`. Raises: ValueError: If the mode string is invalid. Example: >>> mode = Mode('rb') >>> mode.reading True >>> mode.writing False >>> mode.binary True >>> mode.text False cCs||_|dSN)_modevalidate)selfmoder)/usr/lib/python3/dist-packages/fs/mode.py__init__5s z Mode.__init__cCs d|jS)Nz Mode({!r}))formatrrrrr__repr__:s z Mode.__repr__cCs|jSr )rrrrr__str__>sz Mode.__str__cCst|tsJ||jvS)z4Check if a mode contains a given character. ) isinstancerr)r characterrrr __contains__Bs 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)sixZPY2rreplacerrrr 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)rrrrrto_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)z8`bool`: `True` if the mode would create a file. arrrrrrrcreate{sz Mode.createcCd|vpd|vS)z4`bool`: `True` if the mode permits reading. r+rrrrrreadingz Mode.readingcCs d|vpd|vpd|vpd|vS)z4`bool`: `True` if the mode permits writing. rr,r0rrrrrrwritings z Mode.writingcCd|vS)z6`bool`: `True` if the mode permits appending. r,rrrrr appendingzMode.appendingcCr4)zE`bool`: `True` if the mode permits both reading and writing. r0rrrrrupdatingr6z Mode.updatingcCr.)zD`bool`: `True` if the mode would truncate an existing file. rrrrrrrtruncater2z Mode.truncatecCr4)z?`bool`: `True` if the mode require exclusive creation. rrrrrr exclusiver6zMode.exclusivecCr4)z3`bool`: `True` if a mode specifies binary. r#rrrrrbinaryr6z Mode.binarycCsd|vpd|vS)z1`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?Z __future__rrtypingrZ_typingrZ TYPE_CHECKINGrrr__all__Zpython_2_unicode_compatible Containerr r r rEr@r rrrrs    !