\j2:ZddlZddlmZddlmZmZmZmZmZddl m Z m Z Gdde Z y)N) OrderedDict)DictLiteralOptionalSequenceUnion) BaseProvider ElementsTypec eZdZUdZdZeeed<dZeeed<dZ eeed<dZ eeed <d Z eeed <d Z eeed <dZ eeed<dZeeed<edefdefde fde fde fde fde fdeffZeeeefed<dZeeed<dZeeed<dZeeed <d!Zeeed"<d#Zeeed$<edefdefd%efdefdeffZeeeefed&<d'd(d)d*d*d)d+Zeeefed,<d-Zeeed.<d>d0eed1efd2Zd?d0eed3eed1efd4Zd>d0eed1efd5Z d@d6ed0eed3eeee efd7ee!d8e"d9d1ef d:Z#d>d;eed1efd<Z$d>d;eed1efd=Z%y/)AProviderz*Implement default file provider for Faker.)zapplication/atom+xmlzapplication/ecmascriptzapplication/EDI-X12zapplication/EDIFACTzapplication/jsonzapplication/javascriptzapplication/octet-streamzapplication/oggzapplication/pdfzapplication/postscriptzapplication/rdf+xmlzapplication/rss+xmlzapplication/soap+xmlzapplication/font-woffzapplication/xhtml+xmlzapplication/xml-dtdzapplication/xop+xmlzapplication/zipzapplication/gzipapplication_mime_types) z audio/basicz audio/L24z audio/mp4z audio/mpegz audio/oggz audio/vorbiszaudio/vnd.rn-realaudiozaudio/vnd.wavez audio/webmaudio_mime_types)z image/gifz image/jpegz image/pjpegz image/pngz image/svg+xmlz image/tiffzimage/vnd.microsoft.iconimage_mime_types)z message/httpzmessage/imdn+xmlzmessage/partialzmessage/rfc822message_mime_types)z model/examplez model/igesz model/meshz model/vrmlzmodel/x3d+binaryzmodel/x3d+vrmlz model/x3d+xmlmodel_mime_types)zmultipart/mixedzmultipart/alternativezmultipart/relatedzmultipart/form-datazmultipart/signedzmultipart/encryptedmultipart_mime_types)ztext/cmdztext/cssztext/csvz text/htmlztext/javascriptz text/plainz text/vcardztext/xmltext_mime_types)z video/mpegz video/mp4z video/oggzvideo/quicktimez video/webmzvideo/x-matroskazvideo/x-ms-wmvz video/x-flvvideo_mime_types applicationaudioimagemessagemodel multiparttextvideo mime_types)flacmp3wavaudio_file_extensions)bmpgifjpegjpgpngtiffimage_file_extensions)csscsvhtmljsjsontxttext_file_extensions)mp4avimovwebmvideo_file_extensions) docdocxxlsxlsxpptpptxodtodsodppagesnumberskeypdfoffice_file_extensionsofficefile_extensionszC:\\)root separator/)windowslinuxfile_systems_path_rules)sdvdxvdunix_device_prefixesNcategoryreturnc|r|n1|jt|jj}|j|j|S)asGenerate a mime type under the specified ``category``. If ``category`` is ``None``, a random category will be used. The list of valid categories include ``'application'``, ``'audio'``, ``'image'``, ``'message'``, ``'model'``, ``'multipart'``, ``'text'``, and ``'video'``. :sample: :sample: category='application' )random_elementlistrkeysselfrQs G/root/env/lib/python3.12/site-packages/faker/providers/file/__init__.py mime_typezProvider.mime_typesD (8T-@-@dooFZFZF\A]-^""4??8#<== extensioncr||j|}|jj}|r|d|S|S)aGenerate a random file name with extension. If ``extension`` is ``None``, a random extension will be created under the hood using |file_extension| with the specified ``category``. If a value for ``extension`` is provided, the value will be used instead, and ``category`` will be ignored. The actual name part itself is generated using |word|. If extension is an empty string then no extension will be added, and file_name will be the same as |word|. :sample: size=10 :sample: category='audio' :sample: extension='abcdef' :sample: category='audio', extension='abcdef' :sample: extension='' .)file_extension generatorword)rXrQr\filenames rY file_namezProvider.file_namesD"  ++H5I++-,5(1YK(C8Cr[c|2|jt|jj}|j|j|S)a9Generate a file extension under the specified ``category``. If ``category`` is ``None``, a random category will be used. The list of valid categories include: ``'audio'``, ``'image'``, ``'office'``, ``'text'``, and ``'video'``. :sample: :sample: category='image' )rTrUrErVrWs rYr_zProvider.file_extensionsJ  **40D0D0I0I0K+LMH""4#7#7#ABBr[depthabsolutefile_system_rule)rKrJcb|/t|tst|r|j|}nd}|jj |d}|s t d|d}|d}|j||} td|D]"} |jj|| } $|r|| zS| S)aGenerate an pathname to a file. This method uses |file_name| under the hood to generate the file name itself, and ``depth`` controls the depth of the directory path, and |word| is used under the hood to generate the different directory names. If ``absolute`` is ``True`` (default), the generated path starts with ``/`` and is absolute. Otherwise, the generated path is relative. If used, ``extension`` can be either a string, forcing that extension, a sequence of strings (one will be picked at random), or an empty sequence (the path will have no extension). Default behaviour is the same as |file_name| if ``file_system`` is set (default="linux"), the generated path uses specified file system path standard, the list of valid file systems include: ``'windows'``, ``'linux'``. :sample: size=10 :sample: depth=3 :sample: depth=5, category='video' :sample: depth=5, category='video', extension='abcdef' :sample: extension=[] :sample: extension='' :sample: extension=["a", "bc", "def"] :sample: depth=5, category='video', extension='abcdef', file_system='windows' Nz!Specified file system is invalid.rGrHr) isinstancestrlenrTrLget TypeErrorrcranger`ra) rXrerQr\rfrgfs_rulerG seperatorpath_s rY file_pathzProvider.file_pathsL  Is)C9~ // :  ..223CTJ?@ @vK( NN8Y7q% ?Ann))+,YKv>D ?'td{0D0r[prefixc||j|j}|jtj}d||}|S)zGenerate a Unix device file name. If ``prefix`` is ``None``, a random prefix will be used. The list of valid prefixes include: ``'sd'``, ``'vd'``, and ``'xvd'``. :sample: :sample: prefix='mmcblk' z/dev/)rTrPstringascii_lowercase)rXrusuffixrrs rY unix_devicezProvider.unix_deviceHsJ >(()B)BCF))&*@*@Avhvh' r[cb|j|}|t|jz }|S)zGenerate a Unix partition name. This method uses |unix_device| under the hood to create a device file name with the specified ``prefix``. :sample: :sample: prefix='mmcblk' )ru)rzrk random_digit)rXrurrs rYunix_partitionzProvider.unix_partitionWs4$$F$3 D%%'(( r[)N)NN)NNTrK)&__name__ __module__ __qualname____doc__rr rk__annotations__rrrrrrrrrrr"r)r0r5rCrErLrPrrZrcr_intrrboolrrtrzr}r[rYr r s4&1L-&P +l3'  +l3' - S) +l3' /,s+*O\#& +l3' 0; 2 3 & ' & ' * + & ' . / _ % & '  0JS,s++, 0<, 0<,/,s+0<,1L- 5@ + , + , - . ) * + ,  5OT#|C001  0T#t)_ /B,s+A >(3- >3 >D(3-D8C=D\_D, Cx} C C "&9=#'8? 71713-71E#x}"456 71 4. 71 ""45 71 71r (3- 3  Xc] c r[r ) rw collectionsrtypingrrrrrrir r r rr[rYrs" #;;)Y|Yr[