simplysocket 0.1.0__tar.gz

simplysocket-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 simplysocket contributors
+
+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 NONINFRINGEMENT. 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.

simplysocket-0.1.0/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.4
+Name: simplysocket
+Version: 0.1.0
+Summary: Small helpers for creating standard-library sockets
+License-Expression: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# simplysocket
+
+`simplysocket` is a small helper for creating Python standard-library sockets
+using familiar family and protocol names. It has no runtime dependencies.
+
+## Installation
+
+```console
+python -m pip install simplysocket
+```
+
+## Usage
+
+```python
+from simplysocket import socket
+
+tcp_socket = socket.defaultSocket()
+udp_socket = socket.createSocket(socketType="UDP")
+ipv6_socket = socket.createSocket(socketFamily="ipv6")
+
+for sock in (tcp_socket, udp_socket, ipv6_socket):
+    sock.close()
+```
+
+`createSocket` supports the families `v4`, `ipv4`, `inet`, `ip4`, `v6`,
+`ipv6`, `inet6`, `ip6`, and `bluetooth`; and the types `TCP`, `UDP`, and
+`RAW`. Omitting the family or type selects IPv4 or TCP, respectively.
+Unsupported family or type names raise `ValueError`. Bluetooth raises
+`NotImplementedError` on platforms where Python does not expose Bluetooth
+sockets. Creating raw sockets may require elevated operating-system
+permissions.
+
+## Development
+
+Build and validate the distribution with:
+
+```console
+python -m pip install --upgrade build twine
+python -m unittest discover -s tests
+python -m build
+python -m twine check dist/*
+```
+
+Upload only after reviewing the built artifacts and confirming the project
+name and release metadata:
+
+```console
+python -m twine upload dist/*
+```
+
+## License
+
+Distributed under the MIT License. See [LICENSE](LICENSE).

simplysocket-0.1.0/README.md

@@ -0,0 +1,53 @@
+# simplysocket
+
+`simplysocket` is a small helper for creating Python standard-library sockets
+using familiar family and protocol names. It has no runtime dependencies.
+
+## Installation
+
+```console
+python -m pip install simplysocket
+```
+
+## Usage
+
+```python
+from simplysocket import socket
+
+tcp_socket = socket.defaultSocket()
+udp_socket = socket.createSocket(socketType="UDP")
+ipv6_socket = socket.createSocket(socketFamily="ipv6")
+
+for sock in (tcp_socket, udp_socket, ipv6_socket):
+    sock.close()
+```
+
+`createSocket` supports the families `v4`, `ipv4`, `inet`, `ip4`, `v6`,
+`ipv6`, `inet6`, `ip6`, and `bluetooth`; and the types `TCP`, `UDP`, and
+`RAW`. Omitting the family or type selects IPv4 or TCP, respectively.
+Unsupported family or type names raise `ValueError`. Bluetooth raises
+`NotImplementedError` on platforms where Python does not expose Bluetooth
+sockets. Creating raw sockets may require elevated operating-system
+permissions.
+
+## Development
+
+Build and validate the distribution with:
+
+```console
+python -m pip install --upgrade build twine
+python -m unittest discover -s tests
+python -m build
+python -m twine check dist/*
+```
+
+Upload only after reviewing the built artifacts and confirming the project
+name and release metadata:
+
+```console
+python -m twine upload dist/*
+```
+
+## License
+
+Distributed under the MIT License. See [LICENSE](LICENSE).

simplysocket-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "simplysocket"
+version = "0.1.0"
+description = "Small helpers for creating standard-library sockets"
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+license-files = ["LICENSE"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Topic :: System :: Networking",
+]
+
+[tool.setuptools]
+py-modules = ["simplysocket"]

simplysocket-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

simplysocket-0.1.0/simplysocket.egg-info/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.4
+Name: simplysocket
+Version: 0.1.0
+Summary: Small helpers for creating standard-library sockets
+License-Expression: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# simplysocket
+
+`simplysocket` is a small helper for creating Python standard-library sockets
+using familiar family and protocol names. It has no runtime dependencies.
+
+## Installation
+
+```console
+python -m pip install simplysocket
+```
+
+## Usage
+
+```python
+from simplysocket import socket
+
+tcp_socket = socket.defaultSocket()
+udp_socket = socket.createSocket(socketType="UDP")
+ipv6_socket = socket.createSocket(socketFamily="ipv6")
+
+for sock in (tcp_socket, udp_socket, ipv6_socket):
+    sock.close()
+```
+
+`createSocket` supports the families `v4`, `ipv4`, `inet`, `ip4`, `v6`,
+`ipv6`, `inet6`, `ip6`, and `bluetooth`; and the types `TCP`, `UDP`, and
+`RAW`. Omitting the family or type selects IPv4 or TCP, respectively.
+Unsupported family or type names raise `ValueError`. Bluetooth raises
+`NotImplementedError` on platforms where Python does not expose Bluetooth
+sockets. Creating raw sockets may require elevated operating-system
+permissions.
+
+## Development
+
+Build and validate the distribution with:
+
+```console
+python -m pip install --upgrade build twine
+python -m unittest discover -s tests
+python -m build
+python -m twine check dist/*
+```
+
+Upload only after reviewing the built artifacts and confirming the project
+name and release metadata:
+
+```console
+python -m twine upload dist/*
+```
+
+## License
+
+Distributed under the MIT License. See [LICENSE](LICENSE).

