cornellGrading 2.16.2__tar.gz → 2.17.0__tar.gz

{cornellGrading-2.16.2/cornellGrading.egg-info → cornellgrading-2.17.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: cornellGrading
-Version: 2.16.2
+Version: 2.17.0
 Summary: Routines for interacting with Cornell installations of Canvas and Qualtrics
 Home-page: https://github.com/dsavransky/grading
 Author: Dmitry Savransky

{cornellGrading-2.16.2 → cornellgrading-2.17.0}/cornellGrading/__init__.py

@@ -1,4 +1,4 @@
 name = "cornellGrading"
-__version__ = "2.16.2"
+__version__ = "2.17.0"
 from .cornellGrading import cornellGrading
 from .cornellQualtrics import cornellQualtrics

{cornellGrading-2.16.2 → cornellgrading-2.17.0}/cornellGrading/cornellQualtrics.py

@@ -659,6 +659,34 @@ class cornellQualtrics:
 
         return response.json()["result"]["elements"]
 
+    def getDistribution(self, surveyId, distributionId):
+        """Get a distribution
+
+        Args:
+            surveyId (str):
+                Unique id string of survey.  Get either from web interface or via
+                getSurveyId
+            distributionId (str):
+                Unique id string of distribution.
+
+        Returns:
+            dict:
+                Dictionary encoding distribution definition and stats
+
+        Notes:
+            https://api.qualtrics.com/f5b1d8775d803-get-distribution
+
+        """
+
+        baseUrl = "https://{0}{1}distributions/{2}?surveyId={3}".format(
+            self.dataCenter, self.qualtricsapi, distributionId, surveyId
+        )
+
+        response = requests.get(baseUrl, headers=self.headers_tokenOnly)
+        assert response.status_code == 200
+
+        return response.json()["result"]
+
     def exportSurvey(self, surveyId, fileFormat="csv", useLabels="true", saveDir=None):
         """Download and extract survey results
 
@@ -816,31 +844,31 @@ class cornellQualtrics:
             "userId": sharewith,
             "permissions": {
                 "surveyDefinitionManipulation": {
-                    "copySurveyQuestions": True,
-                    "editSurveyFlow": True,
-                    "useBlocks": True,
-                    "useSkipLogic": True,
-                    "useConjoint": True,
-                    "useTriggers": True,
-                    "useQuotas": True,
-                    "setSurveyOptions": True,
-                    "editQuestions": True,
-                    "deleteSurveyQuestions": True,
-                    "useTableOfContents": True,
-                    "useAdvancedQuotas": True,
+                    "copySurveyQuestions": False,
+                    "editSurveyFlow": False,
+                    "useBlocks": False,
+                    "useSkipLogic": False,
+                    "useConjoint": False,
+                    "useTriggers": False,
+                    "useQuotas": False,
+                    "setSurveyOptions": False,
+                    "editQuestions": False,
+                    "deleteSurveyQuestions": False,
+                    "useTableOfContents": False,
+                    "useAdvancedQuotas": False,
                 },
                 "surveyManagement": {
-                    "editSurveys": True,
-                    "activateSurveys": True,
-                    "deactivateSurveys": True,
-                    "copySurveys": True,
-                    "distributeSurveys": True,
-                    "deleteSurveys": True,
-                    "translateSurveys": True,
+                    "editSurveys": False,
+                    "activateSurveys": False,
+                    "deactivateSurveys": False,
+                    "copySurveys": False,
+                    "distributeSurveys": False,
+                    "deleteSurveys": False,
+                    "translateSurveys": False,
                 },
                 "response": {
-                    "editSurveyResponses": True,
-                    "createResponseSets": True,
+                    "editSurveyResponses": False,
+                    "createResponseSets": False,
                     "viewResponseId": True,
                     "useCrossTabs": True,
                     "useScreenouts": True,
@@ -991,7 +1019,7 @@ class cornellQualtrics:
         return response.json()["result"]
 
     def updateSurveyOptions(self, surveyId, data):
-        """Return survey options
+        """Update survey options
 
         Args:
             surveyId (str):
@@ -1199,8 +1227,8 @@ class cornellQualtrics:
                 Message ID string
 
         Returns:
-            list:
-                message dictionaries
+            dict:
+                message contents
 
         """
         baseUrl = "https://{0}{2}libraries/{1}/messages/{3}".format(
@@ -1210,7 +1238,7 @@ class cornellQualtrics:
         response = requests.get(baseUrl, headers=self.headers_tokenOnly)
         assert response.status_code == 200, "Couldn't get messages"
 
-        return response.json()["result"]["elements"]
+        return response.json()["result"]
 
     def createLibraryMessage(self, libraryId, subject, msg, category="thankYou"):
         """Create message in a library

{cornellGrading-2.16.2 → cornellgrading-2.17.0/cornellGrading.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: cornellGrading
-Version: 2.16.2
+Version: 2.17.0
 Summary: Routines for interacting with Cornell installations of Canvas and Qualtrics
 Home-page: https://github.com/dsavransky/grading
 Author: Dmitry Savransky