Skip to content
master
Switch branches/tags
Go to file
Code
This branch is 62 commits ahead of tobiasgass:master.

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

README

This library implements a client for the REST API of the virtualskeleton framework which is used by the Sicasl Medical Image Repository (www.smir.ch). It supports authentication, general queries, and specific requests such as image upload/download, object linking and right management. Examples are provided in the examples directory. Please use 'demo.virtualskeleton.ch' for testing purposes.

Module documentation

-http://sicasfoundation.github.io/vsdConnect/

What is in this Fork

  • Pyhton 3
  • usage of requests package instead of urllib2
  • usage of pathlib instead of os.path
  • usage of PyJWT for jwt.io authentication PyJWT
  • introduction of API classes using jsonmodels

Recent updates

moved to jsonmodels for apiclasses

What is this repository for?

  • Quick summary: connect to vsd
  • Version: 0.8.1dev

How do I get set up?

  1. clone the repo

    git clone https://github.com/SICASFoundation/vsdConnect

  2. Install the package with dependencies

pip install vsdConnect

or

python setup.py install

or, if you want to edit the source:

pip install --editable vsdConnect

Contribution guidelines

  • Write exception handling
  • Writing tests
  • Code review
  • Adding sockets/timeouts/retries
  • Adding more stable support for pagination
  • Add general file upload
  • Write some sort of GUI example

Who do I talk to?

  • Repo owner or admin
  • Other community or team contact

Problems

  • The server response is very slow if you have 50+ folders. VSD-connect makes a request to the server for each folder. Therefore, I will be slow if you have a lot of folders and use the folder methods. You should then use the getRequest function and create your APIFolder object locally.

Get Started

This code connects to the demo server and retrieves an object

from vsdConnect import connect
from vsdConnect import models

## Connect to demo.virtualskeleton.ch
api = connect.VSDConnecter()

# an available object id from the demo and define the selfurl
vsd_id = 38
selfUrl = 'https://demo.virtualskeleton.ch/api/objects/{0}' . format(vsd_id)

# create the APIObject and get it from the server
obj  = models.APIObject(selfUrl=selfUrl).get(api)

# display the object infos (json)
print(obj.show())

to download the object's file add this line

obj.download(api)
``

About

A python library to use the REST interface of the Virtual Skeleton Database

Resources

License

Releases

No releases published

Packages

No packages published

Languages