simplysocket-0.1.0/simplysocket.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+simplysocket.py
+simplysocket.egg-info/PKG-INFO
+simplysocket.egg-info/SOURCES.txt
+simplysocket.egg-info/dependency_links.txt
+simplysocket.egg-info/top_level.txt
+tests/test_simplysocket.py

simplysocket-0.1.0/simplysocket.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

simplysocket-0.1.0/simplysocket.egg-info/top_level.txt

@@ -0,0 +1 @@
+simplysocket

simplysocket-0.1.0/simplysocket.py

@@ -0,0 +1,76 @@
+"""Small helpers for creating standard-library sockets."""
+
+import socket as _socket
+from typing import Optional
+
+__all__ = ["socket"]
+
+
+class socket:
+    """Factory for TCP, UDP, raw, IPv4, IPv6, and Bluetooth sockets."""
+
+    TCP = _socket.SOCK_STREAM
+    UDP = _socket.SOCK_DGRAM
+    RAW_SOCKET = _socket.SOCK_RAW
+
+    IPv4 = _socket.AF_INET
+    IPv6 = _socket.AF_INET6
+    BLUETOOTH = getattr(_socket, "AF_BLUETOOTH", None)
+
+    @staticmethod
+    def defaultSocket() -> _socket.socket:
+        """Create a default IPv4 TCP socket."""
+        return _socket.socket(_socket.AF_INET, _socket.SOCK_STREAM)
+
+    @classmethod
+    def createSocket(
+        cls,
+        socketFamily: Optional[str] = None,
+        socketType: Optional[str] = None,
+    ) -> _socket.socket:
+        """Create a socket for a supported family and protocol type.
+
+        Families accept ``v4``, ``ipv4``, ``inet``, ``ip4``, ``v6``,
+        ``ipv6``, ``inet6``, ``ip6``, or ``bluetooth``. Types accept
+        ``TCP``, ``UDP``, or ``RAW``. Omitting either argument selects
+        IPv4 or TCP, respectively.
+
+        Raises:
+            ValueError: If the requested family or type is not supported.
+            NotImplementedError: If Bluetooth sockets are unavailable.
+        """
+        family = socketFamily.lower() if socketFamily is not None else "v4"
+        socket_kind = socketType.upper() if socketType is not None else "TCP"
+
+        families = {
+            "v4": cls.IPv4,
+            "ipv4": cls.IPv4,
+            "inet": cls.IPv4,
+            "ip4": cls.IPv4,
+            "v6": cls.IPv6,
+            "ipv6": cls.IPv6,
+            "inet6": cls.IPv6,
+            "ip6": cls.IPv6,
+        }
+        if family in families:
+            family_id = families[family]
+        elif family == "bluetooth":
+            if cls.BLUETOOTH is None:
+                raise NotImplementedError(
+                    "Bluetooth sockets are not supported on this platform"
+                )
+            family_id = cls.BLUETOOTH
+        else:
+            raise ValueError(f"Unsupported socket family: {socketFamily!r}")
+
+        socket_types = {
+            "TCP": cls.TCP,
+            "UDP": cls.UDP,
+            "RAW": cls.RAW_SOCKET,
+        }
+        try:
+            socket_type = socket_types[socket_kind]
+        except KeyError:
+            raise ValueError(f"Unsupported socket type: {socketType!r}") from None
+
+        return _socket.socket(family_id, socket_type)

simplysocket-0.1.0/tests/test_simplysocket.py

@@ -0,0 +1,55 @@
+import socket as standard_socket
+import unittest
+
+from simplysocket import socket
+
+
+class SocketFactoryTests(unittest.TestCase):
+    def test_default_socket_is_ipv4_tcp(self):
+        sock = socket.defaultSocket()
+        try:
+            self.assertEqual(sock.family, standard_socket.AF_INET)
+            self.assertEqual(sock.type, standard_socket.SOCK_STREAM)
+        finally:
+            sock.close()
+
+    def test_create_socket_defaults_to_ipv4_tcp(self):
+        sock = socket.createSocket()
+        try:
+            self.assertEqual(sock.family, standard_socket.AF_INET)
+            self.assertEqual(sock.type, standard_socket.SOCK_STREAM)
+        finally:
+            sock.close()
+
+    def test_create_udp_socket(self):
+        sock = socket.createSocket(socketType="udp")
+        try:
+            self.assertEqual(sock.family, standard_socket.AF_INET)
+            self.assertEqual(sock.type, standard_socket.SOCK_DGRAM)
+        finally:
+            sock.close()
+
+    def test_create_ipv6_socket(self):
+        sock = socket.createSocket(socketFamily="IPv6")
+        try:
+            self.assertEqual(sock.family, standard_socket.AF_INET6)
+        finally:
+            sock.close()
+
+    def test_unknown_family_raises_value_error(self):
+        with self.assertRaisesRegex(ValueError, "Unsupported socket family"):
+            socket.createSocket(socketFamily="unknown")
+
+    def test_unknown_type_raises_value_error(self):
+        with self.assertRaisesRegex(ValueError, "Unsupported socket type"):
+            socket.createSocket(socketType="unknown")
+
+    def test_bluetooth_without_platform_support_raises(self):
+        if socket.BLUETOOTH is not None:
+            self.skipTest("This platform exposes Bluetooth socket support")
+        with self.assertRaisesRegex(NotImplementedError, "Bluetooth sockets"):
+            socket.createSocket(socketFamily="bluetooth")
+
+
+if __name__ == "__main__":
+    unittest.main()