\ jxodZddlZddlZddlZddlZddlZddlZGddeZdZ dZ GddZ Gd d e Z Gd d e Z Gd de ZGddZgaGddeZeZejZejZejZejZejZejZejZejZejZejZejZejZejZej Z ej!Z!ej"Z"dS)aLoad application resources from a known path. Loading resources by specifying relative paths to filenames is often problematic in Python, as the working directory is not necessarily the same directory as the application's script files. This module allows applications to specify a search path for resources. Relative paths are taken to be relative to the application's ``__main__`` module. ZIP files can appear on the path; they will be searched inside. The resource module also behaves as expected when applications are bundled using Freezers such as PyInstaller, py2exe, py2app, etc.. In addition to providing file references (with the :py:func:`file` function), the resource module also contains convenience functions for loading images, textures, fonts, media and documents. 3rd party modules or packages not bound to a specific application should construct their own :py:class:`Loader` instance and override the path to use the resources in the module's directory. Path format ^^^^^^^^^^^ The resource path :py:attr:`path` (see also :py:meth:`Loader.__init__` and :py:meth:`Loader.path`) is a list of locations to search for resources. Locations are searched in the order given in the path. If a location is not valid (for example, if the directory does not exist), it is skipped. Locations in the path beginning with an "at" symbol (''@'') specify Python packages. Other locations specify a ZIP archive or directory on the filesystem. Locations that are not absolute are assumed to be relative to the script home. Some examples:: # Search just the `res` directory, assumed to be located alongside the # main script file. path = ['res'] # Search the directory containing the module `levels.level1`, followed # by the `res/images` directory. path = ['@levels.level1', 'res/images'] Paths are always **case-sensitive** and **forward slashes are always used** as path separators, even in cases when the filesystem or platform does not do this. This avoids a common programmer error when porting applications between platforms. The default path is ``['.']``. If you modify the path, you must call :py:func:`reindex`. .. versionadded:: 1.1 NceZdZdZdZdS)ResourceNotFoundExceptionz4The named resource was not found on the search path.cFd|z}t||dS)NzbResource "%s" was not found on the path. Ensure that the filename has the correct captialisation.) Exception__init__)selfnamemessages I/DATA/AppData/hermes/venv/lib/python3.11/site-packages/pyglet/resource.pyrz"ResourceNotFoundException.__init__ds/NQUV4)))))N)__name__ __module__ __qualname____doc__rr r rras)>>*****r rcttdd}ttdd}|r|S|dvr)tjtjS|dkrtjdStjd}t|drAtjtj |j Sd tj tjvrtj StjtjS) a2Get the directory containing the program entry module. For ordinary Python scripts, this is the directory containing the ``__main__`` module. For executables created with py2exe the result is the directory containing the running executable file. For OS X bundles created using Py2App the result is the Resources directory within the running bundle. If none of the above cases apply and the file for ``__main__`` cannot be determined the working directory is returned. When the script is being run by a Python profiler, this function may return the directory where the profiler is running instead of the directory of the real script. To workaround this behaviour the full path to the real script can be specified in :py:attr:`pyglet.resource.path`. :rtype: str frozenN_MEIPASS) windows_exe console_exe macosx_app RESOURCEPATH__main____file__python) getattrsysospathdirname executableenvironmoduleshasattrabspathrbasenamegetcwd)rmeipassmains r get_script_homer*js&S(D ) )Fc:t,,G7 1 1 1ws~... <  z.)){:& 4 $ $ 77??27??4=#A#ABB B27++CN;;;;y{{"ws~666r ctjdvr`dtjvr0tjtjd|Stjd|zStjdkr"tjd|zStjdr`dtjvr0tjtjd|Stjd|zStjd |zS) aGet a directory to save user preferences. Different platforms have different conventions for where to save user preferences, saved games, and settings. This function implements those conventions. Note that the returned path may not exist: applications should use ``os.makedirs`` to construct it if desired. On Linux, a directory `name` in the user's configuration directory is returned (usually under ``~/.config``). On Windows (including under Cygwin) the `name` directory in the user's ``Application Settings`` directory is returned. On Mac OS X the `name` directory under ``~/Library/Application Support`` is returned. :Parameters: `name` : str The name of the application. :rtype: str )cygwinwin32APPDATAz~/%sdarwinz ~/Library/Application Support/%slinuxXDG_CONFIG_HOMEz ~/.config/%sz~/.%s)pygletcompat_platformrr"rjoin expanduser startswith)r s r get_settings_pathr7s0!444  " "7<< 9 5t<< <7%%ftm44 4  8 + +w!!"Dt"KLLL   * *7 3 32  * *7<< +< =tDD D7%%nt&;<< <w!!'D.111r ceZdZdZddZdS)LocationaAbstract resource location. Given a location, a file can be loaded from that location with the `open` method. This provides a convenient way to specify a path to load files from, and not necessarily have that path reside on the filesystem. rbc td)aOpen a file at this location. :Parameters: `filename` : str The filename to open. Absolute paths are not supported. Relative paths are not supported by most locations (you should specify only a filename with no path component). `mode` : str The file mode to open with. Only files opened on the filesystem make use of this parameter; others ignore it. :rtype: file object abstract)NotImplementedErrorrfilenamemodes r openz Location.opens"*---r Nr:)r rrrrArr r r9r9s2......r r9c eZdZdZdZddZdS) FileLocationz Location on the filesystem. c||_dS)zCreate a location given a relative or absolute path. :Parameters: `path` : str Path on the filesystem. Nr)rrs r rzFileLocation.__init__s r r:chttj|j||SN)rArrr4r>s r rAzFileLocation.opens$BGLLH55t<<H,DDD!\\"&#66x}}/00z$r NrBrIrr r rKrKsA         r rKc eZdZdZdZddZdS) URLLocationzLocation on the network. This class uses the ``urlparse`` and ``urllib2`` modules to open files on the network given a URL. c||_dS)zCreate a location given a base URL. :Parameters: `base_url` : str URL string to prepend to filenames. N)base)rbase_urls r rzURLLocation.__init__ s r r:cddl}ddl}|j|j|}|j|S)Nr) urllib.parseurllib.requestparseurljoinr[requesturlopen)rr?r@urlliburls r rAzURLLocation.opensI++++++++l""49h77~%%c***r NrBrIrr r rYrYsA ++++++r rYceZdZdZddZdZdZdZdZdd Z d Z d Z d Z d Z d dZd!dZdZdZdZd"dZdZd#dZdZdZdZdZdS)$LoaderaLoad program resource files from disk. The loader contains a search path which can include filesystem directories, ZIP archives and Python packages. :Ivariables: `path` : list of str List of search locations. After modifying the path you must call the `reindex` method. `script_home` : str Base resource location, defaulting to the location of the application script. Nc>|dg}t|tr|g}t||_|p t |_d|_i|_tj |_ tj |_ tj |_ dS)aCreate a loader for the given path. If no path is specified it defaults to ``['.']``; that is, just the program directory. See the module documentation for details on the path format. :Parameters: `path` : list of str List of locations to search for resources. `script_home` : str Base location of relative files. Defaults to the result of `get_script_home`. N.) isinstancestrlistrr* _script_home_index_texture_atlas_binsweakrefWeakValueDictionary_cached_textures_cached_images_cached_animations)rr script_homes r rzLoader.__init__*s <5D dC  6DJJ 'd |tjD} d | }|D]%} |r |d z| z} n| } || |&d} d} |rtj|stj|d zs|} tj|\}}|| krnZd || f} |rAtj|s"tj|d z|| kr| d } |s||}|rt-j|d }t1|| }|D]I}|| r2| r|t%| dzd}|||JndS) zRefresh the file index. You must call this method if `path` is changed or the filesystem layout changes. @Nrirz\\z/Backslashes are not permitted in relative pathscg|]}||SrHr).0parts r z"Loader.reindex..ss*!6!6!6%)$($4"&%5$4$4r rP.001r)rnrr6 __import__splitrr$rr risabsr4rmisdirrstriprRrDwalklen _index_fileisfile _get_streamzipfileZipFilerKnamelist)rrr module componentlocationdirpathdirnames filenamespartsr? index_namerNold_pathtail_dir zip_streamrMzip_names r rwzLoader.reindexNs  IF AF ADs## =ABBx'--FFH!%C!488I$VY77FF6:..7??6?;;DDDDW]]4(( =D(((*[(((w||D$5t<<w}}T""0 A{{27;//'--46GDMM??0GXy%c$ii!mnn5G2!6!6$+MM"&$9$9!6!6!6#&((5//$-??"2)03)AJJ)1J((X>>>> ??"4BGNN4$8$84BGNN4RX=3}r|) r is_zipfilerrexistsrAbytesrSformatrTrU)rrvolumebytes_ volume_indexrs r rzLoader._get_streams  d # # Kv .. 4dVmT** .fv{{}}-- . . . . . . . . . . . . . . .L'.. (9(9,(G(G!GHH "$!2!2>t-..7 8  v004 HqL H =28|tjtj||j|}t j|| ||S)zLoad a 3D model. :Parameters: `name` : str Filename of the 3D model to load. `batch` : Batch or None An optional Batch instance to add this model to. :rtype: `Model` )r?rbatch) ryrrr4r%rr2modelrr)rr r abspathnames r rz Loader.modelsp gll27??4==3F3F3K#L#LdSS |  +DIIdOOSX YYYr c|||}tj||dS)zLoad an HTML document. :Parameters: `name` : str Filename of the HTML resource to load. :rtype: `FormattedDocument` z text/htmlryrr2rWrrr rs r htmlz Loader.htmls? yy{dK888r c|||}tj||dS)a Load an attributed text document. See `pyglet.text.formats.attributed` for details on this format. :Parameters: `name` : str Filename of the attribute text resource to load. :rtype: `FormattedDocument` ztext/vnd.pyglet-attributedrrs r attributedzLoader.attributeds@ yy{d,HIIIr c|||}tj||dS)zLoad a plain text document. :Parameters: `name` : str Filename of the plain text resource to load. :rtype: `UnformattedDocument` z text/plainrrs r rWz Loader.texts? yy{dL999r cv|t|jS)zQGet the names of textures currently cached. :rtype: list of str )ryrlrrrrxs r get_cached_texture_nameszLoader.get_cached_texture_namess3 D)..00111r )NNrB)FFrTr|)FFrr|)TrH)r rrrrryrwrrrrrrrrrrrrrrrrrrWrrr r rgrgs  @@@@@MAMAMA^,)))2222&222(*$$$"2'>'>'>'>R&>&>&>&>P 0 0 0 4 4 4 7 7 72222<, Z Z Z Z 9 9 9 J J J : : :22222r rgcDeZdZedZejdZdS)_DefaultLoaderctSrHrFrxs r rz_DefaultLoader.paths r c |adSrHrF)rvalues r rz_DefaultLoader.paths r N)r rrpropertyrsetterrr r rrsJ X [[r r)#rrTrrrrpr2rrr*r7r9rDrKrYrgrr_default_loaderrwrrrrrrrrrrrWrrrrrr r rs4H22h  ***** ***'7'7'7T%2%2%2P........2=====8==="     (   <+++++(+++.f2f2f2f2f2f2f2f2b      V   !.""  !  #  #  %   !  ' *C(?,G"3r