Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

source: downloads/boost_1_34_1/libs/python/todo.html @ 29

Last change on this file since 29 was 29, checked in by landauf, 16 years ago

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