Add getDeckStats action

README.md

@@ -960,6 +960,46 @@ corresponding to when the API was available for use.
     }
     ```
 
+*   **getDeckStats**
+
+    Gets statistics such as total cards and cards due for the given decks.
+
+    *Sample request*:
+    ```json
+    {
+        "action": "getDeckStats",
+        "version": 6,
+        "params": {
+            "decks": ["Japanese::JLPT N5", "Easy Spanish"]
+        }
+    }
+    ```
+
+    *Sample result*:
+    ```json
+    {
+        "result": {
+            "1651445861967": {
+                "deck_id": 1651445861967,
+                "name": "Japanese::JLPT N5",
+                "new_count": 20,
+                "learn_count": 0,
+                "review_count": 0,
+                "total_in_deck": 1506
+            },
+            "1651445861960": {
+                "deck_id": 1651445861960,
+                "name": "Easy Spanish",
+                "new_count": 26,
+                "learn_count": 10,
+                "review_count": 5,
+                "total_in_deck": 852
+            }
+        },
+        "error": null
+    }
+    ```
+
 #### Graphical Actions
 
 *   **guiBrowse**

plugin/__init__.py

@@ -346,6 +346,21 @@ def getNote(self, note_id: int) -> Note:
         except NotFoundError:
             raise NotFoundError('Note was not found: {}'.format(note_id))
 
+    def deckStatsToJson(self, due_tree):
+        return {'deck_id': due_tree.deck_id,
+                'name': due_tree.name,
+                'new_count': due_tree.new_count,
+                'learn_count': due_tree.learn_count,
+                'review_count': due_tree.review_count,
+                'total_in_deck': due_tree.total_in_deck}
+
+    def collectDeckTreeChildren(self, parent_node):
+        allNodes = {parent_node.deck_id: parent_node}
+        for child in parent_node.children:
+            for deckId, childNode in self.collectDeckTreeChildren(child).items():
+                allNodes[deckId] = childNode
+        return allNodes
+
     #
     # Miscellaneous
     #
@@ -617,6 +632,18 @@ def removeDeckConfigId(self, configId):
         collection.decks.remConf(configId)
         return True
 
+    @util.api()
+    def getDeckStats(self, decks):
+        collection = self.collection()
+        scheduler = self.scheduler()
+        responseDict = {}
+        deckIds = list(map(lambda d: collection.decks.id(d), decks))
+
+        allDeckNodes = self.collectDeckTreeChildren(scheduler.deck_due_tree())
+        for deckId, deckNode in allDeckNodes.items():
+            if deckId in deckIds:
+                responseDict[deckId] = self.deckStatsToJson(deckNode)
+        return responseDict
 
     @util.api()
     def storeMediaFile(self, filename, data=None, path=None, url=None, skipHash=None, deleteExisting=True):

tests/test_decks.py

@@ -67,3 +67,8 @@ def test_removedDeckConfigId_fails_with_invalid_id(session_with_profile_loaded):
     new_config_id = ac.cloneDeckConfigId(cloneFrom=1, name="test")
     assert ac.removeDeckConfigId(configId=new_config_id) is True
     assert ac.removeDeckConfigId(configId=new_config_id) is False
+
+
+def test_getDeckStats(session_with_profile_loaded):
+    result = ac.getDeckStats(decks=["Default"])
+    assert result["name"] == "Default"