sharepoint-v1-api 0.2.2__tar.gz → 0.2.4__tar.gz

sharepoint_v1_api-0.2.4/CHANGELOG.md

@@ -0,0 +1,53 @@
+## 0.2.4 – 2025-12-03
+
+### Added
+
+- New high‑level `SharePointSite` object providing lazy‑loaded site metadata
+
+## 0.2.3 – 2025-12-02
+
+### Added
+
+- GUID validation for list identifiers with fallback to list title lookup via `GetByTitle`.
+- New helper method `_is_valid_guid` in `SharePointAPI`.
+- Centralized list resolution helper `_resolve_sp_list` for GUID, title, or `SharePointList` instances.
+- New method `get_list_metadata` to fetch only list metadata without items.
+- Type hint enhancements: added `Optional`, `Tuple` imports; updated method signatures (e.g., `get_item_versions` now uses `Optional[List[str]]`).
+- Updated `get_list` to return the resolved `SharePointList` object after appending items.
+- Refactored multiple methods (`get_item`, `create_item`, `update_item`, `attach_file`, `get_item_versions`, `get_case`) to use `_resolve_sp_list`, removing redundant GUID validation logic.
+
+### Changed
+
+- Cleaned up stray `else:` blocks and syntax errors.
+- Improved consistency of return objects across list-related methods.
+- Updated imports and docstrings accordingly.
+
+## 0.2.2 – 2025-11-28
+
+### Added
+
+- `SharePointList.fields` property to retrieve list field definitions
+
+## 0.2.1 – 2025-11-06
+
+### Added
+
+- Optional `select_fields` parameters to list retrieval methods for more efficient queries.
+- New public API methods:
+  - `SharePointAPI.get_group_users` – fetch users of a SharePoint group.
+- Improved error handling with explicit `TypeError` exceptions.
+- Detailed docstrings for core classes and methods (enhances IDE support).
+
+### Changed
+
+- HTTP header handling unified; corrected `X-HTTP-Method: PUT` for full updates.
+- Error handling improved: generic `sys.exit(1)` replaced with explicit `TypeError`/`ConnectionError` exceptions.
+
+### Fixed
+
+- Fixed incorrect PUT header that previously sent a MERGE header.
+- Minor docstring formatting issues.
+
+### Security
+
+- Enforced NTLM authentication across all request helpers.

