get ready to move to trunk

[SVN r9818]

build/filemgr.py

@@ -0,0 +1,135 @@
+# Revision history:
+#   12 Apr 01 use os.path, shutil
+#   Initial version: R.W. Grosse-Kunstleve
+
+bpl_src = "/libs/python/src"
+bpl_tst = "/libs/python/test"
+bpl_exa = "/libs/python/example"
+files = (
+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_src + "/cross_module.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 + "/simple_vector.cpp",
+bpl_exa + "/do_it_yourself_converters.cpp",
+bpl_exa + "/pickle1.cpp",
+bpl_exa + "/pickle2.cpp",
+bpl_exa + "/pickle3.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_simple_vector.py",
+bpl_exa + "/test_do_it_yourself_converters.py",
+bpl_exa + "/test_pickle1.py",
+bpl_exa + "/test_pickle2.py",
+bpl_exa + "/test_pickle3.py",
+bpl_exa + "/noncopyable.h",
+bpl_exa + "/noncopyable_export.cpp",
+bpl_exa + "/noncopyable_import.cpp",
+bpl_exa + "/dvect.h",
+bpl_exa + "/dvect.cpp",
+bpl_exa + "/dvect_conversions.cpp",
+bpl_exa + "/dvect_defs.cpp",
+bpl_exa + "/ivect.h",
+bpl_exa + "/ivect.cpp",
+bpl_exa + "/ivect_conversions.cpp",
+bpl_exa + "/ivect_defs.cpp",
+bpl_exa + "/tst_noncopyable.py",
+bpl_exa + "/tst_dvect1.py",
+bpl_exa + "/tst_dvect2.py",
+bpl_exa + "/tst_ivect1.py",
+bpl_exa + "/tst_ivect2.py",
+bpl_exa + "/test_cross_module.py",
+)
+
+defs = (
+"boost_python_test",
+"abstract",
+"getting_started1",
+"getting_started2",
+"getting_started3",
+"simple_vector",
+"do_it_yourself_converters",
+"pickle1",
+"pickle2",
+"pickle3",
+"noncopyable_export",
+"noncopyable_import",
+"ivect",
+"dvect",
+)
+
+if (__name__ == "__main__"):
+
+  import sys, os, shutil
+
+  path = sys.argv[1]
+  mode = sys.argv[2]
+  if (not mode in ("softlinks", "unlink", "cp", "rm", "copy", "del")):
+    raise RuntimeError, \
+      "usage: python filemgr.py path <softlinks|unlink|cp|rm|copy|del>"
+
+  if (mode in ("cp", "copy")):
+    for fn in files:
+      f = os.path.basename(fn)
+      print "Copying: " + f
+      shutil.copy(path + fn, ".")
+
+  elif (mode == "softlinks"):
+    for fn in files:
+      f = os.path.basename(fn)
+      if (os.path.exists(f)):
+        print "File exists: " + f
+      else:
+        print "Linking: " + f
+        os.symlink(path + fn, f)
+
+  elif (mode in ("rm", "del")):
+    for fn in files:
+      f = os.path.basename(fn)
+      if (os.path.exists(f)):
+        print "Removing: " + f
+        try: os.unlink(f)
+        except: pass
+
+  elif (mode == "unlink"):
+    for fn in files:
+      f = os.path.basename(fn)
+      if (os.path.exists(f)):
+        if (os.path.islink(f)):
+          print "Unlinking: " + f
+          try: os.unlink(f)
+          except: pass
+        else:
+          print "Not a softlink: " + f
+
+  if (mode in ("softlinks", "cp", "copy")):
+    for d in defs:
+      fn = d + ".def"
+      print "Creating: " + fn
+      f = open(fn, "w")
+      f.write("EXPORTS\n")
+      f.write("\tinit" + d + "\n")
+      f.close()
+
+  if (mode in ("unlink", "rm", "del")):
+    for d in defs:
+      fn = d + ".def"
+      if (os.path.exists(fn)):
+        print "Removing: " + fn
+        try: os.unlink(fn)
+        except: pass

build/irix_CC.mak

@@ -0,0 +1,165 @@
+# 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"
+#   Adjust the pathnames 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
+#
+# Revision history:
+#   12 Apr 01 new macro ROOT to simplify configuration (R.W. Grosse-Kunstleve)
+#   Initial version: R.W. Grosse-Kunstleve
+
+ROOT=$(HOME)
+BOOST=$(ROOT)/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$(BOOST)/boost/compatibility/cpp_c_headers
+
+STDOPTS=
+WARNOPTS=-woff 1001,1234,1682
+OPTOPTS=-g
+
+CPP=CC -LANG:std -n32 -mips4
+CPPOPTS=$(STLPORTINC) $(STLPORTOPTS) -I$(BOOST) $(PYINC) \
+        $(STDOPTS) $(WARNOPTS) $(OPTOPTS)
+MAKEDEP=-M
+
+LD=CC -LANG:std -n32 -mips4
+LDOPTS=-shared
+
+OBJ=classes.o conversions.o extension_class.o functions.o \
+    init_function.o module_builder.o \
+    objects.o types.o cross_module.o
+DEPOBJ=$(OBJ) \
+       comprehensive.o \
+       abstract.o \
+       getting_started1.o getting_started2.o getting_started3.o \
+       simple_vector.o \
+       do_it_yourself_converters.o \
+       pickle1.o pickle2.o pickle3.o \
+       noncopyable_export.o noncopyable_import.o \
+       ivect.o dvect.o
+
+.SUFFIXES: .o .cpp
+
+all: libboost_python.a \
+     boost_python_test.so \
+     abstract.so \
+     getting_started1.so getting_started2.so getting_started3.so \
+     simple_vector.so \
+     do_it_yourself_converters.so \
+     pickle1.so pickle2.so pickle3.so \
+     noncopyable_export.so noncopyable_import.so \
+     ivect.so dvect.so
+
+libboost_python.a: $(OBJ)
+	rm -f libboost_python.a
+	$(CPP) -ar -o libboost_python.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
+
+simple_vector.so: $(OBJ) simple_vector.o
+	$(LD) $(LDOPTS) $(OBJ) simple_vector.o -o simple_vector.so
+
+do_it_yourself_converters.so: $(OBJ) do_it_yourself_converters.o
+	$(LD) $(LDOPTS) $(OBJ) do_it_yourself_converters.o -o do_it_yourself_converters.so
+
+pickle1.so: $(OBJ) pickle1.o
+	$(LD) $(LDOPTS) $(OBJ) pickle1.o -o pickle1.so
+
+pickle2.so: $(OBJ) pickle2.o
+	$(LD) $(LDOPTS) $(OBJ) pickle2.o -o pickle2.so
+
+pickle3.so: $(OBJ) pickle3.o
+	$(LD) $(LDOPTS) $(OBJ) pickle3.o -o pickle3.so
+
+noncopyable_export.so: $(OBJ) noncopyable_export.o
+	$(LD) $(LDOPTS) $(OBJ) $(HIDDEN) \
+          noncopyable_export.o -o noncopyable_export.so
+
+noncopyable_import.so: $(OBJ) noncopyable_import.o
+	$(LD) $(LDOPTS) $(OBJ) $(HIDDEN) \
+          noncopyable_import.o -o noncopyable_import.so
+
+ivect.so: $(OBJ) ivect.o
+	$(LD) $(LDOPTS) $(OBJ) $(HIDDEN) ivect.o -o ivect.so
+
+dvect.so: $(OBJ) dvect.o
+	$(LD) $(LDOPTS) $(OBJ) $(HIDDEN) dvect.o -o dvect.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_simple_vector.py
+	$(PYEXE) test_do_it_yourself_converters.py
+	$(PYEXE) test_pickle1.py
+	$(PYEXE) test_pickle2.py
+	$(PYEXE) test_pickle3.py
+	$(PYEXE) test_cross_module.py
+
+clean:
+	rm -f $(OBJ) libboost_python.a libboost_python.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 simple_vector.o simple_vector.so
+	rm -f do_it_yourself_converters.o do_it_yourself_converters.so
+	rm -f pickle1.o pickle1.so
+	rm -f pickle2.o pickle2.so
+	rm -f pickle3.o pickle3.so
+	rm -f noncopyable_export.o noncopyable_export.so
+	rm -f noncopyable_import.o noncopyable_import.so
+	rm -f ivect.o ivect.so
+	rm -f dvect.o dvect.so
+	rm -f so_locations *.pyc
+	rm -rf ii_files
+
+softlinks:
+	$(PYEXE) $(BOOST)/libs/python/build/filemgr.py $(BOOST) softlinks
+
+unlink:
+	$(PYEXE) $(BOOST)/libs/python/build/filemgr.py $(BOOST) unlink
+
+cp:
+	$(PYEXE) $(BOOST)/libs/python/build/filemgr.py $(BOOST) cp
+
+rm:
+	$(PYEXE) $(BOOST)/libs/python/build/filemgr.py $(BOOST) rm
+
+depend:
+	@ cat Makefile.nodepend; \
+          for obj in $(DEPOBJ); \
+          do \
+            bn=`echo "$$obj" | cut -d. -f1`; \
+            $(CPP) $(CPPOPTS) $(MAKEDEP) "$$bn".cpp; \
+          done
+

build/linux_gcc.mak

@@ -0,0 +1,165 @@
+# 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"
+#   Adjust the pathnames 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
+#
+# Revision history:
+#   12 Apr 01 new macro ROOT to simplify configuration (R.W. Grosse-Kunstleve)
+#   Initial version: R.W. Grosse-Kunstleve
+
+ROOT=$(HOME)
+BOOST=$(ROOT)/boost
+
+PYEXE=/usr/bin/python
+PYINC=-I/usr/include/python1.5
+#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
+
+STDOPTS=-ftemplate-depth-21
+WARNOPTS=
+OPTOPTS=-g
+
+CPP=g++
+CPPOPTS=$(STLPORTINC) $(STLPORTOPTS) -I$(BOOST) $(PYINC) \
+        $(STDOPTS) $(WARNOPTS) $(OPTOPTS)
+MAKEDEP=-M
+
+LD=g++
+LDOPTS=-shared
+
+OBJ=classes.o conversions.o extension_class.o functions.o \
+    init_function.o module_builder.o \
+    objects.o types.o cross_module.o
+DEPOBJ=$(OBJ) \
+       comprehensive.o \
+       abstract.o \
+       getting_started1.o getting_started2.o getting_started3.o \
+       simple_vector.o \
+       do_it_yourself_converters.o \
+       pickle1.o pickle2.o pickle3.o \
+       noncopyable_export.o noncopyable_import.o \
+       ivect.o dvect.o
+
+.SUFFIXES: .o .cpp
+
+all: libboost_python.a \
+     boost_python_test.so \
+     abstract.so \
+     getting_started1.so getting_started2.so getting_started3.so \
+     simple_vector.so \
+     do_it_yourself_converters.so \
+     pickle1.so pickle2.so pickle3.so \
+     noncopyable_export.so noncopyable_import.so \
+     ivect.so dvect.so
+
+libboost_python.a: $(OBJ)
+	rm -f libboost_python.a
+	ar r libboost_python.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
+
+simple_vector.so: $(OBJ) simple_vector.o
+	$(LD) $(LDOPTS) $(OBJ) simple_vector.o -o simple_vector.so
+
+do_it_yourself_converters.so: $(OBJ) do_it_yourself_converters.o
+	$(LD) $(LDOPTS) $(OBJ) do_it_yourself_converters.o -o do_it_yourself_converters.so
+
+pickle1.so: $(OBJ) pickle1.o
+	$(LD) $(LDOPTS) $(OBJ) pickle1.o -o pickle1.so
+
+pickle2.so: $(OBJ) pickle2.o
+	$(LD) $(LDOPTS) $(OBJ) pickle2.o -o pickle2.so
+
+pickle3.so: $(OBJ) pickle3.o
+	$(LD) $(LDOPTS) $(OBJ) pickle3.o -o pickle3.so
+
+noncopyable_export.so: $(OBJ) noncopyable_export.o
+	$(LD) $(LDOPTS) $(OBJ) $(HIDDEN) \
+          noncopyable_export.o -o noncopyable_export.so
+
+noncopyable_import.so: $(OBJ) noncopyable_import.o
+	$(LD) $(LDOPTS) $(OBJ) $(HIDDEN) \
+          noncopyable_import.o -o noncopyable_import.so
+
+ivect.so: $(OBJ) ivect.o
+	$(LD) $(LDOPTS) $(OBJ) $(HIDDEN) ivect.o -o ivect.so
+
+dvect.so: $(OBJ) dvect.o
+	$(LD) $(LDOPTS) $(OBJ) $(HIDDEN) dvect.o -o dvect.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_simple_vector.py
+	$(PYEXE) test_do_it_yourself_converters.py
+	$(PYEXE) test_pickle1.py
+	$(PYEXE) test_pickle2.py
+	$(PYEXE) test_pickle3.py
+	$(PYEXE) test_cross_module.py
+
+clean:
+	rm -f $(OBJ) libboost_python.a libboost_python.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 simple_vector.o simple_vector.so
+	rm -f do_it_yourself_converters.o do_it_yourself_converters.so
+	rm -f pickle1.o pickle1.so
+	rm -f pickle2.o pickle2.so
+	rm -f pickle3.o pickle3.so
+	rm -f noncopyable_export.o noncopyable_export.so
+	rm -f noncopyable_import.o noncopyable_import.so
+	rm -f ivect.o ivect.so
+	rm -f dvect.o dvect.so
+	rm -f so_locations *.pyc
+
+softlinks:
+	$(PYEXE) $(BOOST)/libs/python/build/filemgr.py $(BOOST) softlinks
+
+unlink:
+	$(PYEXE) $(BOOST)/libs/python/build/filemgr.py $(BOOST) unlink
+
+cp:
+	$(PYEXE) $(BOOST)/libs/python/build/filemgr.py $(BOOST) cp
+
+rm:
+	$(PYEXE) $(BOOST)/libs/python/build/filemgr.py $(BOOST) rm
+
+depend:
+	@ cat Makefile.nodepend; \
+          for obj in $(DEPOBJ); \
+          do \
+            bn=`echo "$$obj" | cut -d. -f1`; \
+            $(CPP) $(CPPOPTS) $(MAKEDEP) "$$bn".cpp; \
+          done
+

build/mingw32.mak

@@ -0,0 +1,196 @@
+# Usage:
+#
+#   make copy          Copy the sources and tests
+#   make               Compile all sources
+#   make test          Run doctest tests
+#   make clean         Remove all object files
+#   make del           Remove the sources and tests
+#
+# Revision history:
+#   12 Apr 01 new macro ROOT to simplify configuration (R.W. Grosse-Kunstleve)
+#   Initial version: R.W. Grosse-Kunstleve
+
+# To install mingw32, follow instructions at:
+#   http://starship.python.net/crew/kernr/mingw32/Notes.html
+# In particular, install:
+#   ftp://ftp.xraylith.wisc.edu/pub/khan/gnu-win32/mingw32/gcc-2.95.2/gcc-2.95.2-msvcrt.exe
+#   ftp://ftp.xraylith.wisc.edu/pub/khan/gnu-win32/mingw32/gcc-2.95.2/fixes/quote-fix-msvcrt.exe
+#   http://starship.python.net/crew/kernr/mingw32/Python-1.5.2-mingw32.zip
+# Unpack the first two archives in the default locations and update your PATH.
+# Unpack the third archive in \usr.
+
+# Note: comprehensive.cpp generates compiler errors and later crashes.
+#   L:\boost\boost\python\detail\extension_class.hpp:643: warning:
+#   alignment of `vtable for class
+#   boost::python::detail::held_instance<bpl_test::Derived1>'
+#   is greater than maximum object file alignment. Using 16.
+# Could this be fixed with compiler options?
+# -fhuge-objects looks interesting, but requires recompiling the C++ library.
+#                (what exactly does that mean?)
+# -fvtable-thunks eliminates the compiler warning, but
+#                 "import boost_python_test" still causes a crash.
+
+ROOT=L:
+BOOST_WIN="$(ROOT)\boost"
+BOOST_UNIX=$(HOME)/boost
+
+PYEXE="C:\Program files\Python\python.exe"
+PYINC=-I"C:\usr\include\python1.5"
+PYLIB="C:\usr\lib\libpython15.a"
+
+STDOPTS=-ftemplate-depth-21
+WARNOPTS=
+OPTOPTS=-g
+
+CPP=g++
+CPPOPTS=$(STLPORTINC) $(STLPORTOPTS) -I$(BOOST_WIN) $(PYINC) \
+        $(STDOPTS) $(WARNOPTS) $(OPTOPTS)
+
+LD=g++
+LDOPTS=-shared
+
+OBJ=classes.o conversions.o extension_class.o functions.o \
+    init_function.o module_builder.o \
+    objects.o types.o cross_module.o
+
+.SUFFIXES: .o .cpp
+
+all: libboost_python.a \
+     abstract.pyd \
+     getting_started1.pyd getting_started2.pyd getting_started3.pyd \
+     simple_vector.pyd \
+     do_it_yourself_converters.pyd \
+     pickle1.pyd pickle2.pyd pickle3.pyd \
+     noncopyable_export.pyd noncopyable_import.pyd \
+     ivect.pyd dvect.pyd
+
+libboost_python.a: $(OBJ)
+	del libboost_python.a
+	ar r libboost_python.a $(OBJ)
+
+DLLWRAPOPTS=-s --driver-name g++ -s \
+            --entry _DllMainCRTStartup@12 --target=i386-mingw32
+
+boost_python_test.pyd: $(OBJ) comprehensive.o
+	dllwrap $(DLLWRAPOPTS) \
+          --dllname boost_python_test.pyd \
+          --def boost_python_test.def \
+          $(OBJ) comprehensive.o $(PYLIB)
+
+abstract.pyd: $(OBJ) abstract.o
+	dllwrap $(DLLWRAPOPTS) \
+          --dllname abstract.pyd \
+          --def abstract.def \
+          $(OBJ) abstract.o $(PYLIB)
+
+getting_started1.pyd: $(OBJ) getting_started1.o
+	dllwrap $(DLLWRAPOPTS) \
+          --dllname getting_started1.pyd \
+          --def getting_started1.def \
+          $(OBJ) getting_started1.o $(PYLIB)
+
+getting_started2.pyd: $(OBJ) getting_started2.o
+	dllwrap $(DLLWRAPOPTS) \
+          --dllname getting_started2.pyd \
+          --def getting_started2.def \
+          $(OBJ) getting_started2.o $(PYLIB)
+
+getting_started3.pyd: $(OBJ) getting_started3.o
+	dllwrap $(DLLWRAPOPTS) \
+          --dllname getting_started3.pyd \
+          --def getting_started3.def \
+          $(OBJ) getting_started3.o $(PYLIB)
+
+simple_vector.pyd: $(OBJ) simple_vector.o
+	dllwrap $(DLLWRAPOPTS) \
+          --dllname simple_vector.pyd \
+          --def simple_vector.def \
+          $(OBJ) simple_vector.o $(PYLIB)
+
+do_it_yourself_converters.pyd: $(OBJ) do_it_yourself_converters.o
+	dllwrap $(DLLWRAPOPTS) \
+          --dllname do_it_yourself_converters.pyd \
+          --def do_it_yourself_converters.def \
+          $(OBJ) do_it_yourself_converters.o $(PYLIB)
+
+pickle1.pyd: $(OBJ) pickle1.o
+	dllwrap $(DLLWRAPOPTS) \
+          --dllname pickle1.pyd \
+          --def pickle1.def \
+          $(OBJ) pickle1.o $(PYLIB)
+
+pickle2.pyd: $(OBJ) pickle2.o
+	dllwrap $(DLLWRAPOPTS) \
+          --dllname pickle2.pyd \
+          --def pickle2.def \
+          $(OBJ) pickle2.o $(PYLIB)
+
+pickle3.pyd: $(OBJ) pickle3.o
+	dllwrap $(DLLWRAPOPTS) \
+          --dllname pickle3.pyd \
+          --def pickle3.def \
+          $(OBJ) pickle3.o $(PYLIB)
+
+noncopyable_export.pyd: $(OBJ) noncopyable_export.o
+	dllwrap $(DLLWRAPOPTS) \
+          --dllname noncopyable_export.pyd \
+          --def noncopyable_export.def \
+          $(OBJ) noncopyable_export.o $(PYLIB)
+
+noncopyable_import.pyd: $(OBJ) noncopyable_import.o
+	dllwrap $(DLLWRAPOPTS) \
+          --dllname noncopyable_import.pyd \
+          --def noncopyable_import.def \
+          $(OBJ) noncopyable_import.o $(PYLIB)
+
+ivect.pyd: $(OBJ) ivect.o
+	dllwrap $(DLLWRAPOPTS) \
+          --dllname ivect.pyd \
+          --def ivect.def \
+          $(OBJ) ivect.o $(PYLIB)
+
+dvect.pyd: $(OBJ) dvect.o
+	dllwrap $(DLLWRAPOPTS) \
+          --dllname dvect.pyd \
+          --def dvect.def \
+          $(OBJ) dvect.o $(PYLIB)
+
+.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_simple_vector.py
+	$(PYEXE) test_do_it_yourself_converters.py
+	$(PYEXE) test_pickle1.py
+	$(PYEXE) test_pickle2.py
+	$(PYEXE) test_pickle3.py
+	$(PYEXE) test_cross_module.py
+
+clean:
+	del *.o
+	del *.a
+	del *.pyd
+	del *.pyc
+
+softlinks:
+	python $(BOOST_UNIX)/libs/python/build/filemgr.py $(BOOST_UNIX) softlinks
+
+unlink:
+	python $(BOOST_UNIX)/libs/python/build/filemgr.py $(BOOST_UNIX) unlink
+
+cp:
+	python $(BOOST_UNIX)/libs/python/build/filemgr.py $(BOOST_UNIX) cp
+
+rm:
+	python $(BOOST_UNIX)/libs/python/build/filemgr.py $(BOOST_UNIX) rm
+
+copy:
+	$(PYEXE) $(BOOST_WIN)\libs\python\build\filemgr.py $(BOOST_WIN) copy
+
+del:
+	$(PYEXE) $(BOOST_WIN)\libs\python\build\filemgr.py $(BOOST_WIN) del

