add new action: answerCards

README.md

@@ -724,6 +724,44 @@ corresponding to when the API was available for use.
     ```
     </details>
 
+#### `answerCards`
+
+*   Answer cards. Ease is between 1 (Again) and 4 (Easy). Will start the timer immediately before answering. Returns `true` if card exists, `false` otherwise.
+
+    <details>
+    <summary><i>Sample request:</i></summary>
+
+    ```json
+    {
+        "action": "answerCards",
+        "version": 6,
+        "params": {
+            "answers": [
+                {
+                    "cardId": 1498938915662,
+                    "ease": 2
+                },
+                {
+                    "cardId": 1502098034048,
+                    "ease": 4
+                }
+            ]
+        }
+    }
+    ```
+    </details>
+
+    <details>
+    <summary><i>Sample result:</i></summary>
+
+    ```json
+    {
+        "result": [true, true],
+        "error": null
+    }
+    ```
+    </details>
+
 ---
 
 ### Deck Actions

plugin/__init__.py

@@ -1530,6 +1530,24 @@ def relearnCards(self, cards):
         self.stopEditing()
 
 
+    @util.api()
+    def answerCards(self, answers):
+        scheduler = self.scheduler()
+        success = []
+        for answer in answers:
+            try:
+                cid = answer['cardId']
+                ease = answer['ease']
+                card = self.getCard(cid)
+                card.start_timer()
+                scheduler.answerCard(card, ease)
+                success.append(True)
+            except NotFoundError:
+                success.append(False)
+
+        return success
+
+
     @util.api()
     def cardReviews(self, deck, startID):
         return self.database().all(

tests/test_cards.py

@@ -76,3 +76,18 @@ def test_forgetCards(setup):
 
 def test_relearnCards(setup):
     ac.relearnCards(cards=setup.card_ids)
+
+
+class TestAnswerCards:
+    def test_answerCards(self, setup):
+        ac.scheduler().reset()
+        answers = [
+            {"cardId": a, "ease": b} for a, b in zip(setup.card_ids, [2, 1, 4, 3])
+        ]
+        result = ac.answerCards(answers)
+        assert result == [True] * 4
+
+    def test_answerCards_with_invalid_card_id(self, setup):
+        ac.scheduler().reset()
+        result = ac.answerCards([{"cardId": 123, "ease": 2}])
+        assert result == [False]