Returns the specified Special Folder :return: a special Folder :rtype: drive.Folder
(self, name)
| 1687 | **{self._cloud_data_key: data}) |
| 1688 | |
| 1689 | def get_special_folder(self, name): |
| 1690 | """ Returns the specified Special Folder |
| 1691 | |
| 1692 | :return: a special Folder |
| 1693 | :rtype: drive.Folder |
| 1694 | """ |
| 1695 | |
| 1696 | name = name if \ |
| 1697 | isinstance(name, OneDriveWellKnowFolderNames) \ |
| 1698 | else OneDriveWellKnowFolderNames(name.lower()) |
| 1699 | name = name.value |
| 1700 | |
| 1701 | if self.object_id: |
| 1702 | # reference the current drive_id |
| 1703 | url = self.build_url( |
| 1704 | self._endpoints.get('get_special').format(id=self.object_id, |
| 1705 | name=name)) |
| 1706 | else: |
| 1707 | # we don't know the drive_id so go to the default |
| 1708 | url = self.build_url( |
| 1709 | self._endpoints.get('get_special_default').format(name=name)) |
| 1710 | |
| 1711 | response = self.con.get(url) |
| 1712 | if not response: |
| 1713 | return None |
| 1714 | |
| 1715 | data = response.json() |
| 1716 | |
| 1717 | # Everything received from cloud must be passed as self._cloud_data_key |
| 1718 | return self._classifier(data)(parent=self, |
| 1719 | **{self._cloud_data_key: data}) |
| 1720 | |
| 1721 | @staticmethod |
| 1722 | def _classifier(item): |
nothing calls this directly
no test coverage detected