Changes for MPL v2

[SVN r13504]

build/Makefile.linux_gcc

@@ -0,0 +1,166 @@
+# Usage:
+#
+#   Create a new empty directory anywhere (preferably not in the boost tree).
+#   Copy this Makefile to that new directory and rename it to "Makefile"
+#   Set the BOOST pathname below.
+#
+#   make softlinks     Create softlinks to source code and tests
+#   make               Compile all sources
+#   make test          Run doctest tests
+#   make clean         Remove all object files
+#   make unlink        Remove softlinks
+
+BOOST= /net/cci/rwgk/boost
+
+PYEXE= /usr/local/Python-1.5.2/bin/python
+PYINC= -I/usr/local/Python-1.5.2/include/python1.5
+#PYEXE= /usr/local/Python-2.0/bin/python
+#PYINC= -I/usr/local/Python-2.0/include/python2.0
+#STLPORTINC= -I/usr/local/STLport-4.1b3/stlport
+#STLPORTOPTS= \
+# -D__USE_STD_IOSTREAM \
+# -D__STL_NO_SGI_IOSTREAMS \
+# -D__STL_USE_NATIVE_STRING \
+# -D__STL_NO_NEW_C_HEADERS \
+# -D_RWSTD_COMPILE_INSTANTIATE=1
+#STLPORTINC= -I/usr/local/STLport-4.1b4/stlport
+#STLPORTOPTS= -D__NO_USE_STD_IOSTREAM -D__STL_NO_SGI_IOSTREAMS
+#STLPORTINC= -I/net/cci/xp/C++_C_headers
+
+STDOPTS= -ftemplate-depth-21
+WARNOPTS=
+# use -msg_display_number to obtain integer tags for -msg_disable
+
+CPP= g++
+CPPOPTS= $(STLPORTINC) $(STLPORTOPTS) -I$(BOOST) $(PYINC) \
+         $(STDOPTS) $(WARNOPTS) -g
+MAKEDEP= -M
+
+LD= g++
+LDOPTS= -shared
+
+#HIDDEN= -hidden
+
+BPL_SRC = $(BOOST)/libs/python/src
+BPL_TST = $(BOOST)/libs/python/test
+BPL_EXA = $(BOOST)/libs/python/example
+SOFTLINKS = \
+$(BPL_SRC)/classes.cpp \
+$(BPL_SRC)/conversions.cpp \
+$(BPL_SRC)/extension_class.cpp \
+$(BPL_SRC)/functions.cpp \
+$(BPL_SRC)/init_function.cpp \
+$(BPL_SRC)/module_builder.cpp \
+$(BPL_SRC)/objects.cpp \
+$(BPL_SRC)/types.cpp \
+$(BPL_TST)/comprehensive.cpp \
+$(BPL_TST)/comprehensive.hpp \
+$(BPL_TST)/comprehensive.py \
+$(BPL_TST)/doctest.py \
+$(BPL_EXA)/abstract.cpp \
+$(BPL_EXA)/getting_started1.cpp \
+$(BPL_EXA)/getting_started2.cpp \
+$(BPL_EXA)/getting_started3.cpp \
+$(BPL_EXA)/getting_started4.cpp \
+$(BPL_EXA)/getting_started5.cpp \
+$(BPL_EXA)/test_abstract.py \
+$(BPL_EXA)/test_getting_started1.py \
+$(BPL_EXA)/test_getting_started2.py \
+$(BPL_EXA)/test_getting_started3.py \
+$(BPL_EXA)/test_getting_started4.py \
+$(BPL_EXA)/test_getting_started5.py
+
+OBJ = classes.o conversions.o extension_class.o functions.o \
+      init_function.o module_builder.o \
+      objects.o types.o
+DEPOBJ= $(OBJ) comprehensive.o abstract.o \
+        getting_started1.o getting_started2.o getting_started3.o \
+        getting_started4.o getting_started5.o
+
+.SUFFIXES: .o .cpp
+
+all: libbpl.a boost_python_test.so abstract.so \
+     getting_started1.so getting_started2.so getting_started3.so \
+     getting_started4.so getting_started5.so
+
+softlinks:
+	@ for pn in $(SOFTLINKS); \
+	  do \
+            bn=`basename "$$pn"`; \
+	    if [ ! -e "$$bn" ]; then \
+              echo "ln -s $$pn ."; \
+	      ln -s "$$pn" .; \
+            else \
+              echo "info: no softlink created (file exists): $$bn"; \
+	    fi; \
+	  done
+
+unlink:
+	@ for pn in $(SOFTLINKS); \
+	  do \
+            bn=`basename "$$pn"`; \
+	    if [ -L "$$bn" ]; then \
+              echo "rm $$bn"; \
+              rm "$$bn"; \
+            elif [ -e "$$bn" ]; then \
+              echo "info: not a softlink: $$bn"; \
+	    fi; \
+	  done
+
+libbpl.a: $(OBJ)
+	rm -f libbpl.a
+	ar r libbpl.a $(OBJ)
+
+boost_python_test.so: $(OBJ) comprehensive.o
+	$(LD) $(LDOPTS) $(OBJ) comprehensive.o -o boost_python_test.so -lm
+
+abstract.so: $(OBJ) abstract.o
+	$(LD) $(LDOPTS) $(OBJ) abstract.o -o abstract.so
+
+getting_started1.so: $(OBJ) getting_started1.o
+	$(LD) $(LDOPTS) $(OBJ) getting_started1.o -o getting_started1.so
+
+getting_started2.so: $(OBJ) getting_started2.o
+	$(LD) $(LDOPTS) $(OBJ) getting_started2.o -o getting_started2.so
+
+getting_started3.so: $(OBJ) getting_started3.o
+	$(LD) $(LDOPTS) $(OBJ) getting_started3.o -o getting_started3.so
+
+getting_started4.so: $(OBJ) getting_started4.o
+	$(LD) $(LDOPTS) $(OBJ) getting_started4.o -o getting_started4.so
+
+getting_started5.so: $(OBJ) getting_started5.o
+	$(LD) $(LDOPTS) $(OBJ) getting_started5.o -o getting_started5.so
+
+.cpp.o:
+	$(CPP) $(CPPOPTS) -c $*.cpp
+
+test:
+	$(PYEXE) comprehensive.py
+	$(PYEXE) test_abstract.py
+	$(PYEXE) test_getting_started1.py
+	$(PYEXE) test_getting_started2.py
+	$(PYEXE) test_getting_started3.py
+	$(PYEXE) test_getting_started4.py
+	$(PYEXE) test_getting_started5.py
+
+clean:
+	rm -f $(OBJ) libbpl.a libbpl.a.input
+	rm -f comprehensive.o boost_python_test.so
+	rm -f abstract.o abstract.so
+	rm -f getting_started1.o getting_started1.so
+	rm -f getting_started2.o getting_started2.so
+	rm -f getting_started3.o getting_started3.so
+	rm -f getting_started4.o getting_started4.so
+	rm -f getting_started5.o getting_started5.so
+	rm -f so_locations *.pyc
+	rm -rf cxx_repository
+
+depend:
+	@ cat Makefile.nodepend; \
+          for obj in $(DEPOBJ); \
+          do \
+            bn=`echo "$$obj" | cut -d. -f1`; \
+            $(CPP) $(CPPOPTS) $(MAKEDEP) "$$bn".cpp; \
+          done
+

build/Makefile.tru64_cxx

@@ -0,0 +1,170 @@
+# Usage:
+#
+#   Create a new empty directory anywhere (preferably not in the boost tree).
+#   Copy this Makefile to that new directory and rename it to "Makefile"
+#   Set the BOOST pathname below.
+#
+#   make softlinks     Create softlinks to source code and tests
+#   make               Compile all sources
+#   make test          Run doctest tests
+#   make clean         Remove all object files
+#   make unlink        Remove softlinks
+
+BOOST= /net/cci/rwgk/boost
+
+PYEXE= /usr/local/Python-1.5.2/bin/python
+PYINC= -I/usr/local/Python-1.5.2/include/python1.5
+#PYEXE= /usr/local/Python-2.0/bin/python
+#PYINC= -I/usr/local/Python-2.0/include/python2.0
+#STLPORTINC= -I/usr/local/STLport-4.1b3/stlport
+#STLPORTOPTS= \
+# -D__USE_STD_IOSTREAM \
+# -D__STL_NO_SGI_IOSTREAMS \
+# -D__STL_USE_NATIVE_STRING \
+# -D__STL_NO_NEW_C_HEADERS \
+# -D_RWSTD_COMPILE_INSTANTIATE=1
+#STLPORTINC= -I/usr/local/STLport-4.1b4/stlport
+#STLPORTOPTS= -D__NO_USE_STD_IOSTREAM -D__STL_NO_SGI_IOSTREAMS
+STLPORTINC= -I/net/cci/xp/C++_C_headers
+
+STDOPTS= -std strict_ansi
+WARNOPTS= -msg_disable 186,450,1115
+# use -msg_display_number to obtain integer tags for -msg_disable
+
+CPP= cxx
+CPPOPTS= $(STLPORTINC) $(STLPORTOPTS) -I$(BOOST) $(PYINC) \
+         $(STDOPTS) $(WARNOPTS) -g
+MAKEDEP= -Em
+
+LD= cxx
+LDOPTS= -shared -expect_unresolved 'Py*' -expect_unresolved '_Py*'
+
+#HIDDEN= -hidden
+
+BPL_SRC = $(BOOST)/libs/python/src
+BPL_TST = $(BOOST)/libs/python/test
+BPL_EXA = $(BOOST)/libs/python/example
+SOFTLINKS = \
+$(BPL_SRC)/classes.cpp \
+$(BPL_SRC)/conversions.cpp \
+$(BPL_SRC)/extension_class.cpp \
+$(BPL_SRC)/functions.cpp \
+$(BPL_SRC)/init_function.cpp \
+$(BPL_SRC)/module_builder.cpp \
+$(BPL_SRC)/objects.cpp \
+$(BPL_SRC)/types.cpp \
+$(BPL_TST)/comprehensive.cpp \
+$(BPL_TST)/comprehensive.hpp \
+$(BPL_TST)/comprehensive.py \
+$(BPL_TST)/doctest.py \
+$(BPL_EXA)/abstract.cpp \
+$(BPL_EXA)/getting_started1.cpp \
+$(BPL_EXA)/getting_started2.cpp \
+$(BPL_EXA)/getting_started3.cpp \
+$(BPL_EXA)/getting_started4.cpp \
+$(BPL_EXA)/getting_started5.cpp \
+$(BPL_EXA)/test_abstract.py \
+$(BPL_EXA)/test_getting_started1.py \
+$(BPL_EXA)/test_getting_started2.py \
+$(BPL_EXA)/test_getting_started3.py \
+$(BPL_EXA)/test_getting_started4.py \
+$(BPL_EXA)/test_getting_started5.py
+
+OBJ = classes.o conversions.o extension_class.o functions.o \
+      init_function.o module_builder.o \
+      objects.o types.o
+DEPOBJ= $(OBJ) comprehensive.o abstract.o \
+        getting_started1.o getting_started2.o getting_started3.o \
+        getting_started4.o getting_started5.o
+
+.SUFFIXES: .o .cpp
+
+all: libbpl.a boost_python_test.so abstract.so \
+     getting_started1.so getting_started2.so getting_started3.so \
+     getting_started4.so getting_started5.so
+
+softlinks:
+	@ for pn in $(SOFTLINKS); \
+	  do \
+            bn=`basename "$$pn"`; \
+	    if [ ! -e "$$bn" ]; then \
+              echo "ln -s $$pn ."; \
+	      ln -s "$$pn" .; \
+            else \
+              echo "info: no softlink created (file exists): $$bn"; \
+	    fi; \
+	  done
+
+unlink:
+	@ for pn in $(SOFTLINKS); \
+	  do \
+            bn=`basename "$$pn"`; \
+	    if [ -L "$$bn" ]; then \
+              echo "rm $$bn"; \
+              rm "$$bn"; \
+            elif [ -e "$$bn" ]; then \
+              echo "info: not a softlink: $$bn"; \
+	    fi; \
+	  done
+
+libbpl.a: $(OBJ)
+	rm -f libbpl.a
+	cd cxx_repository; \
+          ls -1 > ../libbpl.a.input; \
+          ar r ../libbpl.a -input ../libbpl.a.input
+	rm -f libbpl.a.input
+	ar r libbpl.a $(OBJ)
+
+boost_python_test.so: $(OBJ) comprehensive.o
+	$(LD) $(LDOPTS) $(OBJ) comprehensive.o -o boost_python_test.so -lm
+
+abstract.so: $(OBJ) abstract.o
+	$(LD) $(LDOPTS) $(OBJ) abstract.o -o abstract.so
+
+getting_started1.so: $(OBJ) getting_started1.o
+	$(LD) $(LDOPTS) $(OBJ) getting_started1.o -o getting_started1.so
+
+getting_started2.so: $(OBJ) getting_started2.o
+	$(LD) $(LDOPTS) $(OBJ) getting_started2.o -o getting_started2.so
+
+getting_started3.so: $(OBJ) getting_started3.o
+	$(LD) $(LDOPTS) $(OBJ) getting_started3.o -o getting_started3.so
+
+getting_started4.so: $(OBJ) getting_started4.o
+	$(LD) $(LDOPTS) $(OBJ) getting_started4.o -o getting_started4.so
+
+getting_started5.so: $(OBJ) getting_started5.o
+	$(LD) $(LDOPTS) $(OBJ) getting_started5.o -o getting_started5.so
+
+.cpp.o:
+	$(CPP) $(CPPOPTS) -c $*.cpp
+
+test:
+	$(PYEXE) comprehensive.py
+	$(PYEXE) test_abstract.py
+	$(PYEXE) test_getting_started1.py
+	$(PYEXE) test_getting_started2.py
+	$(PYEXE) test_getting_started3.py
+	$(PYEXE) test_getting_started4.py
+	$(PYEXE) test_getting_started5.py
+
+clean:
+	rm -f $(OBJ) libbpl.a libbpl.a.input
+	rm -f comprehensive.o boost_python_test.so
+	rm -f abstract.o abstract.so
+	rm -f getting_started1.o getting_started1.so
+	rm -f getting_started2.o getting_started2.so
+	rm -f getting_started3.o getting_started3.so
+	rm -f getting_started4.o getting_started4.so
+	rm -f getting_started5.o getting_started5.so
+	rm -f so_locations *.pyc
+	rm -rf cxx_repository
+
+depend:
+	@ cat Makefile.nodepend; \
+          for obj in $(DEPOBJ); \
+          do \
+            bn=`echo "$$obj" | cut -d. -f1`; \
+            $(CPP) $(CPPOPTS) $(MAKEDEP) "$$bn".cpp; \
+          done
+

build/bpl_static.dsp

@@ -0,0 +1,241 @@
+# Microsoft Developer Studio Project File - Name="bpl_static" - Package Owner=<4>
+# Microsoft Developer Studio Generated Build File, Format Version 6.00
+# ** DO NOT EDIT **
+
+# TARGTYPE "Win32 (x86) Static Library" 0x0104
+
+CFG=bpl_static - Win32 DebugPython
+!MESSAGE This is not a valid makefile. To build this project using NMAKE,
+!MESSAGE use the Export Makefile command and run
+!MESSAGE 
+!MESSAGE NMAKE /f "bpl_static.mak".
+!MESSAGE 
+!MESSAGE You can specify a configuration when running NMAKE
+!MESSAGE by defining the macro CFG on the command line. For example:
+!MESSAGE 
+!MESSAGE NMAKE /f "bpl_static.mak" CFG="bpl_static - Win32 DebugPython"
+!MESSAGE 
+!MESSAGE Possible choices for configuration are:
+!MESSAGE 
+!MESSAGE "bpl_static - Win32 Release" (based on "Win32 (x86) Static Library")
+!MESSAGE "bpl_static - Win32 Debug" (based on "Win32 (x86) Static Library")
+!MESSAGE "bpl_static - Win32 DebugPython" (based on "Win32 (x86) Static Library")
+!MESSAGE 
+
+# Begin Project
+# PROP AllowPerConfigDependencies 0
+# PROP Scc_ProjName ""
+# PROP Scc_LocalPath ""
+CPP=cl.exe
+RSC=rc.exe
+
+!IF  "$(CFG)" == "bpl_static - Win32 Release"
+
+# PROP BASE Use_MFC 0
+# PROP BASE Use_Debug_Libraries 0
+# PROP BASE Output_Dir "Release"
+# PROP BASE Intermediate_Dir "Release"
+# PROP BASE Target_Dir ""
+# PROP Use_MFC 0
+# PROP Use_Debug_Libraries 0
+# PROP Output_Dir "Release"
+# PROP Intermediate_Dir "Release"
+# PROP Target_Dir ""
+# ADD BASE CPP /nologo /W3 /GX /O2 /D "WIN32" /D "NDEBUG" /D "_MBCS" /D "_LIB" /YX /FD /c
+# ADD CPP /nologo /MD /W4 /WX /GR /GX /O2 /I "..\..\.." /I "c:\tools\python\include" /D "WIN32" /D "NDEBUG" /D "_MBCS" /D "_LIB" /FR /YX /FD /c
+# ADD BASE RSC /l 0x409 /d "NDEBUG"
+# ADD RSC /l 0x409 /d "NDEBUG"
+BSC32=bscmake.exe
+# ADD BASE BSC32 /nologo
+# ADD BSC32 /nologo
+LIB32=link.exe -lib
+# ADD BASE LIB32 /nologo
+# ADD LIB32 /nologo
+
+!ELSEIF  "$(CFG)" == "bpl_static - Win32 Debug"
+
+# PROP BASE Use_MFC 0
+# PROP BASE Use_Debug_Libraries 1
+# PROP BASE Output_Dir "Debug"
+# PROP BASE Intermediate_Dir "Debug"
+# PROP BASE Target_Dir ""
+# PROP Use_MFC 0
+# PROP Use_Debug_Libraries 1
+# PROP Output_Dir "Debug"
+# PROP Intermediate_Dir "Debug"
+# PROP Target_Dir ""
+# ADD BASE CPP /nologo /W3 /Gm /GX /ZI /Od /D "WIN32" /D "_DEBUG" /D "_MBCS" /D "_LIB" /YX /FD /GZ /c
+# ADD CPP /nologo /MDd /W4 /WX /Gm- /GR /GX /Zi /Od /I "..\..\.." /I "c:\tools\python\include" /D "WIN32" /D "_DEBUG" /D "_MBCS" /D "_LIB" /FR /YX /FD /GZ /c
+# ADD BASE RSC /l 0x409 /d "_DEBUG"
+# ADD RSC /l 0x409 /d "_DEBUG"
+BSC32=bscmake.exe
+# ADD BASE BSC32 /nologo
+# ADD BSC32 /nologo
+LIB32=link.exe -lib
+# ADD BASE LIB32 /nologo
+# ADD LIB32 /nologo
+
+!ELSEIF  "$(CFG)" == "bpl_static - Win32 DebugPython"
+
+# PROP BASE Use_MFC 0
+# PROP BASE Use_Debug_Libraries 1
+# PROP BASE Output_Dir "bpl_static___Win32_DebugPython"
+# PROP BASE Intermediate_Dir "bpl_static___Win32_DebugPython"
+# PROP BASE Target_Dir ""
+# PROP Use_MFC 0
+# PROP Use_Debug_Libraries 1
+# PROP Output_Dir "DebugPython"
+# PROP Intermediate_Dir "DebugPython"
+# PROP Target_Dir ""
+# ADD BASE CPP /nologo /MDd /W4 /WX /Gm /GR /GX /Zi /Od /I "..\..\.." /I "c:\tools\python\include" /D "WIN32" /D "_DEBUG" /D "_MBCS" /D "_LIB" /FR /YX /FD /GZ /c
+# ADD CPP /nologo /MDd /W4 /WX /Gm- /GR /GX /Zi /Od /I "..\..\.." /I "c:\tools\python\include" /D "WIN32" /D "_DEBUG" /D "_MBCS" /D "_LIB" /D "BOOST_DEBUG_PYTHON" /FR /YX /FD /GZ /EHs /c
+# ADD BASE RSC /l 0x409 /d "_DEBUG"
+# ADD RSC /l 0x409 /d "_DEBUG"
+BSC32=bscmake.exe
+# ADD BASE BSC32 /nologo
+# ADD BSC32 /nologo
+LIB32=link.exe -lib
+# ADD BASE LIB32 /nologo
+# ADD LIB32 /nologo
+
+!ENDIF 
+
+# Begin Target
+
+# Name "bpl_static - Win32 Release"
+# Name "bpl_static - Win32 Debug"
+# Name "bpl_static - Win32 DebugPython"
+# Begin Group "Source Files"
+
+# PROP Default_Filter "cpp;c;cxx;rc;def;r;odl;idl;hpj;bat"
+# Begin Source File
+
+SOURCE=..\src\classes.cpp
+# ADD CPP /W3
+# End Source File
+# Begin Source File
+
+SOURCE=..\src\conversions.cpp
+# ADD CPP /W3
+# End Source File
+# Begin Source File
+
+SOURCE=..\src\extension_class.cpp
+# ADD CPP /W3
+# End Source File
+# Begin Source File
+
+SOURCE=..\src\functions.cpp
+# ADD CPP /W3
+# End Source File
+# Begin Source File
+
+SOURCE=..\src\init_function.cpp
+# ADD CPP /W3
+# End Source File
+# Begin Source File
+
+SOURCE=..\src\module_builder.cpp
+# ADD CPP /W3
+# End Source File
+# Begin Source File
+
+SOURCE=..\src\objects.cpp
+# ADD CPP /W3
+# End Source File
+# Begin Source File
+
+SOURCE=..\src\types.cpp
+# ADD CPP /W3
+# End Source File
+# End Group
+# Begin Group "Header Files"
+
+# PROP Default_Filter "h;hpp;hxx;hm;inl"
+# Begin Source File
+
+SOURCE=..\..\..\boost\python\detail\base_object.hpp
+# End Source File
+# Begin Source File
+
+SOURCE=..\..\..\boost\python\callback.hpp
+# End Source File
+# Begin Source File
+
+SOURCE=..\..\..\boost\python\caller.hpp
+# End Source File
+# Begin Source File
+
+SOURCE=..\..\..\boost\python\detail\cast.hpp
+# End Source File
+# Begin Source File
+
+SOURCE=..\..\..\boost\python\class_builder.hpp
+# End Source File
+# Begin Source File
+
+SOURCE=..\..\..\boost\python\classes.hpp
+# End Source File
+# Begin Source File
+
+SOURCE=..\..\..\boost\python\detail\config.hpp
+# End Source File
+# Begin Source File
+
+SOURCE=..\..\..\boost\python\conversions.hpp
+# End Source File
+# Begin Source File
+
+SOURCE=..\..\..\boost\python\errors.hpp
+# End Source File
+# Begin Source File
+
+SOURCE=..\..\..\boost\python\detail\extension_class.hpp
+# End Source File
+# Begin Source File
+
+SOURCE=..\..\..\boost\python\detail\functions.hpp
+# End Source File
+# Begin Source File
+
+SOURCE=..\..\..\boost\python\detail\init_function.hpp
+# End Source File
+# Begin Source File
+
+SOURCE=..\..\..\boost\python\module_builder.hpp
+# End Source File
+# Begin Source File
+
+SOURCE=..\..\..\boost\python\detail\none.hpp
+# End Source File
+# Begin Source File
+
+SOURCE=..\..\..\boost\python\objects.hpp
+# End Source File
+# Begin Source File
+
+SOURCE=..\..\..\boost\python\operators.hpp
+# End Source File
+# Begin Source File
+
+SOURCE=..\..\..\boost\python\reference.hpp
+# End Source File
+# Begin Source File
+
+SOURCE=..\..\..\boost\python\detail\signatures.hpp
+# End Source File
+# Begin Source File
+
+SOURCE=..\..\..\boost\python\detail\singleton.hpp
+# End Source File
+# Begin Source File
+
+SOURCE=..\..\..\boost\python\detail\types.hpp
+# End Source File
+# Begin Source File
+
+SOURCE=..\..\..\boost\python\detail\wrap_python.hpp
+# End Source File
+# End Group
+# End Target
+# End Project

example/dvect.cpp

@@ -0,0 +1,69 @@
+#include "ivect.h"
+#include "dvect.h"
+#include <boost/python/class_builder.hpp>
+#include <boost/python/detail/import_extension_class.hpp>
+namespace python = boost::python;
+
+namespace {
+
+  vects::ivect dvect_as_ivect(const vects::dvect& dv)
+  {
+    vects::ivect iv(dv.size());
+    vects::ivect::iterator iviter = iv.begin();
+    for (int i = 0; i < dv.size(); i++) iviter[i] = static_cast<int>(dv[i]);
+    return iv;
+  }
+
+  boost::python::tuple ivect_as_tuple(const vects::ivect& iv)
+  {
+    return iv.as_tuple();
+  }
+
+  std::auto_ptr<vects::ivect> auto_ptr_ivect(const vects::dvect& dv)
+  {
+    return std::auto_ptr<vects::ivect>(new vects::ivect(dvect_as_ivect(dv)));
+  }
+
+  boost::shared_ptr<vects::ivect> shared_ptr_ivect(const vects::dvect& dv)
+  {
+    return boost::shared_ptr<vects::ivect>(new vects::ivect(dvect_as_ivect(dv)));
+  }
+
+  boost::python::tuple auto_ptr_ivect_as_tuple(std::auto_ptr<vects::ivect>& iv)
+  {
+    return iv->as_tuple();
+  }
+
+  boost::python::tuple shared_ptr_ivect_as_tuple(boost::shared_ptr<vects::ivect>& iv)
+  {
+    return iv->as_tuple();
+  }
+}
+
+extern "C"
+DL_EXPORT(void)
+initdvect()
+{
+  try
+  {
+    python::module_builder this_module("dvect");
+
+    python::x_class_builder<vects::dvect> dvect_class(this_module, "dvect");
+
+    python::import_class_builder<vects::ivect> ivect_class("ivect", "ivect");
+
+    dvect_class.def(python::constructor<python::tuple>());
+    dvect_class.def(&vects::dvect::as_tuple, "as_tuple");
+    dvect_class.def(dvect_as_ivect, "as_ivect");
+
+    this_module.def(ivect_as_tuple, "ivect_as_tuple");
+    dvect_class.def(auto_ptr_ivect, "auto_ptr_ivect");
+    dvect_class.def(shared_ptr_ivect, "shared_ptr_ivect");
+    this_module.def(auto_ptr_ivect_as_tuple, "auto_ptr_ivect_as_tuple");
+    this_module.def(shared_ptr_ivect_as_tuple, "shared_ptr_ivect_as_tuple");
+  }
+  catch(...)
+  {
+    python::handle_exception(); // Deal with the exception for Python
+  }
+}

example/dvect.h

@@ -0,0 +1,32 @@
+#ifndef DVECT_H
+#define DVECT_H
+
+#include <vector>
+#include <boost/python/class_builder.hpp>
+
+namespace vects {
+
+  struct dvect : public std::vector<double>
+  {
+    dvect() : std::vector<double>() {}
+    dvect(size_t n) : std::vector<double>(n) {}
+    dvect(boost::python::tuple tuple) : std::vector<double>(tuple.size())
+    {
+      std::vector<double>::iterator v_it = begin();
+      for (int i = 0; i < tuple.size(); i++)
+        v_it[i] = BOOST_PYTHON_CONVERSION::from_python(tuple[i].get(),
+          boost::python::type<double>());
+    }
+
+    boost::python::tuple as_tuple() const
+    {
+      boost::python::tuple t(size());
+      for (int i = 0; i < size(); i++)
+        t.set_item(i,
+          boost::python::ref(BOOST_PYTHON_CONVERSION::to_python((*this)[i])));
+      return t;
+    }
+  };
+}
+
+#endif // DVECT_H

example/getting_started5.cpp

@@ -0,0 +1,128 @@
+/*
+   This example shows how to convert a class from and to native
+   Python objects, such as tuples.
+
+   We do not want to expose the helper class MillerIndex as an
+   Extension Class. However, in order to simplify the wrapper code,
+   we want to define from_python() and to_python() functions for
+   class MillerIndex.
+
+   Consider the alternatives:
+
+     - Expose MillerIndex as an Extension Class.
+         We need a constructor MillerIndex(python::tuple).
+         Python function calls become more complex:
+           foo(MillerIndex((1,2,3)) instead of foo((1,2,3))
+         We need a method such as MillerIndex().as_tuple().
+
+     - Define a wrapper function for each function that we
+       want to expose, e.g.:
+          void add(const IndexingSet& ixset, const python::tuple PyMIx)
+
+   The first alternative introduces a new type that the user has to
+   deal with. Other modules using Miller indices might organize them in
+   different ways, for example to increase runtime efficiency for
+   important procedures. This means, the user has to know how to
+   convert between the different kinds of Miller index representations.
+   This can quickly become a nuisance. Relying on native Python data
+   structures minimizes the number of special types the user has to
+   learn and convert. Of course, this argument is only valid for
+   small and relatively simply classes.
+
+   If there are many member functions with MillerIndex arguments, the
+   second alternative is impractical, and concentrating the conversion
+   mechanism in one central place is essential for code
+   maintainability.  An added benefit is that more convenient (smarter)
+   conversion functions can be provided without cluttering the rest of
+   the wrapper code.
+
+ */
+
+#include <string>
+#include <vector>
+#include <boost/python/class_builder.hpp>
+namespace python = boost::python;
+
+namespace { // Avoid cluttering the global namespace.
+
+  // The helper class.
+  //
+  class MillerIndex {
+    public:
+      int v[3];
+  };
+
+  // The main class. Imagine that there are MANY member functions
+  // like add() and get().
+  //
+  class IndexingSet {
+    private:
+      std::vector<MillerIndex> VMIx;
+    public:
+      void add(const MillerIndex& MIx) { VMIx.push_back(MIx); }
+      MillerIndex get(const std::size_t i) const { return VMIx[i]; }
+  };
+}
+
+BOOST_PYTHON_BEGIN_CONVERSION_NAMESPACE
+
+  // Convert a Python tuple to a MillerIndex object.
+  //
+  MillerIndex from_python(PyObject* p, python::type<const MillerIndex&>)
+  {
+    python::tuple tup
+      = python::tuple(python::ref(p, python::ref::increment_count));
+    if (tup.size() != 3) {
+      PyErr_SetString(PyExc_ValueError,
+        "expecting exactly 3 values in tuple.");
+      throw python::error_already_set();
+    }
+    MillerIndex result;
+    for (int i = 0; i < 3; i++)
+      result.v[i] = from_python(tup[i].get(), python::type<int>());
+    return result;
+  }
+
+  // Similar conversion for MillerIndex objects passed by value.
+  // Not actually used, but included to show the principle.
+  //
+  MillerIndex from_python(PyObject* p, python::type<MillerIndex>)
+  {
+    return from_python(p, python::type<const MillerIndex&>());
+  }
+
+  // Convert a MillerIndex object to a Python tuple.
+  //
+  PyObject* to_python(const MillerIndex& hkl)
+  {
+    python::tuple result(3);
+    for (int i = 0; i < 3; i++)
+      result.set_item(i, python::ref(to_python(hkl.v[i])));
+    return result.reference().release();
+  }
+
+BOOST_PYTHON_END_CONVERSION_NAMESPACE
+
+extern "C"
+DL_EXPORT(void)
+initgetting_started5()
+{
+  try
+  {
+    // Create an object representing this extension module.
+    python::module_builder this_module("getting_started5");
+
+    // Create the Python type object for our extension class.
+    python::class_builder<IndexingSet> ixset_class(this_module, "IndexingSet");
+
+    // Add the __init__ function.
+    ixset_class.def(python::constructor<>());
+    // Add the member functions.
+    ixset_class.def(&IndexingSet::add, "add");
+    ixset_class.def(&IndexingSet::get, "get");
+  }
+  catch(...)
+  {
+    python::handle_exception(); // Deal with the exception for Python
+  }
+}

example/ivect.cpp

