obLdZddlmZmZddlZddlZddlmZejr ddlm Z m Z m Z gdZ ejGdd ejeZd Zd Zd Zed fdZy)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_modeceZdZdZdZdZdZdZdZdZ e dfd Z d Z e d Ze d Ze d Ze dZe dZe dZe dZe dZe dZy)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 c2||_|jy)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)selfmodes )/usr/lib/python3/dist-packages/fs/mode.py__init__z Mode.__init__-s  c8dj|jS)Nz Mode({!r}))formatrrs r__repr__z Mode.__repr__;s""4::..rc|jS)N)rrs r__str__z Mode.__str__?s zzrcBt|tsJ||jvS)z+Check if a mode contains a given character.) isinstancerr)r characters r __contains__zMode.__contains__Cs#)T***DJJ&&rcrtjr|jjddS|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)sixPY2rreplacers r to_platformzMode.to_platformIs*03wwtzz!!#s+FDJJFrcX|jjdd}d|vr|S|dzS)zvGet a *binary* mode string for the current platform. This removes the 't' and adds a 'b' if needed. tb)r'r&)rrs rto_platform_binzMode.to_platform_binSs4  "**33u u5%#+5rzrwxtab+c|j}|s td|j|stdj||ddvr tdd|vrd|vr tdy y ) 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_charsrs rrz Mode.validate]syzz56 6&&t,DKKDQR R 7& IJ J $;3$;HI I';rcB|jd|vr tdy)zValidate a mode for opening a binary file. Raises: ValueError: if the mode contains invalid chars. r)zmode must be binaryN)rr1rs r validate_binzMode.validate_binos%  $;23 3 rc"d|vxs d|vxsd|vS)z/`bool`: `True` if the mode would create a file.ar#r"rs rcreatez Mode.create{s d{8cTk8SD[8rcd|vxsd|vS)z+`bool`: `True` if the mode permits reading.r+r8rs rreadingz Mode.readingd{)cTk)rc.d|vxsd|vxs d|vxsd|vS)z+`bool`: `True` if the mode permits writing.r#r7r<r"r8rs rwritingz Mode.writings)d{GcTkGSD[GC4KGrc d|vS)z-`bool`: `True` if the mode permits appending.r7r8rs r appendingzMode.appendingd{rc d|vS)z<`bool`: `True` if the mode permits both reading and writing.r<r8rs rupdatingz Mode.updatingrCrcd|vxsd|vS)z;`bool`: `True` if the mode would truncate an existing file.r#r"r8rs rtruncatez Mode.truncater>rc d|vS)z6`bool`: `True` if the mode require exclusive creation.r"r8rs r exclusivezMode.exclusiverCrc d|vS)z*`bool`: `True` if a mode specifies binary.r+r8rs rbinaryz Mode.binaryrCrcd|vxsd|vS)z(`bool`: `True` if a mode specifies text.r)r+r8rs rtextz Mode.textsd{-co-rN)__name__ __module__ __qualname____doc__rrrr r'r, frozensetrr5propertyr9r=r@rBrErGrIrKrMr8rrr r s& /' G6%.i$8J$ 499 ** HH   **   ..rr c,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 r=rs rr r  :  rc,t|jS)zCheck a mode string allows writing. Arguments: mode (str): A mode string, e.g. ``"wt"`` Returns: bool: `True` if the mode allows writing. )r r@rUs rr r rVrct|y)zCheck ``mode`` parameter of `~fs.base.FS.open` is valid. Arguments: mode (str): Mode parameter. Raises: `ValueError` if mode is not valid. N)r rUs rvalidate_open_moderYs  Jrzrwxab+cd|vr td|s td|ddvr td|j|stdj|y) 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.rr0z)mode must start with 'r', 'w', 'a' or 'x'r/N)r1r2r)rr3s rr r sh d{9:: 122 AwfDEE  " "4 (@GGMNN )r)rQ __future__rrtypingr$_typingr TYPE_CHECKINGrrr __all__python_2_unicode_compatible Containerr r r rYrRr r8rrrbs~8  ,, P  V.6  D !V.!V.r   .7x-@Or