Mercurial > pub > dyncall > bindings
annotate python/pydc/README.txt @ 34:2682a627168c
- breaking changes:
* restrict 'Z' conversions to immutable types
* restrict 'p' to mutable types (and handles)
author | Tassilo Philipp |
---|---|
date | Sun, 12 Apr 2020 19:37:37 +0200 |
parents | baf087cf5971 |
children | 75fe1dec0eb4 |
rev | line source |
---|---|
0 | 1 dyncall python bindings |
28 | 2 Copyright 2007-2016 Daniel Adler |
3 2018-2020 Tassilo Philipp | |
4 | |
5 Dec 4, 2007: initial | |
6 Mar 22, 2016: update to dyncall 0.9, includes breaking sig char changes | |
7 Apr 19, 2018: update to dyncall 1.0 | |
8 Apr 7, 2020: update to dyncall 1.1, Python 3 support, using the Capsule | |
9 API, as well as support for python unicode strings | |
34 | 10 Apr 11, 2020: support for getting loaded library path |
11 Apr 12, 2020: breaking change: restrict 'Z' conversions to immutable types | |
12 and 'p' to mutable types (and handles) | |
5 | 13 |
0 | 14 |
7 | 15 BUILD/INSTALLATION |
16
a40084782546
- added support for more return values to python binding
cslag
parents:
10
diff
changeset
|
16 ================== |
4 | 17 |
18 1) make sure dyncall is built and libraries/headers are in include paths or | |
19 CFLAGS points to them, etc. | |
20 | |
10 | 21 2) Build and install this extension with: |
16
a40084782546
- added support for more return values to python binding
cslag
parents:
10
diff
changeset
|
22 |
a40084782546
- added support for more return values to python binding
cslag
parents:
10
diff
changeset
|
23 python setup.py install |
a40084782546
- added support for more return values to python binding
cslag
parents:
10
diff
changeset
|
24 |
28 | 25 Building a wheel package isn't supported, currently. |
4 | 26 |
27 | |
0 | 28 API |
16
a40084782546
- added support for more return values to python binding
cslag
parents:
10
diff
changeset
|
29 === |
0 | 30 |
31 libhandle = load(libpath) | |
5 | 32 funcptr = find(libhandle, symbolname) |
33 call(funcptr, signature, ...) | |
29 | 34 free(libhandle) |
0 | 35 |
7 | 36 |
0 | 37 SIGNATURE FORMAT |
16
a40084782546
- added support for more return values to python binding
cslag
parents:
10
diff
changeset
|
38 ================ |
0 | 39 |
40 is a formated string | |
41 | |
42 format: "xxxxx)y" | |
43 | |
16
a40084782546
- added support for more return values to python binding
cslag
parents:
10
diff
changeset
|
44 x is positional parameter-type charcode, y is result-type charcode |
0 | 45 |
34 | 46 SIG | FROM PYTHON 2 | FROM PYTHON 3 | C/C++ | TO PYTHON 2 | TO PYTHON 3 |
47 ----+---------------------------------+---------------------------------+---------------------------------+--------------------------------------+--------------------------------------- | |
48 'v' | | | void | None (Py_None) (e.g. ret of "...)v") | None (Py_None) (e.g. ret of "...)v") | |
49 'B' | bool (PyBool) | bool (PyBool) # | int/bool | bool (PyBool) | bool (PyBool) @ | |
50 'c' | int (PyInt) % | int (PyLong) % | char | int (PyInt) | int (PyLong) | |
51 | str (with only a single char) % | str (with only a single char) % | char | int (PyInt) | int (PyLong) | |
52 'C' | int (PyInt) % | int (PyLong) % | unsigned char | int (PyInt) | int (PyLong) | |
53 | str (with only a single char) % | str (with only a single char) % | unsigned char | int (PyInt) | int (PyLong) | |
54 's' | int (PyInt) % | int (PyLong) % | short | int (PyInt) | int (PyLong) | |
55 'S' | int (PyInt) % | int (PyLong) % | unsigned short | int (PyInt) | int (PyLong) | |
56 'i' | int (PyInt) | int (PyLong) | int | int (PyInt) | int (PyLong) | |
57 'I' | int (PyInt) | int (PyLong) | unsigned int | int (PyInt) | int (PyLong) | |
58 'j' | int (PyInt) | int (PyLong) | long | int (PyInt) | int (PyLong) | |
59 'J' | int (PyInt) | int (PyLong) | unsigned long | int (PyInt) | int (PyLong) | |
60 'l' | int (PyInt) | int (PyLongLong) | long long | long (PyLong) | int (PyLong) | |
61 | long (PyLong) | - | long long | long (PyLong) | int (PyLong) | |
62 'L' | int (PyInt) | int (PyLongLong) | unsigned long long | long (PyLong) | int (PyLong) | |
63 | long (PyLong) | - | unsigned long long | long (PyLong) | int (PyLong) | |
64 'f' | float (PyFloat) $ | float (PyFloat) $ | float | float (PyFloat) ^ | float (PyFloat) ^ | |
65 'd' | float (PyFloat) | float (PyFloat) | double | float (PyFloat) | float (PyFloat) | |
66 'p' | bytearray (PyByteArray) & | bytearray (PyByteArray) & | void* | int,long (Py_ssize_t) | int (Py_ssize_t) | |
67 | int (PyInt) | int (PyLong) | void* | int,long (Py_ssize_t) | int (Py_ssize_t) | |
68 | long (PyLong) | - | void* | int,long (Py_ssize_t) | int (Py_ssize_t) | |
69 'Z' | str (PyString) ! | str (PyUnicode) ! | const char* (UTF-8 for unicode) | int (PyString) | str (PyUnicode) | |
70 | unicode (PyUnicode) ! | - | const char* (UTF-8 for unicode) | int (PyString) | str (PyUnicode) | |
71 | - | bytes (PyBytes) ! | const char* (UTF-8 for unicode) | int (PyString) | str (PyUnicode) | |
72 | bytearray (PyByteArray) ! | bytearray (PyByteArray) ! | const char* (UTF-8 for unicode) | int (PyString) | str (PyUnicode) | |
0 | 73 |
29 | 74 # converted to 1 if True and 0 otherwise |
75 @ converted to False if 0 and True otherwise | |
34 | 76 % range/length checked |
29 | 77 $ cast to single precision |
78 ^ cast to double precision | |
34 | 79 & mutable buffer when passed to C |
80 ! immutable buffer when passed to C, as strings (in any form) are considered objects, not buffers | |
16
a40084782546
- added support for more return values to python binding
cslag
parents:
10
diff
changeset
|
81 |
a40084782546
- added support for more return values to python binding
cslag
parents:
10
diff
changeset
|
82 TODO |
a40084782546
- added support for more return values to python binding
cslag
parents:
10
diff
changeset
|
83 ==== |
a40084782546
- added support for more return values to python binding
cslag
parents:
10
diff
changeset
|
84 |
28 | 85 - signature suffixes used to indicate calling conventions are not supported yet! |
86 - callback support | |
5 | 87 |
30 | 88 BUGS |
89 ==== | |
90 | |
91 - when using Python 2, the dyncall call vm object is never dcFree'd, as there | |
92 is no way to call a "freefunc" as introduced with Python 3 module definitions | |
93 (see PEP 3121 for details) | |
94 |