1 | <?xml version="1.0" encoding="utf-8" ?> |
---|
2 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
---|
3 | <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> |
---|
4 | <head> |
---|
5 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> |
---|
6 | <meta name="generator" content="Docutils 0.3.1: http://docutils.sourceforge.net/" /> |
---|
7 | <title>Boost.Python TODO list Boost</title> |
---|
8 | <link rel="stylesheet" href="../../rst.css" type="text/css" /> |
---|
9 | </head> |
---|
10 | <body> |
---|
11 | <div class="document" id="boost-python-todo-list-logo"> |
---|
12 | <h1 class="title"><a class="reference" href="index.html">Boost.Python</a> TODO list <a class="reference" href="../../index.htm"><img alt="Boost" src="../../boost.png" /></a></h1> |
---|
13 | <!-- -*- mode: rst -*- --> |
---|
14 | <table class="field-list" frame="void" rules="none"> |
---|
15 | <col class="field-name" /> |
---|
16 | <col class="field-body" /> |
---|
17 | <tbody valign="top"> |
---|
18 | <tr class="field"><th class="field-name">copyright:</th><td class="field-body">Copyright David Abrahams 2003. Use, modification, and |
---|
19 | distribution are subject to the Boost Software License, Version |
---|
20 | 1.0. (See accompanying file <a class="reference" href="../../LICENSE_1_0.txt">LICENSE_1_0.txt</a> or copy at |
---|
21 | <a class="reference" href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>)</td> |
---|
22 | </tr> |
---|
23 | </tbody> |
---|
24 | </table> |
---|
25 | <div class="contents topic" id="outline"> |
---|
26 | <p class="topic-title"><a name="outline">Outline</a></p> |
---|
27 | <ul class="simple"> |
---|
28 | <li><a class="reference" href="#class-support" id="id4" name="id4">Class Support</a><ul> |
---|
29 | <li><a class="reference" href="#base-class-for-virtual-function-callback-wrappers" id="id5" name="id5">Base Class for Virtual Function Callback Wrappers</a></li> |
---|
30 | </ul> |
---|
31 | </li> |
---|
32 | <li><a class="reference" href="#miscellaneous" id="id6" name="id6">Miscellaneous</a><ul> |
---|
33 | <li><a class="reference" href="#support-for-enums-with-duplicate-values" id="id7" name="id7">Support for Enums with Duplicate Values</a></li> |
---|
34 | </ul> |
---|
35 | </li> |
---|
36 | <li><a class="reference" href="#functions" id="id8" name="id8">Functions</a><ul> |
---|
37 | <li><a class="reference" href="#wrapping-function-objects" id="id9" name="id9">Wrapping Function Objects</a></li> |
---|
38 | <li><a class="reference" href="#best-match-overload-resolution" id="id10" name="id10">"Best Match" Overload Resolution</a></li> |
---|
39 | </ul> |
---|
40 | </li> |
---|
41 | <li><a class="reference" href="#type-converters" id="id11" name="id11">Type Converters</a><ul> |
---|
42 | <li><a class="reference" href="#lvalue-conversions-from-non-const-pytypeobject-s" id="id12" name="id12">Lvalue conversions from non-const <tt class="literal"><span class="pre">PyTypeObject*</span></tt>s</a></li> |
---|
43 | <li><a class="reference" href="#converter-scoping" id="id13" name="id13">Converter Scoping</a></li> |
---|
44 | <li><a class="reference" href="#file-conversions" id="id14" name="id14"><tt class="literal"><span class="pre">FILE*</span></tt> conversions</a></li> |
---|
45 | <li><a class="reference" href="#void-conversions" id="id15" name="id15"><tt class="literal"><span class="pre">void*</span></tt> conversions</a></li> |
---|
46 | <li><a class="reference" href="#post-call-actions" id="id16" name="id16">Post-Call Actions</a></li> |
---|
47 | <li><a class="reference" href="#pyunicode-support" id="id17" name="id17"><tt class="literal"><span class="pre">PyUnicode</span></tt> Support</a></li> |
---|
48 | <li><a class="reference" href="#ownership-metadata" id="id18" name="id18">Ownership Metadata</a></li> |
---|
49 | </ul> |
---|
50 | </li> |
---|
51 | <li><a class="reference" href="#documentation" id="id19" name="id19">Documentation</a><ul> |
---|
52 | <li><a class="reference" href="#builtin-converters" id="id20" name="id20">Builtin Converters</a></li> |
---|
53 | <li><a class="reference" href="#internals" id="id21" name="id21">Internals</a></li> |
---|
54 | </ul> |
---|
55 | </li> |
---|
56 | <li><a class="reference" href="#large-scale" id="id22" name="id22">Large Scale</a><ul> |
---|
57 | <li><a class="reference" href="#full-threading-support" id="id23" name="id23">Full Threading Support</a></li> |
---|
58 | <li><a class="reference" href="#langbinding" id="id24" name="id24">Langbinding</a></li> |
---|
59 | <li><a class="reference" href="#refactoring-and-reorganization" id="id25" name="id25">Refactoring and Reorganization</a></li> |
---|
60 | <li><a class="reference" href="#numarray-support-enhancements" id="id26" name="id26">NumArray Support Enhancements</a></li> |
---|
61 | <li><a class="reference" href="#pyfinalize-safety" id="id27" name="id27"><tt class="literal"><span class="pre">PyFinalize</span></tt> Safety</a></li> |
---|
62 | </ul> |
---|
63 | </li> |
---|
64 | </ul> |
---|
65 | </div> |
---|
66 | <div class="section" id="class-support"> |
---|
67 | <h1><a class="toc-backref" href="#id4" name="class-support">Class Support</a></h1> |
---|
68 | <div class="section" id="base-class-for-virtual-function-callback-wrappers"> |
---|
69 | <h2><a class="toc-backref" href="#id5" name="base-class-for-virtual-function-callback-wrappers">Base Class for Virtual Function Callback Wrappers</a></h2> |
---|
70 | <ul class="simple"> |
---|
71 | <li><a class="reference" href="http://aspn.activestate.com/ASPN/Mail/Message/c++-sig/1456023">http://aspn.activestate.com/ASPN/Mail/Message/c++-sig/1456023</a> |
---|
72 | (bottom of message)</li> |
---|
73 | <li><a class="reference" href="http://mail.python.org/pipermail/c++-sig/2003-August/005297.html">http://mail.python.org/pipermail/c++-sig/2003-August/005297.html</a> |
---|
74 | (search for <tt class="literal"><span class="pre">VirtualDispatcher</span></tt>) describes how callback classes |
---|
75 | can swap ownership relationship with their Python wrappers.</li> |
---|
76 | <li><a class="reference" href="http://aspn.activestate.com/ASPN/Mail/Message/c++-sig/1860301">http://aspn.activestate.com/ASPN/Mail/Message/c++-sig/1860301</a> |
---|
77 | describes how this can also be used to considerably simplify |
---|
78 | callback classes, solve some "dangling reference" problems, and |
---|
79 | optimize the calling of non-overridden virtual functions.</li> |
---|
80 | </ul> |
---|
81 | </div> |
---|
82 | </div> |
---|
83 | <div class="section" id="miscellaneous"> |
---|
84 | <h1><a class="toc-backref" href="#id6" name="miscellaneous">Miscellaneous</a></h1> |
---|
85 | <div class="section" id="support-for-enums-with-duplicate-values"> |
---|
86 | <h2><a class="toc-backref" href="#id7" name="support-for-enums-with-duplicate-values">Support for Enums with Duplicate Values</a></h2> |
---|
87 | <blockquote> |
---|
88 | Scott Snyder provided a patch; Dave was dissatisfied for some |
---|
89 | reason, but maybe it should just be applied if no further action |
---|
90 | occurs <a class="reference" href="http://aspn.activestate.com/ASPN/Mail/Message/1824616">http://aspn.activestate.com/ASPN/Mail/Message/1824616</a>.</blockquote> |
---|
91 | </div> |
---|
92 | </div> |
---|
93 | <div class="section" id="functions"> |
---|
94 | <h1><a class="toc-backref" href="#id8" name="functions">Functions</a></h1> |
---|
95 | <div class="section" id="wrapping-function-objects"> |
---|
96 | <h2><a class="toc-backref" href="#id9" name="wrapping-function-objects">Wrapping Function Objects</a></h2> |
---|
97 | <blockquote> |
---|
98 | <p>It should be possible to wrap classes which support <tt class="literal"><span class="pre">operator()</span></tt> |
---|
99 | as Python methods.</p> |
---|
100 | <p><a class="reference" href="http://mail.python.org/pipermail/c++-sig/2003-August/005184.html">http://mail.python.org/pipermail/c++-sig/2003-August/005184.html</a></p> |
---|
101 | </blockquote> |
---|
102 | </div> |
---|
103 | <div class="section" id="best-match-overload-resolution"> |
---|
104 | <h2><a class="toc-backref" href="#id10" name="best-match-overload-resolution">"Best Match" Overload Resolution</a></h2> |
---|
105 | <blockquote> |
---|
106 | <p>Overload resolution currently depends on the order in which <tt class="literal"><span class="pre">def</span></tt> |
---|
107 | calls are made (preferring later overloads). This should be |
---|
108 | changed so that the best-matching overload is always selected. |
---|
109 | This may await <a class="reference" href="#langbinding">Langbinding</a> integration, since the technology is |
---|
110 | already in <a class="reference" href="http://luabind.sf.net">Luabind</a>.</p> |
---|
111 | </blockquote> |
---|
112 | </div> |
---|
113 | </div> |
---|
114 | <div class="section" id="type-converters"> |
---|
115 | <h1><a class="toc-backref" href="#id11" name="type-converters">Type Converters</a></h1> |
---|
116 | <div class="section" id="lvalue-conversions-from-non-const-pytypeobject-s"> |
---|
117 | <h2><a class="toc-backref" href="#id12" name="lvalue-conversions-from-non-const-pytypeobject-s">Lvalue conversions from non-const <tt class="literal"><span class="pre">PyTypeObject*</span></tt>s</a></h2> |
---|
118 | <blockquote> |
---|
119 | <a class="reference" href="http://aspn.activestate.com/ASPN/Mail/Message/C++-sig/1662717">http://aspn.activestate.com/ASPN/Mail/Message/C++-sig/1662717</a></blockquote> |
---|
120 | </div> |
---|
121 | <div class="section" id="converter-scoping"> |
---|
122 | <h2><a class="toc-backref" href="#id13" name="converter-scoping">Converter Scoping</a></h2> |
---|
123 | <blockquote> |
---|
124 | <p><a class="reference" href="http://article.gmane.org/gmane.comp.python.c++/2044">http://article.gmane.org/gmane.comp.python.c++/2044</a></p> |
---|
125 | <p>If this gets done at all, it is going to happen in conjunction |
---|
126 | with <a class="reference" href="#langbinding">Luabind integration</a>.</p> |
---|
127 | </blockquote> |
---|
128 | </div> |
---|
129 | <div class="section" id="file-conversions"> |
---|
130 | <h2><a class="toc-backref" href="#id14" name="file-conversions"><tt class="literal"><span class="pre">FILE*</span></tt> conversions</a></h2> |
---|
131 | <blockquote> |
---|
132 | <a class="reference" href="http://aspn.activestate.com/ASPN/Mail/Message/1411366">http://aspn.activestate.com/ASPN/Mail/Message/1411366</a></blockquote> |
---|
133 | </div> |
---|
134 | <div class="section" id="void-conversions"> |
---|
135 | <h2><a class="toc-backref" href="#id15" name="void-conversions"><tt class="literal"><span class="pre">void*</span></tt> conversions</a></h2> |
---|
136 | <blockquote> |
---|
137 | Pointers to <em>cv</em> <tt class="literal"><span class="pre">void</span></tt> should be able to be passed and |
---|
138 | returned as opaque values.</blockquote> |
---|
139 | </div> |
---|
140 | <div class="section" id="post-call-actions"> |
---|
141 | <h2><a class="toc-backref" href="#id16" name="post-call-actions">Post-Call Actions</a></h2> |
---|
142 | <blockquote> |
---|
143 | From-Python converters should be passed an extra reference to a |
---|
144 | chain of post-call actions in the Policies object, where they can |
---|
145 | register an additional action. See the end of |
---|
146 | <a class="reference" href="http://aspn.activestate.com/ASPN/Mail/Message/C++-sig/1755435">http://aspn.activestate.com/ASPN/Mail/Message/C++-sig/1755435</a></blockquote> |
---|
147 | </div> |
---|
148 | <div class="section" id="pyunicode-support"> |
---|
149 | <h2><a class="toc-backref" href="#id17" name="pyunicode-support"><tt class="literal"><span class="pre">PyUnicode</span></tt> Support</a></h2> |
---|
150 | <blockquote> |
---|
151 | <p>Review and possibly incorporate changes from <a class="reference" href="mailto:qinlj-at-solidshare.com">Lijun Qin</a> at |
---|
152 | <a class="reference" href="http://aspn.activestate.com/ASPN/Mail/Message/C++-sig/1771145">http://aspn.activestate.com/ASPN/Mail/Message/C++-sig/1771145</a></p> |
---|
153 | </blockquote> |
---|
154 | </div> |
---|
155 | <div class="section" id="ownership-metadata"> |
---|
156 | <h2><a class="toc-backref" href="#id18" name="ownership-metadata">Ownership Metadata</a></h2> |
---|
157 | <blockquote> |
---|
158 | In the thread at |
---|
159 | <a class="reference" href="http://aspn.activestate.com/ASPN/Mail/Message/c++-sig/1860301">http://aspn.activestate.com/ASPN/Mail/Message/c++-sig/1860301</a>, |
---|
160 | Niall Douglas describes an idea for solving some "false" |
---|
161 | dangling pointer/reference return errors by attaching data about |
---|
162 | objects which lets the framework determine that the reference |
---|
163 | count on an object doesn't tell us anything about the lifetime |
---|
164 | of its data.</blockquote> |
---|
165 | </div> |
---|
166 | </div> |
---|
167 | <div class="section" id="documentation"> |
---|
168 | <h1><a class="toc-backref" href="#id19" name="documentation">Documentation</a></h1> |
---|
169 | <div class="section" id="builtin-converters"> |
---|
170 | <h2><a class="toc-backref" href="#id20" name="builtin-converters">Builtin Converters</a></h2> |
---|
171 | <blockquote> |
---|
172 | Builtin correspondences between builtiin Python types and C++ |
---|
173 | types need to be documented</blockquote> |
---|
174 | </div> |
---|
175 | <div class="section" id="internals"> |
---|
176 | <h2><a class="toc-backref" href="#id21" name="internals">Internals</a></h2> |
---|
177 | <blockquote> |
---|
178 | <p>The structure of the framework needs to get documented; <a class="reference" href="mailto:brett.calcott-at-paradise.net.nz">Brett |
---|
179 | Calcott</a> has promised to turn <a class="reference" href="doc/internals.html">this document</a> into something fit |
---|
180 | for users</p> |
---|
181 | </blockquote> |
---|
182 | </div> |
---|
183 | </div> |
---|
184 | <div class="section" id="large-scale"> |
---|
185 | <h1><a class="toc-backref" href="#id22" name="large-scale">Large Scale</a></h1> |
---|
186 | <div class="section" id="full-threading-support"> |
---|
187 | <h2><a class="toc-backref" href="#id23" name="full-threading-support">Full Threading Support</a></h2> |
---|
188 | <blockquote> |
---|
189 | Various people have proposed patches to improve threading support |
---|
190 | in Boost.Python: see the thread at |
---|
191 | <a class="reference" href="http://aspn.activestate.com/ASPN/Mail/Message/1826544">http://aspn.activestate.com/ASPN/Mail/Message/1826544</a> and |
---|
192 | <a class="reference" href="http://aspn.activestate.com/ASPN/Mail/Message/1865842">http://aspn.activestate.com/ASPN/Mail/Message/1865842</a> for some |
---|
193 | examples. The only problem is that these are incomplete |
---|
194 | solutions and verifying that we <em>do</em> have a complete solution is |
---|
195 | going to take some time and attention.</blockquote> |
---|
196 | </div> |
---|
197 | <div class="section" id="langbinding"> |
---|
198 | <h2><a class="toc-backref" href="#id24" name="langbinding">Langbinding</a></h2> |
---|
199 | <blockquote> |
---|
200 | This project to generalizes Boost.Python to work for other |
---|
201 | languages, initially Lua. See discussions at |
---|
202 | <a class="reference" href="http://lists.sourceforge.net/lists/listinfo/boost-langbinding">http://lists.sourceforge.net/lists/listinfo/boost-langbinding</a></blockquote> |
---|
203 | </div> |
---|
204 | <div class="section" id="refactoring-and-reorganization"> |
---|
205 | <h2><a class="toc-backref" href="#id25" name="refactoring-and-reorganization">Refactoring and Reorganization</a></h2> |
---|
206 | <blockquote> |
---|
207 | <a class="reference" href="http://aspn.activestate.com/ASPN/Mail/Message/c++-sig/1673338">http://aspn.activestate.com/ASPN/Mail/Message/c++-sig/1673338</a></blockquote> |
---|
208 | </div> |
---|
209 | <div class="section" id="numarray-support-enhancements"> |
---|
210 | <h2><a class="toc-backref" href="#id26" name="numarray-support-enhancements">NumArray Support Enhancements</a></h2> |
---|
211 | <blockquote> |
---|
212 | Consider integrating the enhancements described in |
---|
213 | <a class="reference" href="http://aspn.activestate.com/ASPN/Mail/Message/C++-sig/1757092">http://aspn.activestate.com/ASPN/Mail/Message/C++-sig/1757092</a></blockquote> |
---|
214 | </div> |
---|
215 | <div class="section" id="pyfinalize-safety"> |
---|
216 | <h2><a class="toc-backref" href="#id27" name="pyfinalize-safety"><tt class="literal"><span class="pre">PyFinalize</span></tt> Safety</a></h2> |
---|
217 | <blockquote> |
---|
218 | <p>Currently Boost.Python has several global (or function-static) |
---|
219 | objects whose existence keeps reference counts from dropping to |
---|
220 | zero until the Boost.Python shared object is unloaded. This can |
---|
221 | cause a crash because when the reference counts <em>do</em> go to zero, |
---|
222 | there's no interpreter. In order to make it safe to call |
---|
223 | <tt class="literal"><span class="pre">PyFinalize()</span></tt> we must register an <tt class="literal"><span class="pre">atexit</span></tt> routine which |
---|
224 | destroys these objects and releases all Python reference counts |
---|
225 | so that Python can clean them up while there's still an |
---|
226 | interpreter. <a class="reference" href="mailto:dirk-at-gerrits.homeip.net">Dirk Gerrits</a> has promised to do this job.</p> |
---|
227 | </blockquote> |
---|
228 | </div> |
---|
229 | </div> |
---|
230 | </div> |
---|
231 | <hr class="footer" /> |
---|
232 | <div class="footer"> |
---|
233 | <a class="reference" href="todo.txt">View document source</a>. |
---|
234 | Generated on: 2004-01-02 18:33 UTC. |
---|
235 | Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source. |
---|
236 | </div> |
---|
237 | </body> |
---|
238 | </html> |
---|