allow properly deleting from the cache via del keyword.

Author: UmanShahzad

CHANGELOG.md

@@ -1,5 +1,10 @@
 # IPInfo Changelog
 
+## 4.2.1
+
+- Allow deleting from the cache via the `del` keyword, e.g.
+  `del handler.cache[ip_key]`.
+
 ## 4.2.0
 
 - Cache keys are now versioned.

README.md

@@ -189,25 +189,29 @@ handler = ipinfo.getHandler(cache=MyCustomCache())
 
 #### Accessing the cache directly
 
-You can access/update the cache directly via a dictionary-like notation with a cache_key and the handler.
+You can access/update the cache directly via dictionary-like notation.
 
 ```python
 >>> import ipinfo
 >>> from ipinfo.handler_utils import cache_key
+>>>
 >>> access_token = '123456789abc'
 >>> handler = ipinfo.getHandler(access_token)
 >>> ip_cache_key = cache_key('1.1.1.1')
 
-# Check if the ip address is in the cache
+# Check if IP is in the cache.
 >>> ip_cache_key in handler.cache
 True
 
-# Get the ip address's details from cache
+# Get the IP's details from cache.
 >>> handler.cache[ip_cache_key]
 {'ip': '1.1.1.1', 'hostname': 'one.one.one.one', 'anycast': True, 'city': 'Miami', 'region': 'Florida', 'country': 'US', 'loc': '25.7867,-80.1800', 'org': 'AS13335 Cloudflare, Inc.', 'postal': '33132', 'timezone': 'America/New_York', 'country_name': 'United States', 'latitude': '25.7867', 'longitude': '-80.1800'}
 
-# Remove the ip address from the cache
+# Set the IP's details to something else in the cache.
 >>> handler.cache[ip_cache_key] = None
+
+# Delete the IP from the cache.
+>>> del handler.cache[ip_cache_key]
 ```
 
 ### Modifying request options

ipinfo/cache/default.py

@@ -21,3 +21,6 @@ def __setitem__(self, key, value):
 
     def __getitem__(self, key):
         return self.cache.__getitem__(key)
+
+    def __delitem__(self, key):
+        return self.cache.__delitem__(key)

ipinfo/cache/interface.py

@@ -19,3 +19,7 @@ def __setitem__(self, key, value):
     @abc.abstractmethod
     def __getitem__(self, key):
         pass
+
+    @abc.abstractmethod
+    def __delitem__(self, key):
+        pass

ipinfo/version.py

@@ -1 +1 @@
-SDK_VERSION = "4.2.0"
+SDK_VERSION = "4.2.1"

requirements.txt

@@ -1,38 +1,83 @@
 #
-# This file is autogenerated by pip-compile
+# This file is autogenerated by pip-compile with python 3.9
 # To update, run:
 #
 #    pip-compile --no-emit-index-url --no-emit-trusted-host
 #
-aiohttp==3.7.4.post0      # via -r requirements.in
-appdirs==1.4.4            # via black
-async-timeout==3.0.1      # via aiohttp
-attrs==20.3.0             # via aiohttp, pytest
-black==20.8b1             # via -r requirements.in
-cachetools==4.2.0         # via -r requirements.in
-certifi==2020.12.5        # via requests
-chardet==4.0.0            # via aiohttp, requests
-click==7.1.2              # via black, pip-tools
-idna==2.10                # via requests, yarl
-iniconfig==1.1.1          # via pytest
-multidict==5.1.0          # via aiohttp, yarl
-mypy-extensions==0.4.3    # via black
-packaging==20.9           # via pytest
-pathspec==0.8.1           # via black
-pip-tools==5.4.0          # via -r requirements.in
-pluggy==0.13.1            # via pytest
-py==1.10.0                # via pytest
-pyparsing==2.4.7          # via packaging
-pytest-asyncio==0.14.0    # via -r requirements.in
-pytest==6.2.1             # via -r requirements.in, pytest-asyncio
-regex==2021.4.4           # via black
-requests==2.25.1          # via -r requirements.in
-six==1.15.0               # via pip-tools
-toml==0.10.2              # via black, pytest
-typed-ast==1.4.3          # via black
-typing-extensions==3.7.4.3  # via aiohttp, black
-urllib3==1.26.4           # via requests
-yarl==1.6.3               # via aiohttp
+aiohttp==3.7.4.post0
+    # via -r requirements.in
+appdirs==1.4.4
+    # via black
+async-timeout==3.0.1
+    # via aiohttp
+attrs==21.2.0
+    # via
+    #   aiohttp
+    #   pytest
+black==20.8b1
+    # via -r requirements.in
+cachetools==4.2.0
+    # via -r requirements.in
+certifi==2021.5.30
+    # via requests
+chardet==4.0.0
+    # via
+    #   aiohttp
+    #   requests
+click==8.0.1
+    # via
+    #   black
+    #   pip-tools
+idna==2.10
+    # via
+    #   requests
+    #   yarl
+iniconfig==1.1.1
+    # via pytest
+multidict==5.1.0
+    # via
+    #   aiohttp
+    #   yarl
+mypy-extensions==0.4.3
+    # via black
+packaging==21.0
+    # via pytest
+pathspec==0.8.1
+    # via black
+pip-tools==5.4.0
+    # via -r requirements.in
+pluggy==0.13.1
+    # via pytest
+py==1.10.0
+    # via pytest
+pyparsing==2.4.7
+    # via packaging
+pytest==6.2.1
+    # via
+    #   -r requirements.in
+    #   pytest-asyncio
+pytest-asyncio==0.14.0
+    # via -r requirements.in
+regex==2021.7.6
+    # via black
+requests==2.25.1
+    # via -r requirements.in
+six==1.16.0
+    # via pip-tools
+toml==0.10.2
+    # via
+    #   black
+    #   pytest
+typed-ast==1.4.3
+    # via black
+typing-extensions==3.10.0.0
+    # via
+    #   aiohttp
+    #   black
+urllib3==1.26.6
+    # via requests
+yarl==1.6.3
+    # via aiohttp
 
 # The following packages are considered to be unsafe in a requirements file:
 # pip