copyable 0.0.0.dev0__tar.gz → 0.0.0.dev2__tar.gz

{copyable-0.0.0.dev0/src/copyable.egg-info → copyable-0.0.0.dev2}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: copyable
-Version: 0.0.0.dev0
-Summary: copyable
+Version: 0.0.0.dev2
+Summary: This project provides a copyable ABC.
 Author-email: Johannes <johannes.programming@gmail.com>
 License: The MIT License (MIT)
         
@@ -27,6 +27,7 @@ License: The MIT License (MIT)
 Project-URL: Download, https://pypi.org/project/copyable/#files
 Project-URL: Index, https://pypi.org/project/copyable/
 Project-URL: Source, https://github.com/johannes-programming/copyable/
+Project-URL: Website, https://copyable.johannes-programming.online/
 Classifier: Development Status :: 2 - Pre-Alpha
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
@@ -38,6 +39,7 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.11
 Description-Content-Type: text/x-rst
 License-File: LICENSE.txt
+Requires-Dist: setdoc<2,>=1.2.7
 Dynamic: license-file
 
 ========

{copyable-0.0.0.dev0 → copyable-0.0.0.dev2}/pyproject.toml

@@ -18,13 +18,15 @@ classifiers = [
     "Programming Language :: Python :: 3 :: Only",
     "Typing :: Typed",
 ]
-dependencies = []
-description = "copyable"
+dependencies = [
+    "setdoc>=1.2.7,<2",
+]
+description = "This project provides a copyable ABC."
 keywords = []
 name = "copyable"
 readme = "README.rst"
 requires-python = ">=3.11"
-version = "0.0.0.dev0"
+version = "0.0.0.dev2"
 
 [project.license]
 file = "LICENSE.txt"
@@ -33,3 +35,4 @@ file = "LICENSE.txt"
 Download = "https://pypi.org/project/copyable/#files"
 Index = "https://pypi.org/project/copyable/"
 Source = "https://github.com/johannes-programming/copyable/"
+Website = "https://copyable.johannes-programming.online/"

{copyable-0.0.0.dev0 → copyable-0.0.0.dev2}/src/copyable/__init__.py

@@ -1,5 +1,2 @@
 from copyable.core import *
 from copyable.tests import *
-
-if __name__ == "__main__":
-    main()

copyable-0.0.0.dev2/src/copyable/core/__init__.py

@@ -0,0 +1,16 @@
+from abc import ABC, abstractmethod
+from typing import *
+
+import setdoc
+
+__all__ = ["Copyable"]
+
+
+class Copyable(ABC):
+    __slots__ = ()
+
+    __hash__ = None
+
+    @abstractmethod
+    @setdoc.basic
+    def copy(self: Self) -> Self: ...

copyable-0.0.0.dev2/src/copyable/tests/test_0.py

@@ -0,0 +1,60 @@
+import inspect
+import unittest
+from abc import ABCMeta
+from typing import *
+
+from copyable.core import Copyable
+
+
+class TestCopyable(unittest.TestCase):
+    def test_is_abstract(self: Self) -> None:
+        # Copyable must be an abstract base class and not directly instantiable.
+        self.assertIsInstance(Copyable, ABCMeta)
+        with self.assertRaises(TypeError):
+            Copyable()  # type: ignore[abstract]
+
+    def test_slots_hash_and_abstractmethod(self: Self) -> None:
+        copy_attr: Any
+        # __slots__ is explicitly empty and __hash__ disabled.
+        self.assertTrue(hasattr(Copyable, "__slots__"))
+        self.assertEqual(getattr(Copyable, "__slots__"), ())
+        self.assertIsNone(getattr(Copyable, "__hash__"))
+
+        # "copy" exists and is marked abstract.
+        self.assertTrue(hasattr(Copyable, "copy"))
+        copy_attr = getattr(Copyable, "copy")
+        self.assertTrue(getattr(copy_attr, "__isabstractmethod__", False))
+
+    def test_copy_signature_and_annotations(self: Self) -> None:
+        # Ensure there's a "copy" method and it has type hints present.
+        # Note: runtime "Self" may or may not resolve depending on Python version;
+        # we just verify annotations are present and consistent.
+        hints: dict[str, Any]
+        sig: inspect.Signature
+        params: list[inspect.Parameter]
+        self.assertTrue(callable(getattr(Copyable, "copy")))
+        hints = get_type_hints(Copyable.copy, include_extras=True)
+        self.assertIn("return", hints)
+
+        sig = inspect.signature(Copyable.copy)
+        params = list(sig.parameters.values())
+        self.assertEqual(len(params), 1)
+        self.assertEqual(params[0].name, "self")
+
+    def test_subclass_must_implement_copy(self: Self) -> None:
+        class Bad(Copyable):
+            pass
+
+        class Good(Copyable):
+            def copy(self: Self) -> Self:
+                return self
+
+        g: Good
+        with self.assertRaises(TypeError):
+            Bad()  # still abstract
+        g = Good()
+        self.assertIs(g.copy(), g)
+
+
+if __name__ == "__main__":
+    unittest.main()

