python-ipware 2.0.2__py3-none-any.whl → 2.0.4__py3-none-any.whl

python_ipware/__version__.py

@@ -1 +1 @@
-__version__ = "2.0.2"
+__version__ = "2.0.4"

python_ipware/python_ipware.py

@@ -28,6 +28,7 @@ class IpWareMeta:
             "HTTP_X_CLUSTER_CLIENT_IP",  # Rackspace LB and Riverbed Stingray
             "HTTP_FORWARDED_FOR",  # RFC 7239
             "HTTP_FORWARDED",  # RFC 7239
+            "HTTP_CF_CONNECTING_IP",  # CloudFlare
             "X-CLIENT-IP",  # Microsoft Azure
             "X-REAL-IP",  # NGINX
             "X-CLUSTER-CLIENT-IP",  # Rackspace Cloud Load Balancers
@@ -143,12 +144,9 @@ class IpWareProxy:
 
     def __init__(
         self,
-        proxy_count: int = 0,
+        proxy_count: Optional[int] = None,
         proxy_list: Optional[List[str]] = None,
     ) -> None:
-        if proxy_count is None or proxy_count < 0:
-            raise ValueError("proxy_count must be a positive integer")
-
         self.proxy_count = proxy_count
         self.proxy_list = self._is_valid_proxy_trusted_list(proxy_list or [])
 
@@ -171,15 +169,14 @@ class IpWareProxy:
         """
         Checks if the proxy count is valid
         @param ip_list: list of ip addresses
-        @param strict: if True, we must have exactly proxy_count proxies
+        @param strict: if True, we must have exactly proxy_count proxies, including `0` proxies
         @return: True if the proxy count is valid, False otherwise
         """
-        if self.proxy_count < 1:
+        # No proxy count check is required
+        if self.proxy_count is None:
             return True
 
         ip_count: int = len(ip_list)
-        if ip_count < 1:
-            return False
 
         if strict:
             # our first proxy takes the last ip address and treats it as client ip
@@ -220,10 +217,6 @@ class IpWareProxy:
             if not str(value).startswith(self.proxy_list[index]):
                 return False
 
-        # now all we need is to return the first ip in the list that is not in the trusted proxy list
-        # best_client_ip_index = proxy_list_count + 1
-        # best_client_ip = ip_list[-best_client_ip_index]
-
         return True
 
 
@@ -236,11 +229,11 @@ class IpWare(IpWareMeta, IpWareProxy, IpWareIpAddress):
         self,
         precedence: Optional[Tuple[str, ...]] = None,
         leftmost: bool = True,
-        proxy_count: int = 0,
+        proxy_count: Optional[int] = None,
         proxy_list: Optional[List[str]] = None,
     ) -> None:
         IpWareMeta.__init__(self, precedence, leftmost)
-        IpWareProxy.__init__(self, proxy_count or 0, proxy_list or [])
+        IpWareProxy.__init__(self, proxy_count, proxy_list)
 
     def get_meta_value(self, meta: Dict[str, str], key: str) -> str:
         """
@@ -256,7 +249,13 @@ class IpWare(IpWareMeta, IpWareProxy, IpWareIpAddress):
         Given a list of keys, it returns a list of cleaned up values
         @return: a list of values
         """
