Add NonExistentEntityError exception (#331)

* Add NonExistentEntityError exception

Co-Authored-By: Dennis Priskorn <dennis@priskorn.se>

* Add missing Exception

Co-authored-by: Dennis Priskorn <dennis@priskorn.se>

Author: LeMyst

test/test_entity_item.py

@@ -5,6 +5,7 @@
 from wikibaseintegrator import WikibaseIntegrator
 from wikibaseintegrator.datatypes import BaseDataType, Item
 from wikibaseintegrator.wbi_config import config as wbi_config
+from wikibaseintegrator.wbi_exceptions import NonExistentEntityError
 
 wbi_config['USER_AGENT'] = 'WikibaseIntegrator-pytest/1.0 (test_entity_item.py)'
 
@@ -33,6 +34,10 @@ def test_get(self):
         with self.assertRaises(ValueError):
             wbi.item.get(-1)
 
+        # Test with negative id
+        with self.assertRaises(NonExistentEntityError):
+            wbi.item.get("Q99999999999999")
+
     def test_get_json(self):
         assert wbi.item.get('Q582').get_json()['labels']['fr']['value'] == 'Villeurbanne'
 

wikibaseintegrator/entities/baseentity.py

@@ -10,7 +10,7 @@
 from wikibaseintegrator.datatypes import BaseDataType
 from wikibaseintegrator.models.claims import Claim, Claims
 from wikibaseintegrator.wbi_enums import ActionIfExists
-from wikibaseintegrator.wbi_exceptions import MWApiError, NonUniqueLabelDescriptionPairError
+from wikibaseintegrator.wbi_exceptions import MWApiError, NonExistentEntityError, NonUniqueLabelDescriptionPairError
 from wikibaseintegrator.wbi_helpers import delete_page, mediawiki_api_call_helper
 from wikibaseintegrator.wbi_login import _Login
 
@@ -123,8 +123,14 @@ def get_json(self) -> Dict[str, Union[str, Dict[str, List]]]:
         return json_data
 
     def from_json(self, json_data: Dict[str, Any]) -> BaseEntity:
-        if 'missing' in json_data:
-            raise ValueError('Entity is nonexistent')
+        """
+        Import a dictionary into BaseEntity attributes.
+
+        :param json_data: A specific dictionary from MediaWiki API
+        :return:
+        """
+        if 'missing' in json_data:  # TODO: 1.35 compatibility
+            raise NonExistentEntityError('The MW API returned that the entity was missing.')
 
         if 'title' in json_data:  # TODO: 1.35 compatibility
             self.title = str(json_data['title'])

wikibaseintegrator/wbi_exceptions.py

@@ -60,3 +60,7 @@ class CorePropIntegrityException(Exception):
 
 class MergeError(Exception):
     pass
+
+
+class NonExistentEntityError(Exception):
+    pass

wikibaseintegrator/wbi_helpers.py

@@ -11,7 +11,7 @@
 
 from wikibaseintegrator.wbi_backoff import wbi_backoff
 from wikibaseintegrator.wbi_config import config
-from wikibaseintegrator.wbi_exceptions import MWApiError, SearchError
+from wikibaseintegrator.wbi_exceptions import MWApiError, NonExistentEntityError, SearchError
 
 if TYPE_CHECKING:
     from wikibaseintegrator.entities.baseentity import BaseEntity
@@ -110,6 +110,13 @@ def mediawiki_api_call(method: str, mediawiki_api_url: str = None, session: Sess
                 sleep(retry_after)
                 continue
 
+            # non-existent error
+            if 'code' in json_data['error'] and json_data['error']['code'] == 'no-such-entity':
+                if 'info' in json_data['error']['code']:
+                    raise NonExistentEntityError(json_data['error']['code']['info'])
+                else:
+                    raise NonExistentEntityError()
+
             # others case
             raise MWApiError(response.json() if response else {})