rework function syntaxes

Author: sebastianMindee

docs/code_samples/default_v2.txt

@@ -23,7 +23,7 @@ public class SimpleMindeeClient {
     InferenceParameters options = InferenceParameters.builder(modelId).build();
 
     // Parse the file
-    InferenceResponse response =  mindeeClient.enqueueAndParse(
+    InferenceResponse response =  mindeeClient.enqueueAndGetInference(
         inputSource,
         options
     );

src/main/java/com/mindee/MindeeClientV2.java

@@ -45,7 +45,7 @@ public JobResponse enqueue(
   /**
    * Poll queue for a previously enqueued document.
    */
-  public JobResponse pollQueue(String jobId) {
+  public JobResponse getJob(String jobId) {
     if (jobId == null || jobId.trim().isEmpty()) {
       throw new IllegalArgumentException("jobId must not be null or blank.");
     }
@@ -55,7 +55,7 @@ public JobResponse pollQueue(String jobId) {
   /**
    * Retrieve results for a previously enqueued document.
    */
-  public InferenceResponse parseQueued(String inferenceId) {
+  public InferenceResponse getInference(String inferenceId) {
     if (inferenceId == null || inferenceId.trim().isEmpty()) {
       throw new IllegalArgumentException("jobId must not be null or blank.");
     }
@@ -71,7 +71,7 @@ public InferenceResponse parseQueued(String inferenceId) {
    * @throws IOException Throws if the file can't be accessed.
    * @throws InterruptedException Throws if the thread is interrupted.
    */
-  public InferenceResponse enqueueAndParse(
+  public InferenceResponse enqueueAndGetInference(
       LocalInputSource inputSource,
       InferenceParameters options) throws IOException, InterruptedException {
 
@@ -85,12 +85,12 @@ public InferenceResponse enqueueAndParse(
     int max = options.getPollingOptions().getMaxRetries();
     while (attempts < max) {
       Thread.sleep((long) (options.getPollingOptions().getIntervalSec() * 1000));
-      resp = pollQueue(job.getJob().getId());
+      resp = getJob(job.getJob().getId());
       if (resp.getJob().getStatus().equals("Failed")) {
         break;
       }
       else if (resp.getJob().getStatus().equals("Processed")) {
-        return parseQueued(resp.getJob().getId());
+        return getInference(resp.getJob().getId());
       }
       attempts++;
     }

src/test/java/com/mindee/MindeeClientV2IT.java

@@ -43,7 +43,7 @@ void parseFile_emptyMultiPage_mustSucceed() throws IOException, InterruptedExcep
     InferenceParameters options =
         InferenceParameters.builder(modelId).build();
 
-    InferenceResponse response = mindeeClient.enqueueAndParse(source, options);
+    InferenceResponse response = mindeeClient.enqueueAndGetInference(source, options);
 
     assertNotNull(response);
     assertNotNull(response.getInference());
@@ -67,7 +67,7 @@ void parseFile_filledSinglePage_mustSucceed() throws IOException, InterruptedExc
     InferenceParameters options =
         InferenceParameters.builder(modelId).build();
 
-    InferenceResponse response = mindeeClient.enqueueAndParse(source, options);
+    InferenceResponse response = mindeeClient.enqueueAndGetInference(source, options);
 
     assertNotNull(response);
     assertNotNull(response.getInference());
@@ -113,7 +113,7 @@ void invalidModel_mustThrowError() throws IOException {
   void invalidJob_mustThrowError() {
     MindeeHttpExceptionV2 ex = assertThrows(
         MindeeHttpExceptionV2.class,
-        () -> mindeeClient.parseQueued("not-a-valid-job-ID")
+        () -> mindeeClient.getInference("not-a-valid-job-ID")
     );
     assertEquals(404, ex.getStatus());
     assertNotNull(ex);

src/test/java/com/mindee/MindeeClientV2Test.java

@@ -70,7 +70,7 @@ void document_getQueued_async() throws JsonProcessingException {
 
       MindeeClientV2 mindeeClient = makeClientWithMockedApi(predictable);
 
-      CommonResponse response = mindeeClient.pollQueue("dummy-id");
+      CommonResponse response = mindeeClient.getJob("dummy-id");
       assertNotNull(response, "parseQueued() must return a response");
       verify(predictable, atMostOnce()).reqGetInference(anyString());
     }