dfdZddlZddlZddlZddlZddlZddlZddl Z ddl m Z GddejjZy)z8Utilities for using Motor with Tornado web applications.N) _hash_gridoutc8eZdZdZd dZdZd dZdZdZdZ y) GridFSHandlerazA handler that can serve content from GridFS, very similar to :class:`tornado.web.StaticFileHandler`. .. code-block:: python db = motor.MotorClient().my_database application = web.Application( [ (r"/static/(.*)", web.GridFSHandler, {"database": db}), ] ) By default, requests' If-Modified-Since headers are honored, but no specific cache-control timeout is sent to clients. Thus each request for a GridFS file requires a quick check of the file's ``uploadDate`` in MongoDB. Override :meth:`get_cache_time` in a subclass to customize this. c ||_||_y)N)databaseroot_collection)selfrrs B/home/api-vastappli/venv/lib/python3.12/site-packages/motor/web.py initializezGridFSHandler.initialize9s  .c$|j|S)a#Overridable method to choose a GridFS file to serve at a URL. By default, if a URL pattern like ``"/static/(.*)"`` is mapped to this ``GridFSHandler``, then the trailing portion of the URL is used as the filename, so a request for "/static/image.png" results in a call to :meth:`MotorGridFSBucket.open_download_stream_by_name` with "image.png" as the ``filename`` argument. To customize the mapping of path to GridFS file, override ``get_gridfs_file`` and return a Future :class:`~motor.MotorGridOut` from it. For example, to retrieve the file by ``_id`` instead of filename:: class CustomGridFSHandler(motor.web.GridFSHandler): def get_gridfs_file(self, bucket, filename, request): # Path is interpreted as _id instead of name. # Return a Future MotorGridOut. return fs.open_download_stream(file_id=ObjectId(path)) :Parameters: - `bucket`: A :class:`~motor.motor_tornado.MotorGridFSBucket` - `filename`: A string, the matched group of the URL pattern - `request`: An :class:`tornado.httputil.HTTPServerRequest` .. versionchanged:: 1.0 **BREAKING CHANGE**: Now takes a :class:`~motor.motor_tornado.MotorGridFSBucket`, not a ``MotorGridFS``. Also takes an additional ``request`` parameter. .. versionchanged:: 0.2 ``get_gridfs_file`` no longer accepts a callback, instead returns a Future. )open_download_stream_by_name)r bucketfilenamerequests r get_gridfs_filezGridFSHandler.get_gridfs_file=sD228< OO!!%%h&7&7&;&;<DDDDQ$$Z89  OOOZ#j/-I J OOOX 6 tW-LL((,,-@A  ..y9J ((66t{{:7NOWWXH8#$||##''8   38 ; OOC  ('..9 ++D1 1 1 EI}} 7++'',$ 6 7x 2s;+L K%K"K%I9L L L"K%%4LLc(|j|dS)NF)r>)r1)r r=s r headzGridFSHandler.headsxx5x11r cy)zOverride to customize cache control behavior. Return a positive number of seconds to trigger aggressive caching or 0 to mark resource as cacheable, only. 0 is the default. r)r r=rArCs r r(zGridFSHandler.get_cache_times r cy)z1For subclass to add extra headers to the responseNrM)r r=r@s r r/zGridFSHandler.set_extra_headerssr N)r?)T) __name__ __module__ __qualname____doc__r rr1rKr(r/rMr r rr&s)$/"=HFP2@r r)rRr) email.utilsr2r&r6r tornado.webrrmotor.motor_gridfsrr RequestHandlerrrMr r rWs<?  ,P@GKK..P@r