Add support for the endpoint /challenge/{id}/addFileTasks, closes #83

Author: rYR79435

maproulette/api/challenge.py

@@ -278,6 +278,29 @@ def add_tasks_to_challenge(self, data, challenge_id):
             body=data)
         return response
 
+    def add_file_tasks_to_challenge(self, data, challenge_id, line_by_line="true", remove_unmatched="false", data_origin_date="", skip_snapshot="false"):
+        """Method to add tasks to an existing challenge with tasks as GeoJSON
+
+        :param data: a GeoJSON containing geometry of tasks to be added to a challenge
+        :param challenge_id: the ID corresponding to the challenge that tasks will be added to
+        :param lineByLine: whether or not the provided data is in line-by-line GeoJSON format
+        :param skipSnapshot: whether or not to skip recording a snapshot before proceeding
+        :returns: the API response from the PUT request
+        """
+        query_params = {
+            "lineByLine": str(line_by_line),
+            "removeUnmatched": str(remove_unmatched),
+            "dataOriginDate": str(data_origin_date),
+            "skipSnapshot": str(skip_snapshot)
+        }
+        body = {'json': ('data', data)} # server only accepts dict with key 'json'
+
+        response = self.put_file(
+            endpoint=f"/challenge/{challenge_id}/addFileTasks",
+            body=body,
+            params=query_params)
+        return response
+
     def delete_challenge(self, challenge_id, immediate="false"):
         """Method to delete a challenge by using the corresponding challenge ID
 

maproulette/api/maproulette_server.py

@@ -180,6 +180,51 @@ def put(self, endpoint, body=None, params=None):
                 "status": response.status_code
             }
 
+    def put_file(self, endpoint, body=None, params=None):
+        """Method that completes a multipart PUT request to the MapRoulette API
+
+        :param endpoint: the server endpoint to use for the PUT request
+        :param body: the body of the request (optional)
+        :param params: the parameters that pertain to the request (optional)
+        :returns: a dictionary containing the API response status code as well as the decoded JSON response if decoding
+            was successful. If not, the response text is returned.
+        """
+        response = self.session.put(
+            self.url + endpoint,
+            params=params,
+            files=body
+        )
+        try:
+            response.raise_for_status()
+        except requests.exceptions.HTTPError as e:
+            if e.response.status_code == 400:
+                raise InvalidJsonError(
+                    message=self.parse_response_message(e.response),
+                    status=e.response.status_code
+                ) from None
+            elif e.response.status_code == 401:
+                raise UnauthorizedError(
+                    message=self.parse_response_message(e.response),
+                    status=e.response.status_code
+                ) from None
+            else:
+                raise HttpError(
+                    message=self.parse_response_message(e.response),
+                    status=e.response.status_code
+                ) from None
+        except (requests.ConnectionError, requests.Timeout) as e:
+            raise ConnectionUnavailableError(e) from None
+        try:
+            return {
+                "data": response.json(),
+                "status": response.status_code
+            }
+        except ValueError:
+            return {
+                "data": response.text,
+                "status": response.status_code
+            }
+
     def delete(self, endpoint, params=None):
         """Method that completes a DELETE request to the MapRoulette API