@@ -0,0 +1,69 @@
+#include "ivect.h"
+#include "dvect.h"
+#include <boost/python/class_builder.hpp>
+#include <boost/python/detail/import_extension_class.hpp>
+namespace python = boost::python;
+
+namespace {
+
+  vects::dvect ivect_as_dvect(const vects::ivect& iv)
+  {
+    vects::dvect dv(iv.size());
+    vects::dvect::iterator dviter = dv.begin();
+    for (int i = 0; i < iv.size(); i++) dviter[i] = static_cast<double>(iv[i]);
+    return dv;
+  }
+
+  boost::python::tuple dvect_as_tuple(const vects::dvect& dv)
+  {
+    return dv.as_tuple();
+  }
+
+  std::auto_ptr<vects::dvect> auto_ptr_dvect(const vects::ivect& iv)
+  {
+    return std::auto_ptr<vects::dvect>(new vects::dvect(ivect_as_dvect(iv)));
+  }
+
+  boost::shared_ptr<vects::dvect> shared_ptr_dvect(const vects::ivect& iv)
+  {
+    return boost::shared_ptr<vects::dvect>(new vects::dvect(ivect_as_dvect(iv)));
+  }
+
+  boost::python::tuple auto_ptr_dvect_as_tuple(std::auto_ptr<vects::dvect>& dv)
+  {
+    return dv->as_tuple();
+  }
+
+  boost::python::tuple shared_ptr_dvect_as_tuple(boost::shared_ptr<vects::dvect>& dv)
+  {
+    return dv->as_tuple();
+  }
+}
+
+extern "C"
+DL_EXPORT(void)
+initivect()
+{
+  try
+  {
+    python::module_builder this_module("ivect");
+
+    python::x_class_builder<vects::ivect> ivect_class(this_module, "ivect");
+
+    python::import_class_builder<vects::dvect> dvect_class("dvect", "dvect");
+
+    ivect_class.def(python::constructor<python::tuple>());
+    ivect_class.def(&vects::ivect::as_tuple, "as_tuple");
+    ivect_class.def(ivect_as_dvect, "as_dvect");
+
+    this_module.def(dvect_as_tuple, "dvect_as_tuple");
+    ivect_class.def(auto_ptr_dvect, "auto_ptr_dvect");
+    ivect_class.def(shared_ptr_dvect, "shared_ptr_dvect");
+    this_module.def(auto_ptr_dvect_as_tuple, "auto_ptr_dvect_as_tuple");
+    this_module.def(shared_ptr_dvect_as_tuple, "shared_ptr_dvect_as_tuple");
+  }
+  catch(...)
+  {
+    python::handle_exception(); // Deal with the exception for Python
+  }
+}

example/ivect.h

@@ -0,0 +1,32 @@
+#ifndef IVECT_H
+#define IVECT_H
+
+#include <vector>
+#include <boost/python/class_builder.hpp>
+
+namespace vects {
+
+  struct ivect : public std::vector<int>
+  {
+    ivect() : std::vector<int>() {}
+    ivect(size_t n) : std::vector<int>(n) {}
+    ivect(boost::python::tuple tuple) : std::vector<int>(tuple.size())
+    {
+      std::vector<int>::iterator v_it = begin();
+      for (int i = 0; i < tuple.size(); i++)
+        v_it[i] = BOOST_PYTHON_CONVERSION::from_python(tuple[i].get(),
+          boost::python::type<int>());
+    }
+
+    boost::python::tuple as_tuple() const
+    {
+      boost::python::tuple t(size());
+      for (int i = 0; i < size(); i++)
+        t.set_item(i,
+          boost::python::ref(BOOST_PYTHON_CONVERSION::to_python((*this)[i])));
+      return t;
+    }
+  };
+}
+
+#endif // IVECT_H

example/noncopyable_export.cpp

@@ -0,0 +1,24 @@
+#include <boost/python/class_builder.hpp>
+#include <boost/python/detail/import_extension_class.hpp>
+namespace python = boost::python;
+
+#include "store.h"
+
+extern "C"
+DL_EXPORT(void)
+initnoncopyable_export()
+{
+  try
+  {
+    python::module_builder this_module("noncopyable_export");
+
+    python::xptr_class_builder<store> store_class(this_module, "store");
+
+    store_class.def(python::constructor<int>());
+    store_class.def(&store::recall, "recall");
+  }
+  catch(...)
+  {
+    python::handle_exception(); // Deal with the exception for Python
+  }
+}

example/noncopyable_import.cpp

@@ -0,0 +1,42 @@
+#include <boost/python/class_builder.hpp>
+#include <boost/python/detail/import_extension_class.hpp>
+namespace python = boost::python;
+
+#include "store.h"
+
+namespace { // Avoid cluttering the global namespace.
+
+  // A function with store objects as both input and output parameters.
+  // Because the copy constructor is disabled, we cannot pass a store
+  // object by value. Instead, we pass a smart pointer.
+  std::auto_ptr<store> add_stores(const store& s1, const store& s2)
+  {
+    int sum = s1.recall() + s2.recall();
+    std::auto_ptr<store> ss = std::auto_ptr<store>(new store(sum));
+    return ss;
+  }
+}
+
+extern "C"
+DL_EXPORT(void)
+initnoncopyable_import()
+{
+  try
+  {
+    python::module_builder this_module("noncopyable_import");
+
+    python::import_class_builder<store>
+      dvect_class("noncopyable_export", "store");
+
+    // Imagine all the additional classes with member functions
+    // that have store objects as input and output parameters.
+    // Lots and lots of them.
+    // However, to keep this example simple, we only define a
+    // module-level function.
+    this_module.def(add_stores, "add_stores");
+  }
+  catch(...)
+  {
+    python::handle_exception(); // Deal with the exception for Python
+  }
+}

example/store.h

@@ -0,0 +1,14 @@
+#ifndef STORE_H
+#define STORE_H
+
+class store
+{
+  private:
+    store(const store&) { } // Disable the copy constructor.
+    int number;
+  public:
+    store(const int i) : number(i) { }
+    int recall() const { return number; }
+};
+
+#endif // STORE_H

example/tst_dvect.py

@@ -0,0 +1,16 @@
+import dvect
+print dvect.dvect.__converters__
+dv = dvect.dvect((1,2,3,4,5))
+print dv
+print dv.as_tuple()
+iv = dv.as_ivect()
+print iv
+print iv.as_tuple()
+print dvect.ivect_as_tuple(iv)
+aiv = dv.auto_ptr_ivect()
+print aiv
+siv = dv.shared_ptr_ivect()
+print dvect.auto_ptr_ivect_as_tuple(aiv)
+print dvect.ivect_as_tuple(aiv)
+print dvect.shared_ptr_ivect_as_tuple(siv)
+print dvect.ivect_as_tuple(siv)

example/tst_ivect.py

@@ -0,0 +1,16 @@
+import ivect
+print ivect.ivect.__converters__
+iv = ivect.ivect((1,2,3,4,5))
+print iv
+print iv.as_tuple()
+dv = iv.as_dvect()
+print dv
+print dv.as_tuple()
+print ivect.dvect_as_tuple(dv)
+adv = iv.auto_ptr_dvect()
+print adv
+sdv = iv.shared_ptr_dvect()
+print ivect.auto_ptr_dvect_as_tuple(adv)
+print ivect.dvect_as_tuple(adv)
+print ivect.shared_ptr_dvect_as_tuple(sdv)
+print ivect.dvect_as_tuple(sdv)

example/tst_noncopyable.py

@@ -0,0 +1,8 @@
+import noncopyable_export
+import noncopyable_import
+s1 = noncopyable_export.store(1)
+print s1.recall()
+s2 = noncopyable_export.store(2)
+print s2.recall()
+s3 = noncopyable_import.add_stores(s1, s2)
+print s3.recall()

include/boost/python/object/select_holder.hpp

@@ -0,0 +1,73 @@
+// Copyright David Abrahams 2002. Permission to copy, use,
+// modify, sell and distribute this software is granted provided this
+// copyright notice appears in all copies. This software is provided
+// "as is" without express or implied warranty, and with no claim as
+// to its suitability for any purpose.
+#ifndef SELECT_HOLDER_DWA2002322_HPP
+# define SELECT_HOLDER_DWA2002322_HPP
+
+# include <boost/python/has_back_reference.hpp>
+# include <boost/python/detail/not_specified.hpp>
+# include <boost/python/detail/pointee.hpp>
+# include <boost/python/detail/if_else.hpp>
+# include <boost/python/object/value_holder.hpp>
+# include <boost/python/object/pointer_holder.hpp>
+# include <boost/type.hpp>
+# include <boost/mpl/select_if.hpp>
+
+namespace boost { namespace python { namespace objects {
+
+namespace detail
+{
+  template <class T, class Held>
+  struct select_value_holder
+  {
+      BOOST_STATIC_CONSTANT(bool, selector = (!is_same<T,Held>::value) | has_back_reference<T>::value);
+  
+      typedef typename mpl::select_if_c<
+          selector
+          , value_holder_back_reference<T,Held>
+          , value_holder<T>
+      >::type holder;
+
+      static holder* get() { return 0; }
+  };
+
+  template <class T,class Ptr>
+  struct select_pointer_holder
+  {
+      typedef typename python::detail::pointee<Ptr>::type pointee;
+      BOOST_STATIC_CONSTANT(bool, selector = (!is_same<T,pointee>::value) | has_back_reference<T>::value);
+      
+      typedef typename mpl::select_if_c<
+          selector
+          , pointer_holder_back_reference<Ptr,T>
+          , pointer_holder<Ptr,T>
+      >::type holder;
+      
+      static holder* get() { return 0; }
+  };
+}
+
+template <class T, class NotSpecified>
+inline detail::select_value_holder<T,T> select_holder(python::detail::not_specified*, T* = 0, NotSpecified* = 0)
+{
+    return detail::select_value_holder<T,T>();
+}
+
+template <class T, class Held>
+inline detail::select_value_holder<T, Held> select_holder(T*, Held* = 0)
+{
+    return detail::select_value_holder<T, Held>();
+}
+
+
+template <class T, class Ptr>
+detail::select_pointer_holder<T,Ptr> select_holder(void*, Ptr* = 0, T* = 0)
+{
+    return detail::select_pointer_holder<T,Ptr>();
+}
+
+}}} // namespace boost::python::objects
+
+#endif // SELECT_HOLDER_DWA2002322_HPP

pyste/NEWS

@@ -1,59 +0,0 @@
-3 June 2003
-Appliced a patch from Giulio Eulisse that allows unnamed enumerations to be
-exported with an AllFromHeader construct. Thanks a lot Giulio!
-
-2 June 2003
-Added a new construct, add_method. See documentation.
-
-23 May 2003
-Support for global variables added.
-Various bug fixes.
-
-08 May 2003
-Fixed bug where in a certain cases the GCCXMLParser would end up with multiple
-declarations of the same class
-
-22 Apr 2003
-- Now shows a warning when the user tries to export a forward-declared class.
-  Forward-declared classes are ignored by the AllFromHeader construct.
-- Fixed a bug where classes, functions and enums where being exported, even if
-  excluded from a AllFromHeader construct.
-
-16 Apr 2003
-Added a more generic (but ugly) code to declare the smart pointer converters.
-
-07 Apr 2003
-- Removed the warnings about forward declarations: it was not accurate enough.
-  Another strategy must be thought of.
-- Fixed bug in the --multiple mode, where the order of the class instantiations
-  could end up wrong.
-- Lots of fixes in the documentation, pointed out by Dirk Gerrits. Thanks Dirk!
-- Fixed support for the return_opaque_pointer policy (the support macro was not
-  being declared).
-
-
-06 Apr 2003
-Support for the improved static data members support of Boost.Python.
-
-05 Apr 2003
-New option for generating the bindings: --multiple.
-
-02 Apr 2003
-Forward declarations are now detected and a warning is generated.
-
-24 Mar 2003
-Default policy for functions/methods that return const T& is now
-return_value_policy<copy_const_reference>().
-
-22 Mar 2003
-Exporting virtual methods of the base classes in the derived classes too.
-
-21 Mar 2003
-Added manual support for boost::shared_ptr and std::auto_ptr (see doc).
-
-19 Mar 2003 
-Added support for int, double, float and long operators acting as expected in
-python.
-
-14 Mar 2003 
-Fixed bug: Wrappers for protected and virtual methods were not being generated.

pyste/README

