Including the BilingualFile class

This class is responsible for downloading bilingual files

src/BilingualFile.php

@@ -0,0 +1,70 @@
+<?php
+/**
+ * A very compact and simple Memsource API library
+ * 
+ * @author Bruno Fontes <developer@brunofontes.net>
+ * @link   https://github.com/brunofontes
+ */
+namespace BrunoFontes\Memsource;
+
+class BilingualFile extends \BrunoFontes\Memsource
+{
+    private $_url = '/bilingualFiles';
+    
+    /**
+     * Download one or more bilingual files
+     * 
+     * As Memsource limits downloading files into 100 jobs per time, this script 
+     * will prevent that by making all the necessary fetchs and saving each on 
+     * a different file.
+     * 
+     * An array with all the files used will be returned.
+     *
+     * @param string $projectUid The project uid which contain the jobs
+     * @param array  $jobUids    A simple array of Job uids: ['job_uid1', 'job_uid2']
+     * @param string $filename   File that will be created on server to store the 
+     *                           downloaded jobs
+     * 
+     * @return array A list of the downloaded files
+     */
+    public function downloadBilingualFile(string $projectUid, array $jobUids, string $filename): array
+    {
+        $url = "/api2/v1/projects/{$projectUid}/jobs/bilingualFile";
+
+        $groupedJobUids = array_chunk($jobUids, 100);
+        for ($i = 0; $i < count($groupedJobUids); $i++) {
+            $apiReadyArray = $this->_convertUidArrayToApiRequest($groupedJobUids[$i]);
+            $filenames[$i] = count($groupedJobUids) > 1?"{$i}_{$filename}":$filename;
+            $filecontent = $this->fetch('jsonPost', $url, $apiReadyArray);
+            $this->_saveIntoFile($filenames[$i], $filecontent);
+        }
+        return $filenames;
+    }
+
+    /**
+     * Convert a simple Array of uids provided by the user into the array 
+     * format required by Memsource API
+     *
+     * @param array $uids A simple array of UIDs
+     * 
+     * @return array The API ready array
+     */
+    private function _convertUidArrayToApiRequest(array $uids): array
+    {
+        foreach ($uids as $jobUid) {
+            $convertedArray[] = ['uid' => $jobUid];
+        }
+        return ['jobs' => $convertedArray];
+    }
+
+    private function _saveIntoFile(string $filename, string $filecontent)
+    {
+        try {
+            $f = fopen($filename, 'w+');
+            fwrite($f, $filecontent);
+            fclose($f);
+        } catch (\Exception $e) {
+            throw new Exception("File could not be saved: " . $e->error, 1);
+        }
+   }
+}