# Slide Score Python SDK
This SDK contains the client library for using API of [Slide Score](https://www.SlideScore.com)
See the [documentation](https://www.slidescore.com/docs/api/index.html) for more
# Examples
## Basic usage
- Import the module
- setup token
- setup URL of the Slide Score server
- create an instance of the API Client
from slidescore import *
token="eyJ....<your token>...."
url="https://slidescore.example.com/"
client = APIClient(url, token)
## Downloading a slide
Downloads a slide to the current directory ("."). Check the URL of the slide for image ID and study ID, or click Export cases button on study overview to get a list of slide IDs.
studyid=1
imageid=2
client.download_slide(studyid, imageid, ".")
## Uploading and adding a slide to a study
localFilePath="C:/file_to_upload.tiff"
uploadFolder="UploadTest"
serverFileName="renamedSlide.tiff"
client.upload_file(localFilePath, uploadFolder, serverFileName)
client.add_slide(studyid, uploadFolder+"/"+serverFileName)
## Upload answers - study results
Results are uploaded in the same format as the download.
resultsFilePath="c:/Users/User/Downloads/Study_23_06_21_11.txt"
with open(resultsFilePath, "r") as f:
res = f.read()
client.upload_results(studyid, res)
## Set slide description
You can use (limited) set of HTML tags in slide, case, study and module descriptions:
client.update_slide_description(studyid, imageid, 'Carina Nebula: Cosmic Cliffs, Glittering Landscape of Star Birth. Image Credit: NASA, ESA, CSA, and STScI <a href="https://esawebb.org/news/weic2205/">Original</a>');
## Make a request directly
The SDK doesn't include methods for all possible calls, sometimes you need to make the API request yourself:
response=clientlocal.perform_request("UpdateSlideName", {"imageId":imageid, "newName":'renamedSlide'}, method="POST")
rjson = response.json()
if 'success' not in rjson or rjson['success'] != True:
raise SlideScoreErrorException("Failed updating slide name: " + response.text);
Raw data
{
"_id": null,
"home_page": "https://github.com/slide-score/SlideScore-python-sdk",
"name": "slidescore-sdk",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "slidescore,slide score,sdk,api",
"author": "Slide Score B.V.",
"author_email": "info@slidescore.com",
"download_url": "https://files.pythonhosted.org/packages/c1/fc/56bbe8b20f09fefcc573782c605184e6d1dfd43bfd536859adab2f1bdf5a/slidescore-sdk-1.3.5.tar.gz",
"platform": null,
"description": "# Slide Score Python SDK\n\nThis SDK contains the client library for using API of [Slide Score](https://www.SlideScore.com)\t\nSee the [documentation](https://www.slidescore.com/docs/api/index.html) for more \n\n# Examples\n\n## Basic usage\n\n- Import the module\n- setup token\n- setup URL of the Slide Score server\n- create an instance of the API Client\n\n from slidescore import *\n\n\n token=\"eyJ....<your token>....\"\n url=\"https://slidescore.example.com/\"\n\n client = APIClient(url, token)\n \n## Downloading a slide \n\nDownloads a slide to the current directory (\".\"). Check the URL of the slide for image ID and study ID, or click Export cases button on study overview to get a list of slide IDs.\n\n studyid=1\n imageid=2\n\n client.download_slide(studyid, imageid, \".\")\n\n\n## Uploading and adding a slide to a study\n\n localFilePath=\"C:/file_to_upload.tiff\"\n uploadFolder=\"UploadTest\"\n serverFileName=\"renamedSlide.tiff\"\n\n client.upload_file(localFilePath, uploadFolder, serverFileName)\n client.add_slide(studyid, uploadFolder+\"/\"+serverFileName) \n \n## Upload answers - study results\n\nResults are uploaded in the same format as the download.\n\n resultsFilePath=\"c:/Users/User/Downloads/Study_23_06_21_11.txt\"\n with open(resultsFilePath, \"r\") as f:\n res = f.read()\n client.upload_results(studyid, res)\n\n\n## Set slide description\n\nYou can use (limited) set of HTML tags in slide, case, study and module descriptions:\n\n client.update_slide_description(studyid, imageid, 'Carina Nebula: Cosmic Cliffs, Glittering Landscape of Star Birth. Image Credit: NASA, ESA, CSA, and STScI <a href=\"https://esawebb.org/news/weic2205/\">Original</a>');\n\n\n## Make a request directly\n\nThe SDK doesn't include methods for all possible calls, sometimes you need to make the API request yourself:\n\n response=clientlocal.perform_request(\"UpdateSlideName\", {\"imageId\":imageid, \"newName\":'renamedSlide'}, method=\"POST\")\n rjson = response.json()\n if 'success' not in rjson or rjson['success'] != True:\n raise SlideScoreErrorException(\"Failed updating slide name: \" + response.text);\n\n\n\n\n",
"bugtrack_url": null,
"license": "",
"summary": "SDK for using the API of Slide Score",
"version": "1.3.5",
"project_urls": {
"Homepage": "https://github.com/slide-score/SlideScore-python-sdk"
},
"split_keywords": [
"slidescore",
"slide score",
"sdk",
"api"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "cef9c8bda4baa0ca8ef549d9a74d403b8d0936db5ae8083ae11fa1bbcd456c78",
"md5": "d0588c8937a8451b199737561814d92a",
"sha256": "ec109f0b57da610df31635b4f5d436f212ef4fefb0ca19f629a15c3cf3569300"
},
"downloads": -1,
"filename": "slidescore_sdk-1.3.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d0588c8937a8451b199737561814d92a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 26406,
"upload_time": "2024-02-07T21:34:11",
"upload_time_iso_8601": "2024-02-07T21:34:11.437770Z",
"url": "https://files.pythonhosted.org/packages/ce/f9/c8bda4baa0ca8ef549d9a74d403b8d0936db5ae8083ae11fa1bbcd456c78/slidescore_sdk-1.3.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c1fc56bbe8b20f09fefcc573782c605184e6d1dfd43bfd536859adab2f1bdf5a",
"md5": "247f4b534369b424e7fcd9ef604d8bc0",
"sha256": "3a02caca244dae3eae7927ab1d9db35a852a74b6b57384ee50fd834f97e50bc9"
},
"downloads": -1,
"filename": "slidescore-sdk-1.3.5.tar.gz",
"has_sig": false,
"md5_digest": "247f4b534369b424e7fcd9ef604d8bc0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 24117,
"upload_time": "2024-02-07T21:34:13",
"upload_time_iso_8601": "2024-02-07T21:34:13.233398Z",
"url": "https://files.pythonhosted.org/packages/c1/fc/56bbe8b20f09fefcc573782c605184e6d1dfd43bfd536859adab2f1bdf5a/slidescore-sdk-1.3.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-07 21:34:13",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "slide-score",
"github_project": "SlideScore-python-sdk",
"github_not_found": true,
"lcname": "slidescore-sdk"
}