Merge pull request #138 from andreaskienle/multiple-audio-files

Accept multiple audio files in note creation and update

README.md

@@ -926,12 +926,12 @@ guarantee that your application continues to function properly in the future.
     the created note created on success, and `null` on failure.
 
     AnkiConnect can download audio files and embed them in newly created notes. The corresponding `audio` note member is
-    optional and can be omitted. If you choose to include it, the `url` and `filename` fields must be also defined. The
+    optional and can be omitted. If you choose to include it, it should contain a single object or an array of objects
-    `skipHash` field can be optionally provided to skip the inclusion of downloaded files with an MD5 hash that matches
+    with mandatory `url` and `filename` fields. The `skipHash` field can be optionally provided to skip the inclusion of
-    the provided value. This is useful for avoiding the saving of error pages and stub files. The `fields` member is a
+    downloaded files with an MD5 hash that matches the provided value. This is useful for avoiding the saving of error
-    list of fields that should play audio when the card is displayed in Anki. The `allowDuplicate` member inside
+    pages and stub files. The `fields` member is a list of fields that should play audio when the card is displayed in
-    `options` group can be set to true to enable adding duplicate cards. Normally duplicate cards can not be added and
+    Anki. The `allowDuplicate` member inside `options` group can be set to true to enable adding duplicate cards.
-    trigger exception.
+    Normally duplicate cards can not be added and trigger exception.
 
     *Sample request*:
     ```json
@@ -952,14 +952,14 @@ guarantee that your application continues to function properly in the future.
                 "tags": [
                     "yomichan"
                 ],
-                "audio": {
+                "audio": [{
                     "url": "https://assets.languagepod101.com/dictionary/japanese/audiomp3.php?kanji=猫&kana=ねこ",
                     "filename": "yomichan_ねこ_猫.mp3",
                     "skipHash": "7e2c2f954ef6051373ba916f000168dc",
                     "fields": [
                         "Front"
                     ]
-                }
+                }]
             }
         }
     }
@@ -996,14 +996,14 @@ guarantee that your application continues to function properly in the future.
                     "tags": [
                         "yomichan"
                     ],
-                    "audio": {
+                    "audio": [{
                         "url": "https://assets.languagepod101.com/dictionary/japanese/audiomp3.php?kanji=猫&kana=ねこ",
                         "filename": "yomichan_ねこ_猫.mp3",
                         "skipHash": "7e2c2f954ef6051373ba916f000168dc",
                         "fields": [
                             "Front"
                         ]
-                    }
+                    }]
                 }
             ]
         }
@@ -1056,7 +1056,8 @@ guarantee that your application continues to function properly in the future.
 
 *   **updateNoteFields**
 
-    Modify the fields of an exist note.
+    Modify the fields of an exist note. You can also include audio files which will be added to the note with an
+    optional `audio` property. Please see the documentation for `addNote` for an explanation of objects in the `audio` array.
 
     *Sample request*:
     ```json
@@ -1069,7 +1070,15 @@ guarantee that your application continues to function properly in the future.
                 "fields": {
                     "Front": "new front content",
                     "Back": "new back content"
-                }
+                },
+                "audio": [{
+                    "url": "https://assets.languagepod101.com/dictionary/japanese/audiomp3.php?kanji=猫&kana=ねこ",
+                    "filename": "yomichan_ねこ_猫.mp3",
+                    "skipHash": "7e2c2f954ef6051373ba916f000168dc",
+                    "fields": [
+                        "Front"
+                    ]
+                }]
             }
         }
     }

plugin/__init__.py

@@ -449,7 +449,24 @@ class AnkiConnect:
     def addNote(self, note):
         ankiNote = self.createNote(note)
 
-        audio = note.get('audio')
+        audioObjectOrList = note.get('audio')
+        self.addAudio(ankiNote, audioObjectOrList)
+
+        collection = self.collection()
+        self.startEditing()
+        nCardsAdded = collection.addNote(ankiNote)
+        if nCardsAdded < 1:
+            raise Exception('The field values you have provided would make an empty question on all cards.')
+        collection.autosave()
+        self.stopEditing()
+
+        return ankiNote.id
+
+
+    def addAudio(self, ankiNote, audioObjectOrList):
+        if audioObjectOrList is not None:
+            audioList = audioObjectOrList if isinstance(audioObjectOrList, list) else [audioObjectOrList]
+            for audio in audioList:
                 if audio is not None and len(audio['fields']) > 0:
                     try:
                         data = util.download(audio['url'])
@@ -468,21 +485,11 @@ class AnkiConnect:
                                     ankiNote[field] += u'[sound:{}]'.format(audioFilename)
 
                     except Exception as e:
-                errorMessage = str(e).replace("&", "&amp;").replace("<", "&lt;").replace(">", "&gt;")
+                        errorMessage = str(e).replace('&', '&amp;').replace('<', '&lt;').replace('>', '&gt;')
                         for field in audio['fields']:
                             if field in ankiNote:
                                 ankiNote[field] += errorMessage
 
-        collection = self.collection()
-        self.startEditing()
-        nCardsAdded = collection.addNote(ankiNote)
-        if nCardsAdded < 1:
-            raise Exception('The field values you have provided would make an empty question on all cards.')
-        collection.autosave()
-        self.stopEditing()
-
-        return ankiNote.id
-
 
     @util.api()
     def canAddNote(self, note):
@@ -502,6 +509,9 @@ class AnkiConnect:
             if name in ankiNote:
                 ankiNote[name] = value
 
+        audioObjectOrList = note['audio']
+        self.addAudio(ankiNote, audioObjectOrList)
+
         ankiNote.flush()