private-attribute-cpp 1.0.11__cp314-cp314t-win32.whl → 1.2.4__cp314-cp314t-win32.whl

private_attribute.pyi

@@ -20,3 +20,18 @@ class PrivateAttrType(type):
 class PrivateAttrBase(metaclass=PrivateAttrType):
     __slots__ = ()
     __private_attrs__ = ()
+
+
+class private_temp:
+    @property
+    def name(self) -> str: ...
+    @property
+    def bases(self) -> tuple[type]: ...
+    @property
+    def attrs(self) -> dict[str, Any]: ...
+    @property
+    def kwds(self) -> dict[str, Any]: ...
+
+def prepare(name: str, bases: tuple, attrs: PrivateAttrDict, **kwds) -> private_temp: ...
+def postprocess(typ: type, temp: private_temp) -> None: ...
+def register_metaclass(typ: type) -> None: ...

{private_attribute_cpp-1.0.11.dist-info → private_attribute_cpp-1.2.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: private_attribute_cpp
-Version: 1.0.11
+Version: 1.2.4
 Summary: A Python package that provides a way to define private attributes in C++ implementation.
 Home-page: https://github.com/Locked-chess-official/private_attribute_cpp
 Author: HuangHaoHua
@@ -21,7 +21,7 @@ Dynamic: summary
 
 This package provide a way to create the private attribute like "C++" does.
 
-## All API
+## All Base API
 
 ```python
 from private_attribute import (PrivateAttrBase, PrivateWrapProxy)      # 1 Import public API
@@ -68,11 +68,11 @@ print(obj.expensive_api_call(10))   # works with all decorators applied
 ```
 
 | # | API | Purpose | Required? |
-|---|----------------------------------------|-------------------------------------------------------|-----------|
+| --- | ---------------------------------------- | ------------------------------------------------------- | ----------- |
 | 1 | PrivateAttrBase | Base class – must inherit | Yes |
-| 1 | PrivateWrapProxy  | Decorator wrapper for arbitrary decorators  | When needed |
-| 2 | private_func=callable  | Custom hidden-name generator  | Optional |
-| 3 | Pass private_func in class definition | Same as above   | Optional |
+| 1 | PrivateWrapProxy | Decorator wrapper for arbitrary decorators | When needed |
+| 2 | private_func=callable | Custom hidden-name generator | Optional |
+| 3 | Pass private_func in class definition | Same as above | Optional |
 | 4 | \_\_private_attrs\_\_ list | Declare which attributes are private | Yes |
 | 5 | @PrivateWrapProxy(...) | Make any decorator compatible with private attributes | When needed |
 | 6 | method.result.xxx chain + dummy wrap | Fix decorator order and name conflicts | When needed |
@@ -138,8 +138,7 @@ class MyClass(PrivateAttrBase):
     def method1(self):
         ...
 
-    @method1.attr_name
-    @PrivateWrapProxy(lambda _: _) # use empty function to wrap
+    @PrivateWrapProxy(method1.attr_name, method1) # Use the argument "method1" to save old func
     def method1(self):
         ...
 
@@ -147,8 +146,7 @@ class MyClass(PrivateAttrBase):
     def method2(self):
         ...
 
-    @method2.attr_name
-    @PrivateWrapProxy(lambda _: _)
+    @PrivateWrapProxy(method2.attr_name, method2) # Use the argument "method2" to save old func
     def method2(self):
         ...
 
@@ -181,6 +179,63 @@ class MyClass(PrivateAttrBase):
     def method2(self):
 ```
 
+## Advanced API
+
+### define your metaclass based on one metaclass
+
+You can define your metaclass based on one metaclass:
+
+```python
+from abc import ABCMeta, abstractmethod
+import private_attribute
+
+class PrivateAbcMeta(ABCMeta):
+    def __new__(cls, name, bases, attrs, **kwargs):
+        temp = private_attribute.prepare(name, bases, attrs, **kwargs)
+        typ = super().__new__(cls, temp.name, temp.base, temp.attrs, **temp.kwds)
+        private_attribute.postprocess(typ, temp)
+        return typ
+
+private_attribute.register_metaclass(PrivateAbcMeta)
+```
+
+By this way you create a metaclass both can behave as ABC and private attribute:
+
+```python
+class MyClass(metaclass=PrivateAbcMeta):
+    __private_attrs__ = ()
+    __slots__ = ()
+
+    @abstractmethod
+    def my_function(self): ...
+
+class MyImplement(MyClass):
+    __private_attrs__ = ("_a",)
+    def __init__(self, value=1):
+        self._a = value
+
+    def my_function(self):
+        return self._a
+```
+
+Finally:
+
+```python
+>>> a = MyImplement(1)
+>>> a.my_function()
+1
+>>> a._a
+Traceback (most recent call last):
+  File "<pyshell#2>", line 1, in <module>
+    a._a
+AttributeError: private attribute
+>>> MyClass()
+Traceback (most recent call last):
+  File "<pyshell#3>", line 1, in <module>
+    MyClass()
+TypeError: Can't instantiate abstract class MyClass without an implementation for abstract method 'my_function'
+```
+
 ## Notes
 
 - All of the private attributes class must contain the `__private_attrs__` attribute.
@@ -199,7 +254,7 @@ MIT
 
 ## Requirement
 
-This package require the c++ module "picosha2" to compute the sha256 hash.
+This package require the c++ module "[picosha2](https://github.com/okdshin/PicoSHA2)" to compute the sha256 hash.
 
 ## Support
 

private_attribute_cpp-1.2.4.dist-info/RECORD

@@ -0,0 +1,6 @@
+private_attribute.cp314t-win32.pyd,sha256=ijvAzoiikfzrCJCynxjdz_LEhg67RErs9I-SFY01-Yk,147968
+private_attribute.pyi,sha256=R4rCgSPyIhOT28ewAeCmuWbaMO3uhaEATpBL8P-h7Uw,1251
+private_attribute_cpp-1.2.4.dist-info/METADATA,sha256=9vpCc7jFgzMcTmpG9yM0XJKdWO7QbiZMKj1QJKagLBk,8939
+private_attribute_cpp-1.2.4.dist-info/WHEEL,sha256=_oANSYd4_nQB_UF_JOhTk-kt5AphIxnRYMKIVCyNu0w,99
+private_attribute_cpp-1.2.4.dist-info/top_level.txt,sha256=vOfJKfFO3AgjCIvyK6ppYDBTyJSsEAkf5w34knGZ3JE,19
+private_attribute_cpp-1.2.4.dist-info/RECORD,,

{private_attribute_cpp-1.0.11.dist-info → private_attribute_cpp-1.2.4.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.1)
 Root-Is-Purelib: false
 Tag: cp314-cp314t-win32
 

private_attribute_cpp-1.0.11.dist-info/RECORD

@@ -1,6 +0,0 @@
-private_attribute.cp314t-win32.pyd,sha256=LlBEvfaWycsz1YvFNXWLU2LZI-777dizHGELqRBBuI4,139776
-private_attribute.pyi,sha256=pWpoUdy38dA12n8wyE-knOtoQAd7ENj-f14pxwyHijQ,804
-private_attribute_cpp-1.0.11.dist-info/METADATA,sha256=p5pL0jWFT-3Z7R88-d6sALWz8Flh23AjGCJv3FvbdLc,7410
-private_attribute_cpp-1.0.11.dist-info/WHEEL,sha256=QZj5mezaA5oNm6LDNW4xgYLgBYwS1DTKsN1RAjQk9mo,98
-private_attribute_cpp-1.0.11.dist-info/top_level.txt,sha256=vOfJKfFO3AgjCIvyK6ppYDBTyJSsEAkf5w34knGZ3JE,19
-private_attribute_cpp-1.0.11.dist-info/RECORD,,