a Lcf+@sddlZddlZddlmZddlmZddlmZddlm Z m Z ddl m Z ddl mZmZmZddlmZdd lmZmZdd lmZgZGd d d ZGd ddeZGdddeZGdddeZGdddeZdddZddZej ddddZ!dS)N)apps)settings)utils)ErrorWarning)ImproperlyConfigured)FileSystemStorageStoragedefault_storage) safe_join) LazyObjectempty) import_stringc@s*eZdZdZddZd ddZddZd S) BaseFinderzN A base file finder to be used for custom staticfiles finder classes. cKs tddS)NzUsubclasses may provide a check() method to verify the finder is configured correctly.NotImplementedError)selfkwargsr_/home/httpd/docs/test/DocsMgr/lib/python3.9/site-packages/django/contrib/staticfiles/finders.pycheckszBaseFinder.checkFcCs tddS)z Given a relative file path, find an absolute file path. If the ``all`` parameter is False (default) return only the first found file path; if True, return a list of all found files paths. z5subclasses of BaseFinder must provide a find() methodNr)rpathallrrrfindszBaseFinder.findcCs tddS)z Given an optional list of paths to ignore, return a two item iterable consisting of the relative path and storage instance. z5subclasses of BaseFinder must provide a list() methodNr)rignore_patternsrrrlist(szBaseFinder.listN)F)__name__ __module__ __qualname____doc__rrrrrrrrs rcsFeZdZdZdfdd ZddZddd Zdd d Zd d ZZ S)FileSystemFinderz_ A static files finder that uses the ``STATICFILES_DIRS`` setting to locate files. Ncsg|_i|_tjD]>}t|ttfr.|\}}nd}||f|jvr|j||fq|jD]"\}}t|d}||_ ||j|<qXt j |i|dS)N)location) locationsstoragesrSTATICFILES_DIRS isinstancertupleappendrprefixsuper__init__)r app_namesargsrrootr)Zfilesystem_storage __class__rrr+8s    zFileSystemFinder.__init__cKsg}ttjttfs,|tdddd|StjD]}t|ttfrl|\}}|drl|td|ddtjrt j tjt j |kr|td d dt j |s2|t d |d d dq2|S)Nz4The STATICFILES_DIRS setting is not a tuple or list.z$Perhaps you forgot a trailing comma?zstaticfiles.E001)hintid/zHThe prefix %r in the STATICFILES_DIRS setting must not end with a slash.zstaticfiles.E003)r2zHThe STATICFILES_DIRS setting should not contain the STATIC_ROOT setting.zstaticfiles.E002zThe directory 'z1' in the STATICFILES_DIRS setting does not exist.zstaticfiles.W004)r&rr%rr'r(rendswithZ STATIC_ROOTosrabspathisdirr)rrerrorsr.r)rrrrJsR      zFileSystemFinder.checkFcCsRg}|jD]B\}}|tvr$t|||||}|r |sB|S||q |S)zW Look for files in the extra locations as defined in STATICFILES_DIRS. )r#searched_locationsr( find_location)rrrmatchesr)r. matched_pathrrrrts  zFileSystemFinder.findcCsN|r0d|tjf}||s dS|t|d}t||}tj|rJ|SdS)z Find a requested static file in a location and return the found absolute path (or ``None`` if no match). z%s%sN)r5sep startswithlenr rexists)rr.rr)rrrr:s   zFileSystemFinder.find_locationccsF|jD]:\}}tj|r|j|}t||D]}||fVq0qdS)z2 List all files in all locations. N)r#r5rr7r$r get_files)rrr)r.storagerrrrrs   zFileSystemFinder.list)N)F)N) rrrrr+rrr:r __classcell__rrr/rr 2s *  r csDeZdZdZeZdZd fdd ZddZdd d Z d d Z Z S)AppDirectoriesFinderzu A static files finder that looks in the directory of each app as specified in the source_dir attribute. ZstaticNcsg|_i|_t}r2tfdd|D}|D]P}|tj|j|j}tj |j r6||j|j <|j |jvr6|j |j q6t j|i|dS)Ncsg|]}|jvr|qSr)name).0acr,rr z1AppDirectoriesFinder.__init__..)rr$Zget_app_configsset storage_classr5rjoin source_dirr7r"rEr(r*r+)rr,r-rZ app_configsZ app_configZ app_storager/rHrr+s  zAppDirectoriesFinder.__init__ccs:|jD]*}|dr t||D]}||fVq$q dS)z5 List all files in all app storages. r!N)r$valuesr@rrA)rrrBrrrrrs zAppDirectoriesFinder.listFcCsXg}|jD]H}|j|j}|tvr,t||||}|r |sH|S||q |S)z8 Look for files in the app directories. )rr$r"r9r( find_in_app)rrrr;appZ app_locationmatchrrrrs     zAppDirectoriesFinder.findcCs0|j|}|r,||r,||}|r,|SdS)zL Find a requested static file in an app's static locations. N)r$getr@r)rrQrrBr<rrrrPs   z AppDirectoriesFinder.find_in_app)N)F) rrrrrrLrNr+rrrPrCrrr/rrDs rDcs8eZdZdZdZd fdd Zd ddZdd ZZS) BaseStorageFinderzZ A base static files finder to be used to extended with an own storage class. NcsV|dur||_|jdur&td|jt|jttfs@||_tj|i|dS)NzHThe staticfiles storage finder %r doesn't have a storage class assigned.)rBrr0r&r r r*r+)rrBr-rr/rrr+s  zBaseStorageFinder.__init__FcCshz|jdWnty"YnB0|jjtvr>t|jj|j|rd|j|}|r`|g}|SgS)zL Look for files in the default file storage, if it's local. r!)rBrrr"r9r(r@)rrrrRrrrrs    zBaseStorageFinder.findccs$t|j|D]}||jfVqdS)z0 List all files of the storage. N)rrArB)rrrrrrrszBaseStorageFinder.list)N)F) rrrrrBr+rrrCrrr/rrTs  rTcs$eZdZdZeZfddZZS)DefaultStorageFinderzF A static files finder that uses the default storage backend. cs6tj|i|t|jdt}|s2td|jdS)N base_locationzOThe storage backend of the staticfiles finder %r doesn't have a valid location.)r*r+getattrrBr rr0)rr-rrVr/rrr+szDefaultStorageFinder.__init__)rrrrr rBr+rCrrr/rrUsrUFcCslgtdd<g}tD]@}|j||d}|s8|r8|St|ttfsL|g}||q|r`|S|rhgSdS)z Find a static file with the given path using all enabled finders. If ``all`` is ``False`` (default), return the first matching absolute path (or ``None`` if no match). Otherwise return a list. N)r)r9 get_findersrr&rr'extend)rrr;finderresultrrrr s   rccstjD]}t|VqdS)N)rZSTATICFILES_FINDERS get_finder)Z finder_pathrrrrX6s rX)maxsizecCs(t|}t|ts"td|tf|S)z Import the staticfiles finder class described by import_path, where import_path is the full Python path to the class. z%Finder "%s" is not a subclass of "%s")r issubclassrr)Z import_pathFinderrrrr\;s   r\)F)" functoolsr5Z django.appsrZ django.confrZdjango.contrib.staticfilesrZdjango.core.checksrrZdjango.core.exceptionsrZdjango.core.files.storagerr r Zdjango.utils._osr Zdjango.utils.functionalr r Zdjango.utils.module_loadingrr9rr rDrTrUrrX lru_cacher\rrrrs(       kA0