-hRddlmZddlZddlmZddlmZddlmZm Z erddl m Z m Z ddl mZdd ZeddZdddZdS)) annotationsN)contextmanager) import_module) TYPE_CHECKINGAny)IteratorSequence)Patherror BaseExceptionobjpathstrreturncFdtjd|d|jjd|S)NzWith sys.path = z , accessing z raises z: )syspath __class____name__)r r s M/var/www/FlaskApp/flask-venv/lib/python3.11/site-packages/_griffe/importer.py_error_detailsrs0 lch l lg l lIa l lej l llpaths str | PathIterator[None]c'K|sdVdStj}d|Dt_ dV|t_dS#|t_wxYw)zRedefine `sys.path` temporarily. Parameters: *paths: The paths to use when importing modules. If no paths are given, keep `sys.path` untouched. Yields: Nothing. Nc,g|]}t|S)r).0rs r zsys_path..$s,,,dD ,,,r)rr)rold_paths rsys_pathr!sf  xH,,e,,,CH 8s AA import_path import_pathsSequence[str | Path] | Nonerc |d}g}g}t|pd5|rd|} t|}n#t$rV}|t |||d|dYd}~nd}~wwxYw|td||}|D]} t|| }#t$rc}|t ||dzd|ztd|d}~wwxYw dddn #1swxYwY|S)aDynamically import the specified object. It can be a module, class, method, function, attribute, nested arbitrarily. It works like this: - for a given object path `a.b.x.y` - it tries to import `a.b.x.y` as a module (with `importlib.import_module`) - if it fails, it tries again with `a.b.x`, storing `y` - then `a.b`, storing `x.y` - then `a`, storing `b.x.y` - if nothing worked, it raises an error - if one of the iteration worked, it moves on, and... - it tries to get the remaining (stored) parts with `getattr` - for example it gets `b` from `a`, then `x` from `b`, etc. - if a single attribute access fails, it raises an error - if everything worked, it returns the last obtained attribute Since the function potentially tries multiple things before succeeding, all errors happening along the way are recorded, and re-emitted with an `ImportError` when it fails, to let users know what was tried. IMPORTANT: The paths given through the `import_paths` parameter are used to temporarily patch `sys.path`: this function is therefore not thread-safe. IMPORTANT: The paths given as `import_paths` must be *correct*. The contents of `sys.path` must be consistent to what a user of the imported code would expect. Given a set of paths, if the import fails for a user, it will fail here too, with potentially unintuitive errors. If we wanted to make this function more robust, we could add a loop to "roll the window" of given paths, shifting them to the left (for example: `("/a/a", "/a/b", "/a/c/")`, then `("/a/b", "/a/c", "/a/a/")`, then `("/a/c", "/a/a", "/a/b/")`), to make sure each entry is given highest priority at least once, maintaining relative order, but we deem this unnecessary for now. Parameters: import_path: The path of the object to import. import_paths: The (sys) paths to import the object from. Raises: ModuleNotFoundError: When the object's module could not be found. ImportError: When there was an import error or when couldn't get the attribute. Returns: The imported object. .rrNz; :) splitr!joinrr appendrinsertpop ImportErrorgetattr) r"r# module_parts object_partserrors module_pathmoduler valueparts rdynamic_importr7+s^*//44L L F L&B (55 1((<00K &{33 ! = = = nUK@@AAA##A|'7'7';';<<<<<<<<  =  1dii//00 0  5 5D 5t,,  5 5 5 nUK#4EQ]H^H^4^__```!$))F"3"3444 5 5-555555555555555: Ls`E*A E* B.A B)$E*)B..-E*C-,E*- E7AEEE**E.1E.)r r r rrr)rrrr)N)r"rr#r$rr) __future__rr contextlibr importlibrtypingrrcollections.abcrr pathlibr rr!r7rrrr>s #""""" %%%%%%######%%%%%%%%22222222mmmm*PPPPPPPr