{sharepoint_v1_api-0.2.2/sharepoint_v1_api.egg-info → sharepoint_v1_api-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sharepoint_v1_api
-Version: 0.2.2
+Version: 0.2.4
 Author: Aske Bluhme Klok
 License: MIT
 Keywords: Sharepoint
@@ -156,13 +156,37 @@ for v in versions:
 ```
 
 
+## 0.2.4 – 2025-12-03
+
+### Added
+
+- New high‑level `SharePointSite` object providing lazy‑loaded site metadata
+
+## 0.2.3 – 2025-12-02
+
+### Added
+
+- GUID validation for list identifiers with fallback to list title lookup via `GetByTitle`.
+- New helper method `_is_valid_guid` in `SharePointAPI`.
+- Centralized list resolution helper `_resolve_sp_list` for GUID, title, or `SharePointList` instances.
+- New method `get_list_metadata` to fetch only list metadata without items.
+- Type hint enhancements: added `Optional`, `Tuple` imports; updated method signatures (e.g., `get_item_versions` now uses `Optional[List[str]]`).
+- Updated `get_list` to return the resolved `SharePointList` object after appending items.
+- Refactored multiple methods (`get_item`, `create_item`, `update_item`, `attach_file`, `get_item_versions`, `get_case`) to use `_resolve_sp_list`, removing redundant GUID validation logic.
+
+### Changed
+
+- Cleaned up stray `else:` blocks and syntax errors.
+- Improved consistency of return objects across list-related methods.
+- Updated imports and docstrings accordingly.
+
 ## 0.2.2 – 2025-11-28
 
 ### Added
 
 - `SharePointList.fields` property to retrieve list field definitions
 
-## 0.2.1 – 2025‑11‑06
+## 0.2.1 – 2025-11-06
 
 ### Added
 
@@ -174,7 +198,7 @@ for v in versions:
 
 ### Changed
 
-- HTTP header handling unified; corrected `X‑HTTP‑Method: PUT` for full updates.
+- HTTP header handling unified; corrected `X-HTTP-Method: PUT` for full updates.
 - Error handling improved: generic `sys.exit(1)` replaced with explicit `TypeError`/`ConnectionError` exceptions.
 
 ### Fixed

{sharepoint_v1_api-0.2.2 → sharepoint_v1_api-0.2.4}/setup.py

@@ -1,6 +1,6 @@
 from setuptools import setup
 
-__version__ = "0.2.2"
+__version__ = "0.2.4"
 
 with open("README.md", "r") as readme_file, open("CHANGELOG.md", "r") as changelog_file:
     long_description = f"{readme_file.read()}\n\n{changelog_file.read()}"

{sharepoint_v1_api-0.2.2 → sharepoint_v1_api-0.2.4}/sharepoint_api/SharePointAPI.py

@@ -1,23 +1,24 @@
-import sys
 import os
-import getpass
 import json
+from datetime import timezone
 import requests
 from requests_ntlm import HttpNtlmAuth
-from typing import List
+from typing import List, Optional, Tuple
+import re
 
 from .SharePointUser import SharePointUser
 from .SharePointUserList import SharePointUserList
 from .SharePointListItem import SharePointListItem, SharepointSiteCase
 from .SharePointList import SharePointList, CasesList, TimeRegistrationList
 from .SharePointLists import SharePointLists
+from .SharePointSite import SharePointSite
 
 
 class SharePointAPI:
-    """High‑level client for interacting with SharePoint sites.
+    """High-level client for interacting with SharePoint sites.
 
     Provides methods for authentication, list management, file operations,
-    and time‑registration handling. All public interactions should be performed
+    and time-registration handling. All public interactions should be performed
     through an instance created via :meth:`_compact_init`.
     """
 
@@ -35,7 +36,7 @@ class SharePointAPI:
         Returns
         -------
         SharePointAPI
-            A fully‑initialised ``SharePointAPI`` object ready for use.
+            A fully-initialised ``SharePointAPI`` object ready for use.
 
         Notes
         -----
@@ -68,6 +69,43 @@ class SharePointAPI:
         self.password = password
         self.sharepoint_url = sharepoint_url
         self.proxies = proxies
+        self.timezone = timezone.utc
+
+    def _is_valid_guid(self, guid: str) -> bool:
+        """Validate that a string is a proper GUID."""
+        pattern = r'^[0-9a-fA-F]{8}(-[0-9a-fA-F]{4}){3}-[0-9a-fA-F]{12}$'
+        return bool(re.fullmatch(pattern, guid))
+
+    def _resolve_sp_list(self, sharepoint_site: str, sp_list, SPListType: SharePointList = SharePointList) -> Tuple[str, Optional[SharePointList]]:
+        """
+        Resolve ``sp_list`` (GUID, title or ``SharePointList`` instance) to a GUID
+        and, when possible, a ``SharePointList`` object.
+
+        Returns
+        -------
+        tuple
+            (guid: str, list_obj: SharePointList | None)
+        """
+        # Case 1: already a SharePointList instance
+        if isinstance(sp_list, SharePointList):
+            return sp_list.guid, sp_list
+
+        # Case 2: string – could be GUID or title
+        if isinstance(sp_list, str):
+            if self._is_valid_guid(sp_list):
+                guid = sp_list
+                # Fetch minimal list metadata to build a SharePointList object
+                r = self._api_get_call(
+                    f'{self.sharepoint_url}/cases/{sharepoint_site}/_api/Web/Lists(guid\'{guid}\')')
+                list_obj = SPListType(self, sharepoint_site, r.json()["d"])
+                return guid, list_obj
+            # Assume title – resolve via GetByTitle
+            list_obj = self.get_list_by_name(
+                sharepoint_site, sp_list, SPListType=SPListType)
+            return list_obj.guid, list_obj
+
+        raise TypeError(
+            'Invalid sp_list argument; expected SharePointList or str')
 
     def _handle_response(self, response: requests.Response, success_codes: List[int]) -> requests.Response:
         """
@@ -140,7 +178,7 @@ class SharePointAPI:
         Perform a POST request against the SharePoint REST API.
 
         Enhanced error handling:
-        * Network‑level errors (timeouts, DNS failures, etc.) are caught and re‑raised as
+        * Network-level errors (timeouts, DNS failures, etc.) are caught and re-raised as
           ``ConnectionError`` with a helpful message.
         * HTTP error codes are reported with status, URL and response body when available.
         * The method always returns a ``requests.Response`` on success (status 200, 201 or 204).
@@ -150,7 +188,7 @@ class SharePointAPI:
         url : str
             The full endpoint URL.
         post_data : dict
-            JSON‑serialisable payload to send.
+            JSON-serialisable payload to send.
         form_digest_value : str | None, optional
             FormDigest required for POST/PUT/MERGE operations.
         merge : bool, optional
@@ -201,7 +239,7 @@ class SharePointAPI:
         Perform a PUT request against the SharePoint REST API.
 
         Enhanced error handling:
-        * Network‑level errors (timeouts, DNS failures, etc.) are caught and re‑raised as
+        * Network-level errors (timeouts, DNS failures, etc.) are caught and re-raised as
           ``ConnectionError`` with a helpful message.
         * HTTP error codes are reported with status, URL and response body when available.
         * The method always returns a ``requests.Response`` on success (status 200, 201 or 204).
@@ -211,7 +249,7 @@ class SharePointAPI:
         url : str
             The full endpoint URL.
         put_data : dict
-            JSON‑serialisable payload to send.
+            JSON-serialisable payload to send.
         form_digest_value : str | None, optional
             FormDigest required for POST/PUT/MERGE operations.
         merge : bool, optional
@@ -258,10 +296,10 @@ class SharePointAPI:
     def _api_attachment_call(self, url: str, post_data: bytes | None = None, form_digest_value: str | None = None,
                              overwrite: bool = False, x_http_method: str | None = None) -> requests.Response:
         """
-        Perform an attachment‑related request (POST, PUT, DELETE) against the SharePoint REST API.
+        Perform an attachment-related request (POST, PUT, DELETE) against the SharePoint REST API.
 
         Enhanced error handling:
-        * Network‑level errors (timeouts, DNS failures, etc.) are caught and re‑raised as
+        * Network-level errors (timeouts, DNS failures, etc.) are caught and re-raised as
           ``ConnectionError`` with a helpful message.
         * HTTP error codes are reported with status, URL and response body when available.
         * The method always returns a ``requests.Response`` on success (status 200 or 204).
@@ -286,7 +324,7 @@ class SharePointAPI:
             'X-RequestDigest': f'{form_digest_value}'
         }
 
-        # Determine effective X‑HTTP‑Method
+        # Determine effective X-HTTP-Method
         if overwrite:
             headers['X-HTTP-Method'] = "PUT"
         if x_http_method:
@@ -300,7 +338,7 @@ class SharePointAPI:
                 raise ConnectionError(
                     f'Unsupported X-HTTP-Method: {x_http_method}')
 
-        # Add Content‑Length when payload present
+        # Add Content-Length when payload present
         if post_data is not None:
             headers['Content-Length'] = str(len(post_data))
 
@@ -328,7 +366,7 @@ class SharePointAPI:
         Perform a GET request against the SharePoint REST API.
 
         Enhanced error handling:
-        * Network‑level errors (timeouts, DNS failures, etc.) are caught and re‑raised as
+        * Network-level errors (timeouts, DNS failures, etc.) are caught and re-raised as
           ``ConnectionError`` with a helpful message.
         * HTTP error codes are reported with status, URL and response body when available.
         * The method always returns a ``requests.Response`` on success (status 200).
@@ -425,7 +463,7 @@ class SharePointAPI:
         Returns
         -------
         SharePointUserList
-            A list‑like container with :class:`SharePointUser` objects for each member.
+            A list-like container with :class:`SharePointUser` objects for each member.
         """
         # Build the request URL for the group's users.
         # SharePoint REST endpoint: /_api/web/sitegroups/GetByName('<group_name>')/users
@@ -466,7 +504,7 @@ class SharePointAPI:
             for user_settings in r.json()["d"]["results"]
         ]
 
-        # Return a ``SharePointUserList`` (consistent with other user‑retrieval methods).
+        # Return a ``SharePointUserList`` (consistent with other user-retrieval methods).
         return SharePointUserList(sharepoint_site, users)
 
     def get_user(self, sharepoint_site, user_id, select_fields=None):
@@ -517,6 +555,40 @@ class SharePointAPI:
 
         return SharePointLists(_lists)
 
+    def get_site_metadata(self, sharepoint_site: str) -> dict:
+        """
+        Retrieve metadata of a SharePoint site.
+
+        Parameters
+        ----------
+        sharepoint_site : str
+            Identifier of the SharePoint site (e.g., 'mySite').
+
+        Returns
+        -------
+        dict
+            Dictionary containing the site's metadata as returned by the SharePoint REST API.
+        """
+        r = self._api_get_call(
+            f'{self.sharepoint_url}/cases/{sharepoint_site}/_api/Web')
+        return r.json()["d"]
+
+    def get_site(self, sharepoint_site: str) -> SharePointSite:
+        """
+        Return a :class:`SharePointSite` object representing the given site.
+
+        Parameters
+        ----------
+        sharepoint_site : str
+            Identifier of the SharePoint site (e.g., ``'mySite'``).
+
+        Returns
+        -------
+        SharePointSite
+            A high-level wrapper around site-wide operations.
+        """
+        return SharePointSite(self, sharepoint_site)
+
     def get_list(self, sharepoint_site, sp_list, filters=None, top=1000, view_path=None, select_fields=None, SPListType: SharePointList = SharePointList) -> SharePointList:
         '''
             Returns a list from a given sharepoint_site using its guid
@@ -530,21 +602,9 @@ class SharePointAPI:
             returned for each list item via the ``$select`` OData query option.
         '''
 
-        # Uses either guid or SharePointList
-        if isinstance(sp_list, SharePointList):
-            guid = sp_list.guid
-            r = self._api_get_call(
-                f'{self.sharepoint_url}/cases/{sharepoint_site}/_api/Web/Lists(guid\'{guid}\')')
-            sp_list = SPListType(self, sharepoint_site, r.json()["d"])
-
-        elif isinstance(sp_list, str):
-            guid = sp_list
-            r = self._api_get_call(
-                f'{self.sharepoint_url}/cases/{sharepoint_site}/_api/Web/Lists(guid\'{guid}\')')
-            sp_list = SPListType(self, sharepoint_site, r.json()["d"])
-        else:
-            raise TypeError(
-                'Invalid sp_list argument; expected SharePointList or str')
+        # Resolve sp_list to GUID and (optionally) a SharePointList object
+        guid, sp_list_obj = self._resolve_sp_list(
+            sharepoint_site, sp_list, SPListType=SPListType)
 
         arguments = []
 
@@ -578,8 +638,8 @@ class SharePointAPI:
 
         items = [SPListType.SPItem(self, sharepoint_site, guid, item_settings)
                  for item_settings in r.json()["d"]["results"]]
-        sp_list.append_items(items)
-        return sp_list
+        sp_list_obj.append_items(items)
+        return sp_list_obj
 
     def get_list_by_name(self, sharepoint_site, sp_list_name: str, filters=None, top=1000, view_path=None, select_fields=None, SPListType: SharePointList = SharePointList) -> SharePointList:
         '''
@@ -668,6 +728,21 @@ class SharePointAPI:
 
     # SP Item
 
+    def get_list_metadata(self, sharepoint_site, sp_list, SPListType: SharePointList = SharePointList) -> SharePointList:
+        """
+        Retrieve only the metadata of a SharePoint list without fetching its items.
+        Useful when only list properties (e.g., title, guid) are needed.
+        """
+        guid, list_obj = self._resolve_sp_list(
+            sharepoint_site, sp_list, SPListType=SPListType)
+        # If the list object was already resolved (e.g., via title lookup), reuse it.
+        if list_obj is not None:
+            return list_obj
+        # Otherwise, fetch minimal metadata using the GUID.
+        r = self._api_get_call(
+            f'{self.sharepoint_url}/cases/{sharepoint_site}/_api/Web/Lists(guid\'{guid}\')')
+        return SPListType(self, sharepoint_site, r.json()["d"])
+
     def get_item(self, sharepoint_site, sp_list, item_id, select_fields=None) -> SharePointListItem:
         '''
             Returns a single list item from a given sharepoint_site.
@@ -675,14 +750,8 @@ class SharePointAPI:
             returned via the ``$select`` OData query option.
         '''
 
-        if isinstance(sp_list, SharePointList):
-            guid = sp_list.guid
-
-        elif isinstance(sp_list, str):
-            guid = sp_list
-        else:
-            raise TypeError(
-                'Invalid sp_list argument; expected SharePointList or str')
+        # Resolve sp_list to GUID (and list object if needed)
+        guid, _ = self._resolve_sp_list(sharepoint_site, sp_list)
 
         # Build the request URL, adding $select if needed.
         if select_fields is not None:
@@ -701,14 +770,8 @@ class SharePointAPI:
 
     def create_item(self, sharepoint_site, sp_list, data) -> SharePointListItem:
         # Uses either guid or SharePointList
-        if isinstance(sp_list, SharePointList):
-            guid = sp_list.guid
-        elif isinstance(sp_list, str):
-            guid = sp_list
-            r = self._api_get_call(
-                f'{self.sharepoint_url}/cases/{sharepoint_site}/_api/Web/Lists(guid\'{guid}\')')
-            sp_list = SharePointList(self,
-                                     sharepoint_site, r.json()["d"]["results"][0])
+        # Resolve sp_list to GUID (and list object if needed)
+        guid, _ = self._resolve_sp_list(sharepoint_site, sp_list)
 
         r = self._api_post_call(
             f'{self.sharepoint_url}/cases/{sharepoint_site}/_api/contextinfo', {})
@@ -731,13 +794,8 @@ class SharePointAPI:
             item_id: The id of the item
             data: Data to push to the item
         '''
-        if isinstance(sp_list, SharePointList):
-            guid = sp_list.guid
-        elif isinstance(sp_list, str):
-            guid = sp_list
-        else:
-            raise TypeError(
-                'Only "SharePointList" and "str" types are allowed')
+        # Resolve sp_list to GUID (and list object if needed)
+        guid, _ = self._resolve_sp_list(sharepoint_site, sp_list)
 
         r = self._api_post_call(
             f'{self.sharepoint_url}/cases/{sharepoint_site}/_api/contextinfo', {})
@@ -752,13 +810,8 @@ class SharePointAPI:
 
     def attach_file(self, sharepoint_site, sp_list, item, file_name, file_content) -> dict:
         # Uses either guid or SharePointList
-        if isinstance(sp_list, SharePointList):
-            guid = sp_list.guid
-        elif isinstance(sp_list, str):
-            guid = sp_list
-        else:
-            raise TypeError(
-                'Only "SharePointList" and "str" types are allowed')
+        # Resolve sp_list to GUID (and list object if needed)
+        guid, _ = self._resolve_sp_list(sharepoint_site, sp_list)
 
         r = self._api_post_call(
             f'{self.sharepoint_url}/cases/{sharepoint_site}/_api/contextinfo', {})
@@ -766,23 +819,17 @@ class SharePointAPI:
         )["d"]["GetContextWebInformation"]["FormDigestValue"]
 
         r = self._api_attachment_call(
-            f"{self.sharepoint_url}/cases/{sharepoint_site}/_api/Web/Lists(guid\'{guid}\')/items({item.Id})/AttachmentFiles/ add(FileName='{file_name}')", file_content, form_digest_value)
+            f"{self.sharepoint_url}/cases/{sharepoint_site}/_api/Web/Lists(guid\'{guid}\')/items({item.Id})/AttachmentFiles/add(FileName='{file_name}')", file_content, form_digest_value)
 
         return r.json()
 
-    def get_item_versions(self, sharepoint_site, sp_list, item_id, select_fields=[]) -> list:
+    def get_item_versions(self, sharepoint_site, sp_list, item_id, select_fields: Optional[List[str]] = None) -> list:
         '''
             Returns a list of users from a given sharepoint_site
         '''
 
-        if isinstance(sp_list, SharePointList):
-            guid = sp_list.guid
-
-        elif isinstance(sp_list, str):
-            guid = sp_list
-        else:
-            raise TypeError(
-                'Invalid sp_list argument; expected SharePointList or str')
+        # Resolve sp_list to GUID (and list object if needed)
+        guid, _ = self._resolve_sp_list(sharepoint_site, sp_list)
 
         if select_fields:
             r = self._api_get_call(
@@ -836,14 +883,8 @@ class SharePointAPI:
             Returns a list of users from a given sharepoint_site
         '''
 
-        if isinstance(sp_list, SharePointList):
-            guid = sp_list.guid
-
-        elif isinstance(sp_list, str):
-            guid = sp_list
-        else:
-            raise TypeError(
-                'Invalid sp_list argument; expected SharePointList or str')
+        # Resolve sp_list to GUID (and list object if needed)
+        guid, _ = self._resolve_sp_list(sharepoint_site, sp_list)
 
         r = self._api_get_call(
             f'{self.sharepoint_url}/cases/{sharepoint_site}/_api/Web/Lists(guid\'{guid}\')/items({item_id})')

{sharepoint_v1_api-0.2.2 → sharepoint_v1_api-0.2.4}/sharepoint_api/SharePointList.py

@@ -12,7 +12,7 @@ class SharePointList:
     Provides common functionality for handling list items, including
     retrieval, addition, and serialization to JSON. Subclasses such as
     :class:`CasesList` and :class:`TimeRegistrationList` extend this
-    class with domain‑specific behavior.
+    class with domain-specific behavior.
     """
 
     settings = None
@@ -194,7 +194,7 @@ class CasesList(SharePointList):
 
 class TimeRegistrationList(SharePointList):
     """
-    Specialized list for time‑registration entries.
+    Specialized list for time-registration entries.
 
     Inherits from :class:`SharePointList` and sets ``SPItem`` to the
     :class:`TimeRegistration` class.

{sharepoint_v1_api-0.2.2 → sharepoint_v1_api-0.2.4}/sharepoint_api/SharePointListItem.py

@@ -1,14 +1,15 @@
 from datetime import datetime
 # from .SharePointAPI import SharePointAPI as SP
 
+
 class SharePointListItem:
     """
     Represents a generic item in a SharePoint list.
 
     Provides access to common fields such as ``Id``, ``Title``, ``Created`` and
     ``Modified`` and handles lazy loading of related list data and version
-    history. Sub‑classes (e.g. :class:`SharepointSiteCase` or
-    :class:`TimeRegistration`) extend this base with domain‑specific properties.
+    history. Sub-classes (e.g. :class:`SharepointSiteCase` or
+    :class:`TimeRegistration`) extend this base with domain-specific properties.
     """
     ''' 
     '''
@@ -34,12 +35,12 @@ class SharePointListItem:
     @property
     def versions(self) -> list:
         if not self._versions:
-            self._versions = self.sp.get_item_versions(self.sharepoint_site, self.list_guid, self.Id) 
+            self._versions = self.sp.get_item_versions(
+                self.sharepoint_site, self.list_guid, self.Id)
             if self._list is not None:
                 self._list.CHANGE_DETECTED = True
-        return self._versions    
-    
-    
+        return self._versions
+
     @property
     def Id(self) -> str:
         """Unique identifier of the list item."""
@@ -62,7 +63,7 @@ class SharePointListItem:
         elif self.settings['Created'] is None:
             return None
         else:
-            return datetime.strptime(self.settings['Created'], '%Y-%m-%dT%H:%M:%SZ')
+            return datetime.strptime(self.settings['Created'], '%Y-%m-%dT%H:%M:%SZ').replace(tzinfo=self.sp.timezone)
 
     @property
     def Modified(self) -> datetime:
@@ -76,39 +77,41 @@ class SharePointListItem:
         elif self.settings['Modified'] is None:
             return None
         else:
-            return datetime.strptime(self.settings['Modified'], '%Y-%m-%dT%H:%M:%SZ')
+            return datetime.strptime(self.settings['Modified'], '%Y-%m-%dT%H:%M:%SZ').replace(tzinfo=self.sp.timezone)
 
     def attach_item(self, file_name, file_path):
         """
         Attach a file to this list item.
-    
+
         Parameters
         ----------
         file_name : str
             The name of the file as it should appear in SharePoint.
         file_path : str
             Local path to the file to be uploaded.
-    
+
         The method reads the file content and uses :meth:`SharePointAPI.attach_file`
         to upload it to the corresponding SharePoint list item.
         """
         with open(file_path, 'r') as f:
             file_content = f.read()
 
-    
-        self.sp.attach_file(self.sharepoint_site, self.list, self, file_name, file_content)
+        self.sp.attach_file(self.sharepoint_site, self.list,
+                            self, file_name, file_content)
 
     def versions_select_fields(self, select_fields=[]) -> list:
         if not self._versions:
-            self._versions = self.sp.get_item_versions(self.sharepoint_site, self.list_guid, self.Id, select_fields) 
+            self._versions = self.sp.get_item_versions(
+                self.sharepoint_site, self.list_guid, self.Id, select_fields)
         return self._versions
 
     def update_fields(self, data):
         self.sp.update_item(self.sharepoint_site,
                             self.list_guid, self.Id, data)
 
+
 class SharepointSiteCase(SharePointListItem):
-    
+
     @property
     def AssignmentType(self) -> str:
         return self.settings['AssignmentType']
@@ -121,7 +124,7 @@ class SharepointSiteCase(SharePointListItem):
         elif self.settings['CaseClosed'] is None:
             return None
         else:
-            return datetime.strptime(self.settings['CaseClosed'], '%Y-%m-%dT%H:%M:%SZ')
+            return datetime.strptime(self.settings['CaseClosed'], '%Y-%m-%dT%H:%M:%SZ').replace(tzinfo=self.sp.timezone)
 
     @property
     def Due(self) -> datetime:
@@ -131,7 +134,7 @@ class SharepointSiteCase(SharePointListItem):
         elif self.settings['DueDate'] is None:
             return None
         else:
-            return datetime.strptime(self.settings['DueDate'], '%Y-%m-%dT%H:%M:%SZ')
+            return datetime.strptime(self.settings['DueDate'], '%Y-%m-%dT%H:%M:%SZ').replace(tzinfo=self.sp.timezone)
 
     @property
     def Priority(self) -> str:
@@ -156,7 +159,7 @@ class SharepointSiteCase(SharePointListItem):
                 solved_in_time = True
         else:
             solved_in_time = True
-        
+
         return solved_in_time
 
     @property
@@ -167,7 +170,7 @@ class SharepointSiteCase(SharePointListItem):
         elif self.settings['WorkBegun'] is None:
             return None
         else:
-            return datetime.strptime(self.settings['WorkBegun'], '%Y-%m-%dT%H:%M:%SZ')
+            return datetime.strptime(self.settings['WorkBegun'], '%Y-%m-%dT%H:%M:%SZ').replace(tzinfo=self.sp.timezone)
 
     @property
     def DeadlineWorkTimestamp(self) -> datetime:
@@ -177,7 +180,7 @@ class SharepointSiteCase(SharePointListItem):
         elif self.settings['DeadlineWork'] is None:
             return None
         else:
-            return datetime.strptime(self.settings['DeadlineWork'], '%Y-%m-%dT%H:%M:%SZ')
+            return datetime.strptime(self.settings['DeadlineWork'], '%Y-%m-%dT%H:%M:%SZ').replace(tzinfo=self.sp.timezone)
 
     @property
     def ReactedInTime(self) -> bool:
@@ -191,6 +194,3 @@ class SharepointSiteCase(SharePointListItem):
         else:
             reacted_in_time = True
         return reacted_in_time
-
-    
-        

sharepoint_v1_api-0.2.4/sharepoint_api/SharePointSite.py

@@ -0,0 +1,188 @@
+"""
+Provides a high-level ``SharePointSite`` object that encapsulates site-wide
+metadata and offers convenience wrappers around common ``SharePointAPI``
+operations such as retrieving lists, users, and groups.
+"""
+
+from __future__ import annotations
+from datetime import datetime
+
+from typing import List, Optional
+import locale
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    # Imported only for type checking to avoid circular imports at runtime
+    from .SharePointAPI import SharePointAPI
+from .SharePointList import SharePointList
+from .SharePointLists import SharePointLists
+from .SharePointUser import SharePointUser
+from .SharePointUserList import SharePointUserList
+
+
+class SharePointSite:
+    """
+    High-level representation of a SharePoint site.
+
+    Parameters
+    ----------
+    api : SharePointAPI
+        The low-level client used for HTTP calls.
+    site_id : str
+        Identifier of the SharePoint site (e.g. ``"mySite"``).
+    """
+
+    def __init__(self, api: "SharePointAPI", site_id: str):
+        self._api = api
+        self.site_id = site_id
+        self._metadata: Optional[dict] = None
+
+    # -----------------------------------------------------------------
+    # Internal helpers
+    # -----------------------------------------------------------------
+    def _ensure_metadata(self) -> dict:
+        """Fetch site metadata on first use and cache it."""
+        if self._metadata is None:
+            self._metadata = self._api.get_site_metadata(self.site_id)
+        return self._metadata
+
+    # -----------------------------------------------------------------
+    # Exposed properties (lazy-loaded)
+    # -----------------------------------------------------------------
+    @property
+    def title(self) -> str:
+        """Site title."""
+        return self._ensure_metadata().get("Title", "")
+
+    @property
+    def url(self) -> str:
+        """Absolute URL of the site."""
+        return self._ensure_metadata().get("Url", "")
+
+    @property
+    def description(self) -> str:
+        """Site description, if present."""
+        return self._ensure_metadata().get("Description", "")
+
+    @property
+    def created(self) -> datetime | None:
+        """
+        Creation date of the SharePoint site.
+
+        Returns a ``datetime`` object parsed from the ``Created`` metadata
+        field, or ``None`` if the field is missing or cannot be parsed.
+        """
+        created_str = self._ensure_metadata().get("Created")
+        if not created_str:
+            return None
+        try:
+            # ``fromisoformat`` handles the ISO‑8601 format returned by SharePoint.
+            return datetime.fromisoformat(created_str)
+        except ValueError:
+            # Fallback: return None if parsing fails.
+            return None
+
+    @property
+    def language_id(self) -> int:
+        """Raw LCID value returned by SharePoint."""
+        return self._ensure_metadata().get("Language", 0)
+
+    @property
+    def language_name(self) -> str:
+        """
+        Human-readable language name derived from the LCID using the
+        ``locale`` module. If the LCID is unknown or the locale cannot be set,
+        a fallback string is returned.
+        """
+        lcid = self.language_id
+        locale_code = locale.windows_locale.get(lcid)
+        if not locale_code:
+            return f"Unknown (LCID={lcid})"
+        try:
+            # Attempt to set the locale; may fail if not installed.
+            locale.setlocale(locale.LC_ALL, locale_code)
+            # locale.getlocale() returns a tuple like ('en_US', 'UTF-8')
+            loc = locale.getlocale()[0]
+            if loc:
+                # Return the locale identifier (e.g., 'en_US')
+                return loc
+        except locale.Error:
+            # Locale not available on the system; fall back to the code.
+            pass
+        # Fallback to the raw locale code string.
+        return locale_code
+
+    # -----------------------------------------------------------------
+    # Convenience wrappers around ``SharePointAPI`` methods
+    # -----------------------------------------------------------------
+    def get_lists(self) -> SharePointLists:
+        """Return a ``SharePointLists`` collection for this site."""
+        return self._api.get_lists(self.site_id)
+
+    def get_users(
+        self,
+        filters: Optional[str] = None,
+        select_fields: Optional[List[str]] = None,
+    ) -> SharePointUserList:
+        """Retrieve users from the site."""
+        return self._api.get_users(self.site_id, filters=filters, select_fields=select_fields)
+
+    def get_group_users(
+        self,
+        group_name: str,
+        filters: Optional[str] = None,
+        select_fields: Optional[List[str]] = None,
+    ) -> SharePointUserList:
+        """Retrieve members of a SharePoint group."""
+        return self._api.get_group_users(
+            self.site_id, group_name, filters=filters, select_fields=select_fields
+        )
+
+    def get_user(
+        self,
+        user_id: int,
+        select_fields: Optional[List[str]] = None,
+    ) -> SharePointUser:
+        """Retrieve a single user by ID."""
+        return self._api.get_user(self.site_id, user_id, select_fields=select_fields)
+
+    def get_list(
+        self,
+        sp_list,
+        filters=None,
+        top: int = 1000,
+        view_path=None,
+        select_fields=None,
+        SPListType: SharePointList = SharePointList,
+    ) -> SharePointList:
+        """Delegate to ``SharePointAPI.get_list`` for this site."""
+        return self._api.get_list(
+            self.site_id,
+            sp_list,
+            filters,
+            top,
+            view_path,
+            select_fields,
+            SPListType=SPListType,
+        )
+
+    def get_list_by_name(
+        self,
+        sp_list_name: str,
+        filters=None,
+        top: int = 1000,
+        view_path=None,
+        select_fields=None,
+        SPListType: SharePointList = SharePointList,
+    ) -> SharePointList:
+        """Delegate to ``SharePointAPI.get_list_by_name`` for this site."""
+        return self._api.get_list_by_name(
+            self.site_id,
+            sp_list_name,
+            filters,
+            top,
+            view_path,
+            select_fields,
+            SPListType=SPListType,
+        )

{sharepoint_v1_api-0.2.2 → sharepoint_v1_api-0.2.4}/sharepoint_api/SharePointTimeRegistration.py

@@ -3,9 +3,10 @@ from datetime import datetime
 from sharepoint_api.SharePointListItem import SharePointListItem
 # from .SharePointAPI import SharePointAPI as SP
 
+
 class TimeRegistration(SharePointListItem):
     """
-    Represents a time‑registration entry associated with a SharePoint list item.
+    Represents a time-registration entry associated with a SharePoint list item.
 
     Extends :class:`SharePointListItem` with fields specific to time tracking,
     such as ``Hours``, ``DoneBy`` and related timestamps. Provides lazy loading of the
@@ -22,8 +23,8 @@ class TimeRegistration(SharePointListItem):
         elif self.settings['DoneDate'] is None:
             return None
         else:
-            return datetime.strptime(self.settings['DoneDate'], '%Y-%m-%dT%H:%M:%SZ')
-    
+            return datetime.strptime(self.settings['DoneDate'], '%Y-%m-%dT%H:%M:%SZ').replace(tzinfo=self.sp.timezone)
+
     @property
     def Hours(self) -> str:
         return self.settings['Hours']
@@ -38,7 +39,7 @@ class TimeRegistration(SharePointListItem):
             user_list = self.sp.get_users(self.sharepoint_site)
             self._DoneBy = user_list.get_user_by_id(self.DoneById)
         return self._DoneBy
-    
+
     @property
     def DoneUsername(self) -> str:
         return self.DoneBy.UserName
@@ -46,8 +47,7 @@ class TimeRegistration(SharePointListItem):
     @property
     def CaseId(self) -> str:
         return self.settings['CaseId']
-    
+
     @property
     def WorkPackageId(self) -> str:
         return self.settings['WorkPackageId']
-    

{sharepoint_v1_api-0.2.2 → sharepoint_v1_api-0.2.4}/sharepoint_api/__init__.py

@@ -1,6 +1,6 @@
 """sharepoint_api package
 
-Provides a high‑level Python client for interacting with SharePoint sites via the
+Provides a high-level Python client for interacting with SharePoint sites via the
 `SharePointAPI` class. The package includes helpers for working with lists,
 list items, users, and time registrations.
 
@@ -18,4 +18,5 @@ api = SharePointAPI._compact_init(creds)
 ```
 """
 
-from .SharePointAPI import SharePointAPI
+from .SharePointAPI import SharePointAPI
+from .SharePointSite import SharePointSite

{sharepoint_v1_api-0.2.2 → sharepoint_v1_api-0.2.4/sharepoint_v1_api.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sharepoint_v1_api
-Version: 0.2.2
+Version: 0.2.4
 Author: Aske Bluhme Klok
 License: MIT
 Keywords: Sharepoint
@@ -156,13 +156,37 @@ for v in versions:
 ```
 
 
+## 0.2.4 – 2025-12-03
+
+### Added
+
+- New high‑level `SharePointSite` object providing lazy‑loaded site metadata
+
+## 0.2.3 – 2025-12-02
+
+### Added
+
+- GUID validation for list identifiers with fallback to list title lookup via `GetByTitle`.
+- New helper method `_is_valid_guid` in `SharePointAPI`.
+- Centralized list resolution helper `_resolve_sp_list` for GUID, title, or `SharePointList` instances.
+- New method `get_list_metadata` to fetch only list metadata without items.
+- Type hint enhancements: added `Optional`, `Tuple` imports; updated method signatures (e.g., `get_item_versions` now uses `Optional[List[str]]`).
+- Updated `get_list` to return the resolved `SharePointList` object after appending items.
+- Refactored multiple methods (`get_item`, `create_item`, `update_item`, `attach_file`, `get_item_versions`, `get_case`) to use `_resolve_sp_list`, removing redundant GUID validation logic.
+
+### Changed
+
+- Cleaned up stray `else:` blocks and syntax errors.
+- Improved consistency of return objects across list-related methods.
+- Updated imports and docstrings accordingly.
+
 ## 0.2.2 – 2025-11-28
 
 ### Added
 
 - `SharePointList.fields` property to retrieve list field definitions
 
-## 0.2.1 – 2025‑11‑06
+## 0.2.1 – 2025-11-06
 
 ### Added
 
@@ -174,7 +198,7 @@ for v in versions:
 
 ### Changed
 
-- HTTP header handling unified; corrected `X‑HTTP‑Method: PUT` for full updates.
+- HTTP header handling unified; corrected `X-HTTP-Method: PUT` for full updates.
 - Error handling improved: generic `sys.exit(1)` replaced with explicit `TypeError`/`ConnectionError` exceptions.
 
 ### Fixed

{sharepoint_v1_api-0.2.2 → sharepoint_v1_api-0.2.4}/sharepoint_v1_api.egg-info/SOURCES.txt

@@ -9,6 +9,7 @@ sharepoint_api/SharePointAPI.py
 sharepoint_api/SharePointList.py
 sharepoint_api/SharePointListItem.py
 sharepoint_api/SharePointLists.py
+sharepoint_api/SharePointSite.py
 sharepoint_api/SharePointTimeRegistration.py
 sharepoint_api/SharePointUser.py
 sharepoint_api/SharePointUserList.py

sharepoint_v1_api-0.2.2/CHANGELOG.md

@@ -1,29 +0,0 @@
-## 0.2.2 – 2025-11-28
-
-### Added
-
-- `SharePointList.fields` property to retrieve list field definitions
-
-## 0.2.1 – 2025‑11‑06
-
-### Added
-
-- Optional `select_fields` parameters to list retrieval methods for more efficient queries.
-- New public API methods:
-  - `SharePointAPI.get_group_users` – fetch users of a SharePoint group.
-- Improved error handling with explicit `TypeError` exceptions.
-- Detailed docstrings for core classes and methods (enhances IDE support).
-
-### Changed
-
-- HTTP header handling unified; corrected `X‑HTTP‑Method: PUT` for full updates.
-- Error handling improved: generic `sys.exit(1)` replaced with explicit `TypeError`/`ConnectionError` exceptions.
-
-### Fixed
-
-- Fixed incorrect PUT header that previously sent a MERGE header.
-- Minor docstring formatting issues.
-
-### Security
-
-- Enforced NTLM authentication across all request helpers.