@@ -1,31 +0,0 @@
-Pyste - Python Semi-Automatic Exporter
-======================================
-
-Pyste is a Boost.Python code generator. The user specifies the classes and
-functions to be exported using a simple interface file, which following the
-Boost.Python's philosophy, is simple Python code. Pyste then uses GCCXML to
-parse all the headers and extract the necessary information to automatically
-generate C++ code.
-
-The documentation can be found in the file index.html accompaning this README.
-
-Enjoy!
-Bruno da Silva de Oliveira (nicodemus@globalite.com.br)
-
-Thanks
-======
-
-- David Abrahams, creator of Boost.Python, for tips on the syntax of the interface
-  file and support.
-- Marcelo Camelo, for design tips, support and inspiration for this project.
-  Also, the name was his idea. 8)
-- Brad King, creator of the excellent GCCXML (http://www.gccxml.org)
-- Fredrik Lundh, creator of the elementtree library (http://effbot.org)
-
-Bugs
-====
-
-Pyste is a young tool, so please help it to get better! Send bug reports to
-nicodemus@globalite.com.br, accompaining the stack trace in case of exceptions.
-If possible, run pyste with --debug, and send the resulting xmls too (pyste
-will output a xml file with the same of each header it parsed).

pyste/dist/.cvsignore

@@ -1,2 +0,0 @@
-*.zip
-*.pyc

pyste/dist/create_build.py

@@ -1,51 +0,0 @@
-import os
-import sys
-import shutil
-import fnmatch
-from zipfile import ZipFile, ZIP_DEFLATED
-
-def findfiles(directory, mask):
-    def visit(files, dir, names):
-        for name in names:
-            if fnmatch.fnmatch(name, mask):
-                files.append(os.path.join(dir, name))
-    files = []
-    os.path.walk(directory, visit, files)
-    return files
-                
-        
-def main():
-    # test if PyXML is installed
-    try:
-        import _xmlplus.parsers.expat
-        pyxml = '--includes _xmlplus.parsers.expat'
-    except ImportError:
-        pyxml = ''
-    # create exe
-    status = os.system('python setup.py py2exe %s >& build.log' % pyxml)
-    if status != 0:
-        raise RuntimeError, 'Error creating EXE'
-
-    # create distribution
-    import pyste
-    version = pyste.__VERSION__
-    zip = ZipFile('pyste-%s.zip' % version, 'w', ZIP_DEFLATED)    
-    # include the base files
-    dist_dir = 'dist/pyste'
-    for basefile in os.listdir(dist_dir):
-        zip.write(os.path.join(dist_dir, basefile), os.path.join('pyste', basefile))
-    # include documentation
-    for doc_file in findfiles('../doc', '*.*'):
-        dest_name = os.path.join('pyste/doc', doc_file[3:])
-        zip.write(doc_file, dest_name)
-    zip.write('../index.html', 'pyste/doc/index.html')
-    zip.close()
-    # cleanup
-    os.remove('build.log')
-    shutil.rmtree('build')
-    shutil.rmtree('dist')
-    
-
-if __name__ == '__main__':
-    sys.path.append('../src')
-    main()

pyste/dist/setup.py

@@ -1,6 +0,0 @@
-from distutils.core import setup
-import py2exe
-import sys
-
-sys.path.append('../src')
-setup(name='pyste', scripts=['../src/pyste.py'])

pyste/doc/adding_new_methods.html

@@ -1,78 +0,0 @@
-<html>
-<head>
-<!-- Generated by the Spirit (http://spirit.sf.net) QuickDoc -->
-<title>Adding New Methods</title>
-<link rel="stylesheet" href="theme/style.css" type="text/css">
-<link rel="prev" href="global_variables.html">
-</head>
-<body>
-<table width="100%" height="48" border="0" cellspacing="2">
-  <tr>
-    <td><img src="theme/c%2B%2Bboost.gif">
-    </td>
-    <td width="85%">
-      <font size="6" face="Verdana, Arial, Helvetica, sans-serif"><b>Adding New Methods</b></font>
-    </td>
-  </tr>
-</table>
-<br>
-<table border="0">
-  <tr>
-    <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
-    <td width="30"><a href="global_variables.html"><img src="theme/l_arr.gif" border="0"></a></td>
-    <td width="20"><img src="theme/r_arr_disabled.gif" border="0"></td>
-   </tr>
-</table>
-<p>
-Suppose that you want to add a function to a class, turning it into a method:</p>
-<code><pre>
-    <span class=keyword>struct </span><span class=identifier>World
-    </span><span class=special>{
-        </span><span class=keyword>void </span><span class=identifier>set</span><span class=special>(</span><span class=identifier>std</span><span class=special>::</span><span class=identifier>string </span><span class=identifier>msg</span><span class=special>) { </span><span class=keyword>this</span><span class=special>-&gt;</span><span class=identifier>msg </span><span class=special>= </span><span class=identifier>msg</span><span class=special>; }
-        </span><span class=identifier>std</span><span class=special>::</span><span class=identifier>string </span><span class=identifier>msg</span><span class=special>;
-    };
-
-    </span><span class=identifier>std</span><span class=special>::</span><span class=identifier>string </span><span class=identifier>greet</span><span class=special>(</span><span class=identifier>World</span><span class=special>&amp; </span><span class=identifier>w</span><span class=special>)
-    {
-        </span><span class=keyword>return </span><span class=identifier>w</span><span class=special>.</span><span class=identifier>msg</span><span class=special>;
-    }
-</span></pre></code>
-<p>
-Here, we want to make <tt>greet</tt> work as a method of the class <tt>World</tt>. We do
-that using the <tt>add_method</tt> construct:</p>
-<code><pre>
-    <span class=identifier>W </span><span class=special>= </span><span class=identifier>Class</span><span class=special>(</span><span class=string>&quot;World&quot;</span><span class=special>, </span><span class=string>&quot;hello.h&quot;</span><span class=special>)
-    </span><span class=identifier>add_method</span><span class=special>(</span><span class=identifier>W</span><span class=special>, </span><span class=string>&quot;greet&quot;</span><span class=special>)
-</span></pre></code>
-<p>
-Notice also that then you can rename it, set its policy, just like a regular
-method:</p>
-<code><pre>
-    <span class=identifier>rename</span><span class=special>(</span><span class=identifier>W</span><span class=special>.</span><span class=identifier>greet</span><span class=special>, </span><span class=literal>'Greet'</span><span class=special>)
-</span></pre></code>
-<p>
-Now from Python:</p>
-<code><pre>
-    <span class=special>&gt;&gt;&gt; </span><span class=identifier>import </span><span class=identifier>hello
-    </span><span class=special>&gt;&gt;&gt; </span><span class=identifier>w </span><span class=special>= </span><span class=identifier>hello</span><span class=special>.</span><span class=identifier>World</span><span class=special>()
-    &gt;&gt;&gt; </span><span class=identifier>w</span><span class=special>.</span><span class=identifier>set</span><span class=special>(</span><span class=literal>'Ni'</span><span class=special>)
-    &gt;&gt;&gt; </span><span class=identifier>w</span><span class=special>.</span><span class=identifier>greet</span><span class=special>()
-    </span><span class=literal>'Ni'
-    </span><span class=special>&gt;&gt;&gt; </span><span class=identifier>print </span><span class=literal>'Oh no! The knights who say Ni!'
-    </span><span class=identifier>Oh </span><span class=identifier>no</span><span class=special>! </span><span class=identifier>The </span><span class=identifier>knights </span><span class=identifier>who </span><span class=identifier>say </span><span class=identifier>Ni</span><span class=special>!
-</span></pre></code>
-<table border="0">
-  <tr>
-    <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
-    <td width="30"><a href="global_variables.html"><img src="theme/l_arr.gif" border="0"></a></td>
-    <td width="20"><img src="theme/r_arr_disabled.gif" border="0"></td>
-   </tr>
-</table>
-<br>
-<hr size="1"><p class="copyright">Copyright &copy; 2003 Bruno da Silva de Oliveira<br>Copyright &copy; 2002-2003 Joel de Guzman<br><br>
-<font size="2">Permission to copy, use, modify, sell and distribute this document
- is granted provided this copyright notice appears in all copies. This document
- is provided &quot;as is&quot; without express or implied warranty, and with
- no claim as to its suitability for any purpose. </font> </p>
-</body>
-</html>

pyste/doc/exporting_all_declarations_from_a_header.html

@@ -1,77 +0,0 @@
-<html>
-<head>
-<!-- Generated by the Spirit (http://spirit.sf.net) QuickDoc -->
-<title>Exporting All Declarations from a Header</title>
-<link rel="stylesheet" href="theme/style.css" type="text/css">
-<link rel="prev" href="wrappers.html">
-<link rel="next" href="smart_pointers.html">
-</head>
-<body>
-<table width="100%" height="48" border="0" cellspacing="2">
-  <tr>
-    <td><img src="theme/c%2B%2Bboost.gif">
-    </td>
-    <td width="85%">
-      <font size="6" face="Verdana, Arial, Helvetica, sans-serif"><b>Exporting All Declarations from a Header</b></font>
-    </td>
-  </tr>
-</table>
-<br>
-<table border="0">
-  <tr>
-    <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
-    <td width="30"><a href="wrappers.html"><img src="theme/l_arr.gif" border="0"></a></td>
-    <td width="20"><a href="smart_pointers.html"><img src="theme/r_arr.gif" border="0"></a></td>
-   </tr>
-</table>
-<p>
-Pyste also supports a mechanism to export all declarations found in a header
-file. Suppose again our file, <tt>hello.h</tt>:</p>
-<code><pre>
-    <span class=keyword>struct </span><span class=identifier>World
-    </span><span class=special>{
-        </span><span class=identifier>World</span><span class=special>(</span><span class=identifier>std</span><span class=special>::</span><span class=identifier>string </span><span class=identifier>msg</span><span class=special>): </span><span class=identifier>msg</span><span class=special>(</span><span class=identifier>msg</span><span class=special>) {} 
-        </span><span class=keyword>void </span><span class=identifier>set</span><span class=special>(</span><span class=identifier>std</span><span class=special>::</span><span class=identifier>string </span><span class=identifier>msg</span><span class=special>) { </span><span class=keyword>this</span><span class=special>-&gt;</span><span class=identifier>msg </span><span class=special>= </span><span class=identifier>msg</span><span class=special>; }
-        </span><span class=identifier>std</span><span class=special>::</span><span class=identifier>string </span><span class=identifier>greet</span><span class=special>() { </span><span class=keyword>return </span><span class=identifier>msg</span><span class=special>; }
-        </span><span class=identifier>std</span><span class=special>::</span><span class=identifier>string </span><span class=identifier>msg</span><span class=special>;
-    };
-
-    </span><span class=keyword>enum </span><span class=identifier>choice </span><span class=special>{ </span><span class=identifier>red</span><span class=special>, </span><span class=identifier>blue </span><span class=special>};
-    
-    </span><span class=keyword>void </span><span class=identifier>show</span><span class=special>(</span><span class=identifier>choice </span><span class=identifier>c</span><span class=special>) { </span><span class=identifier>std</span><span class=special>::</span><span class=identifier>cout </span><span class=special>&lt;&lt; </span><span class=string>&quot;value: &quot; </span><span class=special>&lt;&lt; (</span><span class=keyword>int</span><span class=special>)</span><span class=identifier>c </span><span class=special>&lt;&lt; </span><span class=identifier>std</span><span class=special>::</span><span class=identifier>endl</span><span class=special>; } 
-</span></pre></code>
-<p>
-You can just use the <tt>AllFromHeader</tt> construct:</p>
-<code><pre>
-    <span class=identifier>hello </span><span class=special>= </span><span class=identifier>AllFromHeader</span><span class=special>(</span><span class=string>&quot;hello.h&quot;</span><span class=special>)
-</span></pre></code>
-<p>
-this will export all the declarations found in <tt>hello.h</tt>, which is equivalent
-to write:</p>
-<code><pre>
-    <span class=identifier>Class</span><span class=special>(</span><span class=string>&quot;World&quot;</span><span class=special>, </span><span class=string>&quot;hello.h&quot;</span><span class=special>)
-    </span><span class=identifier>Enum</span><span class=special>(</span><span class=string>&quot;choice&quot;</span><span class=special>, </span><span class=string>&quot;hello.h&quot;</span><span class=special>)
-    </span><span class=identifier>Function</span><span class=special>(</span><span class=string>&quot;show&quot;</span><span class=special>, </span><span class=string>&quot;hello.h&quot;</span><span class=special>)
-</span></pre></code>
-<p>
-Note that you can still use the functions <tt>rename</tt>, <tt>set_policy</tt>, <tt>exclude</tt>, etc. Just access
-the members of the header object like this:</p>
-<code><pre>
-    <span class=identifier>rename</span><span class=special>(</span><span class=identifier>hello</span><span class=special>.</span><span class=identifier>World</span><span class=special>.</span><span class=identifier>greet</span><span class=special>, </span><span class=string>&quot;Greet&quot;</span><span class=special>)
-    </span><span class=identifier>exclude</span><span class=special>(</span><span class=identifier>hello</span><span class=special>.</span><span class=identifier>World</span><span class=special>.</span><span class=identifier>set</span><span class=special>, </span><span class=string>&quot;Set&quot;</span><span class=special>)
-</span></pre></code>
-<table border="0">
-  <tr>
-    <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
-    <td width="30"><a href="wrappers.html"><img src="theme/l_arr.gif" border="0"></a></td>
-    <td width="20"><a href="smart_pointers.html"><img src="theme/r_arr.gif" border="0"></a></td>
-   </tr>
-</table>
-<br>
-<hr size="1"><p class="copyright">Copyright &copy; 2003 Bruno da Silva de Oliveira<br>Copyright &copy; 2002-2003 Joel de Guzman<br><br>
-<font size="2">Permission to copy, use, modify, sell and distribute this document
- is granted provided this copyright notice appears in all copies. This document
- is provided &quot;as is&quot; without express or implied warranty, and with
- no claim as to its suitability for any purpose. </font> </p>
-</body>
-</html>

pyste/doc/global_variables.html

@@ -1,50 +0,0 @@
-<html>
-<head>
-<!-- Generated by the Spirit (http://spirit.sf.net) QuickDoc -->
-<title>Global Variables</title>
-<link rel="stylesheet" href="theme/style.css" type="text/css">
-<link rel="prev" href="smart_pointers.html">
-<link rel="next" href="adding_new_methods.html">
-</head>
-<body>
-<table width="100%" height="48" border="0" cellspacing="2">
-  <tr>
-    <td><img src="theme/c%2B%2Bboost.gif">
-    </td>
-    <td width="85%">
-      <font size="6" face="Verdana, Arial, Helvetica, sans-serif"><b>Global Variables</b></font>
-    </td>
-  </tr>
-</table>
-<br>
-<table border="0">
-  <tr>
-    <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
-    <td width="30"><a href="smart_pointers.html"><img src="theme/l_arr.gif" border="0"></a></td>
-    <td width="20"><a href="adding_new_methods.html"><img src="theme/r_arr.gif" border="0"></a></td>
-   </tr>
-</table>
-<p>
-To export global variables, use the <tt>Var</tt> construct:</p>
-<code><pre>
-    <span class=identifier>Var</span><span class=special>(</span><span class=string>&quot;myglobal&quot;</span><span class=special>, </span><span class=string>&quot;foo.h&quot;</span><span class=special>)
-</span></pre></code>
-<p>
-Beware of non-const global variables: changes in Python won't reflect in C++!
-If you really must change them in Python, you will have to write some accessor
-functions, and export those.</p>
-<table border="0">
-  <tr>
-    <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
-    <td width="30"><a href="smart_pointers.html"><img src="theme/l_arr.gif" border="0"></a></td>
-    <td width="20"><a href="adding_new_methods.html"><img src="theme/r_arr.gif" border="0"></a></td>
-   </tr>
-</table>
-<br>
-<hr size="1"><p class="copyright">Copyright &copy; 2003 Bruno da Silva de Oliveira<br>Copyright &copy; 2002-2003 Joel de Guzman<br><br>
-<font size="2">Permission to copy, use, modify, sell and distribute this document
- is granted provided this copyright notice appears in all copies. This document
- is provided &quot;as is&quot; without express or implied warranty, and with
- no claim as to its suitability for any purpose. </font> </p>
-</body>
-</html>

pyste/doc/introduction.html

@@ -1,74 +0,0 @@
-<html>
-<head>
-<!-- Generated by the Spirit (http://spirit.sf.net) QuickDoc -->
-<title>Introduction</title>
-<link rel="stylesheet" href="theme/style.css" type="text/css">
-<link rel="next" href="running_pyste.html">
-</head>
-<body>
-<table width="100%" height="48" border="0" cellspacing="2">
-  <tr>
-    <td><img src="theme/c%2B%2Bboost.gif">
-    </td>
-    <td width="85%">
-      <font size="6" face="Verdana, Arial, Helvetica, sans-serif"><b>Introduction</b></font>
-    </td>
-  </tr>
-</table>
-<br>
-<table border="0">
-  <tr>
-    <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
-    <td width="30"><img src="theme/l_arr_disabled.gif" border="0"></td>
-    <td width="20"><a href="running_pyste.html"><img src="theme/r_arr.gif" border="0"></a></td>
-   </tr>
-</table>
-<a name="what_is_pyste_"></a><h2>What is Pyste?</h2><p>
-Pyste is a <a href="../../index.html">
-Boost.Python</a> code generator. The user specifies the classes and
-functions to be exported using a simple <i>interface file</i>, which following the
-<a href="../../index.html">
-Boost.Python</a>'s philosophy, is simple Python code. Pyste then uses <a href="http://www.gccxml.org">
-GCCXML</a> to
-parse all the headers and extract the necessary information to automatically
-generate C++ code.</p>
-<a name="example"></a><h2>Example</h2><p>
-Let's borrow the class <tt>World</tt> from the <a href="../../doc/tutorial/doc/exposing_classes.html">
-tutorial</a>: </p>
-<code><pre>
-    <span class=keyword>struct </span><span class=identifier>World
-    </span><span class=special>{
-        </span><span class=keyword>void </span><span class=identifier>set</span><span class=special>(</span><span class=identifier>std</span><span class=special>::</span><span class=identifier>string </span><span class=identifier>msg</span><span class=special>) { </span><span class=keyword>this</span><span class=special>-&gt;</span><span class=identifier>msg </span><span class=special>= </span><span class=identifier>msg</span><span class=special>; }
-        </span><span class=identifier>std</span><span class=special>::</span><span class=identifier>string </span><span class=identifier>greet</span><span class=special>() { </span><span class=keyword>return </span><span class=identifier>msg</span><span class=special>; }
-        </span><span class=identifier>std</span><span class=special>::</span><span class=identifier>string </span><span class=identifier>msg</span><span class=special>;
-    };
-</span></pre></code>
-<p>
-Here's the interface file for it, named <tt>world.pyste</tt>:</p>
-<code><pre>
-    <span class=identifier>Class</span><span class=special>(</span><span class=string>&quot;World&quot;</span><span class=special>, </span><span class=string>&quot;world.h&quot;</span><span class=special>)
-</span></pre></code>
-<p>
-and that's it!</p>
-<p>
-The next step is invoke Pyste in the command-line:</p>
-<code><pre>python pyste.py --module=hello world.pyste</pre></code><p>
-this will create a file &quot;<tt>hello.cpp</tt>&quot; in the directory where the command was
-run. </p>
-<p>
-Pyste supports the following features:</p>
-<ul><li>Functions</li><li>Classes</li><li>Class Templates</li><li>Virtual Methods</li><li>Overloading</li><li>Attributes </li><li>Enums (both &quot;free&quot; enums and class enums)</li><li>Nested Classes</li><li>Support for <tt>boost::shared_ptr</tt> and <tt>std::auto_ptr</tt></li><li>Global Variables</li></ul><table border="0">
-  <tr>
-    <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
-    <td width="30"><img src="theme/l_arr_disabled.gif" border="0"></td>
-    <td width="20"><a href="running_pyste.html"><img src="theme/r_arr.gif" border="0"></a></td>
-   </tr>
-</table>
-<br>
-<hr size="1"><p class="copyright">Copyright &copy; 2003 Bruno da Silva de Oliveira<br>Copyright &copy; 2002-2003 Joel de Guzman<br><br>
-<font size="2">Permission to copy, use, modify, sell and distribute this document
- is granted provided this copyright notice appears in all copies. This document
- is provided &quot;as is&quot; without express or implied warranty, and with
- no claim as to its suitability for any purpose. </font> </p>
-</body>
-</html>

pyste/doc/policies.html

@@ -1,90 +0,0 @@
-<html>
-<head>
-<!-- Generated by the Spirit (http://spirit.sf.net) QuickDoc -->
-<title>Policies</title>
-<link rel="stylesheet" href="theme/style.css" type="text/css">
-<link rel="prev" href="renaming_and_excluding.html">
-<link rel="next" href="templates.html">
-</head>
-<body>
-<table width="100%" height="48" border="0" cellspacing="2">
-  <tr>
-    <td><img src="theme/c%2B%2Bboost.gif">
-    </td>
-    <td width="85%">
-      <font size="6" face="Verdana, Arial, Helvetica, sans-serif"><b>Policies</b></font>
-    </td>
-  </tr>
-</table>
-<br>
-<table border="0">
-  <tr>
-    <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
-    <td width="30"><a href="renaming_and_excluding.html"><img src="theme/l_arr.gif" border="0"></a></td>
-    <td width="20"><a href="templates.html"><img src="theme/r_arr.gif" border="0"></a></td>
-   </tr>
-</table>
-<p>
-Even thought Pyste can identify various elements in the C++ code, like virtual
-methods, attributes, and so on, one thing that it can't do is to guess the
-semantics of functions that return pointers or references. In this case, the
-user must manually specify the policy. Policies are explained in the
-<a href="../../doc/tutorial/doc/call_policies.html">
-tutorial</a>.</p>
-<p>
-The policies in Pyste are named exactly as in <a href="../../index.html">
-Boost.Python</a>, only the syntax is
-slightly different. For instance, this policy:</p>
-<code><pre>
-    <span class=identifier>return_internal_reference</span><span class=special>&lt;</span><span class=number>1</span><span class=special>, </span><span class=identifier>with_custodian_and_ward</span><span class=special>&lt;</span><span class=number>1</span><span class=special>, </span><span class=number>2</span><span class=special>&gt; &gt;()
-</span></pre></code>
-<p>
-becomes in Pyste:    </p>
-<code><pre>
-    <span class=identifier>return_internal_reference</span><span class=special>(</span><span class=number>1</span><span class=special>, </span><span class=identifier>with_custodian_and_ward</span><span class=special>(</span><span class=number>1</span><span class=special>, </span><span class=number>2</span><span class=special>))
-</span></pre></code>
-<p>
-The user can specify policies for functions and methods with the <tt>set_policy</tt>
-function:</p>
-<code><pre>
-    <span class=identifier>set_policy</span><span class=special>(</span><span class=identifier>f</span><span class=special>, </span><span class=identifier>return_internal_reference</span><span class=special>())
-    </span><span class=identifier>set_policy</span><span class=special>(</span><span class=identifier>C</span><span class=special>.</span><span class=identifier>foo</span><span class=special>, </span><span class=identifier>return_value_policy</span><span class=special>(</span><span class=identifier>manage_new_object</span><span class=special>))
-</span></pre></code>
-<table width="80%" border="0" align="center">
-  <tr>
-    <td class="note_box">
-
-<img src="theme/note.gif"></img> <b>What if a function or method needs a policy and the user
-doesn't set one?</b><br><br> If a function/method needs a policy and one was not
-set, Pyste will issue a error.  The user should then go in the interface file
-and set the policy for it, otherwise the generated cpp won't compile.
-    </td>
-  </tr>
-</table>
-<table width="80%" border="0" align="center">
-  <tr>
-    <td class="note_box">
-
-<img src="theme/note.gif"></img> 
-Note that, for functions/methods that return <tt>const T&amp;</tt>, the policy
-<tt>return_value_policy&lt;copy_const_reference&gt;()</tt> wil be used by default, because
-that's normally what you want. You can change it to something else if you need
-to, though.
-    </td>
-  </tr>
-</table>
-<table border="0">
-  <tr>
-    <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
-    <td width="30"><a href="renaming_and_excluding.html"><img src="theme/l_arr.gif" border="0"></a></td>
-    <td width="20"><a href="templates.html"><img src="theme/r_arr.gif" border="0"></a></td>
-   </tr>
-</table>
-<br>
-<hr size="1"><p class="copyright">Copyright &copy; 2003 Bruno da Silva de Oliveira<br>Copyright &copy; 2002-2003 Joel de Guzman<br><br>
-<font size="2">Permission to copy, use, modify, sell and distribute this document
- is granted provided this copyright notice appears in all copies. This document
- is provided &quot;as is&quot; without express or implied warranty, and with
- no claim as to its suitability for any purpose. </font> </p>
-</body>
-</html>

pyste/doc/pyste.txt

@@ -1,516 +0,0 @@
-[doc Pyste Documentation]
-
-[def GCCXML             [@http://www.gccxml.org GCCXML]]
-[def Boost.Python       [@../../index.html Boost.Python]]
-
-[page Introduction]
-
-[h2 What is Pyste?]
-
-Pyste is a Boost.Python code generator. The user specifies the classes and
-functions to be exported using a simple ['interface file], which following the
-Boost.Python's philosophy, is simple Python code. Pyste then uses GCCXML to
-parse all the headers and extract the necessary information to automatically
-generate C++ code.
-
-[h2 Example]
-
-Let's borrow the class [^World] from the [@../../doc/tutorial/doc/exposing_classes.html tutorial]: 
-
-    struct World
-    {
-        void set(std::string msg) { this->msg = msg; }
-        std::string greet() { return msg; }
-        std::string msg;
-    };
-
-Here's the interface file for it, named [^world.pyste]:
-
-    Class("World", "world.h")
-
-and that's it!
-
-The next step is invoke Pyste in the command-line:
-
-[pre python pyste.py --module=hello world.pyste]
-
-this will create a file "[^hello.cpp]" in the directory where the command was
-run. 
-
-Pyste supports the following features:
-
-* Functions
-* Classes
-* Class Templates
-* Virtual Methods
-* Overloading
-* Attributes 
-* Enums (both "free" enums and class enums)
-* Nested Classes
-* Support for [^boost::shared_ptr] and [^std::auto_ptr]
-* Global Variables
-
-[page Running Pyste]
-
-To run Pyste, you will need:
-
-* Python 2.2, available at [@http://www.python.org python's website].
-* The great [@http://effbot.org elementtree] library, from Fredrik Lundh.
-* The excellent GCCXML, from Brad King.
-
-Installation for the tools is available in their respective webpages.
-
-[blurb 
-[$theme/note.gif] GCCXML must be accessible in the PATH environment variable, so
-that Pyste can call it. How to do this varies from platform to platform.
-]
-
-[h2 Ok, now what?]
-
-Well, now let's fire it up:
-
-[pre 
-'''
->python pyste.py
-
-Pyste version 0.6.5
-
-Usage:
-    pyste [options] --module=<name> interface-files
-
-where options are:
-    -I <path>           add an include path    
-    -D <symbol>         define symbol    
-    --multiple          create various cpps, instead of only one 
-                        (useful during development)                        
-    --out               specify output filename (default: <module>.cpp)
-                        in --multiple mode, this will be a directory
-    --no-using          do not declare "using namespace boost";
-                        use explicit declarations instead
-    --pyste-ns=<name>   set the namespace where new types will be declared;
-                        default is the empty namespace
-    --debug             writes the xml for each file parsed in the current
-                        directory
-    -h, --help          print this help and exit
-    -v, --version       print version information      
-'''                        
-]
-
-Options explained:
-
-The [^-I] and [^-D] are preprocessor flags, which are needed by GCCXML to parse
-the header files correctly and by Pyste to find the header files declared in the
-interface files.
-
-[^--multiple] tells Pyste to generate multiple cpps for this module (one for
-each header parsed) in the directory named by [^--out], instead of the usual
-single cpp file. This mode is useful during development of a binding, because
-you are constantly changing source files, re-generating the bindings and
-recompiling. This saves a lot of time in compiling.
-
-[^--out] names the output file (default: [^<module>.cpp]), or in multiple mode,
-names a output directory for the files (default: [^<module>]).
-
-[^--no-using] tells Pyste to don't declare "[^using namespace boost;]" in the
-generated cpp, using the namespace boost::python explicitly in all declarations.
-Use only if you're having a name conflict in one of the files.
-
-Use [^--pyste-ns] to change the namespace where new types are declared (for
-instance, the virtual wrappers). Use only if you are having any problems. By
-default, Pyste uses the empty namespace.
-
-[^--debug] will write in the current directory a xml file as outputted by GCCXML
-for each header parsed. Useful for bug reports.
-
-[^-h, --help, -v, --version] are self-explaining, I believe. ;)
-
-So, the usage is simple enough:
-
-[pre >python pyste.py --module=mymodule file.pyste file2.pyste ...]
-
-will generate a file [^mymodule.cpp] in the same dir where the command was
-executed. Now you can compile the file using the same instructions of the
-[@../../doc/tutorial/doc/building_hello_world.html tutorial]. Or, if you prefer:
-
-[pre >python pyste.py --module=mymodule --multiple file.pyste file2.pyste ...]
-
-will create a directory named "mymodule" in the current directory, and will
-generate a bunch of cpp files, one for each header exported. You can then
-compile them all into a single shared library (or dll).
-
-[h2 Wait... how do I set those I and D flags?]
-
-Don't worry: normally GCCXML is already configured correctly for your plataform, 
-so the search path to the standard libraries and the standard defines should 
-already be set. You only have to set the paths to other libraries that your code 
-needs, like Boost, for example.
-
-Plus, Pyste automatically uses the contents of the environment variable
-[^INCLUDE] if it exists. Visual C++ users should run the [^Vcvars32.bat] file,
-which for Visual C++ 6 is normally located at:
-
-    C:\Program Files\Microsoft Visual Studio\VC98\bin\Vcvars32.bat
-
-with that, you should have little trouble setting up the flags.
-
-[blurb [$theme/note.gif][*A note about Psyco][br][br]
-Although you don't have to install [@http://psyco.sourceforge.net/ Psyco] to use Pyste, if you do, Pyste will make use of it to speed up the wrapper generation. Speed ups of 30% can be achieved, so it's highly recommended.
-]
-
-[page The Interface Files]
-
-The interface files are the heart of Pyste. The user creates one or more
-interface files declaring the classes and functions he wants to export, and then
-invokes Pyste passing the interface files to it. Pyste then generates a single
-cpp file with Boost.Python code, with all the classes and functions exported.
-
-Besides declaring the classes and functions, the user has a number of other
-options, like renaming classes and methods, excluding methods and attributes,
-and so on. 
-
-[h2 Basics]
-
-Suppose we have a class and some functions that we want to expose to Python
-declared in the header [^hello.h]:
-
-    struct World
-    {
-        World(std::string msg): msg(msg) {} 
-        void set(std::string msg) { this->msg = msg; }
-        std::string greet() { return msg; }
-        std::string msg;
-    };
-
-    enum choice { red, blue };
-    
-    namespace test {
-    
-    void show(choice c) { std::cout << "value: " << (int)c << std::endl; }
-    
-    }
-
-We create a file named [^hello.pyste] and create instances of the classes
-[^Function], [^Class] and [^Enum]:
-
-    Function("test::show", "hello.h")
-    Class("World", "hello.h")
-    Enum("choice", "hello.h")
-
-That will expose the class, the free function and the enum found in [^hello.h]. 
-
-[page:1 Renaming and Excluding]
-
-You can easily rename functions, classes, methods, attributes, etc. Just use the
-function [^rename], like this:
-
-    World = Class("World", "hello.h")
-    rename(World, "IWorld")
-    show = Function("choice", "hello.h")
-    rename(show, "Show")
-
-You can rename methods and attributes using this syntax:
-
-    rename(World.greet, "Greet")
-    rename(World.set, "Set")
-    choice = Enum("choice", "hello.h")
-    rename(choice.red, "Red")
-    rename(choice.blue, "Blue")
-
-You can exclude functions, classes, methods, attributes, etc, in the same way,
-with the function [^exclude]:
-
-    exclude(World.greet)
-    exclude(World.msg)
-
-To access the operators of a class, access the member [^operator] like this
-(supposing that [^C] is a class being exported):
-
-    exclude(C.operator['+'])
-    exclude(C.operator['*'])
-    exclude(C.operator['<<'])
-
-The string inside the brackets is the same as the name of the operator in C++.[br]
-
-[page:1 Policies]
-
-Even thought Pyste can identify various elements in the C++ code, like virtual
-methods, attributes, and so on, one thing that it can't do is to guess the
-semantics of functions that return pointers or references. In this case, the
-user must manually specify the policy. Policies are explained in the
-[@../../doc/tutorial/doc/call_policies.html tutorial].
-
-The policies in Pyste are named exactly as in Boost.Python, only the syntax is
-slightly different. For instance, this policy:
-
-    return_internal_reference<1, with_custodian_and_ward<1, 2> >()
-
-becomes in Pyste:    
-
-    return_internal_reference(1, with_custodian_and_ward(1, 2))
-
-The user can specify policies for functions and methods with the [^set_policy]
-function:
-
-    set_policy(f, return_internal_reference())
-    set_policy(C.foo, return_value_policy(manage_new_object))
-
-[blurb 
-[$theme/note.gif] [*What if a function or method needs a policy and the user
-doesn't set one?][br][br] If a function/method needs a policy and one was not
-set, Pyste will issue a error.  The user should then go in the interface file
-and set the policy for it, otherwise the generated cpp won't compile.
-]
-
-[blurb
-[$theme/note.gif] 
-Note that, for functions/methods that return [^const T&], the policy
-[^return_value_policy<copy_const_reference>()] wil be used by default, because
-that's normally what you want. You can change it to something else if you need
-to, though.
-]
-
-[page:1 Templates]
-
-Template classes can easily be exported too, but you can't export the template
-itself... you have to export instantiations of it! So, if you want to export a
-[^std::vector], you will have to export vectors of int, doubles, etc.
-
-Suppose we have this code:
-
-    template <class T>
-    struct Point
-    {
-        T x;
-        T y;
-    };
-
-And we want to export [^Point]s of int and double:
-
-    Point = Template("Point", "point.h")
-    Point("int")
-    Point("double")
-
-Pyste will assign default names for each instantiation. In this example, those
-would be "[^Point_int]" and "[^Point_double]", but most of the time users will want to
-rename the instantiations:
-
-    Point("int", "IPoint")         // renames the instantiation
-    double_inst = Point("double")  // another way to do the same
-    rename(double_inst, "DPoint")
-
-Note that you can rename, exclude, set policies, etc, in the [^Template] object
-like you would do with a [^Function] or a [^Class]. This changes affect all
-[*future] instantiations:
-
-    Point = Template("Point", "point.h")
-    Point("float", "FPoint")        // will have x and y as data members
-    rename(Point.x, "X")
-    rename(Point.y, "Y")
-    Point("int", "IPoint")          // will have X and Y as data members
-    Point("double", "DPoint")       // also will have X and Y as data member
-
-If you want to change a option of a particular instantiation, you can do so:
-
-    Point = Template("Point", "point.h")
-    Point("int", "IPoint")          
-    d_inst = Point("double", "DPoint")       
-    rename(d_inst.x, "X")           // only DPoint is affect by this renames,
-    rename(d_inst.y, "Y")           // IPoint stays intact
-
-[blurb [$theme/note.gif] [*What if my template accepts more than one type?]
-[br][br]
-When you want to instantiate a template with more than one type, you can pass
-either a string with the types separated by whitespace, or a list of strings
-'''("int double" or ["int", "double"]''' would both work).
-]
-
-[page:1 Wrappers]
-
-Suppose you have this function:
-
-    std::vector<std::string> names();
-
-But you don't want to export [^std::vector<std::string>], you want this function
-to return a python list of strings. Boost.Python has excellent support for
-that:
-
-    list names_wrapper()
-    {
-        list result;
-        // call original function
-        vector<string> v = names();
-        // put all the strings inside the python list
-        vector<string>::iterator it;
-        for (it = v.begin(); it != v.end(); ++it){
-            result.append(*it);    
-        }
-        return result;
-    }
-    
-    BOOST_PYTHON_MODULE(test)
-    {
-        def("names", &names_wrapper);
-    }
-
-Nice heh? Pyste supports this mechanism too. You declare the [^names_wrapper]
-function in a header named "[^test_wrappers.h]" and in the interface file:
-
-    Include("test_wrappers.h")
-    names = Function("names", "test.h")
-    set_wrapper(names, "names_wrapper")
-
-You can optionally declare the function in the interface file itself:
-
-    names_wrapper = Wrapper("names_wrapper",
-    """
-    list names_wrapper()
-    {
-        // code to call name() and convert the vector to a list...
-    }
-    """)
-    names = Function("names", "test.h")
-    set_wrapper(names, names_wrapper)
-
-The same mechanism can be used with methods too. Just remember that the first
-parameter of wrappers for methods is a pointer to the class, like in
-Boost.Python:
-
-    struct C
-    {
-        std::vector<std::string> names();
-    }
-
-    list names_wrapper(C* c)
-    {
-        // same as before, calling c->names() and converting result to a list 
-    }
-
-And then in the interface file:
-
-    C = Class("C", "test.h")
-    set_wrapper(C.names, "names_wrapper")
-
-[blurb 
-[$theme/note.gif]Even though Boost.Python accepts either a pointer or a
-reference to the class in wrappers for member functions as the first parameter,
-Pyste expects them to be a [*pointer]. Doing otherwise will prevent your
-code to compile when you set a wrapper for a virtual method.
-]
-
-[page:1 Exporting All Declarations from a Header]
-
-Pyste also supports a mechanism to export all declarations found in a header
-file. Suppose again our file, [^hello.h]:
-
-    struct World
-    {
-        World(std::string msg): msg(msg) {} 
-        void set(std::string msg) { this->msg = msg; }
-        std::string greet() { return msg; }
-        std::string msg;
-    };
-
-    enum choice { red, blue };
-    
-    void show(choice c) { std::cout << "value: " << (int)c << std::endl; } 
-
-You can just use the [^AllFromHeader] construct:
-
-    hello = AllFromHeader("hello.h")
-
-this will export all the declarations found in [^hello.h], which is equivalent
-to write:
-
-    Class("World", "hello.h")
-    Enum("choice", "hello.h")
-    Function("show", "hello.h")
-
-Note that you can still use the functions [^rename], [^set_policy], [^exclude], etc. Just access
-the members of the header object like this:
-
-    rename(hello.World.greet, "Greet")
-    exclude(hello.World.set, "Set")
-
-
-[page:1 Smart Pointers]
-
-Pyste for now has manual support for smart pointers. Suppose:
-
-    struct C
-    {
-        int value;
-    };
-
-    boost::shared_ptr<C> newC(int value)
-    {
-        boost::shared_ptr<C> c( new C() );
-        c->value = value;
-        return c;
-    }
-
-    void printC(boost::shared_ptr<C> c)
-    {
-        std::cout << c->value << std::endl;
-    }
-
-To make [^newC] and [^printC] work correctly, you have to tell Pyste that a
-convertor for [^boost::shared_ptr<C>] is needed.
-
-    C = Class('C', 'C.h')
-    use_shared_ptr(C)
-    Function('newC', 'C.h')
-    Function('printC', 'C.h')
-
-For [^std::auto_ptr]'s, use the function [^use_auto_ptr].
-
-This system is temporary, and in the future the converters will automatically be
-exported if needed, without the need to tell Pyste about them explicitly.
-
-
-[page:1 Global Variables]
-
-To export global variables, use the [^Var] construct:
-
-    Var("myglobal", "foo.h")
-
-Beware of non-const global variables: changes in Python won't reflect in C++!
-If you really must change them in Python, you will have to write some accessor
-functions, and export those.
-
-[page:1 Adding New Methods]
-
-Suppose that you want to add a function to a class, turning it into a method:
-
-    struct World
-    {
-        void set(std::string msg) { this->msg = msg; }
-        std::string msg;
-    };
-
-    std::string greet(World& w)
-    {
-        return w.msg;
-    }
-
-Here, we want to make [^greet] work as a method of the class [^World]. We do
-that using the [^add_method] construct:
-
-    W = Class("World", "hello.h")
-    add_method(W, "greet")
-
-Notice also that then you can rename it, set its policy, just like a regular
-method:
-
-    rename(W.greet, 'Greet')
-
-Now from Python:
-
-    >>> import hello
-    >>> w = hello.World()
-    >>> w.set('Ni')
-    >>> w.greet()
-    'Ni'
-    >>> print 'Oh no! The knights who say Ni!'
-    Oh no! The knights who say Ni!
-
-

pyste/doc/renaming_and_excluding.html

@@ -1,76 +0,0 @@
-<html>
-<head>
-<!-- Generated by the Spirit (http://spirit.sf.net) QuickDoc -->
-<title>Renaming and Excluding</title>
-<link rel="stylesheet" href="theme/style.css" type="text/css">
-<link rel="prev" href="the_interface_files.html">
-<link rel="next" href="policies.html">
-</head>
-<body>
-<table width="100%" height="48" border="0" cellspacing="2">
-  <tr>
-    <td><img src="theme/c%2B%2Bboost.gif">
-    </td>
-    <td width="85%">
-      <font size="6" face="Verdana, Arial, Helvetica, sans-serif"><b>Renaming and Excluding</b></font>
-    </td>
-  </tr>
-</table>
-<br>
-<table border="0">
-  <tr>
-    <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
-    <td width="30"><a href="the_interface_files.html"><img src="theme/l_arr.gif" border="0"></a></td>
-    <td width="20"><a href="policies.html"><img src="theme/r_arr.gif" border="0"></a></td>
-   </tr>
-</table>
-<p>
-You can easily rename functions, classes, methods, attributes, etc. Just use the
-function <tt>rename</tt>, like this:</p>
-<code><pre>
-    <span class=identifier>World </span><span class=special>= </span><span class=identifier>Class</span><span class=special>(</span><span class=string>&quot;World&quot;</span><span class=special>, </span><span class=string>&quot;hello.h&quot;</span><span class=special>)
-    </span><span class=identifier>rename</span><span class=special>(</span><span class=identifier>World</span><span class=special>, </span><span class=string>&quot;IWorld&quot;</span><span class=special>)
-    </span><span class=identifier>show </span><span class=special>= </span><span class=identifier>Function</span><span class=special>(</span><span class=string>&quot;choice&quot;</span><span class=special>, </span><span class=string>&quot;hello.h&quot;</span><span class=special>)
-    </span><span class=identifier>rename</span><span class=special>(</span><span class=identifier>show</span><span class=special>, </span><span class=string>&quot;Show&quot;</span><span class=special>)
-</span></pre></code>
-<p>
-You can rename methods and attributes using this syntax:</p>
-<code><pre>
-    <span class=identifier>rename</span><span class=special>(</span><span class=identifier>World</span><span class=special>.</span><span class=identifier>greet</span><span class=special>, </span><span class=string>&quot;Greet&quot;</span><span class=special>)
-    </span><span class=identifier>rename</span><span class=special>(</span><span class=identifier>World</span><span class=special>.</span><span class=identifier>set</span><span class=special>, </span><span class=string>&quot;Set&quot;</span><span class=special>)
-    </span><span class=identifier>choice </span><span class=special>= </span><span class=identifier>Enum</span><span class=special>(</span><span class=string>&quot;choice&quot;</span><span class=special>, </span><span class=string>&quot;hello.h&quot;</span><span class=special>)
-    </span><span class=identifier>rename</span><span class=special>(</span><span class=identifier>choice</span><span class=special>.</span><span class=identifier>red</span><span class=special>, </span><span class=string>&quot;Red&quot;</span><span class=special>)
-    </span><span class=identifier>rename</span><span class=special>(</span><span class=identifier>choice</span><span class=special>.</span><span class=identifier>blue</span><span class=special>, </span><span class=string>&quot;Blue&quot;</span><span class=special>)
-</span></pre></code>
-<p>
-You can exclude functions, classes, methods, attributes, etc, in the same way,
-with the function <tt>exclude</tt>:</p>
-<code><pre>
-    <span class=identifier>exclude</span><span class=special>(</span><span class=identifier>World</span><span class=special>.</span><span class=identifier>greet</span><span class=special>)
-    </span><span class=identifier>exclude</span><span class=special>(</span><span class=identifier>World</span><span class=special>.</span><span class=identifier>msg</span><span class=special>)
-</span></pre></code>
-<p>
-To access the operators of a class, access the member <tt>operator</tt> like this
-(supposing that <tt>C</tt> is a class being exported):</p>
-<code><pre>
-    <span class=identifier>exclude</span><span class=special>(</span><span class=identifier>C</span><span class=special>.</span><span class=keyword>operator</span><span class=special>[</span><span class=literal>'+'</span><span class=special>])
-    </span><span class=identifier>exclude</span><span class=special>(</span><span class=identifier>C</span><span class=special>.</span><span class=keyword>operator</span><span class=special>[</span><span class=literal>'*'</span><span class=special>])
-    </span><span class=identifier>exclude</span><span class=special>(</span><span class=identifier>C</span><span class=special>.</span><span class=keyword>operator</span><span class=special>[</span><span class=literal>'&lt;&lt;'</span><span class=special>])
-</span></pre></code>
-<p>
-The string inside the brackets is the same as the name of the operator in C++.<br></p>
-<table border="0">
-  <tr>
-    <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
-    <td width="30"><a href="the_interface_files.html"><img src="theme/l_arr.gif" border="0"></a></td>
-    <td width="20"><a href="policies.html"><img src="theme/r_arr.gif" border="0"></a></td>
-   </tr>
-</table>
-<br>
-<hr size="1"><p class="copyright">Copyright &copy; 2003 Bruno da Silva de Oliveira<br>Copyright &copy; 2002-2003 Joel de Guzman<br><br>
-<font size="2">Permission to copy, use, modify, sell and distribute this document
- is granted provided this copyright notice appears in all copies. This document
- is provided &quot;as is&quot; without express or implied warranty, and with
- no claim as to its suitability for any purpose. </font> </p>
-</body>
-</html>

pyste/doc/running_pyste.html

@@ -1,150 +0,0 @@
-<html>
-<head>
-<!-- Generated by the Spirit (http://spirit.sf.net) QuickDoc -->
-<title>Running Pyste</title>
-<link rel="stylesheet" href="theme/style.css" type="text/css">
-<link rel="prev" href="introduction.html">
-<link rel="next" href="the_interface_files.html">
-</head>
-<body>
-<table width="100%" height="48" border="0" cellspacing="2">
-  <tr>
-    <td><img src="theme/c%2B%2Bboost.gif">
-    </td>
-    <td width="85%">
-      <font size="6" face="Verdana, Arial, Helvetica, sans-serif"><b>Running Pyste</b></font>
-    </td>
-  </tr>
-</table>
-<br>
-<table border="0">
-  <tr>
-    <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
-    <td width="30"><a href="introduction.html"><img src="theme/l_arr.gif" border="0"></a></td>
-    <td width="20"><a href="the_interface_files.html"><img src="theme/r_arr.gif" border="0"></a></td>
-   </tr>
-</table>
-<p>
-To run Pyste, you will need:</p>
-<ul><li>Python 2.2, available at <a href="http://www.python.org">
-python's website</a>.</li><li>The great <a href="http://effbot.org">
-elementtree</a> library, from Fredrik Lundh.</li><li>The excellent <a href="http://www.gccxml.org">
-GCCXML</a>, from Brad King.</li></ul><p>
-Installation for the tools is available in their respective webpages.</p>
-<table width="80%" border="0" align="center">
-  <tr>
-    <td class="note_box">
-
-<img src="theme/note.gif"></img> <a href="http://www.gccxml.org">
-GCCXML</a> must be accessible in the PATH environment variable, so
-that Pyste can call it. How to do this varies from platform to platform.
-    </td>
-  </tr>
-</table>
-<a name="ok__now_what_"></a><h2>Ok, now what?</h2><p>
-Well, now let's fire it up:</p>
-<code><pre>
-
-&gt;python pyste.py
-
-Pyste version 0.6.5
-
-Usage:
-    pyste [options] --module=&lt;name&gt; interface-files
-
-where options are:
-    -I &lt;path&gt;           add an include path    
-    -D &lt;symbol&gt;         define symbol    
-    --multiple          create various cpps, instead of only one 
-                        (useful during development)                        
-    --out               specify output filename (default: &lt;module&gt;.cpp)
-                        in --multiple mode, this will be a directory
-    --no-using          do not declare &quot;using namespace boost&quot;;
-                        use explicit declarations instead
-    --pyste-ns=&lt;name&gt;   set the namespace where new types will be declared;
-                        default is the empty namespace
-    --debug             writes the xml for each file parsed in the current
-                        directory
-    -h, --help          print this help and exit
-    -v, --version       print version information      
-                        
-</pre></code><p>
-Options explained:</p>
-<p>
-The <tt>-I</tt> and <tt>-D</tt> are preprocessor flags, which are needed by <a href="http://www.gccxml.org">
-GCCXML</a> to parse
-the header files correctly and by Pyste to find the header files declared in the
-interface files.</p>
-<p>
-<tt>--multiple</tt> tells Pyste to generate multiple cpps for this module (one for
-each header parsed) in the directory named by <tt>--out</tt>, instead of the usual
-single cpp file. This mode is useful during development of a binding, because
-you are constantly changing source files, re-generating the bindings and
-recompiling. This saves a lot of time in compiling.</p>
-<p>
-<tt>--out</tt> names the output file (default: <tt>&lt;module&gt;.cpp</tt>), or in multiple mode,
-names a output directory for the files (default: <tt>&lt;module&gt;</tt>).</p>
-<p>
-<tt>--no-using</tt> tells Pyste to don't declare &quot;<tt>using namespace boost;</tt>&quot; in the
-generated cpp, using the namespace boost::python explicitly in all declarations.
-Use only if you're having a name conflict in one of the files.</p>
-<p>
-Use <tt>--pyste-ns</tt> to change the namespace where new types are declared (for
-instance, the virtual wrappers). Use only if you are having any problems. By
-default, Pyste uses the empty namespace.</p>
-<p>
-<tt>--debug</tt> will write in the current directory a xml file as outputted by <a href="http://www.gccxml.org">
-GCCXML</a>
-for each header parsed. Useful for bug reports.</p>
-<p>
-<tt>-h, --help, -v, --version</tt> are self-explaining, I believe. ;)</p>
-<p>
-So, the usage is simple enough:</p>
-<code><pre>&gt;python pyste.py --module=mymodule file.pyste file2.pyste ...</pre></code><p>
-will generate a file <tt>mymodule.cpp</tt> in the same dir where the command was
-executed. Now you can compile the file using the same instructions of the
-<a href="../../doc/tutorial/doc/building_hello_world.html">
-tutorial</a>. Or, if you prefer:</p>
-<code><pre>&gt;python pyste.py --module=mymodule --multiple file.pyste file2.pyste ...</pre></code><p>
-will create a directory named &quot;mymodule&quot; in the current directory, and will
-generate a bunch of cpp files, one for each header exported. You can then
-compile them all into a single shared library (or dll).</p>
-<a name="wait____how_do_i_set_those_i_and_d_flags_"></a><h2>Wait... how do I set those I and D flags?</h2><p>
-Don't worry: normally <a href="http://www.gccxml.org">
-GCCXML</a> is already configured correctly for your plataform, 
-so the search path to the standard libraries and the standard defines should 
-already be set. You only have to set the paths to other libraries that your code 
-needs, like Boost, for example.</p>
-<p>
-Plus, Pyste automatically uses the contents of the environment variable
-<tt>INCLUDE</tt> if it exists. Visual C++ users should run the <tt>Vcvars32.bat</tt> file,
-which for Visual C++ 6 is normally located at:</p>
-<code><pre>
-    <span class=identifier>C</span><span class=special>:\</span><span class=identifier>Program </span><span class=identifier>Files</span><span class=special>\</span><span class=identifier>Microsoft </span><span class=identifier>Visual </span><span class=identifier>Studio</span><span class=special>\</span><span class=identifier>VC98</span><span class=special>\</span><span class=identifier>bin</span><span class=special>\</span><span class=identifier>Vcvars32</span><span class=special>.</span><span class=identifier>bat
-</span></pre></code>
-<p>
-with that, you should have little trouble setting up the flags.</p>
-<table width="80%" border="0" align="center">
-  <tr>
-    <td class="note_box">
-<img src="theme/note.gif"></img><b>A note about Psyco</b><br><br>
-Although you don't have to install <a href="http://psyco.sourceforge.net/">
-Psyco</a> to use Pyste, if you do, Pyste will make use of it to speed up the wrapper generation. Speed ups of 30% can be achieved, so it's highly recommended.
-    </td>
-  </tr>
-</table>
-<table border="0">
-  <tr>
-    <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
-    <td width="30"><a href="introduction.html"><img src="theme/l_arr.gif" border="0"></a></td>
-    <td width="20"><a href="the_interface_files.html"><img src="theme/r_arr.gif" border="0"></a></td>
-   </tr>
-</table>
-<br>
-<hr size="1"><p class="copyright">Copyright &copy; 2003 Bruno da Silva de Oliveira<br>Copyright &copy; 2002-2003 Joel de Guzman<br><br>
-<font size="2">Permission to copy, use, modify, sell and distribute this document
- is granted provided this copyright notice appears in all copies. This document
- is provided &quot;as is&quot; without express or implied warranty, and with
- no claim as to its suitability for any purpose. </font> </p>
-</body>
-</html>

pyste/doc/smart_pointers.html

@@ -1,75 +0,0 @@
-<html>
-<head>
-<!-- Generated by the Spirit (http://spirit.sf.net) QuickDoc -->
-<title>Smart Pointers</title>
-<link rel="stylesheet" href="theme/style.css" type="text/css">
-<link rel="prev" href="exporting_all_declarations_from_a_header.html">
-<link rel="next" href="global_variables.html">
-</head>
-<body>
-<table width="100%" height="48" border="0" cellspacing="2">
-  <tr>
-    <td><img src="theme/c%2B%2Bboost.gif">
-    </td>
-    <td width="85%">
-      <font size="6" face="Verdana, Arial, Helvetica, sans-serif"><b>Smart Pointers</b></font>
-    </td>
-  </tr>
-</table>
-<br>
-<table border="0">
-  <tr>
-    <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
-    <td width="30"><a href="exporting_all_declarations_from_a_header.html"><img src="theme/l_arr.gif" border="0"></a></td>
-    <td width="20"><a href="global_variables.html"><img src="theme/r_arr.gif" border="0"></a></td>
-   </tr>
-</table>
-<p>
-Pyste for now has manual support for smart pointers. Suppose:</p>
-<code><pre>
-    <span class=keyword>struct </span><span class=identifier>C
-    </span><span class=special>{
-        </span><span class=keyword>int </span><span class=identifier>value</span><span class=special>;
-    };
-
-    </span><span class=identifier>boost</span><span class=special>::</span><span class=identifier>shared_ptr</span><span class=special>&lt;</span><span class=identifier>C</span><span class=special>&gt; </span><span class=identifier>newC</span><span class=special>(</span><span class=keyword>int </span><span class=identifier>value</span><span class=special>)
-    {
-        </span><span class=identifier>boost</span><span class=special>::</span><span class=identifier>shared_ptr</span><span class=special>&lt;</span><span class=identifier>C</span><span class=special>&gt; </span><span class=identifier>c</span><span class=special>( </span><span class=keyword>new </span><span class=identifier>C</span><span class=special>() );
-        </span><span class=identifier>c</span><span class=special>-&gt;</span><span class=identifier>value </span><span class=special>= </span><span class=identifier>value</span><span class=special>;
-        </span><span class=keyword>return </span><span class=identifier>c</span><span class=special>;
-    }
-
-    </span><span class=keyword>void </span><span class=identifier>printC</span><span class=special>(</span><span class=identifier>boost</span><span class=special>::</span><span class=identifier>shared_ptr</span><span class=special>&lt;</span><span class=identifier>C</span><span class=special>&gt; </span><span class=identifier>c</span><span class=special>)
-    {
-        </span><span class=identifier>std</span><span class=special>::</span><span class=identifier>cout </span><span class=special>&lt;&lt; </span><span class=identifier>c</span><span class=special>-&gt;</span><span class=identifier>value </span><span class=special>&lt;&lt; </span><span class=identifier>std</span><span class=special>::</span><span class=identifier>endl</span><span class=special>;
-    }
-</span></pre></code>
-<p>
-To make <tt>newC</tt> and <tt>printC</tt> work correctly, you have to tell Pyste that a
-convertor for <tt>boost::shared_ptr&lt;C&gt;</tt> is needed.</p>
-<code><pre>
-    <span class=identifier>C </span><span class=special>= </span><span class=identifier>Class</span><span class=special>(</span><span class=literal>'C'</span><span class=special>, </span><span class=literal>'C.h'</span><span class=special>)
-    </span><span class=identifier>use_shared_ptr</span><span class=special>(</span><span class=identifier>C</span><span class=special>)
-    </span><span class=identifier>Function</span><span class=special>(</span><span class=literal>'newC'</span><span class=special>, </span><span class=literal>'C.h'</span><span class=special>)
-    </span><span class=identifier>Function</span><span class=special>(</span><span class=literal>'printC'</span><span class=special>, </span><span class=literal>'C.h'</span><span class=special>)
-</span></pre></code>
-<p>
-For <tt>std::auto_ptr</tt>'s, use the function <tt>use_auto_ptr</tt>.</p>
-<p>
-This system is temporary, and in the future the converters will automatically be
-exported if needed, without the need to tell Pyste about them explicitly.</p>
-<table border="0">
-  <tr>
-    <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
-    <td width="30"><a href="exporting_all_declarations_from_a_header.html"><img src="theme/l_arr.gif" border="0"></a></td>
-    <td width="20"><a href="global_variables.html"><img src="theme/r_arr.gif" border="0"></a></td>
-   </tr>
-</table>
-<br>
-<hr size="1"><p class="copyright">Copyright &copy; 2003 Bruno da Silva de Oliveira<br>Copyright &copy; 2002-2003 Joel de Guzman<br><br>
-<font size="2">Permission to copy, use, modify, sell and distribute this document
- is granted provided this copyright notice appears in all copies. This document
- is provided &quot;as is&quot; without express or implied warranty, and with
- no claim as to its suitability for any purpose. </font> </p>
-</body>
-</html>

pyste/doc/templates.html

@@ -1,103 +0,0 @@
-<html>
-<head>
-<!-- Generated by the Spirit (http://spirit.sf.net) QuickDoc -->
-<title>Templates</title>
-<link rel="stylesheet" href="theme/style.css" type="text/css">
-<link rel="prev" href="policies.html">
-<link rel="next" href="wrappers.html">
-</head>
-<body>
-<table width="100%" height="48" border="0" cellspacing="2">
-  <tr>
-    <td><img src="theme/c%2B%2Bboost.gif">
-    </td>
-    <td width="85%">
-      <font size="6" face="Verdana, Arial, Helvetica, sans-serif"><b>Templates</b></font>
-    </td>
-  </tr>
-</table>
-<br>
-<table border="0">
-  <tr>
-    <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
-    <td width="30"><a href="policies.html"><img src="theme/l_arr.gif" border="0"></a></td>
-    <td width="20"><a href="wrappers.html"><img src="theme/r_arr.gif" border="0"></a></td>
-   </tr>
-</table>
-<p>
-Template classes can easily be exported too, but you can't export the template
-itself... you have to export instantiations of it! So, if you want to export a
-<tt>std::vector</tt>, you will have to export vectors of int, doubles, etc.</p>
-<p>
-Suppose we have this code:</p>
-<code><pre>
-    <span class=keyword>template </span><span class=special>&lt;</span><span class=keyword>class </span><span class=identifier>T</span><span class=special>&gt;
-    </span><span class=keyword>struct </span><span class=identifier>Point
-    </span><span class=special>{
-        </span><span class=identifier>T </span><span class=identifier>x</span><span class=special>;
-        </span><span class=identifier>T </span><span class=identifier>y</span><span class=special>;
-    };
-</span></pre></code>
-<p>
-And we want to export <tt>Point</tt>s of int and double:</p>
-<code><pre>
-    <span class=identifier>Point </span><span class=special>= </span><span class=identifier>Template</span><span class=special>(</span><span class=string>&quot;Point&quot;</span><span class=special>, </span><span class=string>&quot;point.h&quot;</span><span class=special>)
-    </span><span class=identifier>Point</span><span class=special>(</span><span class=string>&quot;int&quot;</span><span class=special>)
-    </span><span class=identifier>Point</span><span class=special>(</span><span class=string>&quot;double&quot;</span><span class=special>)
-</span></pre></code>
-<p>
-Pyste will assign default names for each instantiation. In this example, those
-would be &quot;<tt>Point_int</tt>&quot; and &quot;<tt>Point_double</tt>&quot;, but most of the time users will want to
-rename the instantiations:</p>
-<code><pre>
-    <span class=identifier>Point</span><span class=special>(</span><span class=string>&quot;int&quot;</span><span class=special>, </span><span class=string>&quot;IPoint&quot;</span><span class=special>)         // </span><span class=identifier>renames </span><span class=identifier>the </span><span class=identifier>instantiation
-    </span><span class=identifier>double_inst </span><span class=special>= </span><span class=identifier>Point</span><span class=special>(</span><span class=string>&quot;double&quot;</span><span class=special>)  // </span><span class=identifier>another </span><span class=identifier>way </span><span class=identifier>to </span><span class=keyword>do </span><span class=identifier>the </span><span class=identifier>same
-    </span><span class=identifier>rename</span><span class=special>(</span><span class=identifier>double_inst</span><span class=special>, </span><span class=string>&quot;DPoint&quot;</span><span class=special>)
-</span></pre></code>
-<p>
-Note that you can rename, exclude, set policies, etc, in the <tt>Template</tt> object
-like you would do with a <tt>Function</tt> or a <tt>Class</tt>. This changes affect all
-<b>future</b> instantiations:</p>
-<code><pre>
-    <span class=identifier>Point </span><span class=special>= </span><span class=identifier>Template</span><span class=special>(</span><span class=string>&quot;Point&quot;</span><span class=special>, </span><span class=string>&quot;point.h&quot;</span><span class=special>)
-    </span><span class=identifier>Point</span><span class=special>(</span><span class=string>&quot;float&quot;</span><span class=special>, </span><span class=string>&quot;FPoint&quot;</span><span class=special>)        // </span><span class=identifier>will </span><span class=identifier>have </span><span class=identifier>x </span><span class=keyword>and </span><span class=identifier>y </span><span class=identifier>as </span><span class=identifier>data </span><span class=identifier>members
-    </span><span class=identifier>rename</span><span class=special>(</span><span class=identifier>Point</span><span class=special>.</span><span class=identifier>x</span><span class=special>, </span><span class=string>&quot;X&quot;</span><span class=special>)
-    </span><span class=identifier>rename</span><span class=special>(</span><span class=identifier>Point</span><span class=special>.</span><span class=identifier>y</span><span class=special>, </span><span class=string>&quot;Y&quot;</span><span class=special>)
-    </span><span class=identifier>Point</span><span class=special>(</span><span class=string>&quot;int&quot;</span><span class=special>, </span><span class=string>&quot;IPoint&quot;</span><span class=special>)          // </span><span class=identifier>will </span><span class=identifier>have </span><span class=identifier>X </span><span class=keyword>and </span><span class=identifier>Y </span><span class=identifier>as </span><span class=identifier>data </span><span class=identifier>members
-    </span><span class=identifier>Point</span><span class=special>(</span><span class=string>&quot;double&quot;</span><span class=special>, </span><span class=string>&quot;DPoint&quot;</span><span class=special>)       // </span><span class=identifier>also </span><span class=identifier>will </span><span class=identifier>have </span><span class=identifier>X </span><span class=keyword>and </span><span class=identifier>Y </span><span class=identifier>as </span><span class=identifier>data </span><span class=identifier>member
-</span></pre></code>
-<p>
-If you want to change a option of a particular instantiation, you can do so:</p>
-<code><pre>
-    <span class=identifier>Point </span><span class=special>= </span><span class=identifier>Template</span><span class=special>(</span><span class=string>&quot;Point&quot;</span><span class=special>, </span><span class=string>&quot;point.h&quot;</span><span class=special>)
-    </span><span class=identifier>Point</span><span class=special>(</span><span class=string>&quot;int&quot;</span><span class=special>, </span><span class=string>&quot;IPoint&quot;</span><span class=special>)          
-    </span><span class=identifier>d_inst </span><span class=special>= </span><span class=identifier>Point</span><span class=special>(</span><span class=string>&quot;double&quot;</span><span class=special>, </span><span class=string>&quot;DPoint&quot;</span><span class=special>)       
-    </span><span class=identifier>rename</span><span class=special>(</span><span class=identifier>d_inst</span><span class=special>.</span><span class=identifier>x</span><span class=special>, </span><span class=string>&quot;X&quot;</span><span class=special>)           // </span><span class=identifier>only </span><span class=identifier>DPoint </span><span class=identifier>is </span><span class=identifier>affect </span><span class=identifier>by </span><span class=keyword>this </span><span class=identifier>renames</span><span class=special>,
-    </span><span class=identifier>rename</span><span class=special>(</span><span class=identifier>d_inst</span><span class=special>.</span><span class=identifier>y</span><span class=special>, </span><span class=string>&quot;Y&quot;</span><span class=special>)           // </span><span class=identifier>IPoint </span><span class=identifier>stays </span><span class=identifier>intact
-</span></pre></code>
-<table width="80%" border="0" align="center">
-  <tr>
-    <td class="note_box">
-<img src="theme/note.gif"></img> <b>What if my template accepts more than one type?</b>
-<br><br>
-When you want to instantiate a template with more than one type, you can pass
-either a string with the types separated by whitespace, or a list of strings
-(&quot;int double&quot; or [&quot;int&quot;, &quot;double&quot;] would both work).
-    </td>
-  </tr>
-</table>
-<table border="0">
-  <tr>
-    <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
-    <td width="30"><a href="policies.html"><img src="theme/l_arr.gif" border="0"></a></td>
-    <td width="20"><a href="wrappers.html"><img src="theme/r_arr.gif" border="0"></a></td>
-   </tr>
-</table>
-<br>
-<hr size="1"><p class="copyright">Copyright &copy; 2003 Bruno da Silva de Oliveira<br>Copyright &copy; 2002-2003 Joel de Guzman<br><br>
-<font size="2">Permission to copy, use, modify, sell and distribute this document
- is granted provided this copyright notice appears in all copies. This document
- is provided &quot;as is&quot; without express or implied warranty, and with
- no claim as to its suitability for any purpose. </font> </p>
-</body>
-</html>

pyste/doc/the_interface_files.html

@@ -1,81 +0,0 @@
-<html>
-<head>
-<!-- Generated by the Spirit (http://spirit.sf.net) QuickDoc -->
-<title>The Interface Files</title>
-<link rel="stylesheet" href="theme/style.css" type="text/css">
-<link rel="prev" href="running_pyste.html">
-<link rel="next" href="renaming_and_excluding.html">
-</head>
-<body>
-<table width="100%" height="48" border="0" cellspacing="2">
-  <tr>
-    <td><img src="theme/c%2B%2Bboost.gif">
-    </td>
-    <td width="85%">
-      <font size="6" face="Verdana, Arial, Helvetica, sans-serif"><b>The Interface Files</b></font>
-    </td>
-  </tr>
-</table>
-<br>
-<table border="0">
-  <tr>
-    <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
-    <td width="30"><a href="running_pyste.html"><img src="theme/l_arr.gif" border="0"></a></td>
-    <td width="20"><a href="renaming_and_excluding.html"><img src="theme/r_arr.gif" border="0"></a></td>
-   </tr>
-</table>
-<p>
-The interface files are the heart of Pyste. The user creates one or more
-interface files declaring the classes and functions he wants to export, and then
-invokes Pyste passing the interface files to it. Pyste then generates a single
-cpp file with <a href="../../index.html">
-Boost.Python</a> code, with all the classes and functions exported.</p>
-<p>
-Besides declaring the classes and functions, the user has a number of other
-options, like renaming classes and methods, excluding methods and attributes,
-and so on. </p>
-<a name="basics"></a><h2>Basics</h2><p>
-Suppose we have a class and some functions that we want to expose to Python
-declared in the header <tt>hello.h</tt>:</p>
-<code><pre>
-    <span class=keyword>struct </span><span class=identifier>World
-    </span><span class=special>{
-        </span><span class=identifier>World</span><span class=special>(</span><span class=identifier>std</span><span class=special>::</span><span class=identifier>string </span><span class=identifier>msg</span><span class=special>): </span><span class=identifier>msg</span><span class=special>(</span><span class=identifier>msg</span><span class=special>) {} 
-        </span><span class=keyword>void </span><span class=identifier>set</span><span class=special>(</span><span class=identifier>std</span><span class=special>::</span><span class=identifier>string </span><span class=identifier>msg</span><span class=special>) { </span><span class=keyword>this</span><span class=special>-&gt;</span><span class=identifier>msg </span><span class=special>= </span><span class=identifier>msg</span><span class=special>; }
-        </span><span class=identifier>std</span><span class=special>::</span><span class=identifier>string </span><span class=identifier>greet</span><span class=special>() { </span><span class=keyword>return </span><span class=identifier>msg</span><span class=special>; }
-        </span><span class=identifier>std</span><span class=special>::</span><span class=identifier>string </span><span class=identifier>msg</span><span class=special>;
-    };
-
-    </span><span class=keyword>enum </span><span class=identifier>choice </span><span class=special>{ </span><span class=identifier>red</span><span class=special>, </span><span class=identifier>blue </span><span class=special>};
-    
-    </span><span class=keyword>namespace </span><span class=identifier>test </span><span class=special>{
-    
-    </span><span class=keyword>void </span><span class=identifier>show</span><span class=special>(</span><span class=identifier>choice </span><span class=identifier>c</span><span class=special>) { </span><span class=identifier>std</span><span class=special>::</span><span class=identifier>cout </span><span class=special>&lt;&lt; </span><span class=string>&quot;value: &quot; </span><span class=special>&lt;&lt; (</span><span class=keyword>int</span><span class=special>)</span><span class=identifier>c </span><span class=special>&lt;&lt; </span><span class=identifier>std</span><span class=special>::</span><span class=identifier>endl</span><span class=special>; }
-    
-    }
-</span></pre></code>
-<p>
-We create a file named <tt>hello.pyste</tt> and create instances of the classes
-<tt>Function</tt>, <tt>Class</tt> and <tt>Enum</tt>:</p>
-<code><pre>
-    <span class=identifier>Function</span><span class=special>(</span><span class=string>&quot;test::show&quot;</span><span class=special>, </span><span class=string>&quot;hello.h&quot;</span><span class=special>)
-    </span><span class=identifier>Class</span><span class=special>(</span><span class=string>&quot;World&quot;</span><span class=special>, </span><span class=string>&quot;hello.h&quot;</span><span class=special>)
-    </span><span class=identifier>Enum</span><span class=special>(</span><span class=string>&quot;choice&quot;</span><span class=special>, </span><span class=string>&quot;hello.h&quot;</span><span class=special>)
-</span></pre></code>
-<p>
-That will expose the class, the free function and the enum found in <tt>hello.h</tt>. </p>
-<table border="0">
-  <tr>
-    <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
-    <td width="30"><a href="running_pyste.html"><img src="theme/l_arr.gif" border="0"></a></td>
-    <td width="20"><a href="renaming_and_excluding.html"><img src="theme/r_arr.gif" border="0"></a></td>
-   </tr>
-</table>
-<br>
-<hr size="1"><p class="copyright">Copyright &copy; 2003 Bruno da Silva de Oliveira<br>Copyright &copy; 2002-2003 Joel de Guzman<br><br>
-<font size="2">Permission to copy, use, modify, sell and distribute this document
- is granted provided this copyright notice appears in all copies. This document
- is provided &quot;as is&quot; without express or implied warranty, and with
- no claim as to its suitability for any purpose. </font> </p>
-</body>
-</html>

pyste/doc/theme/style.css

@@ -1,170 +0,0 @@
-body
-{
-    background-image: url(bkd.gif);
-    background-color: #FFFFFF;
-    margin: 1em 2em 1em 2em;
-}
-
-h1 { font-family: Verdana, Arial, Helvetica, sans-serif; font-weight: bold; text-align: left;  }
-h2 { font: 140% sans-serif; font-weight: bold; text-align: left;  }
-h3 { font: 120% sans-serif; font-weight: bold; text-align: left;  }
-h4 { font: bold 100% sans-serif; font-weight: bold; text-align: left;  }
-h5 { font: italic 100% sans-serif; font-weight: bold; text-align: left;  }
-h6 { font: small-caps 100% sans-serif; font-weight: bold; text-align: left;  }
-
-pre
-{
-    border-top: gray 1pt solid;
-    border-right: gray 1pt solid;
-    border-left: gray 1pt solid;
-    border-bottom: gray 1pt solid;
-
-    padding-top: 2pt;
-    padding-right: 2pt;
-    padding-left: 2pt;
-    padding-bottom: 2pt;
-
-    display: block;
-    font-family: "courier new", courier, mono;
-    background-color: #eeeeee; font-size: small
-}
-
-code
-{
-    font-family: "Courier New", Courier, mono;
-    font-size: small
-}
-
-tt
-{
-    display: inline;
-    font-family: "Courier New", Courier, mono;
-    color: #000099;
-    font-size: small
-}
-
-p
-{
-    text-align: justify;
-    font-family: Georgia, "Times New Roman", Times, serif
-}
-
-ul
-{
-    list-style-image: url(bullet.gif);
-    font-family: Georgia, "Times New Roman", Times, serif
-}
-
-ol
-{
-    font-family: Georgia, "Times New Roman", Times, serif
-}
-
-a
-{
-    font-weight: bold;
-    color: #003366;
-    text-decoration: none;
-}
-
-a:hover { color: #8080FF; }
-
-.literal        {  color: #666666; font-style: italic}
-.keyword        {  color: #000099}
-.identifier     {}
-.comment        {  font-style: italic; color: #990000}
-.special        {  color: #800040}
-.preprocessor   {  color: #FF0000}
-.string         {  font-style: italic; color: #666666}
-.copyright      {  color: #666666; font-size: small}
-.white_bkd      {  background-color: #FFFFFF}
-.dk_grey_bkd    {  background-color: #999999}
-.quotes         {  color: #666666; font-style: italic; font-weight: bold}
-
-.note_box
-{
-    display: block;
-
-    border-top: gray 1pt solid;
-    border-right: gray 1pt solid;
-    border-left: gray 1pt solid;
-    border-bottom: gray 1pt solid;
-
-    padding-right: 12pt;
-    padding-left: 12pt;
-    padding-bottom: 12pt;
-    padding-top: 12pt;
-
-    font-family: Arial, Helvetica, sans-serif;
-    background-color: #E2E9EF;
-    font-size: small; text-align: justify
-}
-
-.table_title
-{
-    background-color: #648CCA;
-
-    font-family: Verdana, Arial, Helvetica, sans-serif; color: #FFFFFF;
-    font-weight: bold
-; padding-top: 4px; padding-right: 4px; padding-bottom: 4px; padding-left: 4px
-}
-
-.table_cells
-{
-    background-color: #E2E9EF;
-
-    font-family: Geneva, Arial, Helvetica, san-serif;
-    font-size: small
-; padding-top: 4px; padding-right: 4px; padding-bottom: 4px; padding-left: 4px
-}
-
-.toc
-{
-    DISPLAY: block;
-    background-color: #E2E9EF
-    font-family: Arial, Helvetica, sans-serif;
-
-    border-top: gray 1pt solid;
-    border-left: gray 1pt solid;
-    border-bottom: gray 1pt solid;
-    border-right: gray 1pt solid;
-
-    padding-top: 24pt;
-    padding-right: 24pt;
-    padding-left: 24pt;
-    padding-bottom: 24pt;
-}
-
-.toc_title
-{
-    background-color: #648CCA;
-    padding-top: 4px;
-    padding-right: 4px;
-    padding-bottom: 4px;
-    padding-left: 4px;
-    font-family: Geneva, Arial, Helvetica, san-serif;
-    color: #FFFFFF;
-    font-weight: bold
-}
-
-.toc_cells
-{
-    background-color: #E2E9EF;
-    padding-top: 4px;
-    padding-right: 4px;
-    padding-bottom: 4px;
-    padding-left: 4px;
-    font-family: Geneva, Arial, Helvetica, san-serif;
-    font-size: small
-}
-
-div.logo
-{
-	float: right;
-}
-
-.toc_cells_L0 { background-color: #E2E9EF; padding-top: 4px; padding-right: 4px; padding-bottom: 4px; padding-left: 4px; font-family: Geneva, Arial, Helvetica, san-serif; font-size: small }
-.toc_cells_L1 { background-color: #E2E9EF; padding-top: 4px; padding-right: 4px; padding-bottom: 4px; padding-left: 44px; font-family: Geneva, Arial, Helvetica, san-serif; font-size: small }
-.toc_cells_L2 { background-color: #E2E9EF; padding-top: 4px; padding-right: 4px; padding-bottom: 4px; padding-left: 88px; font-family: Geneva, Arial, Helvetica, san-serif; font-size: small }
-.toc_cells_L3 { background-color: #E2E9EF; padding-top: 4px; padding-right: 4px; padding-bottom: 4px; padding-left: 122px; font-family: Geneva, Arial, Helvetica, san-serif; font-size: small }
-.toc_cells_L4 { background-color: #E2E9EF; padding-top: 4px; padding-right: 4px; padding-bottom: 4px; padding-left: 166px; font-family: Geneva, Arial, Helvetica, san-serif; font-size: small }

pyste/doc/wrappers.html

@@ -1,125 +0,0 @@
-<html>
-<head>
-<!-- Generated by the Spirit (http://spirit.sf.net) QuickDoc -->
-<title>Wrappers</title>
-<link rel="stylesheet" href="theme/style.css" type="text/css">
-<link rel="prev" href="templates.html">
-<link rel="next" href="exporting_all_declarations_from_a_header.html">
-</head>
-<body>
-<table width="100%" height="48" border="0" cellspacing="2">
-  <tr>
-    <td><img src="theme/c%2B%2Bboost.gif">
-    </td>
-    <td width="85%">
-      <font size="6" face="Verdana, Arial, Helvetica, sans-serif"><b>Wrappers</b></font>
-    </td>
-  </tr>
-</table>
-<br>
-<table border="0">
-  <tr>
-    <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
-    <td width="30"><a href="templates.html"><img src="theme/l_arr.gif" border="0"></a></td>
-    <td width="20"><a href="exporting_all_declarations_from_a_header.html"><img src="theme/r_arr.gif" border="0"></a></td>
-   </tr>
-</table>
-<p>
-Suppose you have this function:</p>
-<code><pre>
-    <span class=identifier>std</span><span class=special>::</span><span class=identifier>vector</span><span class=special>&lt;</span><span class=identifier>std</span><span class=special>::</span><span class=identifier>string</span><span class=special>&gt; </span><span class=identifier>names</span><span class=special>();
-</span></pre></code>
-<p>
-But you don't want to export <tt>std::vector&lt;std::string&gt;</tt>, you want this function
-to return a python list of strings. <a href="../../index.html">
-Boost.Python</a> has excellent support for
-that:</p>
-<code><pre>
-    <span class=identifier>list </span><span class=identifier>names_wrapper</span><span class=special>()
-    {
-        </span><span class=identifier>list </span><span class=identifier>result</span><span class=special>;
-        // </span><span class=identifier>call </span><span class=identifier>original </span><span class=identifier>function
-        </span><span class=identifier>vector</span><span class=special>&lt;</span><span class=identifier>string</span><span class=special>&gt; </span><span class=identifier>v </span><span class=special>= </span><span class=identifier>names</span><span class=special>();
-        // </span><span class=identifier>put </span><span class=identifier>all </span><span class=identifier>the </span><span class=identifier>strings </span><span class=identifier>inside </span><span class=identifier>the </span><span class=identifier>python </span><span class=identifier>list
-        </span><span class=identifier>vector</span><span class=special>&lt;</span><span class=identifier>string</span><span class=special>&gt;::</span><span class=identifier>iterator </span><span class=identifier>it</span><span class=special>;
-        </span><span class=keyword>for </span><span class=special>(</span><span class=identifier>it </span><span class=special>= </span><span class=identifier>v</span><span class=special>.</span><span class=identifier>begin</span><span class=special>(); </span><span class=identifier>it </span><span class=special>!= </span><span class=identifier>v</span><span class=special>.</span><span class=identifier>end</span><span class=special>(); ++</span><span class=identifier>it</span><span class=special>){
-            </span><span class=identifier>result</span><span class=special>.</span><span class=identifier>append</span><span class=special>(*</span><span class=identifier>it</span><span class=special>);    
-        }
-        </span><span class=keyword>return </span><span class=identifier>result</span><span class=special>;
-    }
-    
-    </span><span class=identifier>BOOST_PYTHON_MODULE</span><span class=special>(</span><span class=identifier>test</span><span class=special>)
-    {
-        </span><span class=identifier>def</span><span class=special>(</span><span class=string>&quot;names&quot;</span><span class=special>, &amp;</span><span class=identifier>names_wrapper</span><span class=special>);
-    }
-</span></pre></code>
-<p>
-Nice heh? Pyste supports this mechanism too. You declare the <tt>names_wrapper</tt>
-function in a header named &quot;<tt>test_wrappers.h</tt>&quot; and in the interface file:</p>
-<code><pre>
-    <span class=identifier>Include</span><span class=special>(</span><span class=string>&quot;test_wrappers.h&quot;</span><span class=special>)
-    </span><span class=identifier>names </span><span class=special>= </span><span class=identifier>Function</span><span class=special>(</span><span class=string>&quot;names&quot;</span><span class=special>, </span><span class=string>&quot;test.h&quot;</span><span class=special>)
-    </span><span class=identifier>set_wrapper</span><span class=special>(</span><span class=identifier>names</span><span class=special>, </span><span class=string>&quot;names_wrapper&quot;</span><span class=special>)
-</span></pre></code>
-<p>
-You can optionally declare the function in the interface file itself:</p>
-<code><pre>
-    <span class=identifier>names_wrapper </span><span class=special>= </span><span class=identifier>Wrapper</span><span class=special>(</span><span class=string>&quot;names_wrapper&quot;</span><span class=special>,
-    </span><span class=string>&quot;&quot;</span><span class=string>&quot;
-    list names_wrapper()
-    {
-        // code to call name() and convert the vector to a list...
-    }
-    &quot;</span><span class=string>&quot;&quot;</span><span class=special>)
-    </span><span class=identifier>names </span><span class=special>= </span><span class=identifier>Function</span><span class=special>(</span><span class=string>&quot;names&quot;</span><span class=special>, </span><span class=string>&quot;test.h&quot;</span><span class=special>)
-    </span><span class=identifier>set_wrapper</span><span class=special>(</span><span class=identifier>names</span><span class=special>, </span><span class=identifier>names_wrapper</span><span class=special>)
-</span></pre></code>
-<p>
-The same mechanism can be used with methods too. Just remember that the first
-parameter of wrappers for methods is a pointer to the class, like in
-<a href="../../index.html">
-Boost.Python</a>:</p>
-<code><pre>
-    <span class=keyword>struct </span><span class=identifier>C
-    </span><span class=special>{
-        </span><span class=identifier>std</span><span class=special>::</span><span class=identifier>vector</span><span class=special>&lt;</span><span class=identifier>std</span><span class=special>::</span><span class=identifier>string</span><span class=special>&gt; </span><span class=identifier>names</span><span class=special>();
-    }
-
-    </span><span class=identifier>list </span><span class=identifier>names_wrapper</span><span class=special>(</span><span class=identifier>C</span><span class=special>* </span><span class=identifier>c</span><span class=special>)
-    {
-        // </span><span class=identifier>same </span><span class=identifier>as </span><span class=identifier>before</span><span class=special>, </span><span class=identifier>calling </span><span class=identifier>c</span><span class=special>-&gt;</span><span class=identifier>names</span><span class=special>() </span><span class=keyword>and </span><span class=identifier>converting </span><span class=identifier>result </span><span class=identifier>to </span><span class=identifier>a </span><span class=identifier>list 
-    </span><span class=special>}
-</span></pre></code>
-<p>
-And then in the interface file:</p>
-<code><pre>
-    <span class=identifier>C </span><span class=special>= </span><span class=identifier>Class</span><span class=special>(</span><span class=string>&quot;C&quot;</span><span class=special>, </span><span class=string>&quot;test.h&quot;</span><span class=special>)
-    </span><span class=identifier>set_wrapper</span><span class=special>(</span><span class=identifier>C</span><span class=special>.</span><span class=identifier>names</span><span class=special>, </span><span class=string>&quot;names_wrapper&quot;</span><span class=special>)
-</span></pre></code>
-<table width="80%" border="0" align="center">
-  <tr>
-    <td class="note_box">
-
-<img src="theme/note.gif"></img>Even though <a href="../../index.html">
-Boost.Python</a> accepts either a pointer or a
-reference to the class in wrappers for member functions as the first parameter,
-Pyste expects them to be a <b>pointer</b>. Doing otherwise will prevent your
-code to compile when you set a wrapper for a virtual method.
-    </td>
-  </tr>
-</table>
-<table border="0">
-  <tr>
-    <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
-    <td width="30"><a href="templates.html"><img src="theme/l_arr.gif" border="0"></a></td>
-    <td width="20"><a href="exporting_all_declarations_from_a_header.html"><img src="theme/r_arr.gif" border="0"></a></td>
-   </tr>
-</table>
-<br>
-<hr size="1"><p class="copyright">Copyright &copy; 2003 Bruno da Silva de Oliveira<br>Copyright &copy; 2002-2003 Joel de Guzman<br><br>
-<font size="2">Permission to copy, use, modify, sell and distribute this document
- is granted provided this copyright notice appears in all copies. This document
- is provided &quot;as is&quot; without express or implied warranty, and with
- no claim as to its suitability for any purpose. </font> </p>
-</body>
-</html>

pyste/index.html

@@ -1,86 +0,0 @@
-<html>
-<head>
-<!-- Generated by the Spirit (http://spirit.sf.net) QuickDoc -->
-<title>Pyste Documentation</title>
-<link rel="stylesheet" href="doc/theme/style.css" type="text/css">
-<link rel="next" href="introduction.html">
-</head>
-<body>
-<table width="100%" height="48" border="0" cellspacing="2">
-  <tr>
-    <td><img src="doc/theme/c%2B%2Bboost.gif">
-    </td>
-    <td width="85%">
-      <font size="6" face="Verdana, Arial, Helvetica, sans-serif"><b>Pyste Documentation</b></font>
-    </td>
-  </tr>
-</table>
-<br>
-<table width="80%" border="0" align="center">
-  <tr>
-    <td class="toc_title">Table of contents</td>
-  </tr>
-  <tr>
-    <td class="toc_cells_L0">
-        <a href="doc/introduction.html">Introduction</a>
-    </td>
-  </tr>
-  <tr>
-    <td class="toc_cells_L0">
-        <a href="doc/running_pyste.html">Running Pyste</a>
-    </td>
-  </tr>
-  <tr>
-    <td class="toc_cells_L0">
-        <a href="doc/the_interface_files.html">The Interface Files</a>
-    </td>
-  </tr>
-  <tr>
-    <td class="toc_cells_L1">
-        <a href="doc/renaming_and_excluding.html">Renaming and Excluding</a>
-    </td>
-  </tr>
-  <tr>
-    <td class="toc_cells_L1">
-        <a href="doc/policies.html">Policies</a>
-    </td>
-  </tr>
-  <tr>
-    <td class="toc_cells_L1">
-        <a href="doc/templates.html">Templates</a>
-    </td>
-  </tr>
-  <tr>
-    <td class="toc_cells_L1">
-        <a href="doc/wrappers.html">Wrappers</a>
-    </td>
-  </tr>
-  <tr>
-    <td class="toc_cells_L1">
-        <a href="doc/exporting_all_declarations_from_a_header.html">Exporting All Declarations from a Header</a>
-    </td>
-  </tr>
-  <tr>
-    <td class="toc_cells_L1">
-        <a href="doc/smart_pointers.html">Smart Pointers</a>
-    </td>
-  </tr>
-  <tr>
-    <td class="toc_cells_L1">
-        <a href="doc/global_variables.html">Global Variables</a>
-    </td>
-  </tr>
-  <tr>
-    <td class="toc_cells_L1">
-        <a href="doc/adding_new_methods.html">Adding New Methods</a>
-    </td>
-  </tr>
-</table>
-<br>
-<hr size="1"><p class="copyright">Copyright &copy; 2003 Bruno da Silva de Oliveira<br>Copyright &copy; 2002-2003 Joel de Guzman<br><br>
-<font size="2">Permission to copy, use, modify, sell and distribute this document
- is granted provided this copyright notice appears in all copies. This document
- is provided &quot;as is&quot; without express or implied warranty, and with
- no claim as to its suitability for any purpose. </font> </p>
-</body>
-</html>

pyste/src/.cvsignore

@@ -1 +0,0 @@
-*.pyc

pyste/src/ClassExporter.py

@@ -1,858 +0,0 @@
-import exporters
-from Exporter import Exporter
-from declarations import *
-from settings import *
-from policies import *
-from SingleCodeUnit import SingleCodeUnit
-from EnumExporter import EnumExporter
-from utils import makeid, enumerate
-from copy import deepcopy
-import exporterutils
-import re
-
-#==============================================================================
-# ClassExporter
-#==============================================================================
-class ClassExporter(Exporter):
-    'Generates boost.python code to export a class declaration'
-    
-
-    def __init__(self, info, parser_tail=None):
-        Exporter.__init__(self, info, parser_tail)
-        # sections of code
-        self.sections = {}
-        # template: each item in the list is an item into the class_<...> 
-        # section.
-        self.sections['template'] = []  
-        # constructor: each item in the list is a parameter to the class_ 
-        # constructor, like class_<C>(...)
-        self.sections['constructor'] = []
-        # inside: everything within the class_<> statement        
-        self.sections['inside'] = []        
-        # scope: items outside the class statement but within its scope.
-        # scope* s = new scope(class<>());
-        # ...
-        # delete s;
-        self.sections['scope'] = []
-        # declarations: outside the BOOST_PYTHON_MODULE macro
-        self.sections['declaration'] = []
-        self.sections['declaration-outside'] = []
-        self.sections['include'] = []
-        # a list of Constructor instances
-        self.constructors = []
-        self.wrapper_generator = None
-        # a list of code units, generated by nested declarations
-        self.nested_codeunits = []
-        self._exported_opaque_pointers = {}
-
-
-    def ScopeName(self):
-        return makeid(self.class_.FullName()) + '_scope'
-
-
-    def Unit(self):
-        return makeid(self.class_.name)
-
-
-    def Name(self):
-        return self.class_.FullName()
-
-
-    def SetDeclarations(self, declarations):
-        Exporter.SetDeclarations(self, declarations)
-        decl = self.GetDeclaration(self.info.name)
-        if isinstance(decl, Typedef):
-            self.class_ = self.GetDeclaration(decl.type.name)
-            if not self.info.rename:
-                self.info.rename = decl.name
-        else:
-            self.class_ = decl
-        self.public_members = \
-            [x for x in self.class_.members if x.visibility == Scope.public]
-        
-        
-    def ClassBases(self):
-        bases = []
-        def GetBases(class_):
-            this_bases = [self.GetDeclaration(x.name) for x in class_.bases]
-            bases.extend(this_bases)
-            for base in this_bases:
-                GetBases(base)
-
-        GetBases(self.class_)
-        return bases
-
-    
-    def Order(self):
-        '''Return the TOTAL number of bases that this class has, including the
-        bases' bases.  Do this because base classes must be instantialized
-        before the derived classes in the module definition.  
-        '''
-        return '%s_%s' % (len(self.ClassBases()), self.class_.FullName())
-        
-    
-    def Export(self, codeunit, exported_names):
-        if not self.info.exclude:
-            self.CheckIsForwardDeclared()
-            self.CheckForwardDeclarations()
-            self.ExportBasics()
-            self.ExportBases(exported_names)
-            self.ExportConstructors()
-            self.ExportVariables()
-            self.ExportMethods()
-            self.ExportVirtualMethods()
-            self.ExportOperators()
-            self.ExportNestedClasses(exported_names)
-            self.ExportNestedEnums()
-            self.ExportSmartPointer()
-            self.ExportOpaquePointerPolicies()
-            self.Write(codeunit)
-
-
-    def CheckIsForwardDeclared(self):
-        if self.class_.incomplete:
-            print "--> Error: Class %s is forward declared! " \
-                "Please use the header with its complete definition." % self.class_.FullName()
-            print
-            
-            
-    def CheckForwardDeclarations(self):
-        for m in self.public_members:
-            if isinstance(m, Function):
-                exporterutils.WarnForwardDeclarations(m)
-
-    
-    def Write(self, codeunit):
-        indent = self.INDENT
-        boost_ns = namespaces.python
-        pyste_ns = namespaces.pyste
-        code = ''
-        # begin a scope for this class if needed
-        nested_codeunits = self.nested_codeunits
-        needs_scope = self.sections['scope'] or nested_codeunits
-        if needs_scope:
-            scope_name = self.ScopeName()
-            code += indent + boost_ns + 'scope* %s = new %sscope(\n' %\
-                (scope_name, boost_ns)
-        # export the template section
-        template_params = ', '.join(self.sections['template'])
-        code += indent + boost_ns + 'class_< %s >' % template_params
-        # export the constructor section
-        constructor_params = ', '.join(self.sections['constructor'])
-        code += '(%s)\n' % constructor_params
-        # export the inside section
-        in_indent = indent*2
-        for line in self.sections['inside']:
-            code += in_indent + line + '\n' 
-        # write the scope section and end it
-        if not needs_scope:
-            code += indent + ';\n'
-        else:
-            code += indent + ');\n'
-            for line in self.sections['scope']:
-                code += indent + line + '\n'
-            # write the contents of the nested classes
-            for nested_unit in nested_codeunits:
-                code += '\n' + nested_unit.Section('module')
-            # close the scope
-            code += indent + 'delete %s;\n' % scope_name
-            
-        # write the code to the module section in the codeunit        
-        codeunit.Write('module', code + '\n')
-        
-        # write the declarations to the codeunit        
-        declarations = '\n'.join(self.sections['declaration'])
-        for nested_unit in nested_codeunits:
-            declarations += nested_unit.Section('declaration')
-        if declarations:
-            codeunit.Write('declaration', declarations + '\n')
-        declarations_outside = '\n'.join(self.sections['declaration-outside'])
-        if declarations_outside:
-            codeunit.Write('declaration-outside', declarations_outside + '\n')
-
-        # write the includes to the codeunit
-        includes = '\n'.join(self.sections['include'])
-        for nested_unit in nested_codeunits:
-            includes += nested_unit.Section('include')
-        if includes:
-            codeunit.Write('include', includes)
-
-
-    def Add(self, section, item):
-        'Add the item into the corresponding section'
-        self.sections[section].append(item)
-
-        
-    def ExportBasics(self):
-        'Export the name of the class and its class_ statement'
-        self.Add('template', self.class_.FullName())
-        name = self.info.rename or self.class_.name
-        self.Add('constructor', '"%s"' % name)
-        
-        
-    def ExportBases(self, exported_names):
-        'Expose the bases of the class into the template section'        
-        bases = self.class_.bases
-        bases_list = []
-        for base in bases:
-            if base.visibility == Scope.public and base.name in exported_names:
-                bases_list.append(base.name)
-        if bases_list:
-            code = namespaces.python + 'bases< %s > ' % \
-                (', '.join(bases_list))
-            self.Add('template', code)        
-
-
-    def ExportConstructors(self):
-        '''Exports all the public contructors of the class, plus indicates if the 
-        class is noncopyable.
-        '''
-        py_ns = namespaces.python
-        indent = self.INDENT
-        
-        def init_code(cons):
-            'return the init<>() code for the given contructor'
-            param_list = [p.FullName() for p in cons.parameters]
-            min_params_list = param_list[:cons.minArgs]
-            max_params_list = param_list[cons.minArgs:]
-            min_params = ', '.join(min_params_list)
-            max_params = ', '.join(max_params_list)
-            init = py_ns + 'init< '
-            init += min_params
-            if max_params:
-                if min_params:
-                    init += ', '
-                init += py_ns + ('optional< %s >' % max_params)
-            init += ' >()'    
-            return init
-        
-        constructors = [x for x in self.public_members if isinstance(x, Constructor)]
-        self.constructors = constructors[:]
-        # don't export the copy constructor if the class is abstract
-        if self.class_.abstract:
-            for cons in constructors:
-                if cons.IsCopy():
-                    constructors.remove(cons)
-                    break
-        if not constructors:
-            # declare no_init
-            self.Add('constructor', py_ns + 'no_init') 
-        else:
-            # write the constructor with less parameters to the constructor section
-            smaller = None
-            for cons in constructors:
-                if smaller is None or len(cons.parameters) < len(smaller.parameters):
-                    smaller = cons
-            assert smaller is not None
-            self.Add('constructor', init_code(smaller))
-            constructors.remove(smaller)
-            # write the rest to the inside section, using def()
-            for cons in constructors:
-                code = '.def(%s)' % init_code(cons) 
-                self.Add('inside', code)
-        # check if the class is copyable
-        if not self.class_.HasCopyConstructor() or self.class_.abstract:
-            self.Add('template', namespaces.boost + 'noncopyable')
-            
-        
-    def ExportVariables(self):
-        'Export the variables of the class, both static and simple variables'
-        vars = [x for x in self.public_members if isinstance(x, Variable)]
-        for var in vars:
-            if self.info[var.name].exclude: 
-                continue
-            name = self.info[var.name].rename or var.name
-            fullname = var.FullName() 
-            if var.type.const:
-                def_ = '.def_readonly'
-            else:
-                def_ = '.def_readwrite'
-            code = '%s("%s", &%s)' % (def_, name, fullname)
-            self.Add('inside', code)
-
-    
-    def OverloadName(self, method):
-        'Returns the name of the overloads struct for the given method'
-        name = makeid(method.FullName())
-        overloads = '_overloads_%i_%i' % (method.minArgs, method.maxArgs)    
-        return name + overloads
-
-    
-    def GetAddedMethods(self):
-        added_methods = self.info.__added__
-        result = []
-        if added_methods:
-            for name, rename in added_methods:
-                decl = self.GetDeclaration(name)
-                self.info[name].rename = rename
-                result.append(decl)
-        return result
-
-                
-    def ExportMethods(self):
-        '''Export all the non-virtual methods of this class, plus any function
-        that is to be exported as a method'''
-            
-        declared = {}
-        def DeclareOverloads(m):
-            'Declares the macro for the generation of the overloads'
-            if (isinstance(m, Method) and m.static) or type(m) == Function:
-                func = m.FullName()
-                macro = 'BOOST_PYTHON_FUNCTION_OVERLOADS'
-            else:
-                func = m.name
-                macro = 'BOOST_PYTHON_MEMBER_FUNCTION_OVERLOADS' 
-            code = '%s(%s, %s, %i, %i)\n' % (macro, self.OverloadName(m), func, m.minArgs, m.maxArgs)
-            if code not in declared:
-                declared[code] = True
-                self.Add('declaration', code)
-
-
-        def Pointer(m):
-            'returns the correct pointer declaration for the method m'
-            # check if this method has a wrapper set for him
-            wrapper = self.info[method.name].wrapper
-            if wrapper:
-                return '&' + wrapper.FullName()
-            # return normal pointers to the methods of the class
-            if isinstance(m, Method):
-                is_unique = self.class_.IsUnique(m.name)
-            else:
-                # function
-                is_unique = len(self.GetDeclarations(m.FullName())) == 1
-            if is_unique:
-                return '&' + method.FullName()
-            else:
-                return method.PointerDeclaration() 
-
-        def IsExportable(m):
-            'Returns true if the given method is exportable by this routine'
-            ignore = (Constructor, ClassOperator, Destructor)
-            return isinstance(m, Function) and not isinstance(m, ignore) and not m.virtual        
-        
-        methods = [x for x in self.public_members if IsExportable(x)]        
-        methods.extend(self.GetAddedMethods())
-        
-        for method in methods:
-            method_info = self.info[method.name]
-            
-            # skip this method if it was excluded by the user
-            if method_info.exclude:
-                continue 
-
-            # rename the method if the user requested
-            name = method_info.rename or method.name
-            
-            # warn the user if this method needs a policy and doesn't have one
-            method_info.policy = exporterutils.HandlePolicy(method, method_info.policy)
-            
-            # check for policies
-            policy = method_info.policy or ''
-            if policy:
-                policy = ', %s%s()' % (namespaces.python, policy.Code())
-            # check for overloads
-            overload = ''
-            if method.minArgs != method.maxArgs:
-                # add the overloads for this method
-                DeclareOverloads(method)
-                overload_name = self.OverloadName(method)
-                overload = ', %s%s()' % (namespaces.pyste, overload_name)
-        
-            # build the .def string to export the method
-            pointer = Pointer(method)
-            code = '.def("%s", %s' % (name, pointer)
-            code += policy
-            code += overload
-            code += ')'
-            self.Add('inside', code)
-            # static method
-            if isinstance(method, Method) and method.static:
-                code = '.staticmethod("%s")' % name
-                self.Add('inside', code)
-            # add wrapper code if this method has one
-            wrapper = method_info.wrapper
-            if wrapper and wrapper.code:
-                self.Add('declaration', wrapper.code)
-
-
-    def ExportVirtualMethods(self):        
-        # check if this class has any virtual methods
-        has_virtual_methods = False
-        for member in self.class_.members:
-            if type(member) == Method and member.virtual:
-                has_virtual_methods = True
-                break
-
-        if has_virtual_methods:
-            generator = _VirtualWrapperGenerator(self.class_, self.ClassBases(), self.info)
-            self.Add('template', generator.FullName())
-            for definition in generator.GenerateDefinitions():
-                self.Add('inside', definition)
-            self.Add('declaration', generator.GenerateVirtualWrapper(self.INDENT))
-            
-
-    # operators natively supported by boost
-    BOOST_SUPPORTED_OPERATORS = '+ - * / % ^ & ! ~ | < > == != <= >= << >> && || += -='\
-        '*= /= %= ^= &= |= <<= >>='.split()
-    # create a map for faster lookup
-    BOOST_SUPPORTED_OPERATORS = dict(zip(BOOST_SUPPORTED_OPERATORS, range(len(BOOST_SUPPORTED_OPERATORS))))
-
-    # a dict of operators that are not directly supported by boost, but can be exposed
-    # simply as a function with a special signature
-    BOOST_RENAME_OPERATORS = {
-        '()' : '__call__',
-    }
-
-    # converters which have a special name in python
-    # it's a map of a regular expression of the converter's result to the
-    # appropriate python name
-    SPECIAL_CONVERTERS = {
-        re.compile(r'(const)?\s*double$') : '__float__',
-        re.compile(r'(const)?\s*float$') : '__float__',
-        re.compile(r'(const)?\s*int$') : '__int__',
-        re.compile(r'(const)?\s*long$') : '__long__',
-        re.compile(r'(const)?\s*char\s*\*?$') : '__str__',
-        re.compile(r'(const)?.*::basic_string<.*>\s*(\*|\&)?$') : '__str__',
-    }
-        
-    
-    def ExportOperators(self):
-        'Export all member operators and free operators related to this class'
-        
-        def GetFreeOperators():
-            'Get all the free (global) operators related to this class'
-            operators = []
-            for decl in self.declarations:
-                if isinstance(decl, Operator):
-                    # check if one of the params is this class
-                    for param in decl.parameters:
-                        if param.name == self.class_.FullName():
-                            operators.append(decl)
-                            break
-            return operators
-
-        def GetOperand(param):
-            'Returns the operand of this parameter (either "self", or "other<type>")'
-            if param.name == self.class_.FullName():
-                return namespaces.python + 'self'
-            else:
-                return namespaces.python + ('other< %s >()' % param.name)
-
-
-        def HandleSpecialOperator(operator):
-            # gatter information about the operator and its parameters
-            result_name = operator.result.name                        
-            param1_name = ''
-            if operator.parameters:
-                param1_name = operator.parameters[0].name
-                
-            # check for str
-            ostream = 'basic_ostream'
-            is_str = result_name.find(ostream) != -1 and param1_name.find(ostream) != -1
-            if is_str:
-                namespace = namespaces.python + 'self_ns::'
-                self_ = namespaces.python + 'self'
-                return '.def(%sstr(%s))' % (namespace, self_)
-
-            # is not a special operator
-            return None
-                
-
-        
-        frees = GetFreeOperators()
-        members = [x for x in self.public_members if type(x) == ClassOperator]
-        all_operators = frees + members
-        operators = [x for x in all_operators if not self.info['operator'][x.name].exclude]
-        
-        for operator in operators:
-            # gatter information about the operator, for use later
-            wrapper = self.info['operator'][operator.name].wrapper
-            if wrapper:
-                pointer = '&' + wrapper.FullName()
-                if wrapper.code:
-                    self.Add('declaration', wrapper.code)
-            elif isinstance(operator, ClassOperator) and self.class_.IsUnique(operator.name):
-                pointer = '&' + operator.FullName()
-            else:
-                pointer = operator.PointerDeclaration()                 
-            rename = self.info['operator'][operator.name].rename
-
-            # check if this operator will be exported as a method
-            export_as_method = wrapper or rename or operator.name in self.BOOST_RENAME_OPERATORS
-            
-            # check if this operator has a special representation in boost
-            special_code = HandleSpecialOperator(operator)
-            has_special_representation = special_code is not None
-            
-            if export_as_method:
-                # export this operator as a normal method, renaming or using the given wrapper
-                if not rename:
-                    if wrapper:
-                        rename = wrapper.name
-                    else:
-                        rename = self.BOOST_RENAME_OPERATORS[operator.name]
-                policy = ''
-                policy_obj = self.info['operator'][operator.name].policy
-                if policy_obj:
-                    policy = ', %s()' % policy_obj.Code() 
-                self.Add('inside', '.def("%s", %s%s)' % (rename, pointer, policy))
-            
-            elif has_special_representation:
-                self.Add('inside', special_code)
-                
-            elif operator.name in self.BOOST_SUPPORTED_OPERATORS:
-                # export this operator using boost's facilities
-                op = operator
-                is_unary = isinstance(op, Operator) and len(op.parameters) == 1 or\
-                           isinstance(op, ClassOperator) and len(op.parameters) == 0
-                if is_unary:
-                    self.Add('inside', '.def( %s%sself )' % \
-                        (operator.name, namespaces.python))
-                else:
-                    # binary operator
-                    if len(operator.parameters) == 2:
-                        left_operand = GetOperand(operator.parameters[0])
-                        right_operand = GetOperand(operator.parameters[1])
-                    else:
-                        left_operand = namespaces.python + 'self'
-                        right_operand = GetOperand(operator.parameters[0])
-                    self.Add('inside', '.def( %s %s %s )' % \
-                        (left_operand, operator.name, right_operand))
-
-        # export the converters.
-        # export them as simple functions with a pre-determined name
-
-        converters = [x for x in self.public_members if type(x) == ConverterOperator]
-                
-        def ConverterMethodName(converter):
-            result_fullname = converter.result.FullName()
-            result_name = converter.result.name
-            for regex, method_name in self.SPECIAL_CONVERTERS.items():
-                if regex.match(result_fullname):
-                    return method_name
-            else:
-                # extract the last name from the full name
-                result_name = makeid(result_name)
-                return 'to_' + result_name
-            
-        for converter in converters:
-            info = self.info['operator'][converter.result.FullName()]
-            # check if this operator should be excluded
-            if info.exclude:
-                continue
-            
-            special_code = HandleSpecialOperator(converter)
-            if info.rename or not special_code:
-                # export as method
-                name = info.rename or ConverterMethodName(converter)
-                if self.class_.IsUnique(converter.name):
-                    pointer = '&' + converter.FullName()
-                else:
-                    pointer = converter.PointerDeclaration()
-                policy_code = ''
-                if info.policy:
-                    policy_code = ', %s()' % info.policy.Code()
-                self.Add('inside', '.def("%s", %s%s)' % (name, pointer, policy_code))
-                    
-            elif special_code:
-                self.Add('inside', special_code)
-
-
-
-    def ExportNestedClasses(self, exported_names):
-        nested_classes = [x for x in self.public_members if isinstance(x, NestedClass)]
-        for nested_class in nested_classes:
-            nested_info = self.info[nested_class.name]
-            nested_info.include = self.info.include
-            nested_info.name = nested_class.FullName()
-            exporter = ClassExporter(nested_info)
-            exporter.SetDeclarations(self.declarations + [nested_class])
-            codeunit = SingleCodeUnit(None, None)
-            exporter.Export(codeunit, exported_names)
-            self.nested_codeunits.append(codeunit)
-
-
-    def ExportNestedEnums(self):
-        nested_enums = [x for x in self.public_members if isinstance(x, ClassEnumeration)]
-        for enum in nested_enums:
-            enum_info = self.info[enum.name]
-            enum_info.include = self.info.include
-            enum_info.name = enum.FullName()
-            exporter = EnumExporter(enum_info)
-            exporter.SetDeclarations(self.declarations + [enum])
-            codeunit = SingleCodeUnit(None, None)
-            exporter.Export(codeunit, None)
-            self.nested_codeunits.append(codeunit)
-
-
-    def ExportSmartPointer(self):
-        smart_ptr = self.info.smart_ptr
-        if smart_ptr:
-            class_name = self.class_.FullName()
-            smart_ptr = smart_ptr % class_name
-            #self.Add('template', smart_ptr)
-            
-            self.Add('scope', '// Temporary code for smart pointers')
-            self.Add('scope', namespaces.python + 'objects::class_value_wrapper< ')
-            self.Add('scope', '  %s, objects::make_ptr_instance< ' % smart_ptr)
-            self.Add('scope', '    %s, objects::pointer_holder< ' % class_name)
-            self.Add('scope', '      %s, %s >' % (smart_ptr, class_name))
-            self.Add('scope', '  >')
-            self.Add('scope', '>();')
-            
-
-    def ExportOpaquePointerPolicies(self):
-        # check all methods for 'return_opaque_pointer' policies
-        methods = [x for x in self.public_members if isinstance(x, Method)]
-        for method in methods:
-            return_opaque_policy = return_value_policy(return_opaque_pointer)
-            if self.info[method.name].policy == return_opaque_policy:
-                macro = 'BOOST_PYTHON_OPAQUE_SPECIALIZED_TYPE_ID(%s)' % method.result.name
-                if macro not in self._exported_opaque_pointers:
-                    self.Add('declaration-outside', macro)
-                    self._exported_opaque_pointers[macro] = 1
-
-
-#==============================================================================
-# Virtual Wrapper utils
-#==============================================================================
-
-def _ParamsInfo(m, count=None):
-    if count is None:
-        count = len(m.parameters)
-    param_names = ['p%i' % i for i in range(count)]
-    param_types = [x.FullName() for x in m.parameters[:count]]
-    params = ['%s %s' % (t, n) for t, n in zip(param_types, param_names)]
-    #for i, p in enumerate(m.parameters[:count]):
-    #    if p.default is not None:
-    #        #params[i] += '=%s' % p.default
-    #        params[i] += '=%s' % (p.name + '()')
-    params = ', '.join(params) 
-    return params, param_names, param_types
-
-            
-class _VirtualWrapperGenerator(object):
-    'Generates code to export the virtual methods of the given class'
-
-    def __init__(self, class_, bases, info):
-        self.class_ = class_
-        self.bases = bases[:]
-        self.info = info
-        self.wrapper_name = makeid(class_.FullName()) + '_Wrapper'
-        self.virtual_methods = None
-        self._method_count = {}
-        self.GenerateVirtualMethods()
-
-
-    def DefaultImplementationNames(self, method):
-        '''Returns a list of default implementations for this method, one for each
-        number of default arguments. Always returns at least one name, and return from 
-        the one with most arguments to the one with the least.
-        '''
-        base_name = 'default_' + method.name 
-        minArgs = method.minArgs
-        maxArgs = method.maxArgs
-        if minArgs == maxArgs:
-            return [base_name]
-        else:
-            return [base_name + ('_%i' % i) for i in range(minArgs, maxArgs+1)]                
-
-
-    def Declaration(self, method, indent):
-        '''Returns a string with the declarations of the virtual wrapper and
-        its default implementations. This string must be put inside the Wrapper
-        body.        
-        '''
-        pyste = namespaces.pyste
-        python = namespaces.python
-        rename = self.info[method.name].rename or method.name
-        result = method.result.FullName()
-        return_str = 'return '
-        if result == 'void':
-            return_str = ''
-        params, param_names, param_types = _ParamsInfo(method)
-        constantness = ''
-        if method.const:
-            constantness = ' const'
-        
-        # call_method callback
-        decl  = indent + '%s %s(%s)%s {\n' % (result, method.name, params, constantness)
-        param_names_str = ', '.join(param_names)
-        if param_names_str:
-            param_names_str = ', ' + param_names_str
-        decl += indent*2 + '%s%scall_method< %s >(self, "%s"%s);\n' %\
-            (return_str, python, result, rename, param_names_str)
-        decl += indent + '}\n'
-
-        # default implementations (with overloading)
-        def DefaultImpl(method, param_names):
-            'Return the body of a default implementation wrapper'
-            wrapper = self.info[method.name].wrapper
-            if not wrapper:
-                # return the default implementation of the class
-                return '%s%s::%s(%s);\n' % \
-                    (return_str, self.class_.FullName(), method.name, ', '.join(param_names)) 
-            else:
-                # return a call for the wrapper
-                params = ', '.join(['this'] + param_names)
-                return '%s%s(%s);\n' % (return_str, wrapper.FullName(), params)
-                
-        if not method.abstract and method.visibility != Scope.private:
-            minArgs = method.minArgs
-            maxArgs = method.maxArgs
-            impl_names = self.DefaultImplementationNames(method)
-            for impl_name, argNum in zip(impl_names, range(minArgs, maxArgs+1)): 
-                params, param_names, param_types = _ParamsInfo(method, argNum)            
-                decl += '\n'
-                decl += indent + '%s %s(%s)%s {\n' % (result, impl_name, params, constantness)
-                decl += indent*2 + DefaultImpl(method, param_names)
-                decl += indent + '}\n'                
-        return decl
-            
-
-    def MethodDefinition(self, method):
-        '''Returns a list of lines, which should be put inside the class_
-        statement to export this method.'''
-        # dont define abstract methods
-        pyste = namespaces.pyste
-        rename = self.info[method.name].rename or method.name
-        default_names = self.DefaultImplementationNames(method)
-        class_name = self.class_.FullName()
-        wrapper_name = pyste + self.wrapper_name
-        result = method.result.FullName()
-        is_method_unique = self.IsMethodUnique(method.name)
-        constantness = ''
-        if method.const:
-            constantness = ' const'
-        
-        # create a list of default-impl pointers
-        minArgs = method.minArgs
-        maxArgs = method.maxArgs 
-        if is_method_unique:
-            default_pointers = ['&%s::%s' % (wrapper_name, x) for x in default_names]
-        else:
-            default_pointers = []
-            for impl_name, argNum in zip(default_names, range(minArgs, maxArgs+1)):
-                param_list = [x.FullName() for x in method.parameters[:argNum]]
-                params = ', '.join(param_list)             
-                signature = '%s (%s::*)(%s)%s' % (result, wrapper_name, params, constantness)
-                default_pointer = '(%s)&%s::%s' % (signature, wrapper_name, impl_name)
-                default_pointers.append(default_pointer)
-            
-        # get the pointer of the method
-        if is_method_unique:
-            pointer = '&' + method.FullName()
-        else:
-            pointer = method.PointerDeclaration()
-
-        # generate the defs
-        definitions = []
-        # basic def
-        definitions.append('.def("%s", %s, %s)' % (rename, pointer, default_pointers[-1]))
-        for default_pointer in default_pointers[:-1]:
-            definitions.append('.def("%s", %s)' % (rename, default_pointer))
-        return definitions
-
-    
-    def FullName(self):
-        return namespaces.pyste + self.wrapper_name
-
-
-    def GenerateVirtualMethods(self):
-        '''To correctly export all virtual methods, we must also make wrappers
-        for the virtual methods of the bases of this class, as if the methods
-        were from this class itself.
-        This method creates the instance variable self.virtual_methods.
-        '''        
-        def IsVirtual(m):
-            return type(m) is Method and m.virtual and m.visibility != Scope.private        
-                                      
-        all_methods = [x for x in self.class_.members if IsVirtual(x)]
-        for base in self.bases:
-            base_methods = [x.Copy() for x in base if IsVirtual(x)]
-            for base_method in base_methods:
-                base_method.class_ = self.class_.FullName()
-                all_methods.append(base_method)
-        
-        # extract the virtual methods, avoiding duplications. The duplication
-        # must take in account the full signature without the class name, so 
-        # that inherited members are correctly excluded if the subclass overrides
-        # them.
-        def MethodSig(method):
-            if method.const:
-                const = 'const'
-            else:
-                const = ''
-            if method.result:
-                result = method.result.FullName()
-            else:
-                result = ''
-            params = ', '.join([x.FullName() for x in method.parameters]) 
-            return '%s %s(%s) %s' % (result, method.name, params, const) 
-        
-        self.virtual_methods = []
-        already_added = {}
-        for member in all_methods:
-            sig = MethodSig(member)
-            if IsVirtual(member) and not sig in already_added:
-                self.virtual_methods.append(member)
-                already_added[sig] = 0
-            
-    
-    def IsMethodUnique(self, method):
-        if not self._method_count:
-            for m in self.virtual_methods:
-                self._method_count[m.name] = self._method_count.get(m.name, 0) + 1
-        return self._method_count[method] == 1
-        
-        
-    def Constructors(self):
-        def IsValid(m):
-            return isinstance(m, Constructor) and m.visibility == Scope.public
-        return [m for m in self.class_.members if IsValid(m)]
-    
-        
-    def GenerateDefinitions(self):
-        defs = []
-        for method in self.virtual_methods:
-            exclude = self.info[method.name].exclude
-            # generate definitions only for public methods and non-abstract methods
-            if method.visibility == Scope.public and not method.abstract and not exclude:
-                defs.extend(self.MethodDefinition(method))
-        return defs
-
-        
-    def GenerateVirtualWrapper(self, indent):
-        'Return the wrapper for this class'
-        
-        # generate the class code
-        class_name = self.class_.FullName()
-        code = 'struct %s: %s\n' % (self.wrapper_name, class_name)
-        code += '{\n'
-        # generate constructors (with the overloads for each one)
-        for cons in self.Constructors(): # only public constructors
-            minArgs = cons.minArgs
-            maxArgs = cons.maxArgs
-            # from the min number of arguments to the max number, generate
-            # all version of the given constructor
-            cons_code = ''
-            for argNum in range(minArgs, maxArgs+1):
-                params, param_names, param_types = _ParamsInfo(cons, argNum)
-                if params:
-                    params = ', ' + params
-                cons_code += indent + '%s(PyObject* self_%s):\n' % \
-                    (self.wrapper_name, params)
-                cons_code += indent*2 + '%s(%s), self(self_) {}\n\n' % \
-                    (class_name, ', '.join(param_names))
-            code += cons_code
-        # generate the body
-        body = []
-        for method in self.virtual_methods:
-            if not self.info[method.name].exclude:
-                body.append(self.Declaration(method, indent))            
-        body = '\n'.join(body) 
-        code += body + '\n'
-        # add the self member
-        code += indent + 'PyObject* self;\n'
-        code += '};\n'
-        return code 

pyste/src/CppParser.py

@@ -1,117 +0,0 @@
-from GCCXMLParser import ParseDeclarations
-import tempfile
-import shutil
-import os
-import os.path
-import settings
-
-class CppParserError(Exception): pass
-
-
-class CppParser:
-    'Parses a header file and returns a list of declarations'
-    
-    def __init__(self, includes=None, defines=None):
-        'includes and defines ar the directives given to gcc'
-        if includes is None:
-            includes = []
-        if defines is None:
-            defines = []
-        self.includes = includes
-        self.defines = defines
-        self._cache = []
-        self._CACHE_SIZE = 5
-
-
-    def _includeparams(self, filename):
-        includes = self.includes[:]
-        filedir = os.path.dirname(filename)
-        if not filedir:
-            filedir = '.'
-        includes.insert(0, filedir)
-        includes = ['-I "%s"' % x for x in includes]
-        return ' '.join(includes)
-
-
-    def _defineparams(self):
-        defines = ['-D "%s"' % x for x in self.defines]
-        return ' '.join(defines)
-    
-        
-    def UpdateCache(self, include, tail, decl_name, declarations, header):
-        self._cache.append((include, tail, decl_name, declarations, header))
-        if len(self._cache) > self._CACHE_SIZE:
-            self._cache.pop(0)
-
-            
-    def Cache(self, include, tail, decl_name):
-        for cache_include, cache_tail, cache_decl, declarations, header in self._cache:
-            if cache_include == include \
-            and cache_tail == tail \
-            and cache_decl == decl_name:
-                return declarations, header
-        return None
-        
-    
-    def FindFileName(self, include):
-        if os.path.isfile(include):
-            return include
-        for path in self.includes:
-            filename = os.path.join(path, include)  
-            if os.path.isfile(filename):
-                return filename
-        name = os.path.basename(include)
-        raise RuntimeError, 'Header file "%s" not found!' % name
-    
-            
-    def parse(self, include, tail=None, decl_name=None):
-        '''Parses the given filename, and returns (declaration, header). The
-        header returned is normally the same as the given to this method,
-        except if tail is not None: in this case, the header is copied to a temp
-        filename and the tail code is appended to it before being passed on to gcc.
-        This temp filename is then returned.
-        '''        
-        # check if this header was already parsed
-        cached = self.Cache(include, tail, decl_name)
-        if cached:
-            return cached
-        filename = self.FindFileName(include)
-        # copy file to temp folder, if needed
-        if tail:
-            tempfilename = tempfile.mktemp('.h') 
-            infilename = tempfilename
-            shutil.copyfile(filename, infilename)
-            f = file(infilename, 'a')
-            f.write('\n\n'+tail)
-            f.close()  
-        else:
-            infilename = filename
-        xmlfile = tempfile.mktemp('.xml')
-        try:            
-            # get the params
-            includes = self._includeparams(filename)
-            defines = self._defineparams()
-            # call gccxml
-            cmd = 'gccxml %s %s %s -fxml=%s' \
-               % (includes, defines, infilename, xmlfile)
-            if decl_name is not None:
-                cmd += ' "-fxml-start=%s"' % decl_name
-            status = os.system(cmd)        
-            if status != 0 or not os.path.isfile(xmlfile):
-                raise CppParserError, 'Error executing gccxml'
-            # parse the resulting xml
-            declarations = ParseDeclarations(xmlfile)
-            # cache the results
-            self.UpdateCache(include, tail, decl_name, declarations, infilename)
-            # return the declarations                         
-            return declarations, infilename
-        finally:
-            if settings.DEBUG and os.path.isfile(xmlfile):
-                filename = os.path.basename(include)
-                shutil.copy(xmlfile, os.path.splitext(filename)[0] + '.xml')
-            # delete the temporary files
-            try:
-                os.remove(xmlfile)
-                if tail:
-                    os.remove(tempfilename)
-            except OSError: pass

pyste/src/EnumExporter.py

@@ -1,44 +0,0 @@
-from Exporter import Exporter
-from settings import *
-import utils
-
-#==============================================================================
-# EnumExporter 
-#==============================================================================
-class EnumExporter(Exporter):
-    'Exports enumerators'
-
-    def __init__(self, info):
-        Exporter.__init__(self, info)
-
-
-    def SetDeclarations(self, declarations):
-        Exporter.SetDeclarations(self, declarations)
-        self.enum = self.GetDeclaration(self.info.name)
-
-
-    def Export(self, codeunit, expoted_names):
-        if not self.info.exclude:
-            indent = self.INDENT
-            in_indent = self.INDENT*2
-            rename = self.info.rename or self.enum.name
-            full_name = self.enum.FullName()
-            if rename == "$_0" or rename == '._0':
-                full_name = "int"
-                rename = "unnamed"
-            code = indent + namespaces.python
-            code += 'enum_< %s >("%s")\n' % (full_name, rename)
-            for name in self.enum.values:         
-                rename = self.info[name].rename or name
-                value_fullname = self.enum.ValueFullName(name)
-                code += in_indent + '.value("%s", %s)\n' % (rename, value_fullname)
-            code += indent + ';\n\n'
-            codeunit.Write('module', code)
-
-
-    def Unit(self):
-        return utils.makeid(self.info.include)
-
-
-    def Order(self):
-        return self.info.name

pyste/src/Exporter.py

@@ -1,72 +0,0 @@
-import os.path
-
-#==============================================================================
-# Exporter
-#==============================================================================
-class Exporter:
-    'Base class for objects capable to generate boost.python code.'
-
-    INDENT = ' ' * 4
-    
-    def __init__(self, info, parser_tail=None):
-        self.info = info
-        self.parser_tail = parser_tail
-    
-
-    def Name(self):
-        return self.info.name
-
-        
-    def Parse(self, parser):
-        self.parser = parser
-        header = self.info.include
-        tail = self.parser_tail
-        declarations, parser_header = parser.parse(header, tail)
-        self.parser_header = parser_header
-        self.SetDeclarations(declarations)
-
-
-    def SetDeclarations(self, declarations):
-        self.declarations = declarations
-
-        
-    def GenerateCode(self, codeunit, exported_names):
-        self.WriteInclude(codeunit)
-        self.Export(codeunit, exported_names)        
-
-
-    def WriteInclude(self, codeunit):
-        codeunit.Write('include', '#include <%s>\n' % self.info.include)
-        
-        
-    def Export(self, codeunit, exported_names):
-        'subclasses must override this to do the real work'
-        pass
-    
-                    
-    def Unit(self):
-        raise NotImplementedError
-
-    
-    def GetDeclarations(self, fullname):
-        decls = [x for x in self.declarations if x.FullName() == fullname]
-        if not decls:
-            raise RuntimeError, 'no %s declaration found!' % fullname
-        return decls
-
-
-    def GetDeclaration(self, fullname):
-        decls = self.GetDeclarations(fullname)
-        assert len(decls) == 1
-        return decls[0]
-
-
-    def Order(self):
-        '''Returns a string that uniquely identifies this instance. All
-        exporters will be sorted by Order before being exported.
-        '''
-        raise NotImplementedError
-
-
-    def Unit(self):
-        return self.info.include

pyste/src/FunctionExporter.py

@@ -1,95 +0,0 @@
-from Exporter import Exporter
-from policies import *
-from declarations import *
-from settings import *
-import utils
-import exporterutils
-
-
-#==============================================================================
-# FunctionExporter
-#==============================================================================
-class FunctionExporter(Exporter):
-    'Generates boost.python code to export the given function.'
-    
-    def __init__(self, info, tail=None):
-        Exporter.__init__(self, info, tail)
-        self._exported_opaque_pointers = {}
-        
-        
-    def Export(self, codeunit, exported_names):
-        if not self.info.exclude:
-            decls = self.GetDeclarations(self.info.name)
-            for decl in decls:
-                self.info.policy = exporterutils.HandlePolicy(decl, self.info.policy)
-                exporterutils.WarnForwardDeclarations(decl)
-                self.ExportDeclaration(decl, len(decls) == 1, codeunit)
-                self.ExportOpaquePointer(decl, codeunit)
-            self.GenerateOverloads(decls, codeunit)  
-
-
-    def ExportDeclaration(self, decl, unique, codeunit):
-        name = self.info.rename or decl.name
-        defs = namespaces.python + 'def("%s", ' % name
-        wrapper = self.info.wrapper
-        if wrapper:
-            pointer = '&' + wrapper.FullName()
-        elif not unique:                
-            pointer = decl.PointerDeclaration()
-        else:
-            pointer = '&' + decl.FullName()
-        defs += pointer            
-        defs += self.PolicyCode()                            
-        overload = self.OverloadName(decl)
-        if overload:
-            defs += ', %s()' % (namespaces.pyste + overload)
-        defs += ');'
-        codeunit.Write('module', self.INDENT + defs + '\n')  
-        # add the code of the wrapper
-        if wrapper and wrapper.code:
-            codeunit.Write('declaration', code + '\n')
-            
-
-    def OverloadName(self, decl):
-        if decl.minArgs != decl.maxArgs:
-            return '%s_overloads_%i_%i' % \
-                (decl.name, decl.minArgs, decl.maxArgs)
-        else:
-            return ''
-
-        
-    def GenerateOverloads(self, declarations, codeunit):
-        codes = {}
-        for decl in declarations:
-            overload = self.OverloadName(decl)
-            if overload and overload not in codes:
-                code = 'BOOST_PYTHON_FUNCTION_OVERLOADS(%s, %s, %i, %i)' %\
-                    (overload, decl.FullName(), decl.minArgs, decl.maxArgs)
-                codeunit.Write('declaration', code + '\n')
-                codes[overload] = None
-        
-
-    def PolicyCode(self):
-        policy = self.info.policy
-        if policy is not None:
-            assert isinstance(policy, Policy)
-            return ', %s()' % policy.Code() 
-        else:
-            return ''
-
-
-    def ExportOpaquePointer(self, function, codeunit):
-        if self.info.policy == return_value_policy(return_opaque_pointer):
-            type = function.result.name
-            macro = 'BOOST_PYTHON_OPAQUE_SPECIALIZED_TYPE_ID(%s)' % type
-            if macro not in self._exported_opaque_pointers:
-                codeunit.Write('declaration-outside', macro)
-                self._exported_opaque_pointers[macro] = 1
-
-
-    def Order(self):
-        return self.info.name
-
-
-    def Unit(self):
-        return utils.makeid(self.info.include)

pyste/src/GCCXMLParser.py

@@ -1,426 +0,0 @@
-from declarations import *
-from elementtree.ElementTree import ElementTree
-from xml.parsers.expat import ExpatError
-from copy import deepcopy
-
-
-class InvalidXMLError(Exception): pass
-
-class ParserError(Exception): pass
-
-class InvalidContextError(ParserError): pass
-
-
-class GCCXMLParser(object):
-    'Parse a GCC_XML file and extract the top-level declarations.'
-    
-    interested_tags = {'Class':0, 'Function':0, 'Variable':0, 'Enumeration':0}
-    
-    def Parse(self, filename):
-        self.elements = self.GetElementsFromXML(filename)
-        # high level declarations
-        self.declarations = []
-        # parse the elements
-        for id in self.elements:
-            element, decl = self.elements[id]
-            if decl is None: 
-                try:
-                    self.ParseElement(id, element)
-                except InvalidContextError:
-                    pass # ignore those nodes with invalid context 
-                         # (workaround gccxml bug)
-         
-
-    def Declarations(self):
-        return self.declarations
-
-
-    def AddDecl(self, decl):
-        self.declarations.append(decl)
-
-        
-    def ParseElement(self, id, element):
-        method = 'Parse' + element.tag
-        if hasattr(self, method):
-            func = getattr(self, method)
-            func(id, element)
-        else:
-            self.ParseUnknown(id, element)
-
-            
-    def GetElementsFromXML(self,filename):
-        'Extracts a dictionary of elements from the gcc_xml file.'
-        
-        tree = ElementTree()
-        try:
-            tree.parse(filename)
-        except ExpatError:
-            raise InvalidXMLError, 'Not a XML file: %s' % filename
-
-        root = tree.getroot()
-        if root.tag != 'GCC_XML':
-            raise InvalidXMLError, 'Not a valid GCC_XML file'
-
-        # build a dictionary of id -> element, None
-        elementlist = root.getchildren()
-        elements = {}
-        for element in elementlist:
-            id = element.get('id')
-            if id:
-                elements[id] = element, None
-        return elements
-
-
-    def GetDecl(self, id):
-        if id not in self.elements:
-            if id == '_0':
-                raise InvalidContextError, 'Invalid context found in the xml file.'
-            else: 
-                msg = 'ID not found in elements: %s' % id
-                raise ParserError, msg
-
-        elem, decl = self.elements[id]
-        if decl is None:
-            self.ParseElement(id, elem)
-            elem, decl = self.elements[id]
-            if decl is None:
-                raise ParserError, 'Could not parse element: %s' % elem.tag
-        return decl
-    
-
-    def GetType(self, id):
-        def Check(id, feature):
-            pos = id.find(feature)
-            if pos != -1:
-                id = id[:pos] + id[pos+1:]
-                return True, id
-            else:
-                return False, id
-        const, id = Check(id, 'c')
-        volatile, id = Check(id, 'v')
-        restricted, id = Check(id, 'r')
-        decl = self.GetDecl(id)
-        if isinstance(decl, Type):
-            res = decl.Copy()
-            if const:
-                res.const = const
-            if volatile: 
-                res.volatile = volatile
-            if restricted:
-                res.restricted = restricted
-        else:
-            res = Type(decl.FullName(), const)
-            res.volatile = volatile
-            res.restricted = restricted
-            res.incomplete = decl.incomplete
-        return res            
-        
-                
-    def GetLocation(self, location):
-        file, line = location.split(':')
-        file = self.GetDecl(file)
-        return file, int(line)
-
-        
-    def Update(self, id, decl):
-        element, _ = self.elements[id]
-        self.elements[id] = element, decl
-
-        
-    def ParseUnknown(self, id, element):
-        name = '__Unknown_Element_%s' % id
-        namespace = '::'
-        decl = Declaration(name, namespace)
-        self.Update(id, decl)
-        
-        
-    def ParseNamespace(self, id, element):
-        namespace = element.get('name')
-        context = element.get('context')
-        if context:
-            outerns = self.GetDecl(context)
-            if not outerns.endswith('::'):
-                outerns += '::'
-            namespace = outerns + namespace
-        if namespace.startswith('::'):
-            namespace = namespace[2:]
-        self.Update(id, namespace)
-
-
-    def ParseFile(self, id, element):
-        filename = element.get('name')
-        self.Update(id, filename)
-
-        
-    def ParseVariable(self, id, element):
-        # in gcc_xml, a static Field is declared as a Variable, so we check
-        # this and call the Field parser if apply.
-        context = self.GetDecl(element.get('context'))
-        if isinstance(context, Class):
-            self.ParseField(id, element)
-            elem, decl = self.elements[id]
-            decl.static = True
-        else:
-            namespace = context
-            name = element.get('name')                    
-            type_ = self.GetType(element.get('type'))
-            location = self.GetLocation(element.get('location'))
-            variable = Variable(type_, name, namespace)
-            variable.location = location
-            self.AddDecl(variable)
-            self.Update(id, variable)
-        
-
-    def GetArguments(self, element):
-        args = []
-        for child in element:
-            if child.tag == 'Argument':
-                type_ = self.GetType(child.get('type'))
-                type_.default = child.get('default')                
-                args.append(type_)
-        return args
-
-    
-    def ParseFunction(self, id, element, functionType=Function):
-        '''functionType is used because a Operator is identical to a normal 
-        function, only the type of the function changes.'''
-        name = element.get('name')
-        returns = self.GetType(element.get('returns'))
-        namespace = self.GetDecl(element.get('context'))
-        location = self.GetLocation(element.get('location'))
-        params = self.GetArguments(element)
-        function = functionType(name, namespace, returns, params)
-        function.location = location
-        self.AddDecl(function)
-        self.Update(id, function)
-
-
-    def ParseOperatorFunction(self, id, element):
-        self.ParseFunction(id, element, Operator)
-
-        
-    def GetBases(self, bases):       
-        'Parses the string "bases" from the xml into a list of Base instances.'
-
-        if bases is None:
-            return []
-        bases = bases.split()
-        baseobjs = []
-        for base in bases:
-            # get the visibility
-            split = base.split(':')
-            if len(split) == 2:
-                visib = split[0]
-                base = split[1]
-            else:
-                visib = Scope.public                            
-            decl = self.GetDecl(base)
-            baseobj = Base(decl.FullName(), visib)
-            baseobjs.append(baseobj)
-        return baseobjs
-
-        
-    def GetMembers(self, members):
-        # members must be a string with the ids of the members
-        if members is None:
-            return []
-        memberobjs = []
-        for member in members.split():
-            memberobjs.append(self.GetDecl(member)) 
-        return memberobjs
-
-
-    def ParseClass(self, id, element):
-        name = element.get('name')
-        abstract = bool(int(element.get('abstract', '0')))
-        location = self.GetLocation(element.get('location'))
-        context = self.GetDecl(element.get('context'))
-        incomplete = bool(element.get('incomplete', False))
-        if isinstance(context, str): 
-            class_ = Class(name, context, [], abstract, [])
-            self.AddDecl(class_)
-        else:
-            # a nested class
-            visib = element.get('access', Scope.public)
-            class_ = NestedClass(
-                name, context.FullName(), visib, [], abstract, [])
-        # we have to add the declaration of the class before trying        
-        # to parse its members and bases, to avoid recursion.
-        class_.location = location
-        class_.incomplete = incomplete
-        self.Update(id, class_)       
-        # now we can get the members and the bases
-        class_.bases = self.GetBases(element.get('bases'))        
-        class_.members = self.GetMembers(element.get('members'))
-
-
-    def ParseStruct(self, id, element):
-        self.ParseClass(id, element)
-
-
-    def ParseFundamentalType(self, id, element):
-        name = element.get('name')
-        type_ = FundamentalType(name)
-        self.Update(id, type_)
-
-
-    def ParseArrayType(self, id, element):
-        type_ = self.GetType(element.get('type'))
-        min = element.get('min')
-        max = element.get('max')
-        array = ArrayType(type_.name, type_.const)
-        array.min = min
-        array.max = max
-        self.Update(id, array)
-
-        
-    def ParseReferenceType(self, id, element):
-        type_ = self.GetType(element.get('type'))
-        expand = not isinstance(type_, FunctionType)
-        ref = ReferenceType(type_.name, type_.const, None, type_.incomplete, expand)
-        self.Update(id, ref)
-        
-        
-    def ParsePointerType(self, id, element):
-        type_ = self.GetType(element.get('type'))
-        expand = not isinstance(type_, FunctionType)
-        ref = PointerType(type_.name, type_.const, None, type_.incomplete, expand)
-        self.Update(id, ref)
-        
-        
-    def ParseFunctionType(self, id, element):
-        result = self.GetType(element.get('returns'))
-        args = self.GetArguments(element)
-        func = FunctionType(result, args)
-        self.Update(id, func)
-
-
-    def ParseMethodType(self, id, element):
-        class_ = self.GetDecl(element.get('basetype')).FullName()
-        result = self.GetType(element.get('returns'))
-        args = self.GetArguments(element)
-        method = MethodType(result, args, class_)
-        self.Update(id, method)
-
-        
-    def ParseField(self, id, element):
-        name = element.get('name')
-        visib = element.get('access', Scope.public)
-        classname = self.GetDecl(element.get('context')).FullName()
-        type_ = self.GetType(element.get('type'))
-        static = bool(int(element.get('extern', '0')))
-        location = self.GetLocation(element.get('location'))
-        var = ClassVariable(type_, name, classname, visib, static)
-        var.location = location
-        self.Update(id, var)
-
-
-    def ParseMethod(self, id, element, methodType=Method):
-        name = element.get('name')
-        result = self.GetType(element.get('returns'))
-        classname = self.GetDecl(element.get('context')).FullName()
-        visib = element.get('access', Scope.public)
-        static = bool(int(element.get('static', '0')))
-        virtual = bool(int(element.get('virtual', '0')))
-        abstract = bool(int(element.get('pure_virtual', '0')))
-        const = bool(int(element.get('const', '0')))
-        location = self.GetLocation(element.get('location'))
-        params = self.GetArguments(element)
-        method = methodType(
-            name, classname, result, params, visib, virtual, abstract, static, const)
-        method.location = location
-        self.Update(id, method)
-
-
-    def ParseOperatorMethod(self, id, element):
-        self.ParseMethod(id, element, ClassOperator)
-
-        
-    def ParseConstructor(self, id, element):
-        name = element.get('name')
-        visib = element.get('access', Scope.public)
-        classname = self.GetDecl(element.get('context')).FullName()
-        location = self.GetLocation(element.get('location'))
-        params = self.GetArguments(element)
-        ctor = Constructor(name, classname, params, visib)
-        ctor.location = location
-        self.Update(id, ctor)
-
-
-    def ParseDestructor(self, id, element):
-        name = element.get('name')
-        visib = element.get('access', Scope.public)
-        classname = self.GetDecl(element.get('context')).FullName()
-        virtual = bool(int(element.get('virtual', '0')))
-        location = self.GetLocation(element.get('location'))
-        des = Destructor(name, classname, visib, virtual)
-        des.location = location
-        self.Update(id, des)
-
-
-    def ParseConverter(self, id, element):
-        self.ParseMethod(id, element, ConverterOperator)
-
-
-    def ParseTypedef(self, id, element):
-        name = element.get('name')
-        type = self.GetType(element.get('type'))        
-        context = self.GetDecl(element.get('context'))
-        if isinstance(context, Class):
-            context = context.FullName()
-        typedef = Typedef(type, name, context)
-        self.Update(id, typedef)
-        self.AddDecl(typedef)
-
-
-    def ParseEnumeration(self, id, element):
-        name = element.get('name')
-        location = self.GetLocation(element.get('location'))
-        context = self.GetDecl(element.get('context'))
-        if isinstance(context, str):
-            enum = Enumeration(name, context)
-            self.AddDecl(enum) # in this case, is a top level decl 
-        else:
-            visib = element.get('access', Scope.public)
-            enum = ClassEnumeration(name, context.FullName(), visib)
-            
-        enum.location = location
-        for child in element:
-            if child.tag == 'EnumValue':
-                name = child.get('name')
-                value = int(child.get('init'))
-                enum.values[name] = value
-        self.Update(id, enum)
-
-
-    def ParseUnimplemented(self, id, element):
-        'No idea of what this is'
-        self.Update(id, Declaration('', ''))
-        
-
-    def ParseUnion(self, id, element):
-        name = element.get('name')
-        context = self.GetDecl(element.get('context'))
-        location = self.GetLocation(element.get('location'))
-        if isinstance(context, str):
-            # a free union
-            union = Union(name, context)
-            self.AddDecl(union)
-        else:
-            visib = element.get('access', Scope.public)
-            union = ClassUnion(name, context.FullName(), visib)
-        union.location = location
-        self.Update(id, union)
-        
-
-
-def ParseDeclarations(filename):
-    'Returns a list of the top declarations found in the gcc_xml file.'
-        
-    parser = GCCXMLParser() 
-    parser.Parse(filename)
-    return parser.Declarations()
-
-
-if __name__ == '__main__':
-    ParseDeclarations(r'D:\Programming\Libraries\boost-cvs\boost\libs\python\pyste\example\test.xml')

pyste/src/HeaderExporter.py

@@ -1,77 +0,0 @@
-from Exporter import Exporter
-from ClassExporter import ClassExporter
-from FunctionExporter import FunctionExporter
-from EnumExporter import EnumExporter
-from VarExporter import VarExporter
-from infos import *
-from declarations import *
-import os.path
-import exporters
-
-#==============================================================================
-# HeaderExporter
-#==============================================================================
-class HeaderExporter(Exporter):
-    'Exports all declarations found in the given header'
-
-    def __init__(self, info, parser_tail=None):
-        Exporter.__init__(self, info, parser_tail)
-
-
-    def WriteInclude(self, codeunit):
-        pass
-
-
-    def SetDeclarations(self, declarations):
-        def IsInternalName(name):
-            '''Returns true if the given name looks like a internal compiler
-            structure'''
-            return name.startswith('_')
-        
-        Exporter.SetDeclarations(self, declarations)
-        header = os.path.normpath(self.parser_header)
-        for decl in declarations:
-            # check if this declaration is in the header
-            location = os.path.normpath(decl.location[0])
-            if location != header or IsInternalName(decl.name):
-                continue
-            # ok, check the type of the declaration and export it accordingly
-            self.HandleDeclaration(decl)
-            
-
-    def HandleDeclaration(self, decl):
-        '''Dispatch the declaration to the appropriate method, that must create
-        a suitable info object for a Exporter, create a Exporter, set its
-        declarations and append it to the list of exporters.
-        ''' 
-        dispatch_table = {
-            Class : ClassExporter,
-            Enumeration : EnumExporter,
-            Function : FunctionExporter,
-            Variable : VarExporter,
-        }
-        
-        exporter_class = dispatch_table.get(type(decl))
-        if exporter_class is not None:
-            self.HandleExporter(decl, exporter_class)
-
-            
-    def HandleExporter(self, decl, exporter_type):
-        # only export complete declarations
-        if not getattr(decl, "incomplete", False):
-            info = self.info[decl.name]
-            info.name = decl.FullName()
-            info.include = self.info.include
-            exporter = exporter_type(info)
-            exporter.SetDeclarations(self.declarations)
-            exporters.exporters.append(exporter)
-
-    
-    def Unit(self):
-        return None # doesn't write anything by himself
-
-
-    def Order(self):
-        return self.info.include
-
-        

pyste/src/IncludeExporter.py

@@ -1,24 +0,0 @@
-import os.path
-from Exporter import Exporter
-
-#==============================================================================
-# IncludeExporter
-#==============================================================================
-class IncludeExporter(Exporter):
-    '''Writes an include declaration to the module. Useful to add extra code
-    for use in the Wrappers.
-    This class just reimplements the Parse method to do nothing: the 
-    WriteInclude in Exporter already does the work for us.
-    '''
-
-    def __init__(self, info, parser_tail=None):
-        Exporter.__init__(self, info, parser_tail)
-
-    def Parse(self, parser):
-        pass
-
-    def Order(self):
-        return self.info.include
-
-    def Unit(self):
-        return '__all__'    # include it in all generated cpps (multiple mode)

pyste/src/MultipleCodeUnit.py

@@ -1,104 +0,0 @@
-from SingleCodeUnit import SingleCodeUnit
-import os
-import utils
-from SmartFile import SmartFile
-
-
-#==============================================================================
-# MultipleCodeUnit
-#==============================================================================
-class MultipleCodeUnit(object):
-    '''
-    Represents a bunch of cpp files, where each cpp file represents a header
-    to be exported by pyste. Another cpp, named <module>.cpp is created too.
-    '''
-
-    def __init__(self, modulename, outdir):
-        self.modulename = modulename
-        self.outdir = outdir
-        self.codeunits = {}  # maps from a header to a SingleCodeUnit
-        self.functions = []
-        self._current = None
-
-    
-    def _FunctionName(self, code_unit_name):
-        return '_Export_%s' % utils.makeid(code_unit_name)
-    
-
-    def _FileName(self, code_unit_name):
-        filename = os.path.basename(code_unit_name)
-        filename = '_%s.cpp' % os.path.splitext(filename)[0] 
-        return os.path.join(self.outdir, filename)
-
-    
-    def SetCurrent(self, code_unit_name):
-        'Changes the current code unit'
-        try:
-            if code_unit_name is not None:
-                codeunit = self.codeunits[code_unit_name]
-            else:
-                codeunit = None
-        except KeyError:
-            filename = self._FileName(code_unit_name)
-            function_name = self._FunctionName(code_unit_name)
-            codeunit = SingleCodeUnit(None, filename)
-            codeunit.module_definition = 'void %s()' % function_name
-            self.codeunits[code_unit_name] = codeunit
-            if code_unit_name != '__all__':
-                self.functions.append(function_name)
-        self._current = codeunit
-
-
-    def Current(self):
-        return self._current
-
-    current = property(Current, SetCurrent)
-        
-            
-    def Write(self, section, code):
-        if self._current is not None:
-            self.current.Write(section, code)
-
-
-    def Section(self, section):
-        if self._current is not None: 
-            return self.current.Section(section)
-
-
-    def _CreateOutputDir(self):
-        try:
-            os.mkdir(self.outdir)
-        except OSError: pass # already created
-
-        
-    def Save(self):
-        # create the directory where all the files will go
-        self._CreateOutputDir();
-        # write all the codeunits, merging first the contents of
-        # the special code unit named __all__
-        __all__ = self.codeunits.get('__all__')
-        for name, codeunit in self.codeunits.items():
-            if name != '__all__':                
-                if __all__:
-                    codeunit.Merge(__all__)
-                codeunit.Save()
-        # generate the main cpp
-        filename = os.path.join(self.outdir, self.modulename + '.cpp')
-        fout = SmartFile(filename, 'w')
-        fout.write(utils.left_equals('Include'))
-        fout.write('#include <boost/python.hpp>\n\n')
-        fout.write(utils.left_equals('Exports'))
-        for function in self.functions:
-            fout.write('void %s();\n' % function)
-        fout.write('\n')
-        fout.write(utils.left_equals('Module'))
-        fout.write('BOOST_PYTHON_MODULE(%s)\n' % self.modulename)
-        fout.write('{\n')
-        indent = ' ' * 4
-        for function in self.functions:
-            fout.write(indent)
-            fout.write('%s();\n' % function)
-        fout.write('}\n')
-        
-    
-        

pyste/src/SingleCodeUnit.py

@@ -1,84 +0,0 @@
-from settings import namespaces
-import settings
-from utils import remove_duplicated_lines, left_equals
-from SmartFile import SmartFile
-
-
-#==============================================================================
-# SingleCodeUnit
-#==============================================================================
-class SingleCodeUnit:
-    '''
-    Represents a cpp file, where other objects can write in one of the     
-    predefined sections.
-    The avaiable sections are:
-        include - The include area of the cpp file
-        declaration - The part before the module definition
-        module - Inside the BOOST_PYTHON_MODULE macro
-    '''
-    
-    def __init__(self, modulename, filename):
-        self.modulename = modulename
-        self.filename = filename
-        # define the avaiable sections
-        self.code = {}
-        # include section
-        self.code['include'] = ''
-        # declaration section (inside namespace)        
-        self.code['declaration'] = ''
-        # declaration (outside namespace)
-        self.code['declaration-outside'] = ''
-        # inside BOOST_PYTHON_MACRO
-        self.code['module'] = ''
-        # create the default module definition
-        self.module_definition = 'BOOST_PYTHON_MODULE(%s)' % modulename
-
-
-    def Write(self, section, code):
-        'write the given code in the section of the code unit'
-        if section not in self.code:
-            raise RuntimeError, 'Invalid CodeUnit section: %s' % section
-        self.code[section] += code
-        
-
-    def Merge(self, other):
-        for section in ('include', 'declaration', 'declaration-outside', 'module'):
-            self.code[section] = self.code[section] + other.code[section]    
-
-        
-    def Section(self, section):
-        return self.code[section]
-
-    
-    def Save(self):
-        'Writes this code unit to the filename'
-        space = '\n\n'
-        fout = SmartFile(self.filename, 'w')
-        # includes
-        includes = remove_duplicated_lines(self.code['include'])
-        fout.write('\n' + left_equals('Includes'))        
-        fout.write('#include <boost/python.hpp>\n')
-        fout.write(includes)
-        fout.write(space)
-        # using
-        if settings.USING_BOOST_NS:
-            fout.write(left_equals('Using'))
-            fout.write('using namespace boost::python;\n\n')
-        # declarations
-        declaration = self.code['declaration']
-        declaration_outside = self.code['declaration-outside']
-        if declaration_outside or declaration:
-            fout.write(left_equals('Declarations'))
-            fout.write(declaration_outside + '\n\n')
-            if declaration:
-                pyste_namespace = namespaces.pyste[:-2]            
-                fout.write('namespace %s {\n\n\n' % pyste_namespace)
-                fout.write(declaration) 
-                fout.write('\n\n}// namespace %s\n' % pyste_namespace)
-                fout.write(space)
-        # module
-        fout.write(left_equals('Module'))
-        fout.write(self.module_definition + '\n')
-        fout.write('{\n')
-        fout.write(self.code['module']) 
-        fout.write('}\n')

pyste/src/SmartFile.py

@@ -1,55 +0,0 @@
-import os
-import md5
-
-#==============================================================================
-# SmartFile
-#==============================================================================
-class SmartFile(object):
-    '''
-    A file-like object used for writing files. The given file will only be
-    actually written to disk if there's not a file with the same name, or if
-    the existing file is *different* from the file to be written.
-    '''
-
-    def __init__(self, filename, mode='w'):
-        self.filename = filename
-        self.mode = mode
-        self._contents = []
-        self._closed = False
-
-
-    def __del__(self):
-        if not self._closed:
-            self.close()
-
-
-    def write(self, string):
-        self._contents.append(string)
-
-
-    def _dowrite(self, contents):
-        f = file(self.filename, self.mode)
-        f.write(contents)
-        f.close()
-        
-        
-    def _GetMD5(self, string):
-        return md5.new(string).digest()
-        
-    
-    def close(self):
-        # if the filename doesn't exist, write the file right away
-        this_contents = ''.join(self._contents)
-        if not os.path.isfile(self.filename):
-            self._dowrite(this_contents)
-        else:
-            # read the contents of the file already in disk
-            f = file(self.filename)
-            other_contents = f.read()
-            f.close()
-            # test the md5 for both files 
-            this_md5 = self._GetMD5(this_contents)
-            other_md5 = self._GetMD5(other_contents)
-            if this_md5 != other_md5:
-                self._dowrite(this_contents)
-        self._closed = True

pyste/src/VarExporter.py

@@ -1,35 +0,0 @@
-from Exporter import Exporter
-from settings import *
-import utils
-
-#==============================================================================
-# VarExporter
-#==============================================================================
-class VarExporter(Exporter):
-    '''Exports a global variable.
-    '''
-
-    def __init__(self, info):
-        Exporter.__init__(self, info)
-
-
-    def Export(self, codeunit, exported_names):
-        if self.info.exclude: return
-        decl = self.GetDeclaration(self.info.name)
-        if not decl.type.const: 
-            msg = '---> Warning: The global variable "%s" is non-const:\n' \
-                  '              changes in Python will not reflect in C++.'
-            print msg % self.info.name
-            print
-        rename = self.info.rename or self.info.name
-        code = self.INDENT + namespaces.python
-        code += 'scope().attr("%s") = %s;\n' % (rename, self.info.name)
-        codeunit.Write('module', code)
-
-
-    def Order(self):
-        return self.info.name
-
-
-    def Unit(self):
-        return utils.makeid(self.info.include) 

pyste/src/declarations.py

@@ -1,554 +0,0 @@
-'''
-Module declarations
-
-    Defines classes that represent declarations found in C++ header files.
-    
-'''
-
-class Declaration(object):
-    'Represents a basic declaration.'
-
-    __slots__ = 'name namespace location incomplete'.split()
-
-    def __init__(self, name, namespace):
-        # the declaration name
-        self.name = name
-        # all the namespaces, separated by '::' = 'boost::inner'
-        self.namespace = namespace
-        # tuple (filename, line)
-        self.location = '', -1
-        # if a declaration is incomplete it means that it was
-        # forward declared
-        self.incomplete = False 
-
-
-    def FullName(self):
-        'Returns the full qualified name: "boost::inner::Test"'
-        namespace = self.namespace or ''
-        #if not namespace:
-        #    namespace = ''
-        if namespace and not namespace.endswith('::'):
-            namespace += '::'
-        return namespace + self.name
-    
-    
-    def __repr__(self):        
-        return '<Declaration %s at %s>' % (self.FullName(), id(self))
-
-
-    def __str__(self):
-        return 'Declaration of %s' % self.FullName()
-    
-
-
-class Class(Declaration):
-    'The declaration of a class or struct.'
-    
-    __slots__= 'members abstract bases _members_count'.split()
-    def __init__(self, name, namespace, members, abstract, bases):
-        Declaration.__init__(self, name, namespace)
-        # list of members
-        self.members = members
-        # whatever the class has any abstract methods
-        self.abstract = abstract
-        # instances of Base
-        self.bases = bases
-        self._members_count = {}
-
-
-    def __iter__(self):
-        return iter(self.members)            
-
-
-    def IsAbstract(self):
-        'Returns True if any method of this class is abstract'
-        for member in self.members:
-            if isinstance(member, Method):
-                if member.abstract:
-                    return True
-        return False
-
-    
-    def RawName(self):
-        'Returns the raw name of a template class. name = Foo<int>, raw = Foo'
-        lesspos = self.name.find('<')
-        if lesspos != -1:
-            return self.name[:lesspos]
-        else:
-            return self.name        
-
-
-    def Constructors(self, publics_only=True):
-        constructors = []
-        for member in self:
-            if isinstance(member, Constructor):
-                if publics_only and member.visibility != Scope.public:
-                    continue
-                constructors.append(member)
-        return constructors
-
-    
-    def HasCopyConstructor(self):
-        for cons in self.Constructors():
-            if cons.IsCopy():
-                return True
-        return False
-
-
-    def HasDefaultConstructor(self):
-        for cons in self.Constructors():
-            if cons.IsDefault():
-                return True
-        return False
-
-
-    def IsUnique(self, member_name):
-        if not self._members_count:
-            for m in self:
-                self._members_count[m.name] = self._members_count.get(m.name, 0) + 1
-        try:
-            return self._members_count[member_name] == 1
-        except KeyError:
-            print self._members_count
-            print 'Key', member_name
-
-
-
-class NestedClass(Class):
-    'The declaration of a class/struct inside another class/struct.'
-
-    __slots__= 'class_ visibility'.split()
-    
-    def __init__(self, name, class_, visib, members, abstract, bases):
-        Class.__init__(self, name, None, members, abstract, bases)
-        self.class_ = class_
-        self.visibility = visib
-
-
-    def FullName(self):
-        return '%s::%s' % (self.class_, self.name)
-    
-
-    
-class Base:
-    'Represents a base class of another class.'
-
-    __slots__= 'name visibility'.split() 
-    
-    def __init__(self, name, visibility=None):
-        # class_ is the full name of the base class
-        self.name = name
-        # visibility of the derivation
-        if visibility is None:
-            visibility = Scope.public
-        self.visibility = visibility
-
-
-
-class Scope:
-    public = 'public'
-    private = 'private'
-    protected = 'protected'
-
-
-    
-class Function(Declaration):
-    'The declaration of a function.'
-    
-    __slots__= 'result parameters'.split()
-    
-    def __init__(self, name, namespace, result, params):
-        Declaration.__init__(self, name, namespace)
-        # the result type: instance of Type, or None (constructors)            
-        self.result = result
-        # the parameters: instances of Type
-        self.parameters = params
-
-
-    def PointerDeclaration(self):
-        'returns a declaration of a pointer to this function'
-        result = self.result.FullName()
-        params = ', '.join([x.FullName() for x in self.parameters]) 
-        return '(%s (*)(%s))&%s' % (result, params, self.FullName())
-
-    
-    def _MinArgs(self):
-        min = 0
-        for arg in self.parameters:
-            if arg.default is None:
-                min += 1
-        return min
-
-    minArgs = property(_MinArgs)
-    
-
-    def _MaxArgs(self):
-        return len(self.parameters)
-
-    maxArgs = property(_MaxArgs)
-
-    
-    def Copy(self):
-        return self.__class__(
-            self.name, self.namespace, self.result, self.params[:])       
-   
-   
-class Operator(Function):
-    'The declaration of a custom operator.'
-    
-    def FullName(self):
-        namespace = self.namespace or ''
-        if not namespace.endswith('::'):
-            namespace += '::'
-        return namespace + 'operator' + self.name 
-
-
-class Method(Function):
-    'The declaration of a method.'
-
-    __slots__= 'visibility virtual abstract static class_ const'.split() 
-    
-    def __init__(self, name, class_, result, params, visib, virtual, abstract, static, const):
-        Function.__init__(self, name, None, result, params)
-        self.visibility = visib
-        self.virtual = virtual
-        self.abstract = abstract
-        self.static = static
-        self.class_ = class_
-        self.const = const
-
-    
-    def FullName(self):
-        return self.class_ + '::' + self.name
-
-
-    def PointerDeclaration(self):
-        'returns a declaration of a pointer to this function'
-        if self.static:
-            # static methods are like normal functions
-            return Function.PointerDeclaration(self)
-        else:
-            # using syntax of methods
-            result = self.result.FullName()
-            params = ', '.join([x.FullName() for x in self.parameters]) 
-            const = ''
-            if self.const:
-                const = 'const'            
-            return '(%s (%s::*)(%s) %s)&%s' %\
-                (result, self.class_, params, const, self.FullName()) 
-
-
-    def Copy(self):
-        return self.__class__(
-            self.name, 
-            self.class_, 
-            self.result, 
-            self.parameters[:], 
-            self.visibility, 
-            self.virtual, 
-            self.abstract, 
-            self.static, 
-            self.const)
-
-    
-class Constructor(Method):
-    'A constructor of a class.'
-
-    def __init__(self, name, class_, params, visib):
-        Method.__init__(self, name, class_, None, params, visib, False, False, False, False)
-
-
-    def IsDefault(self):
-        return len(self.parameters) == 0
-
-
-    def IsCopy(self):
-        if len(self.parameters) != 1:
-            return False
-        param = self.parameters[0]
-        class_as_param = self.parameters[0].name == self.class_
-        param_reference = isinstance(param, ReferenceType) 
-        return param_reference and class_as_param and param.const
-        
-
-class Destructor(Method):
-    'The destructor of a class.'
-
-    def __init__(self, name, class_, visib, virtual):
-        Method.__init__(self, name, class_, None, [], visib, virtual, False, False, False)
-
-    def FullName(self):
-        return self.class_ + '::~' + self.name
-
-
-
-class ClassOperator(Method):
-    'The declaration of a custom operator in a class.'
-    
-    def FullName(self):
-        return self.class_ + '::operator ' + self.name
-
-
-    
-class ConverterOperator(ClassOperator):
-    'An operator in the form "operator OtherClass()".'
-    
-    def FullName(self):
-        return self.class_ + '::operator ' + self.result.FullName()
-
-    
-
-class Type(Declaration):
-    'Represents a type.'
-
-    __slots__= 'const default volatile restricted incomplete'.split() 
-    
-    def __init__(self, name, const=False, default=None, incomplete=False):
-        Declaration.__init__(self, name, None)
-        # whatever the type is constant or not
-        self.const = const
-        # used when the Type is a function argument
-        self.default = default
-        self.volatile = False
-        self.restricted = False
-        self.incomplete = incomplete
-
-    def __repr__(self):
-        if self.const:
-            const = 'const '
-        else:
-            const = ''
-        return '<Type ' + const + self.name + '>'
-
-
-    def FullName(self):
-        if self.const:
-            const = 'const '
-        else:
-            const = ''
-        return const + self.name
-
-
-    def Copy(self):
-        t = self.__class__(self.name, self.const, self.default, self.incomplete)
-        t.volatile = self.volatile
-        t.restricted = self.restricted
-        return t
-
-
-class ArrayType(Type):
-    'Represents an array.'
-
-    __slots__= 'min max'.split() 
-    
-    def __init__(self, name, const=False, default=None, incomplete=False): 
-        'min and max can be None.'
-        Type.__init__(self, name, const)
-        self.min = None
-        self.max = None        
-
-    def Copy(self):
-        t = Type.Copy(self)
-        t.min = self.min
-        t.max = self.max
-        return t 
-
-
-    
-class ReferenceType(Type): 
-    'A reference type.'    
-
-    __slots__= 'expand'.split() 
-    
-    def __init__(self, name, const=False, default=None, incomplete=False, expandRef=True):
-        Type.__init__(self, name, const, default, incomplete)
-        self.expand = expandRef
-        
-        
-    def FullName(self):
-        'expand is False for function pointers'
-        expand = ' &'
-        if not self.expand:
-            expand = ''
-        return Type.FullName(self) + expand
-
-
-    def Copy(self):
-        t = Type.Copy(self)
-        t.expand = self.expand
-        return t
-
-
-
-class PointerType(Type):
-    'A pointer type.'
-    
-    __slots__= 'expand'.split() 
-    
-    def __init__(self, name, const=False, default=None, incomplete=False, expandPointer=False):
-        Type.__init__(self, name, const, default, incomplete)
-        self.expand = expandPointer
-
-   
-    def FullName(self):
-        'expand is False for function pointer'
-        expand = ' *'
-        if not self.expand:
-            expand = ''
-        return Type.FullName(self) + expand
-
-    def Copy(self):
-        t = Type.Copy(self)
-        t.expand = self.expand
-        return t 
-   
-
-
-class FundamentalType(Type): 
-    'One of the fundamental types (int, void...).'
-
-    def __init__(self, name, const=False, default=None, incomplete=False): 
-        Type.__init__(self, name, const, default, incomplete)
-
-
-
-class FunctionType(Type):
-    'A pointer to a function.'
-
-    __slots__= 'result parameters name'.split() 
-    
-    def __init__(self, result, parameters):  
-        Type.__init__(self, '', False)
-        self.result = result
-        self.parameters = parameters
-        self.name = self.FullName()
-
-
-    def FullName(self):
-        full = '%s (*)' % self.result.FullName()
-        params = [x.FullName() for x in self.parameters]
-        full += '(%s)' % ', '.join(params)        
-        return full
-    
-    
-    def Copy(self):
-        return FunctionType(self.result, self.parameters[:])
-    
-
-class MethodType(FunctionType):
-    'A pointer to a member function of a class.'
-
-    __slots__= 'result parameters class_ name'.split() 
-    
-    def __init__(self, result, parameters, class_):  
-        Type.__init__(self, '', False)
-        self.result = result
-        self.parameters = parameters
-        self.class_ = class_
-        self.name = self.FullName()
-
-    def FullName(self):
-        full = '%s (%s::*)' % (self.result.FullName(), self.class_)
-        params = [x.FullName() for x in self.parameters]
-        full += '(%s)' % ', '.join(params)
-        return full
-    
-    def Copy(self):
-        return MethodType(self.result, self.parameters[:], self.class_)
-     
-
-class Variable(Declaration):
-    'Represents a global variable.'
-    
-    __slots__= 'type'.split()
-    
-    def __init__(self, type, name, namespace):
-        Declaration.__init__(self, name, namespace)
-        # instance of Type
-        self.type = type
-
-
-
-class ClassVariable(Variable):
-    'Represents a class variable.'
-
-    __slots__= 'visibility static class_'.split() 
-    
-    def __init__(self, type, name, class_, visib, static):
-        Variable.__init__(self, type, name, None)
-        self.visibility = visib
-        self.static = static
-        self.class_ = class_
-    
-
-    def FullName(self):
-        return self.class_ + '::' + self.name
-
-        
-    
-class Enumeration(Declaration):
-    
-    __slots__= 'values'.split()
-    
-    def __init__(self, name, namespace):
-        Declaration.__init__(self, name, namespace)
-        self.values = {} # dict of str => int
-
-    def ValueFullName(self, name):
-        assert name in self.values
-        namespace = self.namespace
-        if namespace:
-            namespace += '::'
-        return namespace + name
-
-
-
-class ClassEnumeration(Enumeration):
-
-    __slots__= 'class_ visibility'.split()
-    
-    def __init__(self, name, class_, visib):
-        Enumeration.__init__(self, name, None)
-        self.class_ = class_
-        self.visibility = visib
-
-
-    def FullName(self):
-        return '%s::%s' % (self.class_, self.name)
-
-
-    def ValueFullName(self, name):
-        assert name in self.values
-        return '%s::%s' % (self.class_, name)
-
-    
-
-class Typedef(Declaration):
-
-    __slots__= 'type visibility'.split() 
-    
-    def __init__(self, type, name, namespace):
-        Declaration.__init__(self, name, namespace)
-        self.type = type
-        self.visibility = Scope.public
-
-
-class Union(Declaration):
-    'Shallow declaration, because Unions are not supported yet'    
-    def __init__(self, name, namespace):
-        Declaration.__init__(self, name, namespace)
-
-
-class ClassUnion(Union):
-
-    __slots__= 'class_ visibility'.split() 
-
-    def __init__(self, name, class_, visib):
-        Union.__init__(self, name, None)
-        self.class_ = class_
-        self.visibility = visib            
-
-    def FullName(self):
-        return '%s::%s' % (self.class_, self.name)
-
-

pyste/src/exporters.py

@@ -1,3 +0,0 @@
-
-# a list of Exporter instances
-exporters = []

pyste/src/exporterutils.py

@@ -1,91 +0,0 @@
-'''
-Various helpers for interface files.
-'''
-
-from settings import *
-from policies import *
-from declarations import *
-
-#==============================================================================
-# FunctionWrapper
-#==============================================================================
-class FunctionWrapper(object): 
-    '''Holds information about a wrapper for a function or a method. It is
-    divided in 2 parts: the name of the Wrapper, and its code.  The code is
-    placed in the declaration section of the module, while the name is used to
-    def' the function or method (with the pyste namespace prepend to it). If
-    code is None, the name is left unchanged.
-    '''
-
-    def __init__(self, name, code=None):
-        self.name = name
-        self.code = code
-
-    def FullName(self):
-        if self.code:
-            return namespaces.pyste + self.name
-        else:
-            return self.name
-
-
-_printed_warnings = {} # used to avoid double-prints of warnings
-
-#==============================================================================
-# HandlePolicy
-#==============================================================================
-def HandlePolicy(function, policy):
-    '''Show a warning to the user if the function needs a policy and doesn't
-    have one. Return a policy to the function, which is the given policy itself
-    if it is not None, or a default policy for this method.
-    '''
-    
-    def IsString(type):
-        'Return True if the Type instance can be considered a string'
-        return type.const and type.name == 'char' and isinstance(type, PointerType)
-
-    def IsPyObject(type):
-        return type.FullName() == '_object *' # internal name of PyObject
-    
-    result = function.result
-    # if the function returns const char*, a policy is not needed
-    if IsString(result) or IsPyObject(result):
-        return policy
-    # if returns a const T&, set the default policy
-    if policy is None and result.const and isinstance(result, ReferenceType):
-        policy = return_value_policy(copy_const_reference)
-    # basic test if the result type demands a policy
-    needs_policy = isinstance(result, (ReferenceType, PointerType)) 
-    # show a warning to the user, if needed
-    if needs_policy and policy is None:
-        global _printed_warnings
-        warning = '---> Error: %s returns a pointer or a reference, ' \
-                  'but no policy was specified.' % function.FullName()
-        if warning not in _printed_warnings:
-            print warning
-            print 
-            # avoid double prints of the same warning
-            _printed_warnings[warning] = 1
-    return policy
-            
-
-
-#==============================================================================
-# WarnForwardDeclarations
-#==============================================================================
-def WarnForwardDeclarations(function):
-    '''Checks if any of the parameters or the result of the function are
-    incomplete types.'''
-
-    types = [function.result] + function.parameters
-    types = [x for x in types if x]
-    for type in types:
-        if type.incomplete:
-            msg = '---> Error: %s is forward declared. Please include the ' \
-                'appropriate header with its definition' % type.name
-            # disable this for now... it was reporting too many false 
-            # forward declarations to be useful
-            if 0 and msg not in _printed_warnings:
-                print msg
-                print 
-                _printed_warnings[msg] = 1
-    

pyste/src/infos.py

@@ -1,217 +0,0 @@
-import os.path
-import copy
-import exporters 
-from ClassExporter import ClassExporter
-from FunctionExporter import FunctionExporter
-from IncludeExporter import IncludeExporter
-from EnumExporter import EnumExporter
-from HeaderExporter import HeaderExporter
-from VarExporter import VarExporter
-from exporterutils import FunctionWrapper
-from utils import makeid
-
-
-#==============================================================================
-# DeclarationInfo
-#==============================================================================
-class DeclarationInfo:
-    
-    def __init__(self, otherInfo=None):
-        self.__infos = {}
-        self.__attributes = {}
-        if otherInfo is not None:
-            self.__infos = copy.deepcopy(otherInfo.__infos)
-            self.__attributes = copy.deepcopy(otherInfo.__attributes)
-
-
-    def __getitem__(self, name):
-        'Used to access sub-infos'        
-        if name.startswith('__'):
-            raise AttributeError
-        default = DeclarationInfo()
-        default._Attribute('name', name)
-        return self.__infos.setdefault(name, default)
-
-
-    def __getattr__(self, name):
-        return self[name]
-
-
-    def _Attribute(self, name, value=None):
-        if value is None:
-            # get value
-            return self.__attributes.get(name)
-        else:
-            # set value
-            self.__attributes[name] = value
-
-
-#==============================================================================
-# FunctionInfo
-#==============================================================================
-class FunctionInfo(DeclarationInfo):
-
-    def __init__(self, name, include, tail=None, otherOption=None):        
-        DeclarationInfo.__init__(self, otherOption)
-        self._Attribute('name', name)
-        self._Attribute('include', include)
-        self._Attribute('exclude', False)
-        # create a FunctionExporter
-        exporter = FunctionExporter(InfoWrapper(self), tail)
-        exporters.exporters.append(exporter)
-
-
-#==============================================================================
-# ClassInfo
-#==============================================================================
-class ClassInfo(DeclarationInfo):
-
-    def __init__(self, name, include, tail=None, otherInfo=None):
-        DeclarationInfo.__init__(self, otherInfo)
-        self._Attribute('name', name)
-        self._Attribute('include', include)
-        self._Attribute('exclude', False)
-        # create a ClassExporter
-        exporter = ClassExporter(InfoWrapper(self), tail)
-        exporters.exporters.append(exporter) 
-        
-
-#==============================================================================
-# IncludeInfo
-#==============================================================================
-class IncludeInfo(DeclarationInfo):
-
-    def __init__(self, include):
-        DeclarationInfo.__init__(self)
-        self._Attribute('include', include)
-        exporter = IncludeExporter(InfoWrapper(self))
-        exporters.exporters.append(exporter)        
-
-
-#==============================================================================
-# templates
-#==============================================================================
-def GenerateName(name, type_list):
-    name = name.replace('::', '_')
-    names = [name] + type_list
-    return makeid('_'.join(names))
-
-    
-class ClassTemplateInfo(DeclarationInfo):
-
-    def __init__(self, name, include):
-        DeclarationInfo.__init__(self)
-        self._Attribute('name', name)
-        self._Attribute('include', include)
-
-
-    def Instantiate(self, type_list, rename=None):
-        if not rename:
-            rename = GenerateName(self._Attribute('name'), type_list)
-        # generate code to instantiate the template
-        types = ', '.join(type_list)
-        tail = 'typedef %s< %s > %s;\n' % (self._Attribute('name'), types, rename)
-        tail += 'void __instantiate_%s()\n' % rename
-        tail += '{ sizeof(%s); }\n\n' % rename
-        # create a ClassInfo
-        class_ = ClassInfo(rename, self._Attribute('include'), tail, self)
-        return class_
-
-
-    def __call__(self, types, rename=None):
-        if isinstance(types, str):
-            types = types.split() 
-        return self.Instantiate(types, rename)
-        
-#==============================================================================
-# EnumInfo
-#==============================================================================
-class EnumInfo(DeclarationInfo):
-    
-    def __init__(self, name, include):
-        DeclarationInfo.__init__(self)
-        self._Attribute('name', name)
-        self._Attribute('include', include)
-        self._Attribute('exclude', False)
-        exporter = EnumExporter(InfoWrapper(self))
-        exporters.exporters.append(exporter)
-
-
-#==============================================================================
-# HeaderInfo
-#==============================================================================
-class HeaderInfo(DeclarationInfo):
-
-    def __init__(self, include):
-        DeclarationInfo.__init__(self)
-        self._Attribute('include', include)
-        exporter = HeaderExporter(InfoWrapper(self))
-        exporters.exporters.append(exporter)
-
-
-#==============================================================================
-# VarInfo
-#==============================================================================
-class VarInfo(DeclarationInfo):
-    
-    def __init__(self, name, include):
-        DeclarationInfo.__init__(self)
-        self._Attribute('name', name)
-        self._Attribute('include', include)
-        exporter = VarExporter(InfoWrapper(self))
-        exporters.exporters.append(exporter)
-        
-                                 
-#==============================================================================
-# InfoWrapper
-#==============================================================================
-class InfoWrapper:
-    'Provides a nicer interface for a info'
-
-    def __init__(self, info):
-        self.__dict__['_info'] = info # so __setattr__ is not called
-
-    def __getitem__(self, name):
-        return InfoWrapper(self._info[name])
-
-    def __getattr__(self, name):
-        return self._info._Attribute(name)
-
-    def __setattr__(self, name, value):
-        self._info._Attribute(name, value)
-
-
-#==============================================================================
-# Functions
-#==============================================================================
-def exclude(info):
-    info._Attribute('exclude', True)
-
-def set_policy(info, policy):
-    info._Attribute('policy', policy)
-
-def rename(info, name):
-    info._Attribute('rename', name)
-
-def set_wrapper(info, wrapper):
-    if isinstance(wrapper, str):
-        wrapper = FunctionWrapper(wrapper)
-    info._Attribute('wrapper', wrapper)
-
-def instantiate(template, types, rename=None):
-    if isinstance(types, str):
-        types = types.split()
-    return template.Instantiate(types, rename)
-
-def use_shared_ptr(info):
-    info._Attribute('smart_ptr', 'boost::shared_ptr< %s >')
-
-def use_auto_ptr(info):
-    info._Attribute('smart_ptr', 'std::auto_ptr< %s >')
-        
-def add_method(info, name, rename=None):
-    added = info._Attribute('__added__')
-    if added is None:
-        info._Attribute('__added__', [(name, rename)])
-    else:
-        added.append((name, rename))

pyste/src/policies.py

@@ -1,83 +0,0 @@
-
-
-class Policy:
-    'Represents one of the call policies of boost.python.'
-
-    def __init__(self):
-        raise RuntimeError, "Can't create an instance of the class Policy"
-
-
-    def Code(self):
-        'Returns the string corresponding to a instancialization of the policy.'
-        pass
-        
-
-    def _next(self):
-        if self.next is not None:
-            return ', %s >' % self.next.Code()
-        else:
-            return ' >'
-
-
-    def __eq__(self, other):
-        try:
-            return self.Code() == other.Code()
-        except AttributeError:
-            return False
-
-
-
-class return_internal_reference(Policy):
-    'Ties the return value to one of the parameters.'
-
-    def __init__(self, param=1, next=None):
-        '''
-        param is the position of the parameter, or None for "self".
-        next indicates the next policy, or None.
-        '''
-        self.param = param
-        self.next=next
-
-
-    def Code(self):
-        c = 'return_internal_reference< %i' % self.param
-        c += self._next()
-        return c
-
-
-
-class with_custodian_and_ward(Policy):
-    'Ties lifetime of two arguments of a function.'
-
-    def __init__(self, custodian, ward, next=None):
-        self.custodian = custodian
-        self.ward = ward
-        self.next = next
-
-    def Code(self):
-        c = 'with_custodian_and_ward< %i, %i' % (self.custodian, self.ward)
-        c += self._next()
-        return c
-
-
-
-class return_value_policy(Policy):
-    'Policy to convert return values.'
-    
-    def __init__(self, which, next=None):            
-        self.which = which
-        self.next = next
-
-
-    def Code(self):
-        c = 'return_value_policy< %s' % self.which
-        c += self._next()
-        return c
-
-
-#  values for return_value_policy
-reference_existing_object = 'reference_existing_object'
-copy_const_reference = 'copy_const_reference'
-copy_non_const_reference = 'copy_non_const_reference'
-manage_new_object = 'manage_new_object'        
-return_opaque_pointer = 'return_opaque_pointer'

pyste/src/pyste-profile.py

@@ -1,17 +0,0 @@
-import profile
-import pstats
-import pyste
-
-import psyco
-import elementtree.XMLTreeBuilder as XMLTreeBuilder
-import GCCXMLParser
-
-
-if __name__ == '__main__':
-    #psyco.bind(XMLTreeBuilder.fixtext)
-    #psyco.bind(XMLTreeBuilder.fixname)
-    #psyco.bind(XMLTreeBuilder.TreeBuilder)
-    #psyco.bind(GCCXMLParser.GCCXMLParser)
-    profile.run('pyste.Main()', 'profile')
-    p = pstats.Stats('profile')
-    p.strip_dirs().sort_stats(-1).print_stats()

pyste/src/pyste.py

@@ -1,204 +0,0 @@
-'''
-Pyste version %s
-
-Usage:
-    pyste [options] interface-files
-
-where options are:
-    --module=<name>     the name of the module that will be generated.
-                        Defaults to the first interface filename, without
-                        the extension.
-    -I <path>           add an include path    
-    -D <symbol>         define symbol    
-    --multiple          create various cpps, instead of only one 
-                        (useful during development)                        
-    --out               specify output filename (default: <module>.cpp)
-                        in --multiple mode, this will be a directory
-    --no-using          do not declare "using namespace boost";
-                        use explicit declarations instead
-    --pyste-ns=<name>   set the namespace where new types will be declared;
-                        default is the empty namespace
-    --debug             writes the xml for each file parsed in the current
-                        directory
-    -h, --help          print this help and exit
-    -v, --version       print version information                         
-'''
-
-import sys
-import os
-import getopt
-import exporters
-import SingleCodeUnit
-import MultipleCodeUnit
-import infos
-import exporterutils
-import settings
-from policies import *
-from CppParser import CppParser, CppParserError
-import time
-
-__VERSION__ = '0.9.2'
-
-def RecursiveIncludes(include):
-    'Return a list containg the include dir and all its subdirectories'
-    dirs = [include]
-    def visit(arg, dir, names):
-        # ignore CVS dirs
-        if os.path.split(dir)[1] != 'CVS':
-            dirs.append(dir)
-    os.path.walk(include, visit, None)
-    return dirs
-
-    
-def GetDefaultIncludes():
-    if 'INCLUDE' in os.environ:
-        include = os.environ['INCLUDE']
-        return include.split(os.pathsep)
-    else:
-        return []
-
-
-def ParseArguments():
-
-    def Usage():
-        print __doc__ % __VERSION__
-        sys.exit(1)
-        
-    try:
-        options, files = getopt.getopt(
-            sys.argv[1:], 
-            'R:I:D:vh', 
-            ['module=', 'multiple', 'out=', 'no-using', 'pyste-ns=', 'debug', 'version', 'help'])
-    except getopt.GetoptError, e:
-        print
-        print 'ERROR:', e
-        Usage()
-    includes = GetDefaultIncludes()
-    defines = []
-    module = None
-    out = None
-    multiple = False
-    for opt, value in options:
-        if opt == '-I':
-            includes.append(value)
-        elif opt == '-D':
-            defines.append(value)
-        elif opt == '-R':
-            includes.extend(RecursiveIncludes(value))
-        elif opt == '--module':
-            module = value
-        elif opt == '--out':
-            out = value 
-        elif opt == '--no-using':
-            settings.namespaces.python = 'boost::python::'
-            settings.USING_BOOST_NS = False
-        elif opt == '--pyste-ns':
-            settings.namespaces.pyste = value + '::'
-        elif opt == '--debug':
-            settings.DEBUG = True
-        elif opt == '--multiple':
-            multiple = True
-        elif opt in ['-h', '--help']:
-            Usage()
-        elif opt in ['-v', '--version']:
-            print 'Pyste version %s' % __VERSION__
-            sys.exit(2)
-        else:
-            print 'Unknown option:', opt
-            Usage()
-
-    if not files:
-        Usage() 
-    if not module:
-        module = os.path.splitext(files[0])[0]
-    if not out:
-        out = module
-        if not multiple:
-            out += '.cpp'
-    return includes, defines, module, out, files, multiple
-
-    
-def CreateContext():
-    'create the context where a interface file will be executed'
-    context = {}
-    # infos
-    context['Function'] = infos.FunctionInfo
-    context['Class'] = infos.ClassInfo
-    context['Include'] = infos.IncludeInfo
-    context['Template'] = infos.ClassTemplateInfo
-    context['Enum'] = infos.EnumInfo
-    context['AllFromHeader'] = infos.HeaderInfo
-    context['Var'] = infos.VarInfo
-    # functions
-    context['rename'] = infos.rename
-    context['set_policy'] = infos.set_policy
-    context['exclude'] = infos.exclude
-    context['set_wrapper'] = infos.set_wrapper
-    context['use_shared_ptr'] = infos.use_shared_ptr
-    context['use_auto_ptr'] = infos.use_auto_ptr
-    context['add_method'] = infos.add_method
-    # policies
-    context['return_internal_reference'] = return_internal_reference
-    context['with_custodian_and_ward'] = with_custodian_and_ward
-    context['return_value_policy'] = return_value_policy
-    context['reference_existing_object'] = reference_existing_object
-    context['copy_const_reference'] = copy_const_reference
-    context['copy_non_const_reference'] = copy_non_const_reference
-    context['return_opaque_pointer'] = return_opaque_pointer
-    context['manage_new_object'] = manage_new_object
-    # utils
-    context['Wrapper'] = exporterutils.FunctionWrapper
-    return context                                        
-
-    
-def Main():
-    includes, defines, module, out, interfaces, multiple = ParseArguments()
-    # execute the interface files
-    for interface in interfaces:
-        context = CreateContext()
-        execfile(interface, context)        
-    # parse all the C++ code        
-    parser = CppParser(includes, defines) 
-    exports = exporters.exporters[:]
-    for export in exports:
-        try:
-            export.Parse(parser)
-        except CppParserError, e:            
-            print '\n'
-            print '***', e, ': exitting'
-            return 2
-    print 
-    # sort the exporters by its order
-    exports = [(x.Order(), x) for x in exporters.exporters]
-    exports.sort()
-    exports = [x for _, x in exports]
-    # now generate the wrapper code
-    if multiple:
-        codeunit = MultipleCodeUnit.MultipleCodeUnit(module, out)
-    else:
-        codeunit = SingleCodeUnit.SingleCodeUnit(module, out)
-    exported_names = []
-    for export in exports:
-        if multiple:
-            codeunit.SetCurrent(export.Unit())
-        export.GenerateCode(codeunit, exported_names)    
-        exported_names.append(export.Name())
-    codeunit.Save()                
-    print 'Module %s generated' % module
-    return 0
-
-
-def UsePsyco():
-    'Tries to use psyco if possible'
-    try:
-        import psyco
-        psyco.profile()
-    except: pass         
-
-    
-if __name__ == '__main__':
-    start = time.clock()
-    UsePsyco()
-    status = Main()
-    print '%0.2f seconds' % (time.clock()-start)
-    sys.exit(status)

pyste/src/settings.py

@@ -1,13 +0,0 @@
-
-#==============================================================================
-# Global information
-#==============================================================================
-
-DEBUG = False
-USING_BOOST_NS = True
-
-class namespaces:
-    boost = 'boost::'
-    pyste = ''
-    python = '' # default is to not use boost::python namespace explicitly, so
-                # use the "using namespace" statement instead

pyste/src/utils.py

@@ -1,47 +0,0 @@
-from __future__ import generators
-import string
-
-#==============================================================================
-# enumerate
-#==============================================================================
-def enumerate(seq):
-    i = 0
-    for x in seq:
-        yield i, x
-        i += 1  
-
-
-#==============================================================================
-# makeid
-#==============================================================================
-_valid_chars = string.ascii_letters + string.digits + '_'
-_valid_chars = dict(zip(_valid_chars, _valid_chars))
-
-def makeid(name):
-    'Returns the name as a valid identifier'
-    newname = []
-    for char in name:
-        if char not in _valid_chars:
-            char = '_'
-        newname.append(char)
-    newname = ''.join(newname)
-    # avoid duplications of '_' chars
-    names = [x for x in newname.split('_') if x]
-    return '_'.join(names)
- 
-
-#==============================================================================
-# remove_duplicated_lines
-#==============================================================================
-def remove_duplicated_lines(text):
-    includes = text.splitlines()
-    d = dict([(include, 0) for include in includes])
-    return '\n'.join(d.keys())
-
-
-#==============================================================================
-# left_equals
-#==============================================================================
-def left_equals(s):
-        s = '// %s ' % s
-        return s + ('='*(80-len(s))) + '\n'  

pyste/tests/.cvsignore

@@ -1,7 +0,0 @@
-*.pyc
-*.exp
-*.lib
-*.obj
-*.arg
-*.dll
-.sconsign

pyste/tests/GCCXMLParserUT.py

@@ -1,338 +0,0 @@
-import sys
-sys.path.append('..') 
-import unittest
-import tempfile
-import os.path
-import GCCXMLParser
-from declarations import *
-
-    
-class Tester(unittest.TestCase):
-
-    def TestConstructor(self, class_, method, visib):
-        self.assert_(isinstance(method, Constructor))
-        self.assertEqual(method.FullName(), class_.FullName() + '::' + method.name)
-        self.assertEqual(method.result, None)
-        self.assertEqual(method.visibility, visib)
-        self.assert_(not method.virtual)
-        self.assert_(not method.abstract)
-        self.assert_(not method.static)
-        
-    def TestDefaultConstructor(self, class_, method, visib):
-        self.TestConstructor(class_, method, visib)
-        self.assert_(method.IsDefault())
-
-    def TestCopyConstructor(self, class_, method, visib):    
-        self.TestConstructor(class_, method, visib)
-        self.assertEqual(len(method.parameters), 1)
-        param = method.parameters[0]
-        self.TestType(
-            param, 
-            ReferenceType, 
-            class_.FullName(), 
-            'const %s &' % class_.FullName(),
-            True)
-        self.assert_(method.IsCopy())
-
-
-    def TestType(self, type_, classtype_, name, fullname, const):
-        self.assert_(isinstance(type_, classtype_))
-        self.assertEqual(type_.name, name)
-        self.assertEqual(type_.namespace, None)
-        self.assertEqual(type_.FullName(), fullname)
-        self.assertEqual(type_.const, const)
-        
-        
-class ClassBaseTest(Tester):
-
-    def setUp(self):
-        self.base = GetDecl('Base')
-        
-    def testClass(self):
-        'test the properties of the class Base'
-        self.assert_(isinstance(self.base, Class))
-        self.assert_(self.base.abstract)
-        self.assertEqual(self.base.RawName(), 'Base')
-                
-
-    def testFoo(self):
-        'test function foo in class Base' 
-        foo = GetMember(self.base, 'foo')
-        self.assert_(isinstance(foo, Method))
-        self.assertEqual(foo.visibility, Scope.public)
-        self.assert_(foo.virtual)
-        self.assert_(foo.abstract)
-        self.failIf(foo.static)
-        self.assertEqual(foo.class_, 'test::Base')
-        self.failIf(foo.const)
-        self.assertEqual(foo.FullName(), 'test::Base::foo')        
-        self.assertEqual(foo.result.name, 'void')
-        self.assertEqual(len(foo.parameters), 1)
-        param = foo.parameters[0]
-        self.TestType(param, FundamentalType, 'int', 'int', False)  
-        self.assertEqual(foo.namespace, None)
-        self.assertEqual(
-            foo.PointerDeclaration(), '(void (test::Base::*)(int) )&test::Base::foo')
-
-    def testX(self):
-        'test the member x in class Base'
-        x = GetMember(self.base, 'x')
-        self.assertEqual(x.class_, 'test::Base')
-        self.assertEqual(x.FullName(), 'test::Base::x')
-        self.assertEqual(x.namespace, None)
-        self.assertEqual(x.visibility, Scope.private)
-        self.TestType(x.type, FundamentalType, 'int', 'int', False)  
-        self.assertEqual(x.static, False)
-
-    def testConstructors(self):
-        'test constructors in class Base'
-        constructors = GetMembers(self.base, 'Base')
-        for cons in constructors:
-            if len(cons.parameters) == 0:
-                self.TestDefaultConstructor(self.base, cons, Scope.public)
-            elif len(cons.parameters) == 1: # copy constructor
-                self.TestCopyConstructor(self.base, cons, Scope.public)
-            elif len(cons.parameters) == 2: # other constructor
-                intp, floatp = cons.parameters
-                self.TestType(intp, FundamentalType, 'int', 'int', False)
-                self.TestType(floatp, FundamentalType, 'float', 'float', False)
-
-    def testSimple(self):
-        'test function simple in class Base'
-        simple = GetMember(self.base, 'simple')
-        self.assert_(isinstance(simple, Method))
-        self.assertEqual(simple.visibility, Scope.protected)
-        self.assertEqual(simple.FullName(), 'test::Base::simple')
-        self.assertEqual(len(simple.parameters), 1)
-        param = simple.parameters[0]
-        self.TestType(param, ReferenceType, 'std::string', 'const std::string &', True)
-        self.TestType(simple.result, FundamentalType, 'bool', 'bool', False)
-        self.assertEqual(
-            simple.PointerDeclaration(), 
-            '(bool (test::Base::*)(const std::string &) )&test::Base::simple')
-        
-          
-    def testZ(self):
-        z = GetMember(self.base, 'z')
-        self.assert_(isinstance(z, Variable))
-        self.assertEqual(z.visibility, Scope.public)
-        self.assertEqual(z.FullName(), 'test::Base::z')
-        self.assertEqual(z.type.name, 'int')
-        self.assertEqual(z.type.const, False)
-        self.assert_(z.static)
-        
-        
-class ClassTemplateTest(Tester):        
-    
-    def setUp(self):
-        self.template = GetDecl('Template<int>')
-
-    def testClass(self):
-        'test the properties of the Template<int> class'
-        self.assert_(isinstance(self.template, Class))
-        self.assert_(not self.template.abstract)
-        self.assertEqual(self.template.FullName(), 'Template<int>')
-        self.assertEqual(self.template.namespace, '')
-        self.assertEqual(self.template.name, 'Template<int>')
-        self.assertEqual(self.template.RawName(), 'Template')
-
-    def testConstructors(self):
-        'test the automatic constructors of the class Template<int>'
-        constructors = GetMembers(self.template, 'Template')
-        for cons in constructors:
-            if len(cons.parameters) == 0:
-                self.TestDefaultConstructor(self.template, cons, Scope.public)
-            elif len(cons.parameters) == 1:
-                self.TestCopyConstructor(self.template, cons, Scope.public)
-                    
-
-    def testValue(self):
-        'test the class variable value'
-        value = GetMember(self.template, 'value')
-        self.assert_(isinstance(value, ClassVariable))
-        self.assert_(value.name, 'value')
-        self.TestType(value.type, FundamentalType, 'int', 'int', False)  
-        self.assert_(not value.static)
-        self.assertEqual(value.visibility, Scope.public)
-        self.assertEqual(value.class_, 'Template<int>')
-        self.assertEqual(value.FullName(), 'Template<int>::value')
-
-    def testBase(self):
-        'test the superclasses of Template<int>'
-        bases = self.template.bases
-        self.assertEqual(len(bases), 1)
-        base = bases[0]
-        self.assert_(isinstance(base, Base))
-        self.assertEqual(base.name, 'test::Base')
-        self.assertEqual(base.visibility, Scope.protected)
-
-        
-        
-class FreeFuncTest(Tester):
-
-    def setUp(self):
-        self.func = GetDecl('FreeFunc')
-
-    def testFunc(self):
-        'test attributes of FreeFunc'
-        self.assert_(isinstance(self.func, Function))
-        self.assertEqual(self.func.name, 'FreeFunc')
-        self.assertEqual(self.func.FullName(), 'test::FreeFunc')
-        self.assertEqual(self.func.namespace, 'test')
-        self.assertEqual(
-            self.func.PointerDeclaration(), 
-            '(const test::Base & (*)(const std::string &, int))&test::FreeFunc')
-
-
-    def testResult(self):
-        'test the return value of FreeFunc'
-        res = self.func.result
-        self.TestType(res, ReferenceType, 'test::Base', 'const test::Base &', True)
-
-    def testParameters(self):
-        'test the parameters of FreeFunc'
-        self.assertEqual(len(self.func.parameters), 2)
-        strp, intp = self.func.parameters
-        self.TestType(strp, ReferenceType, 'std::string', 'const std::string &', True)
-        self.assertEqual(strp.default, None)
-        self.TestType(intp, FundamentalType, 'int', 'int', False)
-        self.assertEqual(intp.default, '10')
-        
-        
-
-class testFunctionPointers(Tester):
-
-    def testMethodPointer(self):
-        'test declaration of a pointer-to-method'
-        meth = GetDecl('MethodTester')
-        param = meth.parameters[0]
-        fullname = 'void (test::Base::*)(int)'
-        self.TestType(param, PointerType, fullname, fullname, False)
-
-    def testFunctionPointer(self):
-        'test declaration of a pointer-to-function'
-        func = GetDecl('FunctionTester')
-        param = func.parameters[0]
-        fullname = 'void (*)(int)'
-        self.TestType(param, PointerType, fullname, fullname, False)
-
-        
-        
-# =============================================================================
-# Support routines
-# =============================================================================
-
-cppcode = '''
-namespace std {
-    class string;
-}
-namespace test {
-class Base
-{
-public:
-    Base();
-    Base(const Base&);
-    Base(int, float);
-
-    virtual void foo(int = 0.0) = 0;
-    static int z;
-protected:    
-    bool simple(const std::string&);
-private:
-    int x;
-};
-
-void MethodTester( void (Base::*)(int) );
-void FunctionTester( void (*)(int) );
-
-
-const Base & FreeFunc(const std::string&, int=10);
-
-}
-
-template <class T>
-struct Template: protected test::Base
-{
-    T value;        
-    virtual void foo(int);
-};
- 
-Template<int> __aTemplateInt;
-'''
-
-def GetXMLFile():
-    '''Generates an gccxml file using the code from the global cppcode. 
-    Returns the xml's filename.'''
-    # write the code to a header file
-    tmpfile = tempfile.mktemp() + '.h'
-    f = file(tmpfile, 'w')
-    f.write(cppcode)
-    f.close()
-    # run gccxml
-    outfile = tmpfile + '.xml'
-    if os.system('gccxml "%s" "-fxml=%s"' % (tmpfile, outfile)) != 0:
-        raise RuntimeError, 'Error executing GCCXML.'
-    # read the output file into the xmlcode
-    f = file(outfile)
-    xmlcode = f.read()
-    #print xmlcode
-    f.close()
-    # remove the header
-    os.remove(tmpfile)
-    return outfile       
-
-
-
-def GetDeclarations():
-    'Uses the GCCXMLParser module to get the declarations.'
-    xmlfile = GetXMLFile()
-    declarations = GCCXMLParser.ParseDeclarations(xmlfile)
-    os.remove(xmlfile)
-    return declarations
-
-# the declarations to be analysed
-declarations = GetDeclarations()
-
-
-def GetDecl(name):
-    'returns one of the top declarations given its name'
-    for decl in declarations:
-        if decl.name == name:
-            return decl
-    else:
-        raise RuntimeError, 'Declaration not found: %s' % name
-
-
-def GetMember(class_, name):
-    'gets the member of the given class by its name'
-                
-    res = None
-    multipleFound = False
-    for member in class_:
-        if member.name == name:
-            if res is not None:
-                multipleFound = True
-                break
-            res = member
-    if res is None or multipleFound:
-        raise RuntimeError, \
-            'No member or more than one member found in class %s: %s' \
-                % (class_.name, name)
-    return res            
-    
-
-def GetMembers(class_, name):
-    'gets the members of the given class by its name'
-    res = []
-    for member in class_:
-        if member.name == name:
-            res.append(member)
-    if len(res) in (0, 1):            
-        raise RuntimeError, \
-            'GetMembers: 0 or 1 members found in class %s: %s' \
-                % (class_.name, name)
-    return res            
-
-
-if __name__ == '__main__':
-    unittest.main()

pyste/tests/SmartFileUT.py

@@ -1,80 +0,0 @@
-import sys
-sys.path.append('../src')
-from SmartFile import *
-import unittest
-import tempfile
-import os
-import time
-
-
-class SmartFileTest(unittest.TestCase):
-
-    FILENAME = tempfile.mktemp()
-    
-    def setUp(self):
-        self._Clean()
-        
-    def tearDown(self):
-        self._Clean()
-
-    def _Clean(self):
-        try:
-            os.remove(self.FILENAME)
-        except OSError: pass
-
-        
-    def testNonExistant(self):
-        "Must override the file, as there's no file in the disk yet"
-        self.assert_(not os.path.isfile(self.FILENAME))
-        f = SmartFile(self.FILENAME, 'w')
-        f.write('Testing 123\nTesting again.')
-        f.close()
-        self.assert_(os.path.isfile(self.FILENAME))
-
-
-    def testOverride(self):
-        "Must override the file, because the contents are different"
-        contents = 'Contents!\nContents!'
-        # create the file normally first
-        f = file(self.FILENAME, 'w')
-        f.write(contents)
-        f.close()
-        file_time = os.path.getmtime(self.FILENAME)
-        self.assert_(os.path.isfile(self.FILENAME))
-        time.sleep(2)
-        f = SmartFile(self.FILENAME, 'w')
-        f.write(contents + '_')
-        f.close()
-        new_file_time = os.path.getmtime(self.FILENAME)
-        self.assert_(new_file_time != file_time)
-
-
-    def testNoOverride(self):
-        "Must not override the file, because the contents are the same"
-        contents = 'Contents!\nContents!'
-        # create the file normally first
-        f = file(self.FILENAME, 'w')
-        f.write(contents)
-        f.close()
-        file_time = os.path.getmtime(self.FILENAME)
-        self.assert_(os.path.isfile(self.FILENAME))
-        time.sleep(2)
-        f = SmartFile(self.FILENAME, 'w')
-        f.write(contents)
-        f.close()
-        new_file_time = os.path.getmtime(self.FILENAME)
-        self.assert_(new_file_time == file_time) 
-
-
-    def testAutoClose(self):
-        "Must be closed when garbage-collected"
-        def foo():
-            f = SmartFile(self.FILENAME)
-            f.write('testing')  
-            self.assert_(not os.path.isfile(self.FILENAME))
-        foo()
-        self.assert_(os.path.isfile(self.FILENAME))
-        
-
-if __name__ == '__main__':
-    unittest.main()

pyste/tests/add_test.h

@@ -1,13 +0,0 @@
-namespace add_test {
-
-struct C
-{
-    int x;
-};
-
-const int get_x(C& c)
-{
-    return c.x;
-}
-
-}

pyste/tests/add_test.pyste

@@ -1,2 +0,0 @@
-C = Class('add_test::C', 'add_test.h')
-add_method(C, 'add_test::get_x')

pyste/tests/add_testUT.py

@@ -1,12 +0,0 @@
-import unittest
-from _add_test import *
-
-class AddMethodTest(unittest.TestCase):
-
-    def testIt(self):
-        c = C()
-        c.x = 10
-        self.assertEqual(c.get_x(), 10)
-
-if __name__ == '__main__':
-    unittest.main()

pyste/tests/basic.cpp

@@ -1,8 +0,0 @@
-#include "basic.h"
-
-namespace  basic {
-    
-    int C::static_value = 3;
-    const int C::const_static_value = 100;   
-
-}

pyste/tests/basic.h

@@ -1,59 +0,0 @@
-#ifndef BASIC_H
-#define BASIC_H
-
-
-#include <string>
-
-namespace basic {
-    
-struct C
-{    
-    // test virtuallity
-    C(): value(1), const_value(0) {}
-    virtual int f(int x = 10)
-    {
-        return x*2;
-    }    
-    
-    int foo(int x=1){
-        return x+1;
-    }
-
-    const std::string& name() { return _name; }
-    void set_name(const std::string& name) { _name = name; }
-    std::string _name;
-
-    // test data members
-    static int static_value;
-    static const int const_static_value;
-    
-    int value;
-    const int const_value;
-
-    // test static functions
-    static int mul(int x=2, int y=3) { return x*y; }
-};
-
-inline int call_f(C& c)
-{
-    return c.f();
-}
-
-inline int call_f(C& c, int x)
-{
-    return c.f(x);
-} 
-
-inline int get_static()
-{
-    return C::static_value;
-}
-
-inline int get_value(C& c)
-{
-    return c.value;
-}
-
-}
-
-#endif

pyste/tests/basic.pyste

@@ -1,5 +0,0 @@
-Class('basic::C', 'basic.h')
-Function('basic::call_f', 'basic.h')
-Function('basic::get_static', 'basic.h')
-Function('basic::get_value', 'basic.h')
-

pyste/tests/basicUT.py

@@ -1,66 +0,0 @@
-import unittest
-from _basic import *
-
-class BasicExampleTest(unittest.TestCase):
-
-    def testIt(self):
-
-        # test virtual functions
-        class D(C):
-            def f(self, x=10):
-                return x+1
-
-        d = D()
-        c = C()
-
-        self.assertEqual(c.f(), 20)
-        self.assertEqual(c.f(3), 6)
-        self.assertEqual(d.f(), 11)
-        self.assertEqual(d.f(3), 4)
-        self.assertEqual(call_f(c), 20)
-        self.assertEqual(call_f(c, 4), 8)
-        self.assertEqual(call_f(d), 11)
-        self.assertEqual(call_f(d, 3), 4)
-        
-        # test data members
-        def testValue(value):
-            self.assertEqual(c.value, value)
-            self.assertEqual(d.value, value) 
-            self.assertEqual(get_value(c), value)
-            self.assertEqual(get_value(d), value)
-        testValue(1)
-        c.value = 30
-        d.value = 30
-        testValue(30)
-        self.assertEqual(c.const_value, 0)
-        self.assertEqual(d.const_value, 0)
-        def set_const_value():
-            c.const_value = 12
-        self.assertRaises(AttributeError, set_const_value)
-        
-        # test static data-members
-        def testStatic(value):
-            self.assertEqual(C.static_value, value)
-            self.assertEqual(c.static_value, value)
-            self.assertEqual(D.static_value, value)
-            self.assertEqual(d.static_value, value)
-            self.assertEqual(get_static(), value)
-        testStatic(3)
-        C.static_value = 10
-        testStatic(10)
-        self.assertEqual(C.const_static_value, 100)
-        def set_const_static():
-            C.const_static_value = 1
-        self.assertRaises(AttributeError, set_const_static)
-
-        # test static function
-        def test_mul(result, *args):
-            self.assertEqual(C.mul(*args), result)
-            self.assertEqual(c.mul(*args), result)
-        test_mul(6)
-        test_mul(3, 1)
-        test_mul(16, 8, 2)
-
-
-if __name__ == '__main__':
-    unittest.main()

pyste/tests/enums.h

@@ -1,29 +0,0 @@
-#ifndef ENUMS_H
-#define ENUMS_H
-
-namespace enums {
-    
-enum color { red, blue };
-
-struct X
-{
-    enum choices
-    {
-        good = 1,
-        bad = 2
-    };
-
-    int set(choices c)
-    {
-        return (int)c;
-    }
-};
-
-enum {
-    x = 0,
-    y = 1
-};
-
-}
-
-#endif

pyste/tests/enums.pyste

@@ -1,7 +0,0 @@
-h = AllFromHeader('enums.h')
-rename(h.color.red, 'Red')
-rename(h.color.blue, 'Blue')
-rename(h.X.choices.bad, 'Bad')
-rename(h.X.choices.good, 'Good')
-rename(h.X.choices, 'Choices')
-

pyste/tests/enumsUT.py

@@ -1,20 +0,0 @@
-import unittest
-from _enums import *
-
-class EnumsTest(unittest.TestCase):
-
-    def testIt(self):
-        self.assertEqual(int(color.Red), 0)
-        self.assertEqual(int(color.Blue), 1)
-
-        self.assertEqual(int(X.Choices.Good), 1)
-        self.assertEqual(int(X.Choices.Bad), 2)
-        x = X()
-        self.assertEqual(x.set(x.Choices.Good), 1)
-        self.assertEqual(x.set(x.Choices.Bad), 2)
-        self.assertEqual(unnamed.x, 0)
-        self.assertEqual(unnamed.y, 1)
-
-
-if __name__ == '__main__':
-    unittest.main()

pyste/tests/header_test.h

@@ -1,38 +0,0 @@
-#ifndef HEADER_TEST_H
-#define HEADER_TEST_H
-
-#include <map>
-#include <string>
-
-namespace header_test {
-    
-enum choice { red, blue };
-
-inline std::string choice_str(choice c)
-{
-    std::map<choice, std::string> choice_map;
-    choice_map[red] = "red";
-    choice_map[blue] = "blue";
-    return choice_map[c];
-}
-
-struct C
-{
-    choice c;
-
-    std::string get()
-    {
-        return choice_str(c);
-    }
-};
-
-// test the exclusion of the following
-
-struct ForwardDeclared; // should be excluded automatically
-struct A {};
-void foo();
-enum bar { value };
-
-}
-
-#endif

pyste/tests/header_test.pyste

@@ -1,4 +0,0 @@
-h = AllFromHeader('header_test.h')
-exclude(h.A)
-exclude(h.foo)
-exclude(h.bar)

pyste/tests/header_testUT.py

@@ -1,23 +0,0 @@
-import unittest
-from _header_test import *
-
-class HeaderTest(unittest.TestCase):
-    
-    def testIt(self):
-        self.assertEqual(choice.red, 0)
-        self.assertEqual(choice.blue, 1)
-        self.assertEqual(choice_str(choice.blue), 'blue')
-        self.assertEqual(choice_str(choice.red), 'red')
-        c = C()
-        c.c = choice.blue
-        self.assertEqual(c.get(), 'blue')
-        c.c = choice.red
-        self.assertEqual(c.get(), 'red')
-        # the following classes/functions should not have being exported
-        self.assertRaises(NameError, lambda: A())
-        self.assertRaises(NameError, lambda: foo())
-        self.assertRaises(NameError, lambda: bar.value)
-        self.assertRaises(NameError, lambda: ForwardDeclared())
-        
-if __name__ == '__main__':
-    unittest.main()    

pyste/tests/infosUT.py

@@ -1,50 +0,0 @@
-import sys
-sys.path.append('../src')  
-from infos import *
-from policies import *
-from exporterutils import *
-import unittest
-
-
-class InfosTest(unittest.TestCase):
-
-    def testFunctionInfo(self):
-        info = FunctionInfo('test::foo', 'foo.h')
-        rename(info, 'hello')
-        set_policy(info, return_internal_reference())
-        set_wrapper(info, FunctionWrapper('foo_wrapper'))
-
-        info = InfoWrapper(info)
-        
-        self.assertEqual(info.rename, 'hello')
-        self.assertEqual(info.policy.Code(), 'return_internal_reference< 1 >')
-        self.assertEqual(info.wrapper.name, 'foo_wrapper')
-
-
-    def testClassInfo(self):
-        info = ClassInfo('test::IFoo', 'foo.h')
-        rename(info.name, 'Name')
-        rename(info.exclude, 'Exclude')
-        rename(info, 'Foo')
-        rename(info.Bar, 'bar')
-        set_policy(info.Baz, return_internal_reference())
-        rename(info.operator['>>'], 'from_string')
-        exclude(info.Bar)
-        set_wrapper(info.Baz, FunctionWrapper('baz_wrapper'))
-        
-        info = InfoWrapper(info)
-        
-        self.assertEqual(info.rename, 'Foo')
-        self.assertEqual(info['Bar'].rename, 'bar')
-        self.assertEqual(info['name'].rename, 'Name')
-        self.assertEqual(info['exclude'].rename, 'Exclude')
-        self.assertEqual(info['Bar'].exclude, True)
-        self.assertEqual(info['Baz'].policy.Code(), 'return_internal_reference< 1 >')
-        self.assertEqual(info['Baz'].wrapper.name, 'baz_wrapper')
-        self.assertEqual(info['operator']['>>'].rename, 'from_string')
-
-     
-
-
-if __name__ == '__main__':
-    unittest.main()

pyste/tests/inherit.h

@@ -1,18 +0,0 @@
-template<typename T>
-class A
-{
-public:
-   void set(T v) { mData = v; }
-
-   T get() const { return mData; }
-
-private:
-   T mData;
-};
-
-
-class B : public A<int>
-{
-public:
-   int go() { return get(); }
-};

pyste/tests/inherit.pyste

@@ -1,8 +0,0 @@
-# Doesn't work:
-A = Template('A', 'inherit.h')
-A_int = A('int')
-
-Class('B', 'inherit.h')
-
-# Does work:
-#AllFromHeader('inherit.h')

pyste/tests/inheritUT.py

@@ -1,20 +0,0 @@
-import unittest
-from _inherit import *
-
-class InheritExampleTest(unittest.TestCase):
-
-    def testIt(self):
-        a = A_int()        
-        b = B()
-        self.assert_(isinstance(b, A_int))
-        self.assert_(issubclass(B, A_int))
-        a.set(10)
-        self.assertEqual(a.get(), 10)        
-        b.set(1)
-        self.assertEqual(b.go(), 1)
-        self.assertEqual(b.get(), 1)
-
-
-
-if __name__ == '__main__':
-    unittest.main() 

pyste/tests/nested.cpp

@@ -1,4 +0,0 @@
-#include "nested.h"
-
-int nested::X::staticXValue = 10;
-int nested::X::Y::staticYValue = 20; 

pyste/tests/nested.h

@@ -1,26 +0,0 @@
-#ifndef NESTED_H
-#define NESTED_H
-
-namespace nested {
-    
-struct X
-{
-    struct Y 
-    {
-        int valueY;
-        static int staticYValue; 
-        struct Z
-        {
-            int valueZ;
-        };
-    };
-    
-    static int staticXValue;
-    int valueX;
-};
-
-typedef X Root;
-
-}
-
-#endif

pyste/tests/nested.pyste

@@ -1 +0,0 @@
-Class('nested::Root', 'nested.h')

pyste/tests/nestedUT.py

@@ -1,15 +0,0 @@
-import unittest
-from _nested import *
-
-class NestedTest(unittest.TestCase):
-
-    def testIt(self):              
-        self.assertEqual(Root.staticXValue, 10)
-        self.assertEqual(Root.Y.staticYValue, 20)
-        z = Root.Y.Z()
-        z.valueZ = 3
-        self.assertEqual(z.valueZ, 3)
-        
-
-if __name__ == '__main__':
-    unittest.main()

pyste/tests/opaque.h

@@ -1,47 +0,0 @@
-#ifndef OPAQUE_H
-#define OPAQUE_H
-
-#include <iostream>
-
-namespace opaque {
-
-    
-struct C { 
-    C(int v): value(v) {}
-    int value; 
-};
-
-
-inline C* new_C()
-{
-    return new C(10);
-}
-
-inline int get(C* c)
-{
-    return c->value;
-}
-
-struct D { 
-    D(double v): value(v) {}
-    double value; 
-};
-
-struct A
-{
-    D* new_handle()
-    {
-        return new D(3.0); 
-    }
-
-    double get(D* d)
-    {
-        return d->value;
-    }
-    
-    int f(int x=0) { return x; }
-};
-
-}
-
-#endif

pyste/tests/opaque.pyste

@@ -1,5 +0,0 @@
-foo = Function('opaque::new_C', 'opaque.h')
-set_policy(foo, return_value_policy(return_opaque_pointer))
-Function('opaque::get', 'opaque.h' )
-A = Class('opaque::A', 'opaque.h')
-set_policy(A.new_handle, return_value_policy(return_opaque_pointer)) 

pyste/tests/opaqueUT.py

@@ -1,18 +0,0 @@
-import unittest
-from _opaque import *
-
-class OpaqueTest(unittest.TestCase):
-
-    def testIt(self):
-
-        c = new_C()
-        self.assertEqual(get(c), 10)
-        a = A()
-        d = a.new_handle()
-        self.assertEqual(a.get(d), 3.0)
-        self.assertEqual(a.f(), 0)
-        self.assertEqual(a.f(3), 3)
-
-
-if __name__ == '__main__':
-    unittest.main()

pyste/tests/operators.cpp

@@ -1,3 +0,0 @@
-#include "operators.h"
-
-double operators::C::x = 10; 

pyste/tests/operators.h

@@ -1,49 +0,0 @@
-#ifndef OPERATORS_H
-#define OPERATORS_H
-
-
-#include <iostream>
-
-namespace operators {
-
-struct C
-{
-    static double x;
-    double value;
-
-    const C operator+(const C other) const
-    {
-        C c;
-        c.value = value + other.value;
-        return c;
-    }
-    operator int() const
-    {
-        return (int)value;    
-    } 
-    
-    double operator()()
-    {
-        return C::x;
-    }
-
-    double operator()(double other)
-    {
-        return C::x + other;
-    }
-    
-    operator const char*() { return "C"; }
-};
-
-inline const C operator*(const C& lhs, const C& rhs)
-{
-    C c;
-    c.value = lhs.value * rhs.value;
-    return c;
-}
-
-
-}
-
-
-#endif

pyste/tests/operators.pyste

@@ -1,2 +0,0 @@
-C = Class('operators::C', 'operators.h')
-#exclude(C.operator['+'])