blob: c44d702629cfa8d759390672068a6009367a01b9 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
Metadata-Version: 2.1
Name: pep487
Version: 1.0.1
Summary: PEP487 - Simpler customisation of class creation
Home-page: https://github.com/zaehlwerk/pep487
Author: Gregor Giesen
Author-email: giesen@zaehlwerk.net
License: GPLv3
Description: ===============================================
PEP487: Simpler customisation of class creation
===============================================
This is a backport of PEP487's simpler customisation of class
creation by Martin Teichmann <https://www.python.org/dev/peps/pep-0487/>
for Python versions before 3.6.
PEP487 is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published
by the Free Software Foundation, either version 3 of the License,
or (at your option) any later version.
Subclass init
=============
>>> from pep487 import PEP487Object
>>> class FooBase(PEP487Object):
... foos = set()
...
... def __init_subclass__(cls, **kwargs):
... cls.foos.add(cls.__name__)
Using `PEP487Object` as base class all subclasses of FooBase
will add their name to the common class variable 'foos'.
>>> class Foo1(FooBase):
... pass
>>> class Foo2(FooBase):
... pass
Hence:
>>> FooBase.foos
{'Foo1', 'Foo2'}
Property names and owner
========================
If a class object has a method `__set_name__` upon declaration
of an PEP487Object class, it will be called:
>>> class NamedProperty:
... def __set_name__(self, owner, name):
... self.context = owner
... self.name = name
>>> class Bar(PEP487Object):
... foo = NamedProperty()
... bar = NamedProperty()
Consequently:
>>> Bar.foo.name is 'foo' and Bar.foo.context is Bar
True
>>> Bar.bar.name is 'bar' and Bar.bar.context is Bar
True
Abstract base classes
=====================
Since `PEP487Object` has a custom metaclass, it is incompatible
to `abc.ABC`. Therefore `pep487` contains patched versions of `ABC`
and `ABCMeta`.
Keywords: pep487
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Provides-Extra: test
|