-        return [self.get_meta_value(meta, key) for key in self.precedence]
+        meta_list: List[str] = []
+        for key in self.precedence:
+            value = self.get_meta_value(meta, key).strip()
+            if value:
+                meta_list.append(value)
+
+        return meta_list
 
     def get_client_ip(
         self,
@@ -271,8 +270,6 @@ class IpWare(IpWareMeta, IpWareProxy, IpWareIpAddress):
         private_list: List[OptionalIpAddressType] = []
 
         for ip_str in self.get_meta_values(meta):
-            if not ip_str:
-                continue
 
             ip_list = self.get_ips_from_string(ip_str)
             if not ip_list:
@@ -336,7 +333,11 @@ class IpWare(IpWareMeta, IpWareProxy, IpWareIpAddress):
             return best_client_ip, True
 
         # the incoming ips match our proxy count
-        if self.proxy_count > 0 and proxy_count_validated:
+        if (
+            self.proxy_count is not None
+            and self.proxy_count > 0
+            and proxy_count_validated
+        ):
             best_client_ip_index = self.proxy_count + 1
             best_client_ip = ip_list[-best_client_ip_index]
             return best_client_ip, True

{python_ipware-2.0.2.dist-info → python_ipware-2.0.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-ipware
-Version: 2.0.2
+Version: 2.0.4
 Summary: A Python package to retrieve user's IP address
 Author-email: Val Neekman <info@neekware.com>
 License: MIT
@@ -134,6 +134,7 @@ request_headers_precedence_order = (
     "HTTP_X_CLUSTER_CLIENT_IP",  # Rackspace LB and Riverbed Stingray
     "HTTP_FORWARDED_FOR",  # RFC 7239
     "HTTP_FORWARDED",  # RFC 7239
+    "HTTP_CF_CONNECTING_IP",  # CloudFlare
     "X-CLIENT-IP",  # Microsoft Azure
     "X-REAL-IP",  # NGINX
     "X-CLUSTER-CLIENT-IP",  # Rackspace Cloud Load Balancers
@@ -215,23 +216,41 @@ If your python server is behind a `known` number of proxies, but you deploy on m
 You can customize the proxy count by providing your `proxy_count` during initialization when calling `IpWare(proxy_count=2)`.
 
 ```python
-# In the above scenario, the total number of proxies can be used as a way to filter out unwanted requests.
 from python_ipware import IpWare
 
-# enforce proxy count
-ipw = IpWare(proxy_count=1)
+# Enforce proxy count
+# proxy_count=0 is valid
+# proxy_count=None to disable proxy_count check
+ipw = IpWare(proxy_count=2)
 
-# enforce proxy count and trusted proxies
-ipw = IpWare(proxy_count=1, proxy_list=["198.84.193.157"])
+# Example usage in non-strict mode:
+# X-Forwarded-For format: <fake>, <client>, <proxy1>, <proxy2>
+# At least `proxy_count` number of proxies
+ip, trusted_route = ipw.get_client_ip(meta=request.META)
 
+# Example usage in strict mode:
+# X-Forwarded-For format: <client>, <proxy1>, <proxy2>
+# Exact `proxy_count` number of proxies
+ip, trusted_route = ipw.get_client_ip(meta=request.META, strict=True)
+```
 
-# usage: non-strict mode (X-Forwarded-For: <fake>, <client>, <proxy1>, <proxy2>)
-# total number of ip addresses are greater than the total count
-ip, trusted_route = ipw.get_client_ip(meta=request.META)
+### Proxy Count & Trusted Proxy List Combo
+In this example, we utilize the total number of proxies as a method to filter out unwanted requests while verifying the trust proxies.
 
+```python
+from python_ipware import IpWare
 
-# usage: strict mode (X-Forwarded-For: <client>, <proxy1>, <proxy2>)
-# total number of ip addresses are exactly equal to client ip + proxy_count
+# Enforce both proxy count and trusted proxies
+ipw = IpWare(proxy_count=1, proxy_list=["198.84.193.157"])
+
+# Example usage in non-strict mode:
+# X-Forwarded-For format: <fake>, <client>, <proxy1>, <proxy2>
+# At least `proxy_count` number of proxies
+ip, trusted_route = ipw.get_client_ip(meta=request.META)
+
+# Example usage in strict mode:
+# X-Forwarded-For format: <client>, <proxy1>
+# Exact `proxy_count` number of proxies
 ip, trusted_route = ipw.get_client_ip(meta=request.META, strict=True)
 ```
 

python_ipware-2.0.4.dist-info/RECORD

@@ -0,0 +1,9 @@
+python_ipware/__init__.py,sha256=TCZx4mt5Gxr2D_zNU6j0ynopdsAN_v4xeiTWz1OXSpY,87
+python_ipware/__version__.py,sha256=ZOg41aCgKEuObK5WhegikXektFWPJaeZ-TMDh0Ke95M,22
+python_ipware/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+python_ipware/python_ipware.py,sha256=sN3NeWWs96beGzI9x3YZ9ucYnMIZh1Q4fWOOIm2_P-s,11987
+python_ipware-2.0.4.dist-info/LICENSE,sha256=MLpNxpqfTc4TLdcDk3x6k7Vz4lJGBNLV-SxQZlFMDU8,1103
+python_ipware-2.0.4.dist-info/METADATA,sha256=-KqYlSwY52kwnnAMA7ym2A31L1yX8BffjMdZ3I32Wl0,15420
+python_ipware-2.0.4.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+python_ipware-2.0.4.dist-info/top_level.txt,sha256=URE4dvjpReJtRHyQpJqoBow5EWt_RqVXFn85B9Tq5Xw,14
+python_ipware-2.0.4.dist-info/RECORD,,

{python_ipware-2.0.2.dist-info → python_ipware-2.0.4.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.42.0)
+Generator: bdist_wheel (0.43.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

python_ipware-2.0.2.dist-info/RECORD

@@ -1,9 +0,0 @@
-python_ipware/__init__.py,sha256=TCZx4mt5Gxr2D_zNU6j0ynopdsAN_v4xeiTWz1OXSpY,87
-python_ipware/__version__.py,sha256=tATvJM5shAzfspHYjdVwpV2w3-gDA119NlEYi5X2lFY,22
-python_ipware/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-python_ipware/python_ipware.py,sha256=V6yEmV2kBIrVqWf8eitUO1YFVIL18TdGdh37t2dHf9c,12068
-python_ipware-2.0.2.dist-info/LICENSE,sha256=MLpNxpqfTc4TLdcDk3x6k7Vz4lJGBNLV-SxQZlFMDU8,1103
-python_ipware-2.0.2.dist-info/METADATA,sha256=2H8IHP6sUsA-2I8IqbJDSOPVsBAKFRn-dBUD7ay_TP0,14814
-python_ipware-2.0.2.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
-python_ipware-2.0.2.dist-info/top_level.txt,sha256=URE4dvjpReJtRHyQpJqoBow5EWt_RqVXFn85B9Tq5Xw,14
-python_ipware-2.0.2.dist-info/RECORD,,