build/tru64_cxx.mak

@@ -0,0 +1,180 @@
+# 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"
+#   Adjust the pathnames 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
+#
+# Revision history:
+#   12 Apr 01 new macro ROOT to simplify configuration (R.W. Grosse-Kunstleve)
+#   Initial version: R.W. Grosse-Kunstleve
+
+ROOT=$(HOME)
+BOOST=$(ROOT)/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
+#STLPORTINC=-I/usr/local/STLport-4.1b4/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$(BOOST)/boost/compatibility/cpp_c_headers
+
+STDOPTS=-std strict_ansi
+# use -msg_display_number to obtain integer tags for -msg_disable
+WARNOPTS=-msg_disable 186,450,1115
+OPTOPTS=-g
+
+CPP=cxx
+CPPOPTS=$(STLPORTINC) $(STLPORTOPTS) -I$(BOOST) $(PYINC) \
+        $(STDOPTS) $(WARNOPTS) $(OPTOPTS)
+MAKEDEP=-Em
+
+LD=cxx
+LDOPTS=-shared -expect_unresolved 'Py*' -expect_unresolved '_Py*'
+
+#HIDDEN=-hidden
+
+OBJ=classes.o conversions.o extension_class.o functions.o \
+    init_function.o module_builder.o \
+    objects.o types.o cross_module.o
+DEPOBJ=$(OBJ) \
+       comprehensive.o \
+       abstract.o \
+       getting_started1.o getting_started2.o getting_started3.o \
+       simple_vector.o \
+       do_it_yourself_converters.o \
+       pickle1.o pickle2.o pickle3.o \
+       noncopyable_export.o noncopyable_import.o \
+       ivect.o dvect.o
+
+.SUFFIXES: .o .cpp
+
+all: libboost_python.a \
+     boost_python_test.so \
+     abstract.so \
+     getting_started1.so getting_started2.so getting_started3.so \
+     simple_vector.so \
+     do_it_yourself_converters.so \
+     pickle1.so pickle2.so pickle3.so \
+     noncopyable_export.so noncopyable_import.so \
+     ivect.so dvect.so
+
+libboost_python.a: $(OBJ)
+	rm -f libboost_python.a
+	cd cxx_repository; \
+          ls -1 > ../libboost_python.a.input; \
+          ar r ../libboost_python.a -input ../libboost_python.a.input
+	rm -f libboost_python.a.input
+	ar r libboost_python.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
+
+simple_vector.so: $(OBJ) simple_vector.o
+	$(LD) $(LDOPTS) $(OBJ) simple_vector.o -o simple_vector.so
+
+do_it_yourself_converters.so: $(OBJ) do_it_yourself_converters.o
+	$(LD) $(LDOPTS) $(OBJ) do_it_yourself_converters.o -o do_it_yourself_converters.so
+
+pickle1.so: $(OBJ) pickle1.o
+	$(LD) $(LDOPTS) $(OBJ) pickle1.o -o pickle1.so
+
+pickle2.so: $(OBJ) pickle2.o
+	$(LD) $(LDOPTS) $(OBJ) pickle2.o -o pickle2.so
+
+pickle3.so: $(OBJ) pickle3.o
+	$(LD) $(LDOPTS) $(OBJ) pickle3.o -o pickle3.so
+
+noncopyable_export.so: $(OBJ) noncopyable_export.o
+	$(LD) $(LDOPTS) $(OBJ) $(HIDDEN) \
+          noncopyable_export.o -o noncopyable_export.so
+
+noncopyable_import.so: $(OBJ) noncopyable_import.o
+	$(LD) $(LDOPTS) $(OBJ) $(HIDDEN) \
+          noncopyable_import.o -o noncopyable_import.so
+
+ivect.so: $(OBJ) ivect.o
+	$(LD) $(LDOPTS) $(OBJ) $(HIDDEN) ivect.o -o ivect.so
+
+dvect.so: $(OBJ) dvect.o
+	$(LD) $(LDOPTS) $(OBJ) $(HIDDEN) dvect.o -o dvect.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_simple_vector.py
+	$(PYEXE) test_do_it_yourself_converters.py
+	$(PYEXE) test_pickle1.py
+	$(PYEXE) test_pickle2.py
+	$(PYEXE) test_pickle3.py
+	$(PYEXE) test_cross_module.py
+
+clean:
+	rm -f $(OBJ) libboost_python.a libboost_python.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 simple_vector.o simple_vector.so
+	rm -f do_it_yourself_converters.o do_it_yourself_converters.so
+	rm -f pickle1.o pickle1.so
+	rm -f pickle2.o pickle2.so
+	rm -f pickle3.o pickle3.so
+	rm -f noncopyable_export.o noncopyable_export.so
+	rm -f noncopyable_import.o noncopyable_import.so
+	rm -f ivect.o ivect.so
+	rm -f dvect.o dvect.so
+	rm -f so_locations *.pyc
+	rm -rf cxx_repository
+
+softlinks:
+	$(PYEXE) $(BOOST)/libs/python/build/filemgr.py $(BOOST) softlinks
+
+unlink:
+	$(PYEXE) $(BOOST)/libs/python/build/filemgr.py $(BOOST) unlink
+
+cp:
+	$(PYEXE) $(BOOST)/libs/python/build/filemgr.py $(BOOST) cp
+
+rm:
+	$(PYEXE) $(BOOST)/libs/python/build/filemgr.py $(BOOST) rm
+
+depend:
+	@ cat Makefile.nodepend; \
+          for obj in $(DEPOBJ); \
+          do \
+            bn=`echo "$$obj" | cut -d. -f1`; \
+            $(CPP) $(CPPOPTS) $(MAKEDEP) "$$bn".cpp; \
+          done
+

build/vc60.mak

@@ -0,0 +1,133 @@
+# Usage:
+#
+#   make copy          Copy the sources and tests
+#   make               Compile all sources
+#   make test          Run doctest tests
+#   make clean         Remove all object files
+#   make del           Remove the sources and tests
+#
+# Revision history:
+#   12 Apr 01 new macro ROOT to simplify configuration (R.W. Grosse-Kunstleve)
+#   Initial version: R.W. Grosse-Kunstleve
+
+ROOT=L:
+BOOST_WIN="$(ROOT)\boost"
+BOOST_UNIX=$(HOME)/boost
+
+PYEXE="C:\Program files\Python\python.exe"
+PYINC=/I"C:\Program files\Python\include"
+PYLIB="C:\Program files\Python\libs\python15.lib"
+
+STDOPTS=/nologo /MD /GR /GX /Zm200
+WARNOPTS=
+OPTOPTS=
+
+CPP=cl.exe
+CPPOPTS=$(STLPORTINC) $(STLPORTOPTS) /I$(BOOST_WIN) $(PYINC) \
+        $(STDOPTS) $(WARNOPTS) $(OPTOPTS)
+
+LD=link.exe
+LDOPTS=/nologo /dll /incremental:no
+
+OBJ=classes.obj conversions.obj extension_class.obj functions.obj \
+    init_function.obj module_builder.obj \
+    objects.obj types.obj cross_module.obj
+
+.SUFFIXES: .obj .cpp
+
+all: boost_python.lib \
+     boost_python_test.pyd \
+     abstract.pyd \
+     getting_started1.pyd getting_started2.pyd getting_started3.pyd \
+     simple_vector.pyd \
+     do_it_yourself_converters.pyd \
+     pickle1.pyd pickle2.pyd pickle3.pyd \
+     noncopyable_export.pyd noncopyable_import.pyd \
+     ivect.pyd dvect.pyd
+
+boost_python.lib: $(OBJ)
+	$(LD) -lib /nologo /out:boost_python.lib $(OBJ)
+
+boost_python_test.pyd: $(OBJ) comprehensive.obj
+	$(LD) $(LDOPTS) $(OBJ) comprehensive.obj $(PYLIB) /export:initboost_python_test /out:"boost_python_test.pyd"
+
+abstract.pyd: $(OBJ) abstract.obj
+	$(LD) $(LDOPTS) $(OBJ) abstract.obj $(PYLIB) /export:initabstract /out:"abstract.pyd"
+
+getting_started1.pyd: $(OBJ) getting_started1.obj
+	$(LD) $(LDOPTS) $(OBJ) getting_started1.obj $(PYLIB) /export:initgetting_started1 /out:"getting_started1.pyd"
+
+getting_started2.pyd: $(OBJ) getting_started2.obj
+	$(LD) $(LDOPTS) $(OBJ) getting_started2.obj $(PYLIB) /export:initgetting_started2 /out:"getting_started2.pyd"
+
+getting_started3.pyd: $(OBJ) getting_started3.obj
+	$(LD) $(LDOPTS) $(OBJ) getting_started3.obj $(PYLIB) /export:initgetting_started3 /out:"getting_started3.pyd"
+
+simple_vector.pyd: $(OBJ) simple_vector.obj
+	$(LD) $(LDOPTS) $(OBJ) simple_vector.obj $(PYLIB) /export:initsimple_vector /out:"simple_vector.pyd"
+
+do_it_yourself_converters.pyd: $(OBJ) do_it_yourself_converters.obj
+	$(LD) $(LDOPTS) $(OBJ) do_it_yourself_converters.obj $(PYLIB) /export:initdo_it_yourself_converters /out:"do_it_yourself_converters.pyd"
+
+pickle1.pyd: $(OBJ) pickle1.obj
+	$(LD) $(LDOPTS) $(OBJ) pickle1.obj $(PYLIB) /export:initpickle1 /out:"pickle1.pyd"
+
+pickle2.pyd: $(OBJ) pickle2.obj
+	$(LD) $(LDOPTS) $(OBJ) pickle2.obj $(PYLIB) /export:initpickle2 /out:"pickle2.pyd"
+
+pickle3.pyd: $(OBJ) pickle3.obj
+	$(LD) $(LDOPTS) $(OBJ) pickle3.obj $(PYLIB) /export:initpickle3 /out:"pickle3.pyd"
+
+noncopyable_export.pyd: $(OBJ) noncopyable_export.obj
+	$(LD) $(LDOPTS) $(OBJ) noncopyable_export.obj $(PYLIB) /export:initnoncopyable_export /out:"noncopyable_export.pyd"
+
+noncopyable_import.pyd: $(OBJ) noncopyable_import.obj
+	$(LD) $(LDOPTS) $(OBJ) noncopyable_import.obj $(PYLIB) /export:initnoncopyable_import /out:"noncopyable_import.pyd"
+
+ivect.pyd: $(OBJ) ivect.obj
+	$(LD) $(LDOPTS) $(OBJ) ivect.obj $(PYLIB) /export:initivect /out:"ivect.pyd"
+
+dvect.pyd: $(OBJ) dvect.obj
+	$(LD) $(LDOPTS) $(OBJ) dvect.obj $(PYLIB) /export:initdvect /out:"dvect.pyd"
+
+.cpp.obj:
+	$(CPP) $(CPPOPTS) /c $*.cpp
+
+test:
+	$(PYEXE) comprehensive.py --broken-auto-ptr 
+	$(PYEXE) test_abstract.py
+	$(PYEXE) test_getting_started1.py
+	$(PYEXE) test_getting_started2.py
+	$(PYEXE) test_getting_started3.py
+	$(PYEXE) test_simple_vector.py
+	$(PYEXE) test_do_it_yourself_converters.py
+	$(PYEXE) test_pickle1.py
+	$(PYEXE) test_pickle2.py
+	$(PYEXE) test_pickle3.py
+	$(PYEXE) test_cross_module.py --broken-auto-ptr
+
+clean:
+	del *.obj
+	del *.lib
+	del *.exp
+	del *.idb
+	del *.pyd
+	del *.pyc
+
+softlinks:
+	python $(BOOST_UNIX)/libs/python/build/filemgr.py $(BOOST_UNIX) softlinks
+
+unlink:
+	python $(BOOST_UNIX)/libs/python/build/filemgr.py $(BOOST_UNIX) unlink
+
+cp:
+	python $(BOOST_UNIX)/libs/python/build/filemgr.py $(BOOST_UNIX) cp
+
+rm:
+	python $(BOOST_UNIX)/libs/python/build/filemgr.py $(BOOST_UNIX) rm
+
+copy:
+	$(PYEXE) $(BOOST_WIN)\libs\python\build\filemgr.py $(BOOST_WIN) copy
+
+del:
+	$(PYEXE) $(BOOST_WIN)\libs\python\build\filemgr.py $(BOOST_WIN) del

doc/cross_module_dependencies.html

