julee.api.routers.documents
===========================

.. py:module:: julee.api.routers.documents

.. autoapi-nested-parse::

   Documents API router for the julee CEAP system.

   This module provides document management API endpoints for retrieving
   and managing documents in the system.

   Routes defined at root level:
   - GET / - List all documents with pagination
   - GET /{document_id} - Get document metadata by ID
   - GET /{document_id}/content - Get document content by ID

   These routes are mounted with '/documents' prefix in the main app.



Attributes
----------

.. autoapisummary::

   julee.api.routers.documents.logger
   julee.api.routers.documents.router


Functions
---------

.. autoapisummary::

   julee.api.routers.documents.get_document
   julee.api.routers.documents.get_document_content
   julee.api.routers.documents.list_documents


Module Contents
---------------

.. py:function:: get_document(document_id = Path(..., description='Document ID'), repository = Depends(get_document_repository))
   :async:


   Get a single document by ID with metadata only.

   :param document_id: Unique document identifier
   :param repository: Document repository dependency

   :returns: Document with metadata only (no content)

   :raises HTTPException: If document not found or repository operation fails


.. py:function:: get_document_content(document_id = Path(..., description='Document ID'), repository = Depends(get_document_repository))
   :async:


   Get the content of a document by ID.

   :param document_id: Unique document identifier
   :param repository: Document repository dependency

   :returns: Raw document content with appropriate Content-Type header

   :raises HTTPException: If document not found or has no content


.. py:function:: list_documents(repository = Depends(get_document_repository))
   :async:


   List all documents with pagination.

   :param repository: Document repository dependency

   :returns: Paginated list of documents

   :raises HTTPException: If repository operation fails


.. py:data:: logger

.. py:data:: router