Mercurial > pub > dyncall > bindings

annotate python/pydc/README.txt @ 24:681db37a300c

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
- prep 1.0 release
author Tassilo Philipp
date Thu, 19 Apr 2018 18:54:47 +0200
parents a40084782546
children edbbd467f50a
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
1 dyncall python bindings
16
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
2 (C) 2007-2016 Daniel Adler
5
bf5625bb6f05 - brought python binding up to dc v0.9
cslag
parents: 4
diff changeset
3 Dec 4, 2007: initial
16
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
4 Mar 22,2016: update to dyncall 0.9, includes breaking sig char changes
24
681db37a300c - prep 1.0 release
Tassilo Philipp
parents: 16
diff changeset
5 Apr 19,2018: update to dyncall 1.0
5
bf5625bb6f05 - brought python binding up to dc v0.9
cslag
parents: 4
diff changeset
6
0
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
7
7
4fd959b3df78 - python binding readme clarifications
cslag
parents: 5
diff changeset
8 BUILD/INSTALLATION
16
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
9 ==================
4
4c5019f00f5b - python binding cleanup
cslag
parents: 0
diff changeset
10
4c5019f00f5b - python binding cleanup
cslag
parents: 0
diff changeset
11 1) make sure dyncall is built and libraries/headers are in include paths or
4c5019f00f5b - python binding cleanup
cslag
parents: 0
diff changeset
12 CFLAGS points to them, etc.
4c5019f00f5b - python binding cleanup
cslag
parents: 0
diff changeset
13
10
6493c9ed4b33 - ruby and python binding readme updates
cslag
parents: 7
diff changeset
14 2) Build and install this extension with:
16
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
15
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
16 python setup.py install
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
17
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
18 Building an egg isn't supported, currently.
4
4c5019f00f5b - python binding cleanup
cslag
parents: 0
diff changeset
19
4c5019f00f5b - python binding cleanup
cslag
parents: 0
diff changeset
20
0
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
21 API
16
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
22 ===
0
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
23
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
24 libhandle = load(libpath)
5
bf5625bb6f05 - brought python binding up to dc v0.9
cslag
parents: 4
diff changeset
25 funcptr = find(libhandle, symbolname)
bf5625bb6f05 - brought python binding up to dc v0.9
cslag
parents: 4
diff changeset
26 call(funcptr, signature, ...)
0
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
27
7
4fd959b3df78 - python binding readme clarifications
cslag
parents: 5
diff changeset
28
0
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
29 SIGNATURE FORMAT
16
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
30 ================
0
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
31
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
32 is a formated string
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
33
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
34 format: "xxxxx)y"
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
35
16
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
36 x is positional parameter-type charcode, y is result-type charcode
0
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
37
16
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
38 SIG | FROM PYTHON | C/C++ | TO PYTHON
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
39 ----+------------------------------------+--------------------+-----------------------------------
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
40 'v' | | void |
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
41 'B' | PyBool | bool | PyBool
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
42 'c' | PyInt (range checked) | char | PyInt
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
43 'C' | PyInt (range checked) | unsigned char | PyInt
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
44 's' | PyInt (range checked) | short | PyInt
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
45 'S' | PyInt (range checked) | unsigned short | PyInt
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
46 'i' | PyInt | int | PyInt
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
47 'I' | PyInt | unsigned int | PyInt
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
48 'j' | PyLong | long | PyLong
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
49 'J' | PyLong | unsigned long | PyLong
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
50 'l' | PyLongLong | long long | PyLongLong
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
51 'L' | PyLongLong | unsigned long long | PyLongLong
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
52 'f' | PyFloat (cast to single precision) | float | PyFloat (cast to double precision)
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
53 'd' | PyFloat | double | PyFloat
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
54 'p' | PyCObject | void* | PyCObject encapsulating a void*
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
55 'Z' | PyString | const char* | PyString
0
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
56
16
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
57
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
58 TODO
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
59 ====
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
60
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
61 - support signature suffixes used to indicate calling conventions, are not supported yet!
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
62 - not sure if returning 'p' is working, creating PyCObject, check and write test code
5
bf5625bb6f05 - brought python binding up to dc v0.9
cslag
parents: 4
diff changeset
63
0
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
64
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
65 BUGS
16
a40084782546 - added support for more return values to python binding
cslag
parents: 10
diff changeset
66 ====
0
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
67
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
68 * build on osx/ppc - link error i386 something... [MacPython 2.4]
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
69
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
70 solution:
4
4c5019f00f5b - python binding cleanup
cslag
parents: 0
diff changeset
71 installation of latest python for os x (MacPython 2.5)
0
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
72
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
73 build log:
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
74
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
75 python setup.py install
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
76 running install
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
77 running build
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
78 running build_py
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
79 creating build
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
80 creating build/lib.macosx-10.3-fat-2.4
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
81 copying pydc.py -> build/lib.macosx-10.3-fat-2.4
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
82 running build_ext
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
83 building 'pydcext' extension
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
84 creating build/temp.macosx-10.3-fat-2.4
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
85 gcc -arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.4u.sdk -fno-strict-aliasing -Wno-long-double -no-cpp-precomp -mno-fused-madd -fno-common -dynamic -DNDEBUG -g -O3 -I../../../dyncall -I../../../dynload -I/Library/Frameworks/Python.framework/Versions/2.4/include/python2.4 -c pydcext.c -o build/temp.macosx-10.3-fat-2.4/pydcext.o
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
86 gcc -arch i386 -arch ppc -isysroot /Developer/SDKs/MacOSX10.4u.sdk -g -bundle -undefined dynamic_lookup build/temp.macosx-10.3-fat-2.4/pydcext.o -L../../../dyncall -L../../../dynload -ldyncall_s -ldynload_s -lstdc++ -o build/lib.macosx-10.3-fat-2.4/pydcext.so
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
87 /usr/bin/ld: for architecture i386
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
88 /usr/bin/ld: warning ../../../dyncall/libdyncall_s.a archive's cputype (18, architecture ppc) does not match cputype (7) for specified -arch flag: i386 (can't load from it)
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
89 /usr/bin/ld: warning ../../../dynload/libdynload_s.a archive's cputype (18, architecture ppc) does not match cputype (7) for specified -arch flag: i386 (can't load from it)
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
90 running install_lib
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
91 copying build/lib.macosx-10.3-fat-2.4/pydcext.so -> /Library/Frameworks/Python.framework/Versions/2.4/lib/python2.4/site-packages
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
92