random-port 0.0.1__py3-none-any.whl → 0.0.3__py3-none-any.whl

random_port/core.py

@@ -0,0 +1,76 @@
+# The MIT License (MIT)
+#
+# Copyright (C) 2025 Fabrício Barros Cabral
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included
+# in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+import random
+import socket
+from abc import ABC, abstractmethod
+
+
+class RandomPort(ABC):
+    @abstractmethod
+    def value(self) -> int:
+        pass
+
+
+class TcpRandomPort(RandomPort):
+    def __init__(
+        self, host: str = "127.0.0.1", begin: int = 1024, end: int = 65536
+    ) -> None:
+        self.__host = host
+        self.__begin = begin
+        self.__end = end
+
+    def value(self) -> int:
+        def is_tcp_port_in_use(host: str, port: int) -> bool:
+            with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as sckt:
+                try:
+                    sckt.bind((host, port))
+                except OSError:
+                    return True
+                return False
+
+        port = random.randint(self.__begin, self.__end)
+        while is_tcp_port_in_use(self.__host, port):
+            port = random.randint(self.__begin, self.__end)
+        return port
+
+
+class UdpRandomPort(RandomPort):
+    def __init__(
+        self, host: str = "127.0.0.1", begin: int = 1024, end: int = 65536
+    ) -> None:
+        self.__host = host
+        self.__begin = begin
+        self.__end = end
+
+    def value(self) -> int:
+        def is_udp_port_in_use(host: str, port: int) -> bool:
+            with socket.socket(socket.AF_INET, socket.SOCK_DGRAM) as sckt:
+                try:
+                    sckt.bind((host, port))
+                except OSError:
+                    return True
+                return False
+
+        port = random.randint(self.__begin, self.__end)
+        while is_udp_port_in_use(self.__host, port):
+            port = random.randint(self.__begin, self.__end)
+        return port

{random_port-0.0.1.dist-info → random_port-0.0.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: random_port
-Version: 0.0.1
+Version: 0.0.3
 Summary: Generate a free TCP or UDP random port
 Author-email: Fabrício Barros Cabral <fabriciofx@gmail.com>
 License-Expression: MIT
@@ -34,16 +34,20 @@ in your project folder.
 
 ## Usage
 
-- To a TCP random port:
+- To use a TCP random port:
 
 ```python
-port = RandomTcpPort().value()
+from random_port.core import TcpRandomPort
+
+port = TcpRandomPort().value()
 ```
 
-- To a UDP random port:
+- To use a UDP random port:
 
 ```python
-port = RandomUdpPort().value()
+from random_port.core import UdpRandomPort
+
+port = UdpRandomPort().value()
 ```
 
 ## License

random_port-0.0.3.dist-info/RECORD

@@ -0,0 +1,7 @@
+random_port/__init__.py,sha256=WnbD7VqLlKdJ81-K8BGjxrmQLXEu_g-czd-Y73OAezQ,1129
+random_port/core.py,sha256=uzh051hXfHpcZalg6HaoxDIdGgU9ttXzZ35BU2eTL1g,2756
+random_port-0.0.3.dist-info/licenses/LICENSE.txt,sha256=SrFTda5sgSB9hkS5IK7GpSHxGMawR9F_6099TboKYXk,1091
+random_port-0.0.3.dist-info/METADATA,sha256=QK-9jJNyC_0LC-pF57oO0yVF_w5p8P71Mhmdr7m9xOc,2248
+random_port-0.0.3.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
+random_port-0.0.3.dist-info/top_level.txt,sha256=wypEHVVFuk5I-FKJUMe84GL6xu7FPBEa8iRY_oyqxfw,12
+random_port-0.0.3.dist-info/RECORD,,

random_port-0.0.1.dist-info/RECORD

@@ -1,6 +0,0 @@
-random_port/__init__.py,sha256=WnbD7VqLlKdJ81-K8BGjxrmQLXEu_g-czd-Y73OAezQ,1129
-random_port-0.0.1.dist-info/licenses/LICENSE.txt,sha256=SrFTda5sgSB9hkS5IK7GpSHxGMawR9F_6099TboKYXk,1091
-random_port-0.0.1.dist-info/METADATA,sha256=pSEeBfhD9kvWkWxP-lg-keH9BTGWchulFpgZ1PpOOiQ,2152
-random_port-0.0.1.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
-random_port-0.0.1.dist-info/top_level.txt,sha256=wypEHVVFuk5I-FKJUMe84GL6xu7FPBEa8iRY_oyqxfw,12
-random_port-0.0.1.dist-info/RECORD,,