@@ -0,0 +1,336 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN"
+"http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<title>Cross-extension-module dependencies</title>
+
+<div>
+
+<img src="../../../c++boost.gif"
+     alt="c++boost.gif (8819 bytes)"
+     align="center"
+     width="277" height="86">
+
+<hr>
+<h1>Cross-extension-module dependencies</h1>
+
+It is good programming practice to organize large projects as modules
+that interact with each other via well defined interfaces. With
+Boost.Python it is possible to reflect this organization at the C++
+level at the Python level. This is, each logical C++ module can be
+organized as a separate Python extension module.
+
+<p>
+At first sight this might seem natural and straightforward. However, it
+is a fairly complex problem to establish cross-extension-module
+dependencies while maintaining the same ease of use Boost.Python
+provides for classes that are wrapped in the same extension module. To
+a large extent this complexity can be hidden from the author of a
+Boost.Python extension module, but not entirely.
+
+<hr>
+<h2>The recipe</h2>
+
+Suppose there is an extension module that exposes certain instances of
+the C++ <tt>std::vector</tt> template library such that it can be used
+from Python in the following manner:
+
+<pre>
+import std_vector
+v = std_vector.double([1, 2, 3, 4])
+v.push_back(5)
+v.size()
+</pre>
+
+Suppose the <tt>std_vector</tt> module is done well and reflects all
+C++ functions that are useful at the Python level, for all C++ built-in
+data types (<tt>std_vector.int</tt>, <tt>std_vector.long</tt>, etc.).
+
+<p>
+Suppose further that there is statistic module with a C++ class that
+has constructors or member functions that use or return a
+<tt>std::vector</tt>.  For example:
+
+<pre>
+class xy {
+  public:
+    xy(const std::vector&lt;double&gt;&amp; x, const std::vector&lt;double&gt;&amp; y) : m_x(x), m_y(y) {}
+    const std::vector&lt;double&gt;&amp; x() const { return m_x; }
+    const std::vector&lt;double&gt;&amp; y() const { return m_y; }
+    double correlation();
+  private:
+    std::vector&lt;double&gt; m_x;
+    std::vector&lt;double&gt; m_y;
+}
+</pre>
+
+What is more natural than reusing the <tt>std_vector</tt> extension
+module to expose these constructors or functions to Python?
+
+<p>
+Unfortunately, what seems natural needs a little work in both the
+<tt>std_vector</tt> and the <tt>statistics</tt> module.
+
+<p>
+In the <tt>std_vector</tt> extension module,
+<tt>std::vector&lt;double&gt;</tt> is exposed to Python in the usual
+way with the <tt>class_builder&lt;&gt;</tt> template.  To also enable the
+automatic conversion of <tt>std::vector&lt;double&gt;</tt> function
+arguments or return values in other Boost.Python C++ modules, the
+converters that convert a <tt>std::vector&lt;double&gt;</tt> C++ object
+to a Python object and vice versa (i.e. the <tt>to_python()</tt> and
+<tt>from_python()</tt> template functions) have to be exported. For
+example:
+
+<pre>
+  #include &lt;boost/python/cross_module.hpp&gt;
+  //...
+  class_builder&lt;std::vector&lt;double&gt; &gt; v_double(std_vector_module, &quot;double&quot;);
+  export_converters(v_double);
+</pre>
+
+In the extension module that wraps <tt>class xy</tt> we can now import
+these converters with the <tt>import_converters&lt;&gt;</tt> template.
+For example:
+
+<pre>
+  #include &lt;boost/python/cross_module.hpp&gt;
+  //...
+  import_converters&lt;std::vector&lt;double&gt; &gt; v_double_converters(&quot;std_vector&quot;, &quot;double&quot;);
+</pre>
+
+That is all. All the attributes that are defined for
+<tt>std_vector.double</tt> in the <tt>std_vector</tt> Boost.Python
+module will be available for the returned objects of <tt>xy.x()</tt>
+and <tt>xy.y()</tt>.  Similarly, the constructor for <tt>xy</tt> will
+accept objects that were created by the <tt>std_vector</tt>module.
+
+<hr>
+<h2>Placement of <tt>import_converters&lt;&gt;</tt> template instantiations</h2>
+
+<tt>import_converts&lt;&gt;</tt> can be viewed as a drop-in replacement
+for <tt>class_wrapper&lt;&gt;</tt>, and the recommendations for the
+placement of <tt>class_wrapper&lt;&gt;</tt> template instantiations
+also apply to to <tt>import_converts&lt;&gt;</tt>. In particular, it is
+important that an instantiation of <tt>class_wrapper&lt;&gt;</tt> is
+visible to any code which wraps a C++ function with a <tt>T</tt>,
+<tt>T*</tt>, const <tt>T&amp;</tt>, etc. parameter or return value.
+Therefore you may want to group all <tt>class_wrapper&lt;&gt;</tt> and
+<tt>import_converts&lt;&gt;</tt> instantiations at the top of your
+module's init function, then <tt>def()</tt> the member functions later
+to avoid problems with inter-class dependencies.
+
+<hr>
+<h2>Non-copyable types</h2>
+
+<tt>export_converters()</tt> instantiates C++ template functions that
+invoke the copy constructor of the wrapped type. For a type that is
+non-copyable this will result in compile-time error messages. In such a
+case, <tt>export_converters_noncopyable()</tt> can be used to export
+the converters that do not involve the copy constructor of the wrapped
+type.  For example:
+
+<pre>
+class_builder&lt;store&gt; py_store(your_module, &quot;store&quot;);
+export_converters_noncopyable(py_store);
+</pre>
+
+The corresponding <tt>import_converters&lt;&gt;</tt> statement does not
+need any special attention:
+
+<pre>
+import_converters&lt;store&gt; py_store(&quot;noncopyable_export&quot;, &quot;store&quot;);
+</pre>
+
+<hr>
+<h2>Python module search path</h2>
+
+The <tt>std_vector</tt> and <tt>statistics</tt> modules can now be used
+in the following way:
+
+<pre>
+import std_vector
+import statistics
+x = std_vector.double([1, 2, 3, 4])
+y = std_vector.double([2, 4, 6, 8])
+xy = statistics.xy(x, y)
+xy.correlation()
+</pre>
+
+In this example it is clear that Python has to be able to find both the
+<tt>std_vector</tt> and the <tt>statistics</tt> extension module. In
+other words, both extension modules need to be in the Python module
+search path (<tt>sys.path</tt>).
+
+<p>
+The situation is not always this obvious. Suppose the
+<tt>statistics</tt> module has a <tt>random()</tt> function that
+returns a vector of random numbers with a given length:
+
+<pre>
+import statistics
+x = statistics.random(5)
+y = statistics.random(5)
+xy = statistics.xy(x, y)
+xy.correlation()
+</pre>
+
+A naive user will not easily anticipate that the <tt>std_vector</tt>
+module is used to pass the <tt>x</tt> and <tt>y</tt> vectors around. If
+the <tt>std_vector</tt> module is in the Python module search path,
+this form of ignorance is of no harm.  On the contrary, we are glad
+that we do not have to bother the user with details like this.
+
+<p>
+If the <tt>std_vector</tt> module is not in the Python module search
+path, a Python exception will be raised:
+
+<pre>
+Traceback (innermost last):
+  File &quot;foo.py&quot;, line 2, in ?
+    x = statistics.random(5)
+ImportError: No module named std_vector
+</pre>
+
+As is the case with any system of a non-trivial complexity, it is
+important that the setup is consistent and complete.
+
+<hr>
+<h2>Two-way module dependencies</h2>
+
+Boost.Python supports two-way module dependencies. This is best
+illustrated by a simple example.
+
+<p>
+Suppose there is a module <tt>ivect</tt> that implements vectors of
+integers, and a similar module <tt>dvect</tt> that implements vectors
+of doubles. We want to be able do convert an integer vector to a double
+vector and vice versa. For example:
+
+<pre>
+import ivect
+iv = ivect.ivect((1,2,3,4,5))
+dv = iv.as_dvect()
+</pre>
+
+The last expression will implicitly import the <tt>dvect</tt> module in
+order to enable the conversion of the C++ representation of
+<tt>dvect</tt> to a Python object. The analogous is possible for a
+<tt>dvect</tt>:
+
+<pre>
+import dvect
+dv = dvect.dvect((1,2,3,4,5))
+iv = dv.as_ivect()
+</pre>
+
+Now the <tt>ivect</tt> module is imported implicitly.
+
+<p>
+Note that the two-way dependencies are possible because the
+dependencies are resolved only when needed. This is, the initialization
+of the <tt>ivect</tt> module does not rely on the <tt>dvect</tt>
+module, and vice versa.  Only if <tt>as_dvect()</tt> or
+<tt>as_ivect()</tt> is actually invoked will the corresponding module
+be implicitly imported. This also means that, for example, the
+<tt>dvect</tt> module does not have to be available at all if
+<tt>as_dvect()</tt> is never used.
+
+<hr>
+<h2>Clarification of compile-time and link-time dependencies</h2>
+
+Boost.Python's support for resolving cross-module dependencies at
+runtime does not imply that compile-time dependencies are eliminated.
+For example, the statistics extension module in the example above will
+need to <tt>#include &lt;vector&gt;</tt>. This is immediately obvious
+from the definition of <tt>class xy</tt>.
+
+<p>
+If a library is wrapped that consists of both header files and compiled
+components (e.g. <tt>libdvect.a</tt>, <tt>dvect.lib</tt>, etc.), both
+the Boost.Python extension module with the
+<tt>export_converters()</tt> statement and the module with the
+<tt>import_converters&lt;&gt;</tt> statement need to be linked against
+the object library.  Ideally one would build a shared library (e.g.
+<tt>libdvect.so</tt>, <tt>dvect.dll</tt>, etc.). However, this
+introduces the issue of having to configure the search path for the
+dynamic loading correctly. For small libraries it is therefore often
+more convenient to ignore the fact that the object files are loaded
+into memory more than once.
+
+<hr>
+<h2>Summary of motivation for cross-module support</h2>
+
+The main purpose of Boost.Python's cross-module support is to allow for
+a modular system layout. With this support it is straightforward to
+reflect C++ code organization at the Python level. Without the
+cross-module support, a multi-purpose module like <tt>std_vector</tt>
+would be impractical because the entire wrapper code would somehow have
+to be duplicated in all extension modules that use it, making them
+harder to maintain and harder to build.
+
+<p>
+Another motivation for the cross-module support is that two extension
+modules that wrap the same class cannot both be imported into Python.
+For example, if there are two modules <tt>A</tt> and <tt>B</tt> that
+both wrap a given <tt>class X</tt>, this will work:
+
+<pre>
+import A
+x = A.X()
+</pre>
+
+This will also work:
+
+<pre>
+import B
+x = B.X()
+</pre>
+
+However, this will fail:
+
+<pre>
+import A
+import B
+python: /net/cci/rwgk/boost/boost/python/detail/extension_class.hpp:866:
+static void boost::python::detail::class_registry&lt;X&gt;::register_class(boost::python::detail::extension_class_base *):
+Assertion `static_class_object == 0' failed.
+Abort
+</pre>
+
+A good solution is to wrap <tt>class X</tt> only once. Depending on the
+situation, this could be done by module <tt>A</tt> or <tt>B</tt>, or an
+additional small extension module that only wraps and exports
+<tt>class X</tt>.
+
+<p>
+Finally, there can be important psychological or political reasons for
+using the cross-module support. If a group of classes is lumped
+together with many others in a huge module, the authors will have
+difficulties in being identified with their work. The situation is
+much more transparent if the work is represented by a module with a
+recognizable name. This is not just a question of strong egos, but also
+of getting credit and funding.
+
+<hr>
+<h2>Why not use <tt>export_converters()</tt> universally?</h2>
+
+There is some overhead associated with the Boost.Python cross-module
+support. Depending on the platform, the size of the code generated by
+<tt>export_converters()</tt> is roughly 10%-20% of that generated
+by <tt>class_builder&lt;&gt;</tt>. For a large extension module with
+many wrapped classes, this could mean a significant difference.
+Therefore the general recommendation is to use
+<tt>export_converters()</tt> only for classes that are likely to
+be used as function arguments or return values in other modules.
+
+<hr>
+&copy; Copyright Ralf W. Grosse-Kunstleve 2001. Permission to copy,
+use, modify, sell and distribute this document is granted provided this
+copyright notice appears in all copies. This document is provided "as
+is" without express or implied warranty, and with no claim as to its
+suitability for any purpose.
+
+<p>
+Updated: April 2001
+
+</div>

doc/pickle.html

@@ -0,0 +1,272 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN"
+"http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<title>Boost.Python Pickle Support</title>
+
+<div>
+
+<img src="../../../c++boost.gif"
+     alt="c++boost.gif (8819 bytes)"
+     align="center"
+     width="277" height="86">
+
+<hr>
+<h1>Boost.Python Pickle Support</h1>
+
+Pickle is a Python module for object serialization, also known
+as persistence, marshalling, or flattening.
+
+<p>
+It is often necessary to save and restore the contents of an object to
+a file. One approach to this problem is to write a pair of functions
+that read and write data from a file in a special format. A powerful
+alternative approach is to use Python's pickle module. Exploiting
+Python's ability for introspection, the pickle module recursively
+converts nearly arbitrary Python objects into a stream of bytes that
+can be written to a file.
+
+<p>
+The Boost Python Library supports the pickle module by emulating the
+interface implemented by Jim Fulton's ExtensionClass module that is
+included in the
+<a href="http://www.zope.org/"
+>ZOPE</a>
+distribution.
+This interface is similar to that for regular Python classes as
+described in detail in the
+<a href="http://www.python.org/doc/current/lib/module-pickle.html"
+>Python Library Reference for pickle.</a>
+
+<hr>
+<h2>The Boost.Python Pickle Interface</h2>
+
+At the user level, the Boost.Python pickle interface involves three special
+methods:
+
+<dl>
+<dt>
+<strong><tt>__getinitargs__</tt></strong>
+<dd>
+  When an instance of a Boost.Python extension class is pickled, the
+  pickler tests if the instance has a <tt>__getinitargs__</tt> method.
+  This method must return a Python tuple (it is most convenient to use
+  a boost::python::tuple). When the instance is restored by the
+  unpickler, the contents of this tuple are used as the arguments for
+  the class constructor.
+
+  <p>
+  If <tt>__getinitargs__</tt> is not defined, the class constructor
+  will be called without arguments.
+
+<p>
+<dt>
+<strong><tt>__getstate__</tt></strong>
+
+<dd>
+  When an instance of a Boost.Python extension class is pickled, the
+  pickler tests if the instance has a <tt>__getstate__</tt> method.
+  This method should return a Python object representing the state of
+  the instance.
+
+  <p>
+  If <tt>__getstate__</tt> is not defined, the instance's
+  <tt>__dict__</tt> is pickled (if it is not empty).
+
+<p>
+<dt>
+<strong><tt>__setstate__</tt></strong>
+
+<dd>
+  When an instance of a Boost.Python extension class is restored by the
+  unpickler, it is first constructed using the result of
+  <tt>__getinitargs__</tt> as arguments (see above). Subsequently the
+  unpickler tests if the new instance has a <tt>__setstate__</tt>
+  method. If so, this method is called with the result of
+  <tt>__getstate__</tt> (a Python object) as the argument.
+
+  <p>
+  If <tt>__setstate__</tt> is not defined, the result of
+  <tt>__getstate__</tt> must be a Python dictionary. The items of this
+  dictionary are added to the instance's <tt>__dict__</tt>.
+
+</dl>
+
+If both <tt>__getstate__</tt> and <tt>__setstate__</tt> are defined,
+the Python object returned by <tt>__getstate__</tt> need not be a
+dictionary. The <tt>__getstate__</tt> and <tt>__setstate__</tt> methods
+can do what they want.
+
+<hr>
+<h2>Pitfalls and Safety Guards</h2>
+
+In Boost.Python extension modules with many extension classes,
+providing complete pickle support for all classes would be a
+significant overhead. In general complete pickle support should only be
+implemented for extension classes that will eventually be pickled.
+However, the author of a Boost.Python extension module might not
+anticipate correctly which classes need support for pickle.
+Unfortunately, the pickle protocol described above has two important
+pitfalls that the end user of a Boost.Python extension module might not
+be aware of:
+
+<dl>
+<dt>
+<strong>Pitfall 1:</strong>
+Both <tt>__getinitargs__</tt> and <tt>__getstate__</tt> are not defined.
+
+<dd>
+  In this situation the unpickler calls the class constructor without
+  arguments and then adds the <tt>__dict__</tt> that was pickled by
+  default to that of the new instance.
+
+  <p>
+  However, most C++ classes wrapped with Boost.Python will have member
+  data that are not restored correctly by this procedure. To alert the
+  user to this problem, a safety guard is provided. If both
+  <tt>__getinitargs__</tt> and <tt>__getstate__</tt> are not defined,
+  Boost.Python tests if the class has an attribute
+  <tt>__dict_defines_state__</tt>. An exception is raised if this
+  attribute is not defined:
+
+<pre>
+    RuntimeError: Incomplete pickle support (__dict_defines_state__ not set)
+</pre>
+
+  In the rare cases where this is not the desired behavior, the safety
+  guard can deliberately be disabled. The corresponding C++ code for
+  this is, e.g.:
+
+<pre>
+    class_builder&lt;your_class&gt; py_your_class(your_module, "your_class");
+    py_your_class.dict_defines_state();
+</pre>
+
+  It is also possible to override the safety guard at the Python level.
+  E.g.:
+
+<pre>
+    import your_bpl_module
+    class your_class(your_bpl_module.your_class):
+      __dict_defines_state__ = 1
+</pre>
+
+<p>
+<dt>
+<strong>Pitfall 2:</strong>
+<tt>__getstate__</tt> is defined and the instance's <tt>__dict__</tt> is not empty.
+
+<dd>
+  The author of a Boost.Python extension class might provide a
+  <tt>__getstate__</tt> method without considering the possibilities
+  that:
+
+  <p>
+  <ul>
+  <li>
+    his class is used in Python as a base class. Most likely the
+    <tt>__dict__</tt> of instances of the derived class needs to be
+    pickled in order to restore the instances correctly.
+
+  <p>
+  <li>
+    the user adds items to the instance's <tt>__dict__</tt> directly.
+    Again, the <tt>__dict__</tt> of the instance then needs to be
+    pickled.
+
+  </ul>
+  <p>
+
+  To alert the user to this highly unobvious problem, a safety guard is
+  provided. If <tt>__getstate__</tt> is defined and the instance's
+  <tt>__dict__</tt> is not empty, Boost.Python tests if the class has
+  an attribute <tt>__getstate_manages_dict__</tt>. An exception is
+  raised if this attribute is not defined:
+
+<pre>
+    RuntimeError: Incomplete pickle support (__getstate_manages_dict__ not set)
+</pre>
+
+  To resolve this problem, it should first be established that the
+  <tt>__getstate__</tt> and <tt>__setstate__</tt> methods manage the
+  instances's <tt>__dict__</tt> correctly. Note that this can be done
+  both at the C++ and the Python level. Finally, the safety guard
+  should intentionally be overridden.  E.g. in C++:
+
+<pre>
+    class_builder&lt;your_class&gt; py_your_class(your_module, "your_class");
+    py_your_class.getstate_manages_dict();
+</pre>
+
+  In Python:
+
+<pre>
+    import your_bpl_module
+    class your_class(your_bpl_module.your_class):
+      __getstate_manages_dict__ = 1
+      def __getstate__(self):
+        # your code here
+      def __setstate__(self, state):
+        # your code here
+</pre>
+</dl>
+
+<hr>
+<h2>Practical Advice</h2>
+
+<ul>
+<li>
+  Avoid using <tt>__getstate__</tt> if the instance can also be
+  reconstructed by way of <tt>__getinitargs__</tt>. This automatically
+  avoids Pitfall 2.
+
+<p>
+<li>
+  If <tt>__getstate__</tt> is required, include the instance's
+  <tt>__dict__</tt> in the Python object that is returned.
+
+</ul>
+
+<hr>
+<h2>Examples</h2>
+
+There are three files in <tt>boost/libs/python/example</tt> that
+show how so provide pickle support.
+
+<h3><a href="../example/pickle1.cpp"><tt>pickle1.cpp</tt></a></h3>
+
+    The C++ class in this example can be fully restored by passing the
+    appropriate argument to the constructor. Therefore it is sufficient
+    to define the pickle interface method <tt>__getinitargs__</tt>.
+
+<h3><a href="../example/pickle2.cpp"><tt>pickle2.cpp</tt></a></h3>
+
+    The C++ class in this example contains member data that cannot be
+    restored by any of the constructors. Therefore it is necessary to
+    provide the <tt>__getstate__</tt>/<tt>__setstate__</tt> pair of
+    pickle interface methods.
+
+    <p>
+    For simplicity, the <tt>__dict__</tt> is not included in the result
+    of <tt>__getstate__</tt>. This is not generally recommended, but a
+    valid approach if it is anticipated that the object's
+    <tt>__dict__</tt> will always be empty. Note that the safety guards
+    will catch the cases where this assumption is violated.
+
+<h3><a href="../example/pickle3.cpp"><tt>pickle3.cpp</tt></a></h3>
+
+    This example is similar to <a
+    href="../example/pickle2.cpp"><tt>pickle2.cpp</tt></a>. However, the
+    object's <tt>__dict__</tt> is included in the result of
+    <tt>__getstate__</tt>.  This requires more code but is unavoidable
+    if the object's <tt>__dict__</tt> is not always empty.
+
+<hr>
+&copy; Copyright Ralf W. Grosse-Kunstleve 2001. Permission to copy,
+use, modify, sell and distribute this document is granted provided this
+copyright notice appears in all copies. This document is provided "as
+is" without express or implied warranty, and with no claim as to its
+suitability for any purpose.
+
+<p>
+Updated: March 21, 2001
+</div>

example/do_it_yourself_converters.cpp

@@ -0,0 +1,126 @@
+/*
+   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(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
+
+BOOST_PYTHON_MODULE_INIT(do_it_yourself_converters)
+{
+  try
+  {
+    // Create an object representing this extension module.
+    python::module_builder this_module("do_it_yourself_converters");
+
+    // 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/dvect.cpp

@@ -0,0 +1,42 @@
+#include "dvect.h"
+#include "ivect.h"
+#include <boost/python/cross_module.hpp>
+namespace python = boost::python;
+
+namespace {
+
+# include "dvect_conversions.cpp"
+# include "ivect_conversions.cpp"
+
+  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_MODULE_INIT(dvect)
+{
+  try
+  {
+    python::module_builder this_module("dvect");
+
+    python::class_builder<vects::dvect> dvect_class(this_module, "dvect");
+    python::export_converters(dvect_class);
+
+    python::import_converters<vects::ivect> ivect_converters("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");
+
+# include "dvect_defs.cpp"
+# include "ivect_defs.cpp"
+  }
+  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/dvect_conversions.cpp

@@ -0,0 +1,51 @@
+  // basics first: const reference converters
+  boost::python::tuple const_dvect_reference_as_tuple(const vects::dvect& dv)
+  {
+    return dv.as_tuple();
+  }
+
+  // to_python smart pointer conversions
+  std::auto_ptr<vects::dvect> dvect_as_auto_ptr(const vects::dvect& dv)
+  {
+    return std::auto_ptr<vects::dvect>(new vects::dvect(dv));
+  }
+  boost::shared_ptr<vects::dvect> dvect_as_shared_ptr(const vects::dvect& dv)
+  {
+    return boost::shared_ptr<vects::dvect>(new vects::dvect(dv));
+  }
+
+  // smart pointers passed by value
+  boost::python::ref auto_ptr_value_dvect_as_tuple(std::auto_ptr<vects::dvect> dv)
+  {
+    if (dv.get() == 0) return boost::python::ref(Py_None, boost::python::ref::increment_count);
+    return dv->as_tuple().reference();
+  }
+  boost::python::ref shared_ptr_value_dvect_as_tuple(boost::shared_ptr<vects::dvect> dv)
+  {
+    if (dv.get() == 0) return boost::python::ref(Py_None, boost::python::ref::increment_count);
+    return dv->as_tuple().reference();
+  }
+
+  // smart pointers passed by reference
+  boost::python::ref auto_ptr_reference_dvect_as_tuple(std::auto_ptr<vects::dvect>& dv)
+  {
+    if (dv.get() == 0) return boost::python::ref(Py_None, boost::python::ref::increment_count);
+    return dv->as_tuple().reference();
+  }
+  boost::python::ref shared_ptr_reference_dvect_as_tuple(boost::shared_ptr<vects::dvect>& dv)
+  {
+    if (dv.get() == 0) return boost::python::ref(Py_None, boost::python::ref::increment_count);
+    return dv->as_tuple().reference();
+  }
+
+  // smart pointers passed by const reference
+  boost::python::ref auto_ptr_const_reference_dvect_as_tuple(const std::auto_ptr<vects::dvect>& dv)
+  {
+    if (dv.get() == 0) return boost::python::ref(Py_None, boost::python::ref::increment_count);
+    return dv->as_tuple().reference();
+  }
+  boost::python::ref shared_ptr_const_reference_dvect_as_tuple(const boost::shared_ptr<vects::dvect>& dv)
+  {
+    if (dv.get() == 0) return boost::python::ref(Py_None, boost::python::ref::increment_count);
+    return dv->as_tuple().reference();
+  }

example/dvect_defs.cpp

@@ -0,0 +1,13 @@
+    this_module.def(dvect_as_auto_ptr, "dvect_as_auto_ptr");
+    this_module.def(dvect_as_shared_ptr, "dvect_as_shared_ptr");
+
+    this_module.def(const_dvect_reference_as_tuple, "const_dvect_reference_as_tuple");
+
+    this_module.def(auto_ptr_value_dvect_as_tuple, "auto_ptr_value_dvect_as_tuple");
+    this_module.def(shared_ptr_value_dvect_as_tuple, "shared_ptr_value_dvect_as_tuple");
+
+    this_module.def(auto_ptr_reference_dvect_as_tuple, "auto_ptr_reference_dvect_as_tuple");
+    this_module.def(shared_ptr_reference_dvect_as_tuple, "shared_ptr_reference_dvect_as_tuple");
+
+    this_module.def(auto_ptr_const_reference_dvect_as_tuple, "auto_ptr_const_reference_dvect_as_tuple");
+    this_module.def(shared_ptr_const_reference_dvect_as_tuple, "shared_ptr_const_reference_dvect_as_tuple");

example/ivect.cpp

@@ -0,0 +1,42 @@
+#include "dvect.h"
+#include "ivect.h"
+#include <boost/python/cross_module.hpp>
+namespace python = boost::python;
+
+namespace {
+
+# include "dvect_conversions.cpp"
+# include "ivect_conversions.cpp"
+
+  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_MODULE_INIT(ivect)
+{
+  try
+  {
+    python::module_builder this_module("ivect");
+
+    python::class_builder<vects::ivect> ivect_class(this_module, "ivect");
+    python::export_converters(ivect_class);
+
+    python::import_converters<vects::dvect> dvect_converters("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");
+
+# include "dvect_defs.cpp"
+# include "ivect_defs.cpp"
+  }
+  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/ivect_conversions.cpp

@@ -0,0 +1,51 @@
+  // basics first: const reference converters
+  boost::python::tuple const_ivect_reference_as_tuple(const vects::ivect& iv)
+  {
+    return iv.as_tuple();
+  }
+
+  // to_python smart pointer conversions
+  std::auto_ptr<vects::ivect> ivect_as_auto_ptr(const vects::ivect& iv)
+  {
+    return std::auto_ptr<vects::ivect>(new vects::ivect(iv));
+  }
+  boost::shared_ptr<vects::ivect> ivect_as_shared_ptr(const vects::ivect& iv)
+  {
+    return boost::shared_ptr<vects::ivect>(new vects::ivect(iv));
+  }
+
+  // smart pointers passed by value
+  boost::python::ref auto_ptr_value_ivect_as_tuple(std::auto_ptr<vects::ivect> iv)
+  {
+    if (iv.get() == 0) return boost::python::ref(Py_None, boost::python::ref::increment_count);
+    return iv->as_tuple().reference();
+  }
+  boost::python::ref shared_ptr_value_ivect_as_tuple(boost::shared_ptr<vects::ivect> iv)
+  {
+    if (iv.get() == 0) return boost::python::ref(Py_None, boost::python::ref::increment_count);
+    return iv->as_tuple().reference();
+  }
+
+  // smart pointers passed by reference
+  boost::python::ref auto_ptr_reference_ivect_as_tuple(std::auto_ptr<vects::ivect>& iv)
+  {
+    if (iv.get() == 0) return boost::python::ref(Py_None, boost::python::ref::increment_count);
+    return iv->as_tuple().reference();
+  }
+  boost::python::ref shared_ptr_reference_ivect_as_tuple(boost::shared_ptr<vects::ivect>& iv)
+  {
+    if (iv.get() == 0) return boost::python::ref(Py_None, boost::python::ref::increment_count);
+    return iv->as_tuple().reference();
+  }
+
+  // smart pointers passed by const reference
+  boost::python::ref auto_ptr_const_reference_ivect_as_tuple(const std::auto_ptr<vects::ivect>& iv)
+  {
+    if (iv.get() == 0) return boost::python::ref(Py_None, boost::python::ref::increment_count);
+    return iv->as_tuple().reference();
+  }
+  boost::python::ref shared_ptr_const_reference_ivect_as_tuple(const boost::shared_ptr<vects::ivect>& iv)
+  {
+    if (iv.get() == 0) return boost::python::ref(Py_None, boost::python::ref::increment_count);
+    return iv->as_tuple().reference();
+  }

example/ivect_defs.cpp

@@ -0,0 +1,13 @@
+    this_module.def(ivect_as_auto_ptr, "ivect_as_auto_ptr");
+    this_module.def(ivect_as_shared_ptr, "ivect_as_shared_ptr");
+
+    this_module.def(const_ivect_reference_as_tuple, "const_ivect_reference_as_tuple");
+
+    this_module.def(auto_ptr_value_ivect_as_tuple, "auto_ptr_value_ivect_as_tuple");
+    this_module.def(shared_ptr_value_ivect_as_tuple, "shared_ptr_value_ivect_as_tuple");
+
+    this_module.def(auto_ptr_reference_ivect_as_tuple, "auto_ptr_reference_ivect_as_tuple");
+    this_module.def(shared_ptr_reference_ivect_as_tuple, "shared_ptr_reference_ivect_as_tuple");
+
+    this_module.def(auto_ptr_const_reference_ivect_as_tuple, "auto_ptr_const_reference_ivect_as_tuple");
+    this_module.def(shared_ptr_const_reference_ivect_as_tuple, "shared_ptr_const_reference_ivect_as_tuple");

example/noncopyable.h

@@ -0,0 +1,14 @@
+#ifndef NONCOPYABLE_H
+#define NONCOPYABLE_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 // NONCOPYABLE_H

example/noncopyable_export.cpp

@@ -0,0 +1,22 @@
+#include <boost/python/cross_module.hpp>
+namespace python = boost::python;
+
+#include "noncopyable.h"
+
+BOOST_PYTHON_MODULE_INIT(noncopyable_export)
+{
+  try
+  {
+    python::module_builder this_module("noncopyable_export");
+
+    python::class_builder<store> store_class(this_module, "store");
+    python::export_converters_noncopyable(store_class);
+
+    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,39 @@
+#include <boost/python/cross_module.hpp>
+namespace python = boost::python;
+
+#include "noncopyable.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;
+  }
+}
+
+BOOST_PYTHON_MODULE_INIT(noncopyable_import)
+{
+  try
+  {
+    python::module_builder this_module("noncopyable_import");
+
+    python::import_converters<store>
+      dvect_converters("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/pickle1.cpp

@@ -0,0 +1,62 @@
+/*
+    This example shows how to make an Extension Class "pickleable".
+
+    The world class below can be fully restored by passing the
+    appropriate argument to the constructor. Therefore it is sufficient
+    to define the pickle interface method __getinitargs__.
+
+    For more information refer to boost/libs/python/doc/pickle.html.
+ */
+
+#include <string>
+
+#include <boost/python/class_builder.hpp>
+namespace python = boost::python;
+
+namespace { // Avoid cluttering the global namespace.
+
+  // A friendly class.
+  class world
+  {
+    private:
+      std::string country;
+      int secret_number;
+    public:
+      world(const std::string& country) : secret_number(0) {
+        this->country = country;
+      }
+      std::string greet() const { return "Hello from " + country + "!"; }
+      std::string get_country() const { return country; }
+  };
+
+  // Support for pickle.
+  python::ref world_getinitargs(const world& w) {
+      python::tuple result(1);
+      result.set_item(0, w.get_country());
+      return result.reference();
+  }
+}
+
+BOOST_PYTHON_MODULE_INIT(pickle1)
+{
+  try
+  {
+    // Create an object representing this extension module.
+    python::module_builder this_module("pickle1");
+
+    // Create the Python type object for our extension class.
+    python::class_builder<world> world_class(this_module, "world");
+
+    // Add the __init__ function.
+    world_class.def(python::constructor<std::string>());
+    // Add a regular member function.
+    world_class.def(&world::greet, "greet");
+
+    // Support for pickle.
+    world_class.def(world_getinitargs, "__getinitargs__");
+  }
+  catch(...)
+  {
+    python::handle_exception(); // Deal with the exception for Python
+  }
+}

example/pickle2.cpp

@@ -0,0 +1,98 @@
+/*
+    This example shows how to make an Extension Class "pickleable".
+
+    The world class below contains member data (secret_number) that
+    cannot be restored by any of the constructors. Therefore it is
+    necessary to provide the __getstate__/__setstate__ pair of pickle
+    interface methods.
+
+    For simplicity, the __dict__ is not included in the result of
+    __getstate__. This is not generally recommended, but a valid
+    approach if it is anticipated that the object's __dict__ will
+    always be empty. Note that safety guard are provided to catch the
+    cases where this assumption is not true.
+
+    pickle3.cpp shows how to include the object's __dict__ in the
+    result of __getstate__.
+
+    For more information refer to boost/libs/python/doc/pickle.html.
+ */
+
+#include <string>
+
+#include <boost/python/class_builder.hpp>
+namespace python = boost::python;
+
+namespace { // Avoid cluttering the global namespace.
+
+  // A friendly class.
+  class world
+  {
+    public:
+      world(const std::string& country) : secret_number(0) {
+        this->country = country;
+      }
+      std::string greet() const { return "Hello from " + country + "!"; }
+      std::string get_country() const { return country; }
+      void set_secret_number(int number) { secret_number = number; }
+      int get_secret_number() const { return secret_number; }
+    private:
+      std::string country;
+      int secret_number;
+  };
+
+  // Support for pickle.
+
+  using BOOST_PYTHON_CONVERSION::from_python;
+
+  python::ref world_getinitargs(const world& w) {
+      python::tuple result(1);
+      result.set_item(0, w.get_country());
+      return result.reference(); // returning the reference avoids the copying.
+  }
+
+  python::ref world_getstate(const world& w) {
+      python::tuple result(1);
+      result.set_item(0, w.get_secret_number());
+      return result.reference(); // returning the reference avoids the copying.
+  }
+
+  void world_setstate(world& w, python::tuple state) {
+    if (state.size() != 1) {
+      PyErr_SetString(PyExc_ValueError,
+        "Unexpected argument in call to __setstate__.");
+      throw python::error_already_set();
+    }
+    int number = from_python(state[0].get(), python::type<int>());
+    if (number != 42)
+      w.set_secret_number(number);
+  }
+}
+
+BOOST_PYTHON_MODULE_INIT(pickle2)
+{
+  try
+  {
+    // Create an object representing this extension module.
+    python::module_builder this_module("pickle2");
+
+    // Create the Python type object for our extension class.
+    python::class_builder<world> world_class(this_module, "world");
+
+    // Add the __init__ function.
+    world_class.def(python::constructor<std::string>());
+    // Add a regular member function.
+    world_class.def(&world::greet, "greet");
+    world_class.def(&world::get_secret_number, "get_secret_number");
+    world_class.def(&world::set_secret_number, "set_secret_number");
+
+    // Support for pickle.
+    world_class.def(world_getinitargs, "__getinitargs__");
+    world_class.def(world_getstate, "__getstate__");
+    world_class.def(world_setstate, "__setstate__");
+  }
+  catch(...)
+  {
+    python::handle_exception(); // Deal with the exception for Python
+  }
+}

example/pickle3.cpp

@@ -0,0 +1,148 @@
+/*
+    This example shows how to make an Extension Class "pickleable".
+
+    The world class below contains member data (secret_number) that
+    cannot be restored by any of the constructors. Therefore it is
+    necessary to provide the __getstate__/__setstate__ pair of pickle
+    interface methods.
+
+    The object's __dict__ is included in the result of __getstate__.
+    This requires more code (compare with pickle2.cpp), but is
+    unavoidable if the object's __dict__ is not always empty.
+
+    For more information refer to boost/libs/python/doc/pickle.html.
+ */
+
+#include <string>
+
+#include <boost/python/class_builder.hpp>
+namespace python = boost::python;
+
+namespace boost { namespace python {
+
+  ref getattr(PyObject* o, const std::string& attr_name) {
+    return ref(PyObject_GetAttrString(o, const_cast<char*>(attr_name.c_str())));
+  }
+  ref getattr(const ref& r, const std::string& attr_name) {
+    return getattr(r.get(), attr_name);
+  }
+
+}}
+
+namespace { // Avoid cluttering the global namespace.
+
+  // A friendly class.
+  class world
+  {
+    public:
+      world(const std::string& country) : secret_number(0) {
+        this->country = country;
+      }
+      std::string greet() const { return "Hello from " + country + "!"; }
+      std::string get_country() const { return country; }
+      void set_secret_number(int number) { secret_number = number; }
+      int get_secret_number() const { return secret_number; }
+    private:
+      std::string country;
+      int secret_number;
+  };
+
+  // Support for pickle.
+  python::ref world_getinitargs(const world& w) {
+      python::tuple result(1);
+      result.set_item(0, w.get_country());
+      return result.reference(); // returning the reference avoids the copying.
+  }
+
+  python::ref world_getstate(python::tuple const & args,
+                             python::dictionary const & keywords);
+
+  PyObject* world_setstate(python::tuple const & args,
+                           python::dictionary const & keywords);
+}
+
+BOOST_PYTHON_MODULE_INIT(pickle3)
+{
+  try
+  {
+    // Create an object representing this extension module.
+    python::module_builder this_module("pickle3");
+
+    // Create the Python type object for our extension class.
+    python::class_builder<world> world_class(this_module, "world");
+
+    // Add the __init__ function.
+    world_class.def(python::constructor<std::string>());
+    // Add a regular member function.
+    world_class.def(&world::greet, "greet");
+    world_class.def(&world::get_secret_number, "get_secret_number");
+    world_class.def(&world::set_secret_number, "set_secret_number");
+
+    // Support for pickle.
+    world_class.def(world_getinitargs, "__getinitargs__");
+    world_class.def_raw(world_getstate, "__getstate__");
+    world_class.def_raw(world_setstate, "__setstate__");
+    world_class.getstate_manages_dict();
+  }
+  catch(...)
+  {
+    python::handle_exception(); // Deal with the exception for Python
+  }
+}
+
+namespace {
+
+  using BOOST_PYTHON_CONVERSION::from_python;
+  using boost::python::type;
+  using boost::python::ref;
+  using boost::python::tuple;
+  using boost::python::list;
+  using boost::python::dictionary;
+  using boost::python::getattr;
+
+  ref world_getstate(tuple const & args, dictionary const & keywords)
+  {
+      if(args.size() != 1 || keywords.size() != 0) {
+          PyErr_SetString(PyExc_TypeError, "wrong number of arguments");
+          throw boost::python::argument_error();
+      }
+      const world& w = from_python(args[0].get(), type<const world&>());
+      ref mydict = getattr(args[0], "__dict__");
+      tuple result(2);
+      // store the object's __dict__
+      result.set_item(0, mydict);
+      // store the internal state of the C++ object
+      result.set_item(1, w.get_secret_number());
+      return result.reference(); // returning the reference avoids the copying.
+  }
+
+  PyObject* world_setstate(tuple const & args, dictionary const & keywords)
+  {
+      if(args.size() != 2 || keywords.size() != 0) {
+          PyErr_SetString(PyExc_TypeError, "wrong number of arguments");
+          throw boost::python::argument_error();
+      }
+      world& w = from_python(args[0].get(), type<world&>());
+      ref mydict = getattr(args[0], "__dict__");
+      tuple state = from_python(args[1].get(), type<tuple>());
+      if (state.size() != 2) {
+        PyErr_SetString(PyExc_ValueError,
+          "Unexpected argument in call to __setstate__.");
+        throw python::error_already_set();
+      }
+      // restore the object's __dict__
+      dictionary odict = from_python(mydict.get(), type<dictionary>());
+      const dictionary& pdict = from_python(state[0].get(), type<const dictionary&>());
+      list pkeys(pdict.keys());
+      for (int i = 0; i < pkeys.size(); i++) {
+        ref k(pkeys[i]);
+        //odict[k] = pdict[k]; // XXX memory leak!
+        odict[k] = pdict.get_item(k); // this does not leak.
+      }
+      // restore the internal state of the C++ object
+      int number = from_python(state[1].get(), type<int>());
+      if (number != 42)
+        w.set_secret_number(number);
+      return python::detail::none();
+  }
+}

example/simple_vector.cpp

@@ -0,0 +1,101 @@
+#include <boost/python/class_builder.hpp>
+namespace python = boost::python;
+
+namespace { // Avoid cluttering the global namespace.
+
+  // A wrapper is used to define additional constructors.
+  //
+  struct vector_double_wrapper: std::vector<double>
+  {
+    // Tell the compiler how to convert a base class object to
+    // this wrapper object.
+    vector_double_wrapper(PyObject*, const std::vector<double>& vd)
+      : std::vector<double>(vd) {}
+
+    vector_double_wrapper(PyObject* self)
+      : std::vector<double>() {}
+
+    vector_double_wrapper(PyObject* self, int n)
+      : std::vector<double>(n) {}
+
+    vector_double_wrapper(PyObject* self, python::tuple tuple)
+      : std::vector<double>(tuple.size())
+    {
+      std::vector<double>::iterator vd = begin();
+      for (int i = 0; i < tuple.size(); i++)
+        vd[i] = BOOST_PYTHON_CONVERSION::from_python(tuple[i].get(),
+          python::type<double>());
+    }
+  };
+
+  double getitem(const std::vector<double>& vd, std::size_t key) {
+    return vd[key];
+  }
+
+  void setitem(std::vector<double>& vd, std::size_t key, double d) {
+    std::vector<double>::iterator vditer = vd.begin();
+    vditer[key] = d;
+  }
+
+  void delitem(std::vector<double>& vd, std::size_t key) {
+    std::vector<double>::iterator vditer = vd.begin();
+    vd.erase(&vditer[key]);
+  }
+
+  // Convert vector_double to a regular Python tuple.
+  //
+  python::tuple as_tuple(const std::vector<double>& vd)
+  {
+    python::tuple t(vd.size());
+    for (int i = 0; i < vd.size(); i++) t.set_item(i,
+      python::ref(BOOST_PYTHON_CONVERSION::to_python(vd[i])));
+    return t;
+  }
+
+  // Function returning a vector_double object to Python.
+  //
+  std::vector<double> foo(int n)
+  {
+    std::vector<double> vd(n);
+    std::vector<double>::iterator vditer = vd.begin();
+    for (int i = 0; i < n; i++) vditer[i] = double(i);
+    return vd;
+  }
+
+  // Same as foo(), but avoid copying on return.
+  //
+  std::auto_ptr<std::vector<double> > bar(int n)
+  {
+    std::auto_ptr<std::vector<double> > vdptr(new std::vector<double>(n));
+    std::vector<double>::iterator vditer = vdptr->begin();
+    for (int i = 0; i < n; i++) vditer[i] = double(10 * i);
+    return vdptr;
+  }
+}
+
+BOOST_PYTHON_MODULE_INIT(simple_vector)
+{
+  try
+  {
+    python::module_builder this_module("simple_vector");
+
+    python::class_builder<std::vector<double>, vector_double_wrapper>
+      vector_double(this_module, "vector_double");
+
+    vector_double.def(python::constructor<>());
+    vector_double.def(python::constructor<const int>());
+    vector_double.def(python::constructor<python::tuple>());
+    vector_double.def(&std::vector<double>::size, "__len__");
+    vector_double.def(getitem, "__getitem__");
+    vector_double.def(setitem, "__setitem__");
+    vector_double.def(delitem, "__delitem__");
+    vector_double.def(as_tuple, "as_tuple");
+
+    this_module.def(foo, "foo");
+    this_module.def(bar, "bar");
+  }
+  catch(...)
+  {
+    python::handle_exception(); // Deal with the exception for Python
+  }
+}

example/swap_iv_dv.sh

@@ -0,0 +1 @@
+sed 's/iv/xv/g' $1 | sed 's/dv/iv/g' | sed 's/xv/dv/g'

example/test_do_it_yourself_converters.py

@@ -0,0 +1,22 @@
+r'''>>> import do_it_yourself_converters
+    >>> ixset = do_it_yourself_converters.IndexingSet()
+    >>> ixset.add((1,2,3))
+    >>> ixset.add((4,5,6))
+    >>> ixset.add((7,8,9))
+    >>> print ixset.get(0)
+    (1, 2, 3)
+    >>> print ixset.get(1)
+    (4, 5, 6)
+    >>> print ixset.get(2)
+    (7, 8, 9)
+'''
+
+def run(args = None):
+    if args is not None:
+        import sys
+        sys.argv = args
+    import doctest, test_do_it_yourself_converters
+    doctest.testmod(test_do_it_yourself_converters)
+
+if __name__ == '__main__':
+    run()

example/test_pickle1.py

@@ -0,0 +1,31 @@
+r'''>>> import pickle1
+    >>> import re
+    >>> import pickle
+    >>> pickle1.world.__module__
+    'pickle1'
+    >>> pickle1.world.__safe_for_unpickling__
+    1
+    >>> pickle1.world.__reduce__()
+    'world'
+    >>> assert re.match(
+    ... "\(<extension class pickle1.world at [0-9a-fA-FxX]+>, \('Hello',\)\)",
+    ... repr(pickle1.world('Hello').__reduce__()))
+    >>>
+    >>> wd = pickle1.world('California')
+    >>> pstr = pickle.dumps(wd)
+    >>> wl = pickle.loads(pstr)
+    >>> print wd.greet()
+    Hello from California!
+    >>> print wl.greet()
+    Hello from California!
+'''
+
+def run(args = None):
+    if args is not None:
+        import sys
+        sys.argv = args
+    import doctest, test_pickle1
+    doctest.testmod(test_pickle1)
+
+if __name__ == '__main__':
+    run()

example/test_pickle2.py

@@ -0,0 +1,45 @@
+r'''>>> import pickle2
+    >>> import re
+    >>> import pickle
+    >>> pickle2.world.__module__
+    'pickle2'
+    >>> pickle2.world.__safe_for_unpickling__
+    1
+    >>> pickle2.world.__reduce__()
+    'world'
+    >>> assert re.match(
+    ... "\(<extension class pickle2.world at [0-9a-fA-FxX]+>, \('Hello',\), \(0,\)\)",
+    ... repr(pickle2.world('Hello').__reduce__()))
+    >>>
+    >>> for number in (24, 42):
+    ...   wd = pickle2.world('California')
+    ...   wd.set_secret_number(number)
+    ...   pstr = pickle.dumps(wd)
+    ...   wl = pickle.loads(pstr)
+    ...   print wd.greet(), wd.get_secret_number()
+    ...   print wl.greet(), wl.get_secret_number()
+    Hello from California! 24
+    Hello from California! 24
+    Hello from California! 42
+    Hello from California! 0
+
+# Now show that the __dict__ is not taken care of.
+    >>> wd = pickle2.world('California')
+    >>> wd.x = 1
+    >>> wd.__dict__
+    {'x': 1}
+    >>> try: pstr = pickle.dumps(wd)
+    ... except RuntimeError, err: print err[0]
+    ...
+    Incomplete pickle support (__getstate_manages_dict__ not set)
+'''
+
+def run(args = None):
+    if args is not None:
+        import sys
+        sys.argv = args
+    import doctest, test_pickle2
+    doctest.testmod(test_pickle2)
+
+if __name__ == '__main__':
+    run()

example/test_pickle3.py

@@ -0,0 +1,38 @@
+r'''>>> import pickle3
+    >>> import re
+    >>> import pickle
+    >>> pickle3.world.__module__
+    'pickle3'
+    >>> pickle3.world.__safe_for_unpickling__
+    1
+    >>> pickle3.world.__reduce__()
+    'world'
+    >>> assert re.match(
+    ... "\(<extension class pickle3.world at [0-9a-fA-FxX]+>, \('Hello',\), \(\{\}, 0\)\)",
+    ... repr(pickle3.world('Hello').__reduce__()))
+    >>>
+    >>> for number in (24, 42):
+    ...   wd = pickle3.world('California')
+    ...   wd.set_secret_number(number)
+    ...   wd.x = 2 * number
+    ...   wd.y = 'y' * number
+    ...   wd.z = 3. * number
+    ...   pstr = pickle.dumps(wd)
+    ...   wl = pickle.loads(pstr)
+    ...   print wd.greet(), wd.get_secret_number(), wd.__dict__
+    ...   print wl.greet(), wl.get_secret_number(), wl.__dict__
+    Hello from California! 24 {'z': 72.0, 'x': 48, 'y': 'yyyyyyyyyyyyyyyyyyyyyyyy'}
+    Hello from California! 24 {'z': 72.0, 'x': 48, 'y': 'yyyyyyyyyyyyyyyyyyyyyyyy'}
+    Hello from California! 42 {'z': 126.0, 'x': 84, 'y': 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'}
+    Hello from California! 0 {'z': 126.0, 'x': 84, 'y': 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'}
+'''
+
+def run(args = None):
+    if args is not None:
+        import sys
+        sys.argv = args
+    import doctest, test_pickle3
+    doctest.testmod(test_pickle3)
+
+if __name__ == '__main__':
+    run()

example/test_simple_vector.py

@@ -0,0 +1,35 @@
+r'''>>> import simple_vector
+    >>> v=simple_vector.vector_double()
+    >>> print v.as_tuple()
+    ()
+    >>> v=simple_vector.vector_double(5)
+    >>> print v.as_tuple()
+    (0.0, 0.0, 0.0, 0.0, 0.0)
+    >>> print len(v)
+    5
+    >>> v=simple_vector.vector_double((3,4,5))
+    >>> print v.as_tuple()
+    (3.0, 4.0, 5.0)
+    >>> print v[1]
+    4.0
+    >>> v[1] = 40
+    >>> print v.as_tuple()
+    (3.0, 40.0, 5.0)
+    >>> del v[1]
+    >>> print v.as_tuple()
+    (3.0, 5.0)
+    >>> print simple_vector.foo(11).as_tuple()
+    (0.0, 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0)
+    >>> print simple_vector.bar(12).as_tuple()
+    (0.0, 10.0, 20.0, 30.0, 40.0, 50.0, 60.0, 70.0, 80.0, 90.0, 100.0, 110.0)
+'''
+
+def run(args = None):
+    if args is not None:
+        import sys
+        sys.argv = args
+    import doctest, test_simple_vector
+    doctest.testmod(test_simple_vector)
+
+if __name__ == '__main__':
+    run()

example/tst_dvect1.py

@@ -0,0 +1,23 @@
+def f():
+  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.const_ivect_reference_as_tuple(iv)
+  aiv = dvect.ivect_as_auto_ptr(iv)
+  print dvect.const_ivect_reference_as_tuple(aiv)
+  siv = dvect.ivect_as_shared_ptr(iv)
+  print dvect.const_ivect_reference_as_tuple(siv)
+  print aiv.as_tuple()
+  print siv.as_tuple()
+
+if (__name__ == "__main__"):
+  import sys, string
+  n = 1
+  if (len(sys.argv) > 1): n = string.atoi(sys.argv[1])
+  for i in xrange(n):
+    f()

example/tst_dvect2.py

@@ -0,0 +1,98 @@
+def f(broken_auto_ptr):
+  import dvect
+  import ivect
+  #
+  dv = dvect.dvect((1,2,3,4,5))
+  iv = dv.as_ivect()
+  #
+  aiv = dvect.ivect_as_auto_ptr(iv)
+  print '1. auto_ptr_value_ivect_as_tuple'
+  print ivect.auto_ptr_value_ivect_as_tuple(aiv)
+  print '2. auto_ptr_value_ivect_as_tuple'
+  if (not broken_auto_ptr):
+    print ivect.auto_ptr_value_ivect_as_tuple(aiv)
+  else:
+    print None
+  #
+  adv = dvect.dvect_as_auto_ptr(dv)
+  print '1. auto_ptr_value_dvect_as_tuple'
+  print ivect.auto_ptr_value_dvect_as_tuple(adv)
+  print '2. auto_ptr_value_dvect_as_tuple'
+  if (not broken_auto_ptr):
+    print ivect.auto_ptr_value_dvect_as_tuple(adv)
+  else:
+    print None
+  #
+  siv = dvect.ivect_as_shared_ptr(iv)
+  print '1. shared_ptr_value_ivect_as_tuple'
+  print ivect.shared_ptr_value_ivect_as_tuple(siv)
+  print '2. shared_ptr_value_ivect_as_tuple'
+  print ivect.shared_ptr_value_ivect_as_tuple(siv)
+  #
+  sdv = dvect.dvect_as_shared_ptr(dv)
+  print '1. shared_ptr_value_dvect_as_tuple'
+  print ivect.shared_ptr_value_dvect_as_tuple(sdv)
+  print '2. shared_ptr_value_dvect_as_tuple'
+  print ivect.shared_ptr_value_dvect_as_tuple(sdv)
+  #
+  aiv = dvect.ivect_as_auto_ptr(iv)
+  print '1. auto_ptr_reference_ivect_as_tuple'
+  print ivect.auto_ptr_reference_ivect_as_tuple(aiv)
+  print '2. auto_ptr_reference_ivect_as_tuple'
+  print ivect.auto_ptr_reference_ivect_as_tuple(aiv)
+  #
+  adv = dvect.dvect_as_auto_ptr(dv)
+  print '1. auto_ptr_reference_dvect_as_tuple'
+  print ivect.auto_ptr_reference_dvect_as_tuple(adv)
+  print '2. auto_ptr_reference_dvect_as_tuple'
+  print ivect.auto_ptr_reference_dvect_as_tuple(adv)
+  #
+  siv = dvect.ivect_as_shared_ptr(iv)
+  print '1. shared_ptr_reference_ivect_as_tuple'
+  print ivect.shared_ptr_reference_ivect_as_tuple(siv)
+  print '2. shared_ptr_reference_ivect_as_tuple'
+  print ivect.shared_ptr_reference_ivect_as_tuple(siv)
+  #
+  sdv = dvect.dvect_as_shared_ptr(dv)
+  print '1. shared_ptr_reference_dvect_as_tuple'
+  print ivect.shared_ptr_reference_dvect_as_tuple(sdv)
+  print '2. shared_ptr_reference_dvect_as_tuple'
+  print ivect.shared_ptr_reference_dvect_as_tuple(sdv)
+  #
+  aiv = dvect.ivect_as_auto_ptr(iv)
+  print '1. auto_ptr_const_reference_ivect_as_tuple'
+  print ivect.auto_ptr_const_reference_ivect_as_tuple(aiv)
+  print '2. auto_ptr_const_reference_ivect_as_tuple'
+  print ivect.auto_ptr_const_reference_ivect_as_tuple(aiv)
+  #
+  adv = dvect.dvect_as_auto_ptr(dv)
+  print '1. auto_ptr_const_reference_dvect_as_tuple'
+  print ivect.auto_ptr_const_reference_dvect_as_tuple(adv)
+  print '2. auto_ptr_const_reference_dvect_as_tuple'
+  print ivect.auto_ptr_const_reference_dvect_as_tuple(adv)
+  #
+  siv = dvect.ivect_as_shared_ptr(iv)
+  print '1. shared_ptr_const_reference_ivect_as_tuple'
+  print ivect.shared_ptr_const_reference_ivect_as_tuple(siv)
+  print '2. shared_ptr_const_reference_ivect_as_tuple'
+  print ivect.shared_ptr_const_reference_ivect_as_tuple(siv)
+  #
+  sdv = dvect.dvect_as_shared_ptr(dv)
+  print '1. shared_ptr_const_reference_dvect_as_tuple'
+  print ivect.shared_ptr_const_reference_dvect_as_tuple(sdv)
+  print '2. shared_ptr_const_reference_dvect_as_tuple'
+  print ivect.shared_ptr_const_reference_dvect_as_tuple(sdv)
+
+if (__name__ == "__main__"):
+  import sys, string
+  broken_auto_ptr = 0
+  n = 1
+  if (len(sys.argv) > 1):
+    if (sys.argv[1] == "--broken-auto-ptr"):
+      broken_auto_ptr = 1
+      if (len(sys.argv) > 2):
+        n = string.atoi(sys.argv[2])
+    else:
+      n = string.atoi(sys.argv[1])
+  for i in xrange(n):
+    f(broken_auto_ptr)

example/tst_ivect1.py

@@ -0,0 +1,23 @@
+def f():
+  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.const_dvect_reference_as_tuple(dv)
+  adv = ivect.dvect_as_auto_ptr(dv)
+  print ivect.const_dvect_reference_as_tuple(adv)
+  sdv = ivect.dvect_as_shared_ptr(dv)
+  print ivect.const_dvect_reference_as_tuple(sdv)
+  print adv.as_tuple()
+  print sdv.as_tuple()
+
+if (__name__ == "__main__"):
+  import sys, string
+  n = 1
+  if (len(sys.argv) > 1): n = string.atoi(sys.argv[1])
+  for i in xrange(n):
+    f()

example/tst_ivect2.py

@@ -0,0 +1,98 @@
+def f(broken_auto_ptr):
+  import ivect
+  import dvect
+  #
+  iv = ivect.ivect((1,2,3,4,5))
+  dv = iv.as_dvect()
+  #
+  adv = ivect.dvect_as_auto_ptr(dv)
+  print '1. auto_ptr_value_dvect_as_tuple'
+  print dvect.auto_ptr_value_dvect_as_tuple(adv)
+  print '2. auto_ptr_value_dvect_as_tuple'
+  if (not broken_auto_ptr):
+    print dvect.auto_ptr_value_dvect_as_tuple(adv)
+  else:
+    print None
+  #
+  aiv = ivect.ivect_as_auto_ptr(iv)
+  print '1. auto_ptr_value_ivect_as_tuple'
+  print dvect.auto_ptr_value_ivect_as_tuple(aiv)
+  print '2. auto_ptr_value_ivect_as_tuple'
+  if (not broken_auto_ptr):
+    print dvect.auto_ptr_value_ivect_as_tuple(aiv)
+  else:
+    print None
+  #
+  sdv = ivect.dvect_as_shared_ptr(dv)
+  print '1. shared_ptr_value_dvect_as_tuple'
+  print dvect.shared_ptr_value_dvect_as_tuple(sdv)
+  print '2. shared_ptr_value_dvect_as_tuple'
+  print dvect.shared_ptr_value_dvect_as_tuple(sdv)
+  #
+  siv = ivect.ivect_as_shared_ptr(iv)
+  print '1. shared_ptr_value_ivect_as_tuple'
+  print dvect.shared_ptr_value_ivect_as_tuple(siv)
+  print '2. shared_ptr_value_ivect_as_tuple'
+  print dvect.shared_ptr_value_ivect_as_tuple(siv)
+  #
+  adv = ivect.dvect_as_auto_ptr(dv)
+  print '1. auto_ptr_reference_dvect_as_tuple'
+  print dvect.auto_ptr_reference_dvect_as_tuple(adv)
+  print '2. auto_ptr_reference_dvect_as_tuple'
+  print dvect.auto_ptr_reference_dvect_as_tuple(adv)
+  #
+  aiv = ivect.ivect_as_auto_ptr(iv)
+  print '1. auto_ptr_reference_ivect_as_tuple'
+  print dvect.auto_ptr_reference_ivect_as_tuple(aiv)
+  print '2. auto_ptr_reference_ivect_as_tuple'
+  print dvect.auto_ptr_reference_ivect_as_tuple(aiv)
+  #
+  sdv = ivect.dvect_as_shared_ptr(dv)
+  print '1. shared_ptr_reference_dvect_as_tuple'
+  print dvect.shared_ptr_reference_dvect_as_tuple(sdv)
+  print '2. shared_ptr_reference_dvect_as_tuple'
+  print dvect.shared_ptr_reference_dvect_as_tuple(sdv)
+  #
+  siv = ivect.ivect_as_shared_ptr(iv)
+  print '1. shared_ptr_reference_ivect_as_tuple'
+  print dvect.shared_ptr_reference_ivect_as_tuple(siv)
+  print '2. shared_ptr_reference_ivect_as_tuple'
+  print dvect.shared_ptr_reference_ivect_as_tuple(siv)
+  #
+  adv = ivect.dvect_as_auto_ptr(dv)
+  print '1. auto_ptr_const_reference_dvect_as_tuple'
+  print dvect.auto_ptr_const_reference_dvect_as_tuple(adv)
+  print '2. auto_ptr_const_reference_dvect_as_tuple'
+  print dvect.auto_ptr_const_reference_dvect_as_tuple(adv)
+  #
+  aiv = ivect.ivect_as_auto_ptr(iv)
+  print '1. auto_ptr_const_reference_ivect_as_tuple'
+  print dvect.auto_ptr_const_reference_ivect_as_tuple(aiv)
+  print '2. auto_ptr_const_reference_ivect_as_tuple'
+  print dvect.auto_ptr_const_reference_ivect_as_tuple(aiv)
+  #
+  sdv = ivect.dvect_as_shared_ptr(dv)
+  print '1. shared_ptr_const_reference_dvect_as_tuple'
+  print dvect.shared_ptr_const_reference_dvect_as_tuple(sdv)
+  print '2. shared_ptr_const_reference_dvect_as_tuple'
+  print dvect.shared_ptr_const_reference_dvect_as_tuple(sdv)
+  #
+  siv = ivect.ivect_as_shared_ptr(iv)
+  print '1. shared_ptr_const_reference_ivect_as_tuple'
+  print dvect.shared_ptr_const_reference_ivect_as_tuple(siv)
+  print '2. shared_ptr_const_reference_ivect_as_tuple'
+  print dvect.shared_ptr_const_reference_ivect_as_tuple(siv)
+
+if (__name__ == "__main__"):
+  import sys, string
+  broken_auto_ptr = 0
+  n = 1
+  if (len(sys.argv) > 1):
+    if (sys.argv[1] == "--broken-auto-ptr"):
+      broken_auto_ptr = 1
+      if (len(sys.argv) > 2):
+        n = string.atoi(sys.argv[2])
+    else:
+      n = string.atoi(sys.argv[1])
+  for i in xrange(n):
+    f(broken_auto_ptr)

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/cross_module.hpp

@@ -0,0 +1,322 @@
+/* (C) Copyright Ralf W. Grosse-Kunstleve 2001. 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.
+
+   Revision History:
+     17 Apr 01 merged into boost CVS trunk (Ralf W. Grosse-Kunstleve)
+*/
+
+/* Implementation of Boost.Python cross-module support.
+   See root/libs/python/doc/cross_module.html for details.
+*/
+
+#ifndef CROSS_MODULE_HPP
+# define CROSS_MODULE_HPP
+
+# include <boost/python/class_builder.hpp>
+
+namespace boost { namespace python {
+    struct import_error : error_already_set {};
+    struct export_error : error_already_set {};
+}}
+
+namespace boost { namespace python { namespace detail {
+
+// Concept: throw exception if api_major is changed
+//          show warning on stderr if api_minor is changed
+const int export_converters_api_major = 4;
+const int export_converters_api_minor = 1;
+extern const char* converters_attribute_name;
+void* import_converter_object(const std::string& module_name,
+                              const std::string& py_class_name,
+                              const std::string& attribute_name);
+void check_export_converters_api(const int importing_major,
+                                 const int importing_minor,
+                                 const int imported_major,
+                                 const int imported_minor);
+
+}}}
+
+// forward declaration
+namespace boost { namespace python { namespace detail {
+template <class T> class import_extension_class;
+}}}
+
+BOOST_PYTHON_BEGIN_CONVERSION_NAMESPACE
+
+/* This class template is instantiated by import_converters<T>.
+   This class is a look-alike of class python_extension_class_converters.
+   The converters in this class are wrappers that call converters
+   imported from another module.
+   To ensure that the dynamic loader resolves all symbols in the
+   intended way, the signature of all friend functions is changed with
+   respect to the original functions in class
+   python_extension_class_converters by adding an arbitrary additional
+   parameter with a default value, in this case "bool sig = false".
+   See also: comments for class export_converter_object_base below.
+ */
+template <class T>
+class python_import_extension_class_converters
+{
+ public:
+
+    friend python_import_extension_class_converters py_extension_class_converters(boost::python::type<T>, bool sig = false) {
+        return python_import_extension_class_converters();
+    }
+
+    PyObject* to_python(const T& x) const {
+        return boost::python::detail::import_extension_class<T>::get_converters()->to_python(x);
+    }
+
+    friend T* from_python(PyObject* p, boost::python::type<T*> t, bool sig = false) {
+        return boost::python::detail::import_extension_class<T>::get_converters()->from_python_Ts(p, t);
+    }
+    friend const T* from_python(PyObject* p, boost::python::type<const T*> t, bool sig = false) {
+        return boost::python::detail::import_extension_class<T>::get_converters()->from_python_cTs(p, t);
+    }
+    friend const T* from_python(PyObject* p, boost::python::type<const T*const&> t, bool sig = false) {
+        return boost::python::detail::import_extension_class<T>::get_converters()->from_python_cTscr(p, t);
+    }
+    friend T* from_python(PyObject* p, boost::python::type<T* const&> t, bool sig = false) {
+        return boost::python::detail::import_extension_class<T>::get_converters()->from_python_Tscr(p, t);
+    }
+    friend T& from_python(PyObject* p, boost::python::type<T&> t, bool sig = false) {
+        return boost::python::detail::import_extension_class<T>::get_converters()->from_python_Tr(p, t);
+    }
+    friend const T& from_python(PyObject* p, boost::python::type<const T&> t, bool sig = false) {
+        return boost::python::detail::import_extension_class<T>::get_converters()->from_python_cTr(p, t);
+    }
+    friend const T& from_python(PyObject* p, boost::python::type<T> t, bool sig = false) {
+        return boost::python::detail::import_extension_class<T>::get_converters()->from_python_T(p, t);
+    }
+
+    friend std::auto_ptr<T>& from_python(PyObject* p, boost::python::type<std::auto_ptr<T>&> t, bool sig = false) {
+        return boost::python::detail::import_extension_class<T>::get_converters()->from_python_aTr(p, t);
+    }
+    friend std::auto_ptr<T> from_python(PyObject* p, boost::python::type<std::auto_ptr<T> > t, bool sig = false) {
+        return boost::python::detail::import_extension_class<T>::get_converters()->from_python_aT(p, t);
+    }
+    friend const std::auto_ptr<T>& from_python(PyObject* p, boost::python::type<const std::auto_ptr<T>&> t, bool sig = false) {
+        return boost::python::detail::import_extension_class<T>::get_converters()->from_python_caTr(p, t);
+    }
+    friend PyObject* to_python(std::auto_ptr<T> x, bool sig = false) {
+        return boost::python::detail::import_extension_class<T>::get_converters()->to_python(x);
+    }
+
+    friend boost::shared_ptr<T>& from_python(PyObject* p, boost::python::type<boost::shared_ptr<T>&> t, bool sig = false) {
+        return boost::python::detail::import_extension_class<T>::get_converters()->from_python_sTr(p, t);
+    }
+    friend const boost::shared_ptr<T>& from_python(PyObject* p, boost::python::type<boost::shared_ptr<T> > t, bool sig = false) {
+        return boost::python::detail::import_extension_class<T>::get_converters()->from_python_sT(p, t);
+    }
+    friend const boost::shared_ptr<T>& from_python(PyObject* p, boost::python::type<const boost::shared_ptr<T>&> t, bool sig = false) {
+        return boost::python::detail::import_extension_class<T>::get_converters()->from_python_csTr(p, t);
+    }
+    friend PyObject* to_python(boost::shared_ptr<T> x, bool sig = false) {
+        return boost::python::detail::import_extension_class<T>::get_converters()->to_python(x);
+    }
+};
+
+BOOST_PYTHON_END_CONVERSION_NAMESPACE
+
+namespace boost { namespace python {
+
+BOOST_PYTHON_IMPORT_CONVERSION(python_import_extension_class_converters);
+
+/* This class template is instantiated by export_converters().
+   A pointer to this class is exported/imported via the Python API.
+   Using the Python API ensures maximum portability.
+   All member functions are virtual. This is, what we export/import
+   is essentially just a pointer to a vtbl.
+   To work around a deficiency of Visual C++ 6.0, the name of each
+   from_python() member functions is made unique by appending a few
+   characters (derived in a ad-hoc manner from the corresponding type).
+ */
+template <class T>
+struct export_converter_object_base
+{
+    virtual int get_api_major() const { return detail::export_converters_api_major; }
+    virtual int get_api_minor() const { return detail::export_converters_api_minor; }
+
+    virtual PyObject* to_python(const T& x) = 0;
+
+    virtual T* from_python_Ts(PyObject* p, boost::python::type<T*> t) = 0;
+    virtual const T* from_python_cTs(PyObject* p, boost::python::type<const T*> t) = 0;
+    virtual const T* from_python_cTscr(PyObject* p, boost::python::type<const T*const&> t) = 0;
+    virtual T* from_python_Tscr(PyObject* p, boost::python::type<T* const&> t) = 0;
+    virtual T& from_python_Tr(PyObject* p, boost::python::type<T&> t) = 0;
+    virtual const T& from_python_cTr(PyObject* p, boost::python::type<const T&> t) = 0;
+    virtual const T& from_python_T(PyObject* p, boost::python::type<T> t) = 0;
+
+    virtual std::auto_ptr<T>& from_python_aTr(PyObject* p, boost::python::type<std::auto_ptr<T>&> t) = 0;
+    virtual std::auto_ptr<T> from_python_aT(PyObject* p, boost::python::type<std::auto_ptr<T> > t) = 0;
+    virtual const std::auto_ptr<T>& from_python_caTr(PyObject* p, boost::python::type<const std::auto_ptr<T>&> t) = 0;
+    virtual PyObject* to_python(std::auto_ptr<T> x) = 0;
+
+    virtual boost::shared_ptr<T>& from_python_sTr(PyObject* p, boost::python::type<boost::shared_ptr<T>&> t) = 0;
+    virtual const boost::shared_ptr<T>& from_python_sT(PyObject* p, boost::python::type<boost::shared_ptr<T> > t) = 0;
+    virtual const boost::shared_ptr<T>& from_python_csTr(PyObject* p, boost::python::type<const boost::shared_ptr<T>&> t) = 0;
+    virtual PyObject* to_python(boost::shared_ptr<T> x) = 0;
+};
+
+// Converters to be used if T is not copyable.
+template <class T>
+struct export_converter_object_noncopyable : export_converter_object_base<T>
+{
+    virtual PyObject* to_python(const T& x) {
+        PyErr_SetString(PyExc_RuntimeError,
+          "to_python(const T&) converter not exported");
+        throw import_error();
+    }
+
+    virtual T* from_python_Ts(PyObject* p, boost::python::type<T*> t) {
+        return BOOST_PYTHON_CONVERSION::from_python(p, t);
+    }
+    virtual const T* from_python_cTs(PyObject* p, boost::python::type<const T*> t) {
+        return BOOST_PYTHON_CONVERSION::from_python(p, t);
+    }
+    virtual const T* from_python_cTscr(PyObject* p, boost::python::type<const T*const&> t) {
+        return BOOST_PYTHON_CONVERSION::from_python(p, t);
+    }
+    virtual T* from_python_Tscr(PyObject* p, boost::python::type<T* const&> t) {
+        return BOOST_PYTHON_CONVERSION::from_python(p, t);
+    }
+    virtual T& from_python_Tr(PyObject* p, boost::python::type<T&> t) {
+        return BOOST_PYTHON_CONVERSION::from_python(p, t);
+    }
+    virtual const T& from_python_cTr(PyObject* p, boost::python::type<const T&> t) {
+        return BOOST_PYTHON_CONVERSION::from_python(p, t);
+    }
+    virtual const T& from_python_T(PyObject* p, boost::python::type<T> t) {
+        return BOOST_PYTHON_CONVERSION::from_python(p, t);
+    }
+
+    virtual std::auto_ptr<T>& from_python_aTr(PyObject* p, boost::python::type<std::auto_ptr<T>&> t) {
+        return BOOST_PYTHON_CONVERSION::from_python(p, t);
+    }
+    virtual std::auto_ptr<T> from_python_aT(PyObject* p, boost::python::type<std::auto_ptr<T> > t) {
+        return BOOST_PYTHON_CONVERSION::from_python(p, t);
+    }
+    virtual const std::auto_ptr<T>& from_python_caTr(PyObject* p, boost::python::type<const std::auto_ptr<T>&> t) {
+        return BOOST_PYTHON_CONVERSION::from_python(p, t);
+    }
+    virtual PyObject* to_python(std::auto_ptr<T> x) {
+        return BOOST_PYTHON_CONVERSION::to_python(x);
+    }
+
+    virtual boost::shared_ptr<T>& from_python_sTr(PyObject* p, boost::python::type<boost::shared_ptr<T>&> t) {
+        return BOOST_PYTHON_CONVERSION::from_python(p, t);
+    }
+    virtual const boost::shared_ptr<T>& from_python_sT(PyObject* p, boost::python::type<boost::shared_ptr<T> > t) {
+        return BOOST_PYTHON_CONVERSION::from_python(p, t);
+    }
+    virtual const boost::shared_ptr<T>& from_python_csTr(PyObject* p, boost::python::type<const boost::shared_ptr<T>&> t) {
+        return BOOST_PYTHON_CONVERSION::from_python(p, t);
+    }
+    virtual PyObject* to_python(boost::shared_ptr<T> x) {
+        return BOOST_PYTHON_CONVERSION::to_python(x);
+    }
+};
+
+// The addditional to_python() converter that can be used if T is copyable.
+template <class T>
+struct export_converter_object : export_converter_object_noncopyable<T>
+{
+    virtual PyObject* to_python(const T& x) {
+        return BOOST_PYTHON_CONVERSION::py_extension_class_converters(boost::python::type<T>()).to_python(x);
+    }
+};
+
+namespace detail {
+
+/* This class template is instantiated by import_converters<T>.
+   Its purpose is to import the converter_object via the Python API.
+   The actual import is only done once. The pointer to the
+   imported converter object is kept in the static data member
+   imported_converters.
+ */
+template <class T>
+class import_extension_class
+    : public python_import_extension_class_converters<T>
+{
+ public:
+    inline import_extension_class(const char* module, const char* py_class) {
+      m_module = module;
+      m_py_class = py_class;
+    }
+
+    static boost::python::export_converter_object_base<T>* get_converters();
+
+  private:
+    static std::string m_module;
+    static std::string m_py_class;
+    static boost::python::export_converter_object_base<T>* imported_converters;
+};
+
+template <class T> std::string import_extension_class<T>::m_module;
+template <class T> std::string import_extension_class<T>::m_py_class;
+template <class T>
+boost::python::export_converter_object_base<T>*
+import_extension_class<T>::imported_converters = 0;
+
+template <class T>
+boost::python::export_converter_object_base<T>*
+import_extension_class<T>::get_converters() {
+  if (imported_converters == 0) {
+    void* cobject
+      = import_converter_object(m_module, m_py_class,
+                                converters_attribute_name);
+    imported_converters
+      = static_cast<boost::python::export_converter_object_base<T>*>(cobject);
+    check_export_converters_api(
+      export_converters_api_major,
+      export_converters_api_minor,
+      imported_converters->get_api_major(),
+      imported_converters->get_api_minor());
+  }
+  return imported_converters;
+}
+
+}}} // namespace boost::python::detail
+
+namespace boost { namespace python {
+
+// Implementation of export_converters().
+template <class T, class U>
+void export_converters(class_builder<T, U>& cb)
+{
+    static export_converter_object<T> export_cvts;
+    cb.add(
+      ref(PyCObject_FromVoidPtr(reinterpret_cast<void*>(&export_cvts), NULL)),
+      detail::converters_attribute_name);
+}
+
+// Implementation of export_converters_noncopyable().
+template <class T, class U>
+void export_converters_noncopyable(class_builder<T, U>& cb)
+{
+    static export_converter_object_noncopyable<T> export_cvts;
+    cb.add(
+      ref(PyCObject_FromVoidPtr(reinterpret_cast<void*>(&export_cvts), NULL)),
+      detail::converters_attribute_name);
+}
+
+// Implementation of import_converters<T>.
+template <class T>
+class import_converters
+    : python_import_extension_class_converters<T> // Works around MSVC6.x/GCC2.95.2 bug described
+                                                  // at the bottom of class_builder.hpp.
+{
+ public:
+    import_converters(const char* module, const char* py_class)
+        : m_class(new detail::import_extension_class<T>(module, py_class))
+    { }
+ private:
+    boost::shared_ptr<detail::import_extension_class<T> > m_class;
+};
+
+}} // namespace boost::python
+
+#endif // CROSS_MODULE_HPP

include/boost/python/detail/extension_class.hpp

@@ -0,0 +1,915 @@
+//  (C) Copyright David Abrahams 2000. 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.
+//
+//  The author gratefully acknowleges the support of Dragon Systems, Inc., in
+//  producing this work.
+//
+//  This file automatically generated for 10-argument constructors by
+//  gen_extclass.python
+
+//  Revision History:
+//  05 Mar 01  Fixed a bug which prevented auto_ptr values from being converted
+//             to_python (Dave Abrahams)
+
+#ifndef EXTENSION_CLASS_DWA052000_H_
+# define EXTENSION_CLASS_DWA052000_H_
+
+# include <boost/python/detail/config.hpp>
+# include <boost/python/classes.hpp>
+# include <vector>
+# include <boost/python/detail/none.hpp>
+# include <boost/python/objects.hpp>
+# include <boost/python/detail/functions.hpp>
+# include <memory>
+# include <boost/python/detail/init_function.hpp>
+# include <typeinfo>
+# include <boost/smart_ptr.hpp>
+# include <boost/type_traits.hpp>
+
+namespace boost { namespace python {
+
+// forward declarations
+template <long which, class operand> struct operators;
+template <class T> struct left_operand;
+template <class T> struct right_operand;
+
+enum without_downcast_t { without_downcast };
+
+namespace detail {
+
+// forward declarations
+class extension_instance;
+class extension_class_base;
+template <class T> class instance_holder;
+template <class T, class U> class instance_value_holder;
+template <class ref, class T> class instance_ptr_holder;
+template <class Specified> struct operand_select;
+  template <long> struct choose_op;
+  template <long> struct choose_rop;
+  template <long> struct choose_unary_op;
+  template <long> struct define_operator;
+
+meta_class<extension_instance>* extension_meta_class();
+extension_instance* get_extension_instance(PyObject* p);
+void report_missing_instance_data(extension_instance*, class_t<extension_instance>*, const std::type_info&);
+void report_missing_ptr_data(extension_instance*, class_t<extension_instance>*, const std::type_info&);
+void report_missing_class_object(const std::type_info&);
+void report_released_smart_pointer(const std::type_info&);
+    
+template <class T>
+T* check_non_null(T* p)
+{
+    if (p == 0)
+        report_released_smart_pointer(typeid(T));
+    return p;
+}
+
+template <class Held> class held_instance;
+
+typedef void* (*conversion_function_ptr)(void*);
+
+struct base_class_info
+{
+    base_class_info(extension_class_base* t, conversion_function_ptr f)
+        :class_object(t), convert(f)
+        {}
+    
+    extension_class_base* class_object;
+    conversion_function_ptr convert;
+};
+
+typedef base_class_info derived_class_info;
+
+struct add_operator_base;
+
+class extension_class_base : public class_t<extension_instance>
+{
+ public:
+    extension_class_base(const char* name);
+    
+ public:
+    // the purpose of try_class_conversions() and its related functions 
+    // is explained in extclass.cpp
+    void* try_class_conversions(instance_holder_base*) const;
+    void* try_base_class_conversions(instance_holder_base*) const;
+    void* try_derived_class_conversions(instance_holder_base*) const;
+
+    void set_attribute(const char* name, PyObject* x);
+    void set_attribute(const char* name, ref x);
+    
+ private:
+    virtual void* extract_object_from_holder(instance_holder_base* v) const = 0;
+    virtual std::vector<base_class_info> const& base_classes() const = 0;
+    virtual std::vector<derived_class_info> const& derived_classes() const = 0;
+
+ protected:
+    friend struct add_operator_base;
+    void add_method(reference<function> method, const char* name);
+    void add_method(function* method, const char* name);
+    
+    void add_constructor_object(function*);
+    void add_setter_method(function*, const char* name);
+    void add_getter_method(function*, const char* name);
+};
+
+template <class T>
+class class_registry
+{
+ public:
+    static extension_class_base* class_object()
+        { return static_class_object; }
+
+    // Register/unregister the Python class object corresponding to T
+    static void register_class(extension_class_base*);
+    static void unregister_class(extension_class_base*);
+
+    // Establish C++ inheritance relationships
+    static void register_base_class(base_class_info const&);
+    static void register_derived_class(derived_class_info const&);
+
+    // Query the C++ inheritance relationships
+    static std::vector<base_class_info> const& base_classes();
+    static std::vector<derived_class_info> const& derived_classes();
+ private:
+    static extension_class_base* static_class_object;
+    static std::vector<base_class_info> static_base_class_info;
+    static std::vector<derived_class_info> static_derived_class_info;
+};
+
+template <bool is_pointer>
+struct is_null_helper
+{
+    template <class Ptr>
+    static bool test(Ptr x) { return x == 0; }
+};
+
+template <>
+struct is_null_helper<false>
+{
+    template <class Ptr>
+    static bool test(const Ptr& x) { return x.get() == 0; }
+};
+
+template <class Ptr>
+bool is_null(const Ptr& x)
+{
+    return is_null_helper<(is_pointer<Ptr>::value)>::test(x);
+}
+
+}}} // namespace boost::python::detail
+
+BOOST_PYTHON_BEGIN_CONVERSION_NAMESPACE
+
+// This class' only job is to define from_python and to_python converters for T
+// and U. T is the class the user really intends to wrap. U is a class derived
+// from T with some virtual function overriding boilerplate, or if there are no
+// virtual functions, U = held_instance<T>.
+template <class T, class U = boost::python::detail::held_instance<T> >
+class python_extension_class_converters
+{
+ public:
+    // Get an object which can be used to convert T to/from python. This is used
+    // as a kind of concept check by the global template
+    //
+    //     PyObject* to_python(const T& x)
+    //
+    // below this class, to prevent the confusing messages that would otherwise
+    // pop up. Now, if T hasn't been wrapped as an extension class, the user
+    // will see an error message about the lack of an eligible
+    // py_extension_class_converters() function.
+    friend python_extension_class_converters py_extension_class_converters(boost::python::type<T>, bool sig = false)
+    { 
+        return python_extension_class_converters();
+    }
+
+    // This is a member function because in a conforming implementation, friend
+    // funcitons defined inline in the class body are all instantiated as soon
+    // as the enclosing class is instantiated. If T is not copyable, that causes
+    // a compiler error. Instead, we access this function through the global
+    // template 
+    //
+    //     PyObject* to_python(const T& x)
+    //
+    // defined below this class. Since template functions are instantiated only
+    // on demand, errors will be avoided unless T is noncopyable and the user
+    // writes code which causes us to try to copy a T.
+    PyObject* to_python(const T& x) const
+    {
+        boost::python::reference<boost::python::detail::extension_instance> result(create_instance());
+        result->add_implementation(
+            std::auto_ptr<boost::python::detail::instance_holder_base>(
+                new boost::python::detail::instance_value_holder<T,U>(result.get(), x)));
+        return result.release();
+    }
+
+    friend
+    T* non_null_from_python(PyObject* obj, boost::python::type<T*>)
+    {
+        // downcast to an extension_instance, then find the actual T
+        boost::python::detail::extension_instance* self = boost::python::detail::get_extension_instance(obj);
+        typedef std::vector<boost::python::detail::instance_holder_base*>::const_iterator iterator;
+        for (iterator p = self->wrapped_objects().begin();
+             p != self->wrapped_objects().end(); ++p)
+        {
+            boost::python::detail::instance_holder<T>* held = dynamic_cast<boost::python::detail::instance_holder<T>*>(*p);
+            if (held != 0)
+                return held->target();
+
+            // see extclass.cpp for an explanation of try_class_conversions()
+            void* target = boost::python::detail::class_registry<T>::class_object()->try_class_conversions(*p);
+            if(target) 
+                return static_cast<T*>(target);
+        }
+        boost::python::detail::report_missing_instance_data(self, boost::python::detail::class_registry<T>::class_object(), typeid(T));
+        throw boost::python::argument_error();
+    }
+
+    // Convert to T*
+    friend T* from_python(PyObject* obj, boost::python::type<T*>, bool sig = false)
+    {
+        if (obj == Py_None)
+            return 0;
+        else
+            return non_null_from_python(obj, boost::python::type<T*>());
+    }
+
+    // Extract from obj a mutable reference to the PtrType object which is holding a T.
+    template <class PtrType>
+    static PtrType& smart_ptr_reference(PyObject* obj, boost::python::type<PtrType>)
+    {
+        // downcast to an extension_instance, then find the actual T
+        boost::python::detail::extension_instance* self = boost::python::detail::get_extension_instance(obj);
+        typedef std::vector<boost::python::detail::instance_holder_base*>::const_iterator iterator;
+        for (iterator p = self->wrapped_objects().begin();
+             p != self->wrapped_objects().end(); ++p)
+        {
+            boost::python::detail::instance_ptr_holder<PtrType, T>* held =
+                dynamic_cast<boost::python::detail::instance_ptr_holder<PtrType, T>*>(*p);
+            if (held != 0)
+                return held->ptr();
+        }
+        boost::python::detail::report_missing_ptr_data(self, boost::python::detail::class_registry<T>::class_object(), typeid(T));
+        throw boost::python::argument_error();
+    }
+
+    // Extract from obj a reference to the PtrType object which is holding a
+    // T. If it weren't for auto_ptr, it would be a constant reference. Do not
+    // modify the referent except by copying an auto_ptr! If obj is None, the
+    // reference denotes a default-constructed PtrType
+    template <class PtrType>
+    static PtrType& smart_ptr_value(PyObject* obj, boost::python::type<PtrType>)
+    {
+        if (obj == Py_None)
+        {
+            static PtrType null_ptr;
+            return null_ptr;
+        }
+        return smart_ptr_reference(obj, boost::python::type<PtrType>());
+    }
+        
+    template <class PtrType>
+    static PyObject* smart_ptr_to_python(PtrType x)
+    {
+        if (boost::python::detail::is_null(x))
+        {
+            return boost::python::detail::none();
+        }
+        
+        boost::python::reference<boost::python::detail::extension_instance> result(create_instance());
+        result->add_implementation(
+            std::auto_ptr<boost::python::detail::instance_holder_base>(
+                new boost::python::detail::instance_ptr_holder<PtrType,T>(x)));
+        return result.release();
+    }
+
+    static boost::python::reference<boost::python::detail::extension_instance> create_instance()
+    {
+        PyTypeObject* class_object = boost::python::detail::class_registry<T>::class_object();
+        if (class_object == 0)
+            boost::python::detail::report_missing_class_object(typeid(T));
+            
+        return boost::python::reference<boost::python::detail::extension_instance>(
+            new boost::python::detail::extension_instance(class_object));
+    }
+
+    // Convert to const T*
+    friend const T* from_python(PyObject* p, boost::python::type<const T*>, bool sig = false)
+        { return from_python(p, boost::python::type<T*>()); }
+
+    // Convert to const T* const&
+    friend const T* from_python(PyObject* p, boost::python::type<const T*const&>, bool sig = false)
+         { return from_python(p, boost::python::type<const T*>()); }
+  
+    // Convert to T* const&
+    friend T* from_python(PyObject* p, boost::python::type<T* const&>, bool sig = false)
+         { return from_python(p, boost::python::type<T*>()); }
+ 
+    // Convert to T&
+    friend T& from_python(PyObject* p, boost::python::type<T&>, bool sig = false)
+        { return *boost::python::detail::check_non_null(non_null_from_python(p, boost::python::type<T*>())); }
+
+    // Convert to const T&
+    friend const T& from_python(PyObject* p, boost::python::type<const T&>, bool sig = false)
+        { return from_python(p, boost::python::type<T&>()); }
+
+    // Convert to T
+    friend const T& from_python(PyObject* p, boost::python::type<T>, bool sig = false)
+        { return from_python(p, boost::python::type<T&>()); }
+
+    friend std::auto_ptr<T>& from_python(PyObject* p, boost::python::type<std::auto_ptr<T>&>, bool sig = false)
+        { return smart_ptr_reference(p, boost::python::type<std::auto_ptr<T> >()); }
+    
+    friend std::auto_ptr<T> from_python(PyObject* p, boost::python::type<std::auto_ptr<T> >, bool sig = false)
+        { return smart_ptr_value(p, boost::python::type<std::auto_ptr<T> >()); }
+    
+    friend const std::auto_ptr<T>& from_python(PyObject* p, boost::python::type<const std::auto_ptr<T>&>, bool sig = false)
+        { return smart_ptr_value(p, boost::python::type<std::auto_ptr<T> >()); }
+
+    friend PyObject* to_python(std::auto_ptr<T> x, bool sig = false)
+        { return smart_ptr_to_python(x); }
+
+    friend boost::shared_ptr<T>& from_python(PyObject* p, boost::python::type<boost::shared_ptr<T>&>, bool sig = false)
+        { return smart_ptr_reference(p, boost::python::type<boost::shared_ptr<T> >()); }
+    
+    friend const boost::shared_ptr<T>& from_python(PyObject* p, boost::python::type<boost::shared_ptr<T> >, bool sig = false)
+        { return smart_ptr_value(p, boost::python::type<boost::shared_ptr<T> >()); }
+    
+    friend const boost::shared_ptr<T>& from_python(PyObject* p, boost::python::type<const boost::shared_ptr<T>&>, bool sig = false)
+        { return smart_ptr_value(p, boost::python::type<boost::shared_ptr<T> >()); }
+
+    friend PyObject* to_python(boost::shared_ptr<T> x, bool sig = false)
+        { return smart_ptr_to_python(x); }
+};
+
+// Convert T to_python, instantiated on demand and only if there isn't a
+// non-template overload for this function. This version is the one invoked when
+// T is a wrapped class. See the first 2 functions declared in
+// python_extension_class_converters above for more info.
+template <class T>
+PyObject* to_python(const T& x)
+{
+    return py_extension_class_converters(boost::python::type<T>()).to_python(x);
+}
+
+BOOST_PYTHON_END_CONVERSION_NAMESPACE
+
+namespace boost { namespace python {
+
+BOOST_PYTHON_IMPORT_CONVERSION(python_extension_class_converters);
+
+namespace detail {
+
+template <class T> class instance_holder;
+
+class read_only_setattr_function : public function
+{
+ public:
+    read_only_setattr_function(const char* name);
+    PyObject* do_call(PyObject* args, PyObject* keywords) const;
+    const char* description() const;
+ private:
+    string m_name;
+};
+
+  template <class From, class To>
+  struct define_conversion
+  {
+      static void* upcast_ptr(void* v)
+      {
+          return static_cast<To*>(static_cast<From*>(v));
+      }
+
+      static void* downcast_ptr(void* v)
+      {
+          return dynamic_cast<To*>(static_cast<From*>(v));
+      }
+  };
+
+// An easy way to make an extension base class which wraps T. Note that Python
+// subclasses of this class will simply be class_t<extension_instance> objects.
+//
+// U should be a class derived from T which overrides virtual functions with
+// boilerplate code to call back into Python. See extclass_demo.h for examples.
+// 
+// U is optional, but you won't be able to override any member functions in
+// Python which are called from C++ if you don't supply it. If you just want to
+// be able to use T in python without overriding member functions, you can omit
+// U.
+template <class T, class U = held_instance<T> >
+class extension_class
+    : public python_extension_class_converters<T, U>, // This generates the to_python/from_python functions
+      public extension_class_base
+{
+ public:
+    typedef T wrapped_type;
+    typedef U callback_type;
+    
+    // Construct with a name that comes from typeid(T).name(). The name only
+    // affects the objects of this class are represented through repr()
+    extension_class();
+    
+    // Construct with the given name. The name only affects the objects of this
+    // class are represented through repr()
+    extension_class(const char* name);
+    
+    ~extension_class();
+
+    // define constructors
+    template <class A1, class A2, class A3, class A4, class A5, class A6, class A7, class A8, class A9, class A10>
+    inline void def(constructor<A1, A2, A3, A4, A5, A6, A7, A8, A9, A10>)
+    // The following incantation builds a signature1, signature2,... object. It
+    // should _all_ get optimized away.
+    { add_constructor(
+        prepend(type<A1>::id(),
+        prepend(type<A2>::id(),
+        prepend(type<A3>::id(),
+        prepend(type<A4>::id(),
+        prepend(type<A5>::id(),
+        prepend(type<A6>::id(),
+        prepend(type<A7>::id(),
+        prepend(type<A8>::id(),
+        prepend(type<A9>::id(),
+        prepend(type<A10>::id(),
+                signature0())))))))))));
+    }
+
+
+    // export homogeneous operators (type of both lhs and rhs is 'operator')
+    // usage:  foo_class.def(boost::python::operators<(boost::python::op_add | boost::python::op_sub), Foo>());
+    
+    // export homogeneous operators (type of both lhs and rhs is 'T const&')
+    // usage:  foo_class.def(boost::python::operators<(boost::python::op_add | boost::python::op_sub)>());
+    template <long which, class Operand>
+    inline void def(operators<which,Operand>)
+    {
+        typedef typename operand_select<Operand>::template wrapped<T>::type true_operand;
+        def_operators(operators<which,true_operand>());
+    }
+
+    // export heterogeneous operators (type of lhs: 'left', of rhs: 'right')
+    // usage:  foo_class.def(boost::python::operators<(boost::python::op_add | boost::python::op_sub), Foo>(),
+    //                       boost::python::right_operand<int const&>());
+
+    // export heterogeneous operators (type of lhs: 'T const&', of rhs: 'right')
+    // usage:  foo_class.def(boost::python::operators<(boost::python::op_add | boost::python::op_sub)>(),
+    //                       boost::python::right_operand<int const&>());
+    template <long which, class Left, class Right>
+    inline void def(operators<which,Left>, right_operand<Right> r)
+    {
+        typedef typename operand_select<Left>::template wrapped<T>::type true_left;
+        def_operators(operators<which,true_left>(), r);
+    }
+
+    // export heterogeneous reverse-argument operators 
+    // (type of lhs: 'left', of rhs: 'right')
+    // usage:  foo_class.def(boost::python::operators<(boost::python::op_add | boost::python::op_sub), Foo>(),
+    //                       boost::python::left_operand<int const&>());
+    
+    // export heterogeneous reverse-argument operators 
+    // (type of lhs: 'left', of rhs: 'T const&')
+    // usage:  foo_class.def(boost::python::operators<(boost::python::op_add | boost::python::op_sub)>(),
+    //                       boost::python::left_operand<int const&>());
+    template <long which, class Left, class Right>
+    inline void def(operators<which,Right>, left_operand<Left> l)
+    {
+        typedef typename operand_select<Right>::template wrapped<T>::type true_right;
+        def_operators(operators<which,true_right>(), l);
+    }
+
+    // define a function that passes Python arguments and keywords
+    // to C++ verbatim (as a 'tuple const&' and 'dictionary const&' 
+    // respectively). This is useful for manual argument passing.
+    // It's also the only possibility to pass keyword arguments to C++.
+    // Fn must have a signatur that is compatible to 
+    //     PyObject* (*)(PyObject* aTuple, PyObject* aDictionary)
+    template <class Fn>
+    inline void def_raw(Fn fn, const char* name)
+    {
+        this->add_method(new_raw_arguments_function(fn), name);
+    }
+
+    // define member functions. In fact this works for free functions, too -
+    // they act like static member functions, or if they start with the
+    // appropriate self argument (as a pointer), they can be used just like
+    // ordinary member functions -- just like Python!
+    template <class Fn>
+    inline void def(Fn fn, const char* name)
+    {
+        this->add_method(new_wrapped_function(fn), name);
+    }
+
+    // Define a virtual member function with a default implementation.
+    // default_fn should be a function which provides the default implementation.
+    // Be careful that default_fn does not in fact call fn virtually!
+    template <class Fn, class DefaultFn>
+    inline void def(Fn fn, const char* name, DefaultFn default_fn)
+    {
+        this->add_method(new_virtual_function(type<T>(), fn, default_fn), name);
+    }
+
+    // Provide a function which implements x.<name>, reading from the given
+    // member (pm) of the T obj
+    template <class MemberType>
+    inline void def_getter(MemberType T::*pm, const char* name)
+    {
+        this->add_getter_method(new getter_function<T, MemberType>(pm), name);
+    }
+    
+    // Provide a function which implements assignment to x.<name>, writing to
+    // the given member (pm) of the T obj
+    template <class MemberType>
+    inline void def_setter(MemberType T::*pm, const char* name)
+    {
+        this->add_setter_method(new setter_function<T, MemberType>(pm), name);
+    }
+    
+    // Expose the given member (pm) of the T obj as a read-only attribute
+    template <class MemberType>
+    inline void def_readonly(MemberType T::*pm, const char* name)
+    {
+        this->add_setter_method(new read_only_setattr_function(name), name);
+        this->def_getter(pm, name);
+    }
+    
+    // Expose the given member (pm) of the T obj as a read/write attribute
+    template <class MemberType>
+    inline void def_read_write(MemberType T::*pm, const char* name)
+    {
+        this->def_getter(pm, name);
+        this->def_setter(pm, name);
+    }
+    
+    // define the standard coercion needed for operator overloading
+    void def_standard_coerce();
+
+    // declare the given class a base class of this one and register 
+    // up and down conversion functions
+    template <class S, class V>
+    void declare_base(extension_class<S, V>* base)
+    {
+        // see extclass.cpp for an explanation of why we need to register
+        // conversion functions
+        base_class_info baseInfo(base, 
+                            &define_conversion<S, T>::downcast_ptr);
+        class_registry<T>::register_base_class(baseInfo);
+        add_base(ref(as_object(base), ref::increment_count));
+        
+        derived_class_info derivedInfo(this, 
+                            &define_conversion<T, S>::upcast_ptr);
+        class_registry<S>::register_derived_class(derivedInfo);
+    }
+        
+    // declare the given class a base class of this one and register 
+    // only up conversion function
+    template <class S, class V>
+    void declare_base(extension_class<S, V>* base, without_downcast_t)
+    {
+        // see extclass.cpp for an explanation of why we need to register
+        // conversion functions
+        base_class_info baseInfo(base, 0);
+        class_registry<T>::register_base_class(baseInfo);
+        add_base(ref(as_object(base), ref::increment_count));
+        
+        derived_class_info derivedInfo(this, 
+                           &define_conversion<T, S>::upcast_ptr);
+        class_registry<S>::register_derived_class(derivedInfo);
+    }
+    
+ private: // types
+    typedef instance_value_holder<T,U> holder;
+
+ private: // extension_class_base virtual function implementations
+    std::vector<base_class_info> const& base_classes() const;
+    std::vector<derived_class_info> const& derived_classes() const;
+    void* extract_object_from_holder(instance_holder_base* v) const;
+
+ private: // Utility functions
+    template <long which, class Operand>
+    inline void def_operators(operators<which,Operand>)
+    {
+        def_standard_coerce();
+
+        // for some strange reason, this prevents MSVC from having an
+        // "unrecoverable block scoping error"!
+        typedef choose_op<(which & op_add)> choose_add;
+
+        choose_op<(which & op_add)>::template args<Operand>::add(this);
+        choose_op<(which & op_sub)>::template args<Operand>::add(this);
+        choose_op<(which & op_mul)>::template args<Operand>::add(this);
+        choose_op<(which & op_div)>::template args<Operand>::add(this);
+        choose_op<(which & op_mod)>::template args<Operand>::add(this);
+        choose_op<(which & op_divmod)>::template args<Operand>::add(this);
+        choose_op<(which & op_pow)>::template args<Operand>::add(this);
+        choose_op<(which & op_lshift)>::template args<Operand>::add(this);
+        choose_op<(which & op_rshift)>::template args<Operand>::add(this);
+        choose_op<(which & op_and)>::template args<Operand>::add(this);
+        choose_op<(which & op_xor)>::template args<Operand>::add(this);
+        choose_op<(which & op_or)>::template args<Operand>::add(this);
+        choose_unary_op<(which & op_neg)>::template args<Operand>::add(this);
+        choose_unary_op<(which & op_pos)>::template args<Operand>::add(this);
+        choose_unary_op<(which & op_abs)>::template args<Operand>::add(this);
+        choose_unary_op<(which & op_invert)>::template args<Operand>::add(this);
+        choose_unary_op<(which & op_int)>::template args<Operand>::add(this);
+        choose_unary_op<(which & op_long)>::template args<Operand>::add(this);
+        choose_unary_op<(which & op_float)>::template args<Operand>::add(this);
+        choose_op<(which & op_cmp)>::template args<Operand>::add(this);
+        choose_unary_op<(which & op_str)>::template args<Operand>::add(this);
+    }
+
+    template <long which, class Left, class Right>
+    inline void def_operators(operators<which,Left>, right_operand<Right>)
+    {
+        def_standard_coerce();
+        
+        choose_op<(which & op_add)>::template args<Left,Right>::add(this);
+        choose_op<(which & op_sub)>::template args<Left,Right>::add(this);
+        choose_op<(which & op_mul)>::template args<Left,Right>::add(this);
+        choose_op<(which & op_div)>::template args<Left,Right>::add(this);
+        choose_op<(which & op_mod)>::template args<Left,Right>::add(this);
+        choose_op<(which & op_divmod)>::template args<Left,Right>::add(this);
+        choose_op<(which & op_pow)>::template args<Left,Right>::add(this);
+        choose_op<(which & op_lshift)>::template args<Left,Right>::add(this);
+        choose_op<(which & op_rshift)>::template args<Left,Right>::add(this);
+        choose_op<(which & op_and)>::template args<Left,Right>::add(this);
+        choose_op<(which & op_xor)>::template args<Left,Right>::add(this);
+        choose_op<(which & op_or)>::template args<Left,Right>::add(this);
+        choose_op<(which & op_cmp)>::template args<Left,Right>::add(this);
+    }
+    
+    template <long which, class Left, class Right>
+    inline void def_operators(operators<which,Right>, left_operand<Left>)
+    {
+        def_standard_coerce();
+        
+        choose_rop<(which & op_add)>::template args<Left,Right>::add(this);
+        choose_rop<(which & op_sub)>::template args<Left,Right>::add(this);
+        choose_rop<(which & op_mul)>::template args<Left,Right>::add(this);
+        choose_rop<(which & op_div)>::template args<Left,Right>::add(this);
+        choose_rop<(which & op_mod)>::template args<Left,Right>::add(this);
+        choose_rop<(which & op_divmod)>::template args<Left,Right>::add(this);
+        choose_rop<(which & op_pow)>::template args<Left,Right>::add(this);
+        choose_rop<(which & op_lshift)>::template args<Left,Right>::add(this);
+        choose_rop<(which & op_rshift)>::template args<Left,Right>::add(this);
+        choose_rop<(which & op_and)>::template args<Left,Right>::add(this);
+        choose_rop<(which & op_xor)>::template args<Left,Right>::add(this);
+        choose_rop<(which & op_or)>::template args<Left,Right>::add(this);
+        choose_rop<(which & op_cmp)>::template args<Left,Right>::add(this);
+    }
+    
+    template <class signature>
+    void add_constructor(signature sig)
+    {
+        this->add_constructor_object(init_function<holder>::create(sig));
+    }
+};
+
+// A simple wrapper over a T which allows us to use extension_class<T> with a
+// single template parameter only. See extension_class<T>, above.
+template <class Held>
+class held_instance : public Held
+{
+    // There are no member functions: we want to avoid inadvertently overriding
+    // any virtual functions in Held.
+public:
+    held_instance(PyObject*) : Held() {}
+    template <class A1>
+    held_instance(PyObject*, A1 a1) : Held(a1) {}
+    template <class A1, class A2>
+    held_instance(PyObject*, A1 a1, A2 a2) : Held(a1, a2) {}
+    template <class A1, class A2, class A3>
+    held_instance(PyObject*, A1 a1, A2 a2, A3 a3) : Held(a1, a2, a3) {}
+    template <class A1, class A2, class A3, class A4>
+    held_instance(PyObject*, A1 a1, A2 a2, A3 a3, A4 a4) : Held(a1, a2, a3, a4) {}
+    template <class A1, class A2, class A3, class A4, class A5>
+    held_instance(PyObject*, A1 a1, A2 a2, A3 a3, A4 a4, A5 a5) : Held(a1, a2, a3, a4, a5) {}
+    template <class A1, class A2, class A3, class A4, class A5, class A6>
+    held_instance(PyObject*, A1 a1, A2 a2, A3 a3, A4 a4, A5 a5, A6 a6) : Held(a1, a2, a3, a4, a5, a6) {}
+    template <class A1, class A2, class A3, class A4, class A5, class A6, class A7>
+    held_instance(PyObject*, A1 a1, A2 a2, A3 a3, A4 a4, A5 a5, A6 a6, A7 a7) : Held(a1, a2, a3, a4, a5, a6, a7) {}
+    template <class A1, class A2, class A3, class A4, class A5, class A6, class A7, class A8>
+    held_instance(PyObject*, A1 a1, A2 a2, A3 a3, A4 a4, A5 a5, A6 a6, A7 a7, A8 a8) : Held(a1, a2, a3, a4, a5, a6, a7, a8) {}
+    template <class A1, class A2, class A3, class A4, class A5, class A6, class A7, class A8, class A9>
+    held_instance(PyObject*, A1 a1, A2 a2, A3 a3, A4 a4, A5 a5, A6 a6, A7 a7, A8 a8, A9 a9) : Held(a1, a2, a3, a4, a5, a6, a7, a8, a9) {}
+    template <class A1, class A2, class A3, class A4, class A5, class A6, class A7, class A8, class A9, class A10>
+    held_instance(PyObject*, A1 a1, A2 a2, A3 a3, A4 a4, A5 a5, A6 a6, A7 a7, A8 a8, A9 a9, A10 a10) : Held(a1, a2, a3, a4, a5, a6, a7, a8, a9, a10) {}
+};
+
+// Abstract base class for all obj holders. Base for template class
+// instance_holder<>, below.
+class instance_holder_base
+{
+public:
+    virtual ~instance_holder_base() {}
+    virtual bool held_by_value() = 0;
+};
+
+// Abstract base class which holds a Held, somehow. Provides a uniform way to
+// get a pointer to the held object
+template <class Held>
+class instance_holder : public instance_holder_base
+{
+public:
+    virtual Held*target() = 0;
+};
+
+// Concrete class which holds a Held by way of a wrapper class Wrapper. If Held
+// can be constructed with arguments (A1...An), Wrapper must have a
+// corresponding constructor for arguments (PyObject*, A1...An). Wrapper is
+// neccessary to implement virtual function callbacks (there must be a
+// back-pointer to the actual Python object so that we can call any
+// overrides). held_instance (above) is used as a default Wrapper class when
+// there are no virtual functions.
+template <class Held, class Wrapper>
+class instance_value_holder : public instance_holder<Held>
+{
+public:
+    Held* target() { return &m_held; }
+    Wrapper* value_target() { return &m_held; }
+
+    instance_value_holder(extension_instance* p) :
+        m_held(p) {}
+    template <class A1>
+    instance_value_holder(extension_instance* p, A1 a1) :
+        m_held(p, a1) {}
+    template <class A1, class A2>
+    instance_value_holder(extension_instance* p, A1 a1, A2 a2) :
+        m_held(p, a1, a2) {}
+    template <class A1, class A2, class A3>
+    instance_value_holder(extension_instance* p, A1 a1, A2 a2, A3 a3) :
+        m_held(p, a1, a2, a3) {}
+    template <class A1, class A2, class A3, class A4>
+    instance_value_holder(extension_instance* p, A1 a1, A2 a2, A3 a3, A4 a4) :
+        m_held(p, a1, a2, a3, a4) {}
+    template <class A1, class A2, class A3, class A4, class A5>
+    instance_value_holder(extension_instance* p, A1 a1, A2 a2, A3 a3, A4 a4, A5 a5) :
+        m_held(p, a1, a2, a3, a4, a5) {}
+    template <class A1, class A2, class A3, class A4, class A5, class A6>
+    instance_value_holder(extension_instance* p, A1 a1, A2 a2, A3 a3, A4 a4, A5 a5, A6 a6) :
+        m_held(p, a1, a2, a3, a4, a5, a6) {}
+    template <class A1, class A2, class A3, class A4, class A5, class A6, class A7>
+    instance_value_holder(extension_instance* p, A1 a1, A2 a2, A3 a3, A4 a4, A5 a5, A6 a6, A7 a7) :
+        m_held(p, a1, a2, a3, a4, a5, a6, a7) {}
+    template <class A1, class A2, class A3, class A4, class A5, class A6, class A7, class A8>
+    instance_value_holder(extension_instance* p, A1 a1, A2 a2, A3 a3, A4 a4, A5 a5, A6 a6, A7 a7, A8 a8) :
+        m_held(p, a1, a2, a3, a4, a5, a6, a7, a8) {}
+    template <class A1, class A2, class A3, class A4, class A5, class A6, class A7, class A8, class A9>
+    instance_value_holder(extension_instance* p, A1 a1, A2 a2, A3 a3, A4 a4, A5 a5, A6 a6, A7 a7, A8 a8, A9 a9) :
+        m_held(p, a1, a2, a3, a4, a5, a6, a7, a8, a9) {}
+    template <class A1, class A2, class A3, class A4, class A5, class A6, class A7, class A8, class A9, class A10>
+    instance_value_holder(extension_instance* p, A1 a1, A2 a2, A3 a3, A4 a4, A5 a5, A6 a6, A7 a7, A8 a8, A9 a9, A10 a10) :
+        m_held(p, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10) {}
+
+ public: // implementation of instance_holder_base required interface
+    bool held_by_value() { return true; }
+
+ private:
+    Wrapper m_held;
+};
+
+// Concrete class which holds a HeldType by way of a (possibly smart) pointer
+// PtrType. By default, these are only generated for PtrType ==
+// std::auto_ptr<HeldType> and PtrType == boost::shared_ptr<HeldType>.
+template <class PtrType, class HeldType>
+class instance_ptr_holder : public instance_holder<HeldType>
+{
+ public:
+    HeldType* target() { return &*m_ptr; }
+    PtrType& ptr() { return m_ptr; }
+
+    instance_ptr_holder(PtrType ptr) : m_ptr(ptr) {}
+    
+ public: // implementation of instance_holder_base required interface
+    bool held_by_value() { return false; }
+ private:
+    PtrType m_ptr;
+};
+
+class extension_instance : public instance
+{
+ public:
+    extension_instance(PyTypeObject* class_);
+    ~extension_instance();
+    
+    void add_implementation(std::auto_ptr<instance_holder_base> holder);
+
+    typedef std::vector<instance_holder_base*> held_objects;
+    const held_objects& wrapped_objects() const
+        { return m_wrapped_objects; }
+ private:
+    held_objects m_wrapped_objects;
+};
+
+//
+// Template function implementations
+//
+
+template <class T, class U>
+extension_class<T, U>::extension_class()
+    : extension_class_base(typeid(T).name())
+{
+    class_registry<T>::register_class(this);
+}
+
+template <class T, class U>
+extension_class<T, U>::extension_class(const char* name)
+    : extension_class_base(name)
+{
+    class_registry<T>::register_class(this);
+}
+
+template <class T, class U>
+void extension_class<T, U>::def_standard_coerce()
+{
+    ref coerce_fct = dict().get_item(string("__coerce__"));
+    
+    if(coerce_fct.get() == 0) // not yet defined
+        this->def(&standard_coerce, "__coerce__");
+}
+
+template <class T, class U>
+inline
+std::vector<base_class_info> const& 
+extension_class<T, U>::base_classes() const
+{
+    return class_registry<T>::base_classes();
+}
+
+template <class T, class U>
+inline
+std::vector<derived_class_info> const& 
+extension_class<T, U>::derived_classes() const
+{
+    return class_registry<T>::derived_classes();
+}
+       
+template <class T, class U>
+void* extension_class<T, U>::extract_object_from_holder(instance_holder_base* v) const
+{
+    instance_holder<T>* held = dynamic_cast<instance_holder<T>*>(v);
+    if(held)
+        return held->target();
+    return 0;
+}
+
+template <class T, class U>
+extension_class<T, U>::~extension_class()
+{
+    class_registry<T>::unregister_class(this);
+}
+
+template <class T>
+inline void class_registry<T>::register_class(extension_class_base* p)
+{
+    // You're not expected to create more than one of these!
+    assert(static_class_object == 0);
+    static_class_object = p;
+}
+
+template <class T>
+inline void class_registry<T>::unregister_class(extension_class_base* p)
+{
+    // The user should be destroying the same object they created.
+    assert(static_class_object == p);
+    (void)p; // unused in shipping version
+    static_class_object = 0;
+}
+
+template <class T>
+void class_registry<T>::register_base_class(base_class_info const& i)
+{
+    static_base_class_info.push_back(i);
+}
+
+template <class T>
+void class_registry<T>::register_derived_class(derived_class_info const& i)
+{
+    static_derived_class_info.push_back(i);
+}
+
+template <class T>
+std::vector<base_class_info> const& class_registry<T>::base_classes()
+{
+    return static_base_class_info;
+}
+
+template <class T>
+std::vector<derived_class_info> const& class_registry<T>::derived_classes()
+{
+    return static_derived_class_info;
+}
+
+//
+// Static data member declaration.
+//
+template <class T>
+extension_class_base* class_registry<T>::static_class_object;
+template <class T>
+std::vector<base_class_info> class_registry<T>::static_base_class_info;
+template <class T>
+std::vector<derived_class_info> class_registry<T>::static_derived_class_info;
+
+}}} // namespace boost::python::detail
+
+#endif // EXTENSION_CLASS_DWA052000_H_

pyste/NEWS

@@ -1,50 +0,0 @@
-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/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,49 +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">
-</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"><img src="theme/r_arr_disabled.gif" border="0"></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"><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/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,479 +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.
-

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,81 +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>
-</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,840 +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 ExportMethods(self):
-        'Export all the non-virtual methods of this class'        
-            
-        def OverloadName(m):
-            'Returns the name of the overloads struct for the given method'            
-            return makeid(m.FullName()) + ('_overloads_%i_%i' % (m.minArgs, m.maxArgs))
-        
-        declared = {}
-        def DeclareOverloads(m):
-            'Declares the macro for the generation of the overloads'
-            if not m.virtual:
-                if m.static:
-                    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, 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
-            is_unique = self.class_.IsUnique(m.name)
-            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, Method) and not isinstance(m, ignore) and not m.virtual        
-        
-        methods = [x for x in self.public_members if IsExportable(x)]        
-        
-        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 = 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 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,40 +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()
-            code = indent + namespaces.python + '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,74 +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, parser_decl=None):
-        self.info = info
-        self.parser_tail = parser_tail
-        self.parser_decl = parser_decl
-    
-
-    def Name(self):
-        return self.info.name
-
-        
-    def Parse(self, parser):
-        self.parser = parser
-        header = self.info.include
-        tail = self.parser_tail
-        decl = self.parser_decl
-        declarations, parser_header = parser.parse(header, tail, decl)
-        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,417 +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)
-
-            
-    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 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,212 +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(option):
-    option._Attribute('exclude', True)
-
-def set_policy(option, policy):
-    option._Attribute('policy', policy)
-
-def rename(option, name):
-    option._Attribute('rename', name)
-
-def set_wrapper(option, wrapper):
-    if isinstance(wrapper, str):
-        wrapper = FunctionWrapper(wrapper)
-    option._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(option):
-    option._Attribute('smart_ptr', 'boost::shared_ptr< %s >')
-
-def use_auto_ptr(option):
-    option._Attribute('smart_ptr', 'std::auto_ptr< %s >')
-        
-    

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,203 +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.8.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
-    # 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/_smart_tr.cpp

@@ -1,83 +0,0 @@
-
-// Includes ====================================================================
-#include <boost/python.hpp>
-#include <smart_ptr.h>
-
-// Using =======================================================================
-using namespace boost::python;
-
-// Declarations ================================================================
-
-
-namespace  {
-
-
-struct smart_ptr_A_Wrapper: smart_ptr::A
-{
-    smart_ptr_A_Wrapper(PyObject* self_, const smart_ptr::A & p0):
-        smart_ptr::A(p0), self(self_) {}
-
-    smart_ptr_A_Wrapper(PyObject* self_):
-        smart_ptr::A(), self(self_) {}
-
-    int f() {
-        return call_method< int >(self, "f");
-    }
-
-    PyObject* self;
-};
-
-
-
-}// namespace 
-
-
-// Module ======================================================================
-BOOST_PYTHON_MODULE(_smart_tr)
-{
-    scope* smart_ptr_A_scope = new scope(
-    class_< smart_ptr::A, boost::noncopyable, smart_ptr_A_Wrapper >("A", init<  >())
-    );
-    // Temporary code for smart pointers
-    objects::class_value_wrapper< 
-      boost::shared_ptr< smart_ptr::A >, objects::make_ptr_instance< 
-        smart_ptr::A, objects::pointer_holder< 
-          boost::shared_ptr< smart_ptr::A >, smart_ptr::A >
-      >
-    >();
-    delete smart_ptr_A_scope;
-
-    scope* smart_ptr_C_scope = new scope(
-    class_< smart_ptr::C >("C", init<  >())
-        .def(init< const smart_ptr::C & >())
-        .def_readwrite("value", &smart_ptr::C::value)
-    );
-    // Temporary code for smart pointers
-    objects::class_value_wrapper< 
-      boost::shared_ptr< smart_ptr::C >, objects::make_ptr_instance< 
-        smart_ptr::C, objects::pointer_holder< 
-          boost::shared_ptr< smart_ptr::C >, smart_ptr::C >
-      >
-    >();
-    delete smart_ptr_C_scope;
-
-    scope* smart_ptr_D_scope = new scope(
-    class_< smart_ptr::D >("D", init<  >())
-        .def(init< const smart_ptr::D & >())
-        .def("Get", &smart_ptr::D::Get)
-        .def("Set", &smart_ptr::D::Set)
-    );
-    // Temporary code for smart pointers
-    objects::class_value_wrapper< 
-      std::auto_ptr< smart_ptr::D >, objects::make_ptr_instance< 
-        smart_ptr::D, objects::pointer_holder< 
-          std::auto_ptr< smart_ptr::D >, smart_ptr::D >
-      >
-    >();
-    delete smart_ptr_D_scope;
-
-    def("GetA", &smart_ptr::GetA);
-    def("NewA", &smart_ptr::NewA);
-    def("NewC", &smart_ptr::NewC);
-    def("NewD", &smart_ptr::NewD);
-}

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,24 +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;
-    }
-};
-
-}
-
-#endif