copyable-0.0.0.dev2/src/copyable/tests/test_1.py

@@ -0,0 +1,43 @@
+from __future__ import annotations
+
+import unittest
+from typing import *
+
+from copyable.core import Copyable
+
+
+class TestCopyable(unittest.TestCase):
+    def test_copyable_cannot_be_instantiated(self: Self) -> None:
+        with self.assertRaises(TypeError):
+            Copyable()  # abstract
+
+    def test_subclass_without_copy_is_abstract(self: Self) -> None:
+        class Bad(Copyable):
+            pass
+
+        with self.assertRaises(TypeError):
+            Bad()
+
+    def test_copy_returns_same_type_and_new_instance(self: Self) -> None:
+        class Point(Copyable):
+            __slots__ = ("x", "y")
+
+            def __init__(self: Self, x: int, y: int) -> None:
+                self.x = x
+                self.y = y
+
+            def copy(self: Self) -> Self:
+                return type(self)(self.x, self.y)
+
+        p: Point
+        c: Point
+        p = Point(1, 2)
+        c = p.copy()
+
+        self.assertIsInstance(c, Point)
+        self.assertIsNot(c, p)
+        self.assertEqual((c.x, c.y), (p.x, p.y))
+
+
+if __name__ == "__main__":
+    unittest.main()

{copyable-0.0.0.dev0 → copyable-0.0.0.dev2/src/copyable.egg-info}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: copyable
-Version: 0.0.0.dev0
-Summary: copyable
+Version: 0.0.0.dev2
+Summary: This project provides a copyable ABC.
 Author-email: Johannes <johannes.programming@gmail.com>
 License: The MIT License (MIT)
         
@@ -27,6 +27,7 @@ License: The MIT License (MIT)
 Project-URL: Download, https://pypi.org/project/copyable/#files
 Project-URL: Index, https://pypi.org/project/copyable/
 Project-URL: Source, https://github.com/johannes-programming/copyable/
+Project-URL: Website, https://copyable.johannes-programming.online/
 Classifier: Development Status :: 2 - Pre-Alpha
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
@@ -38,6 +39,7 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.11
 Description-Content-Type: text/x-rst
 License-File: LICENSE.txt
+Requires-Dist: setdoc<2,>=1.2.7
 Dynamic: license-file
 
 ========

{copyable-0.0.0.dev0 → copyable-0.0.0.dev2}/src/copyable.egg-info/SOURCES.txt

@@ -4,11 +4,12 @@ README.rst
 pyproject.toml
 setup.cfg
 src/copyable/__init__.py
-src/copyable/__main__.py
 src/copyable.egg-info/PKG-INFO
 src/copyable.egg-info/SOURCES.txt
 src/copyable.egg-info/dependency_links.txt
+src/copyable.egg-info/requires.txt
 src/copyable.egg-info/top_level.txt
 src/copyable/core/__init__.py
 src/copyable/tests/__init__.py
-src/copyable/tests/test_1984.py
+src/copyable/tests/test_0.py
+src/copyable/tests/test_1.py

copyable-0.0.0.dev2/src/copyable.egg-info/requires.txt

@@ -0,0 +1 @@
+setdoc<2,>=1.2.7

copyable-0.0.0.dev0/src/copyable/__main__.py

@@ -1,4 +0,0 @@
-from copyable import main
-
-if __name__ == "__main__":
-    main()

copyable-0.0.0.dev0/src/copyable/core/__init__.py

@@ -1,8 +0,0 @@
-from typing import *
-
-__all__ = ["main"]
-
-
-def main(args: Optional[Iterable] = None) -> None:
-    "This function prints 'Hello World!'."
-    print("Hello World!")

copyable-0.0.0.dev0/src/copyable/tests/test_1984.py

@@ -1,11 +0,0 @@
-import unittest
-from typing import *
-
-
-class Test1984(unittest.TestCase):
-    def test_1984(self: Self) -> None:
-        self.assertEqual(2 + 2, 4, "Ignorance is Strength")
-
-
-if __name__ == "__main__":
-    unittest.main()