portforward 0.6.2__cp39-none-win32.whl → 0.7.1__cp39-none-win32.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
@@ -19,8 +19,8 @@ License: MIT License
 Requires-Python: >=3.7
 Description-Content-Type: text/x-rst; charset=UTF-8
 Project-URL: Changelog, https://github.com/pytogo/portforward/blob/main/HISTORY.rst
-Project-URL: Documentation, https://portforward.readthedocs.io
 Project-URL: Repository, https://github.com/pytogo/portforward.git
+Project-URL: Documentation, https://portforward.readthedocs.io
 
 ===========
 portforward
@@ -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=XYy4LPpLRtncTbRmH4lPc9pX6WPUmGa_R4sO3g9b05I,3845
+portforward-0.7.1.dist-info/WHEEL,sha256=-pOKL-1cllc2H3p_NoLr-36gcqPykwR8M9OfdKqys-Q,92
+portforward-0.7.1.dist-info/license_files/LICENSE,sha256=_-nf_xCZIwUkKBXXiYR-fjbXGhmx6V-7b3jSKoolnO4,1096
+portforward-0.7.1.dist-info/license_files/AUTHORS.rst,sha256=mskf9O-AvJL9NxWUYX0nJRuLfBw7SH-T-H-pPYLW-xI,176
+portforward/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+portforward/_portforward.pyi,sha256=UDGuRjzq4fFH2vyVMKGpsBQvYq8MK0LfFsM1FxljTX4,353
+portforward/__init__.py,sha256=XvIOYJ8iCV9tgefojXHItQ_-doS9bFhVpbsXJ_9XLH0,7125
+portforward/_portforward.cp39-win32.pyd,sha256=vLtrf8tDlA0rKiBhugySd_GOKm0VABOXrFXXRcd99s8,6594048
+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=70RzsEV8M2YzoV5uVGymAm-y_Ntm1mg91AYrFio6hmE,3844
-portforward-0.6.2.dist-info/WHEEL,sha256=-pOKL-1cllc2H3p_NoLr-36gcqPykwR8M9OfdKqys-Q,92
-portforward-0.6.2.dist-info/license_files/LICENSE,sha256=_-nf_xCZIwUkKBXXiYR-fjbXGhmx6V-7b3jSKoolnO4,1096
-portforward-0.6.2.dist-info/license_files/AUTHORS.rst,sha256=mskf9O-AvJL9NxWUYX0nJRuLfBw7SH-T-H-pPYLW-xI,176
-portforward/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-portforward/_portforward.pyi,sha256=UDGuRjzq4fFH2vyVMKGpsBQvYq8MK0LfFsM1FxljTX4,353
-portforward/__init__.py,sha256=j6RtAqZa6JIEgWbl5n1Tudc-HeewIJAqcsoVBukqBDg,7062
-portforward/_portforward.cp39-win32.pyd,sha256=lP0NIIpLXBVkjYhIJ9HpVYXpXqimm9FX8Qi1vaAkEKY,6651392
-portforward-0.6.2.dist-info/RECORD,,