portforward 0.6.2__cp311-cp311-macosx_11_0_arm64.whl → 0.7.1__cp311-cp311-macosx_11_0_arm64.whl

portforward/__init__.py

@@ -2,7 +2,7 @@
 Easy Kubernetes Port-Forward For Python
 """
 
-__version__ = "0.6.2"
+__version__ = "0.7.1"
 
 import asyncio
 import contextlib
@@ -57,7 +57,7 @@ def forward(
 
     :param namespace: Target namespace
     :param pod_or_service: Name of target Pod or service
-    :param from_port: Local port
+    :param from_port: Local port, or 0 to use any free port
     :param to_port: Port inside the pod
     :param config_path: Path for loading kube config
     :param waiting: Delay in seconds
@@ -129,6 +129,11 @@ class PortForwarder:
     def is_stopped(self):
         return self._async_forwarder.is_stopped
 
+    @property
+    def from_port(self):
+        """The local port that was actually used for the portforward."""
+        return self._async_forwarder.from_port
+
 
 class AsyncPortForwarder:
     """Use the same args as the `portforward.forward` method."""
@@ -158,11 +163,12 @@ class AsyncPortForwarder:
         bind_ip = _validate_ip_address(bind_ip)
 
         self.actual_pod_name: str = ""
+        self.from_port: int = 0
         self._is_stopped: bool = False
         self.bind_address: str = f"{bind_ip}:{from_port}"
 
     async def forward(self):
-        self.actual_pod_name = await _portforward.forward(
+        (self.actual_pod_name, self.from_port) = await _portforward.forward(
             self.namespace,
             self.pod_or_service,
             self.bind_address,
@@ -193,14 +199,11 @@ def _validate_str(arg_name, arg) -> str:
     if len(arg) == 0:
         raise ValueError(f"{arg_name} cannot be an empty str")
 
-    if "/" in arg:
-        raise ValueError(f"{arg_name} contains illegal character '/'")
-
     return arg
 
 
 def _validate_port(arg_name, arg) -> int:
-    in_range = arg and 0 < arg < 65536
+    in_range = arg is not None and 0 <= arg < 65536
     if arg is None or not isinstance(arg, int) or not in_range:
         raise ValueError(f"{arg_name}={arg} is not a valid port")
 
@@ -247,7 +250,4 @@ def _kube_context(context):
     if not isinstance(context, str):
         raise ValueError(f"kube_context={context} is not a valid str")
 
-    if "/" in context:
-        raise ValueError("kube_context contains illegal character '/'")
-
     return context

{portforward-0.6.2.dist-info → portforward-0.7.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: portforward
-Version: 0.6.2
+Version: 0.7.1
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
@@ -64,11 +64,11 @@ Wheels are available for:
 
 with Python versions:
 
-* 3.8
 * 3.9
 * 3.10
 * 3.11
 * 3.12
+* 3.13
 
 **Requirements for installation from source**
 

portforward-0.7.1.dist-info/RECORD

@@ -0,0 +1,9 @@
+portforward-0.7.1.dist-info/METADATA,sha256=KZ4FcPovhDaV4zP8KIqEgbkiP2XS0bR8FazwrquzGYc,3734
+portforward-0.7.1.dist-info/WHEEL,sha256=8hoTVLxyLdG351Jq1HozDQCHHiKu32mfNA2_wpcO9P4,106
+portforward-0.7.1.dist-info/license_files/LICENSE,sha256=n2aq0UH0YZkyF_5hougjNi5gzXIUapEEqEUn6FwAcFE,1075
+portforward-0.7.1.dist-info/license_files/AUTHORS.rst,sha256=YQwE3_FUEuGVHbxYUa4NQMlG28QBGwcCYEoa2MP9Xgk,163
+portforward/__init__.py,sha256=6j9B55t1hQy_eRL9oM4TRvfvXOsc9Ifwxg92zbrjMaM,6872
+portforward/_portforward.pyi,sha256=KZSR_2INAUDtpwbVFA9e6cLs3KBwgMw-hgtirmMRZgY,336
+portforward/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+portforward/_portforward.cpython-311-darwin.so,sha256=JVpGUZZKKmLkKLzmZMs0eaQzYfdCHc8GGrs81HgwAaE,9517624
+portforward-0.7.1.dist-info/RECORD,,

portforward-0.6.2.dist-info/RECORD

@@ -1,9 +0,0 @@
-portforward-0.6.2.dist-info/METADATA,sha256=0AZ3nsSc26Xsqm1TK9fBJUoaUZ8XJDEfPt4Wtcbn1tM,3733
-portforward-0.6.2.dist-info/WHEEL,sha256=8hoTVLxyLdG351Jq1HozDQCHHiKu32mfNA2_wpcO9P4,106
-portforward-0.6.2.dist-info/license_files/LICENSE,sha256=n2aq0UH0YZkyF_5hougjNi5gzXIUapEEqEUn6FwAcFE,1075
-portforward-0.6.2.dist-info/license_files/AUTHORS.rst,sha256=YQwE3_FUEuGVHbxYUa4NQMlG28QBGwcCYEoa2MP9Xgk,163
-portforward/__init__.py,sha256=dIOPdTMLHUgZ2VeG-UQoGUIp515tikAGmSIFKQZkxXU,6809
-portforward/_portforward.pyi,sha256=KZSR_2INAUDtpwbVFA9e6cLs3KBwgMw-hgtirmMRZgY,336
-portforward/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-portforward/_portforward.cpython-311-darwin.so,sha256=8iXmpFbJJs8lqSM_YZYmlpS3nErJsDh-DEliugYIhVU,9663960
-portforward-0.6.2.dist-info/RECORD,,