Expose token in Share objects

Some use cases require passing the token to external applications
that access NextCloud shares via WebDAV.

Author: meck-gd

nc_py_api/files/__init__.py

@@ -442,6 +442,11 @@ def path(self) -> str:
         """Share path relative to the user's root directory."""
         return self._raw_data.get("path", "").lstrip("/")
 
+    @property
+    def token(self) -> str:
+        """Token for the Shared object."""
+        return self._raw_data.get("token", "")
+
     @property
     def label(self) -> str:
         """Label for the Shared object."""

tests/actual_tests/files_sharing_test.py

@@ -50,6 +50,7 @@ def _test_share_fields(new_share: Share, get_by_id: Share, shared_file: FsNode):
     assert get_by_id.path == new_share.path
     assert get_by_id.mimetype == new_share.mimetype
     assert get_by_id.share_type == new_share.share_type
+    assert get_by_id.token == new_share.token
     assert get_by_id.file_owner == new_share.file_owner
     assert get_by_id.share_owner == new_share.share_owner
     assert not get_by_id.share_with