sda.documents.resolver
======================

.. py:module:: sda.documents.resolver

.. autoapi-nested-parse::

   Unified document resolver: local filesystem first, MS Graph API fallback.



Attributes
----------

.. autoapisummary::

   sda.documents.resolver.GraphClient


Functions
---------

.. autoapisummary::

   sda.documents.resolver.get_document


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

.. py:data:: GraphClient

.. py:function:: get_document(path_or_relative, download_dir = None)

   Resolve a document path, downloading from SharePoint if not found locally.

   :param path_or_relative: Absolute local path or relative SharePoint path (e.g. 'Reports/T297.docx').
   :type path_or_relative: :py:class:`str`
   :param download_dir: Where to save downloaded files. Defaults to ~/.sda/downloads/.
   :type download_dir: :py:class:`Path`, *optional*

   :returns: Local filesystem path to the document.
   :rtype: :py:class:`Path`