src/python.h

   1 /*********************************
   2 ** Tsunagari Tile Engine        **
   3 ** python.h                     **
   4 ** Copyright 2011-2012 OmegaSDG **
   5 *********************************/
   6
   7 #ifndef PYTHON_H
   8 #define PYTHON_H
   9
  10 // In this file.
  11 #include <boost/python/errors.hpp>
  12 #include <boost/python/import.hpp>
  13 #include <boost/python/object.hpp>
  14 #include <boost/python/ptr.hpp>
  15 #include <boost/python/scope.hpp>
  16
  17 // For bindings.
  18 #include <boost/python/class.hpp>
  19 #include <boost/python/operators.hpp>
  20 #include <boost/python/other.hpp>
  21 #include <boost/python/self.hpp>
  22
  23 //! Initialize Python libraries for use.
  24 bool pythonInit();
  25
  26 //! Free resourcers used by Python libraries and uninitialize them.
  27 void pythonFinalize();
  28
  29 //! Print last error received within Python.
  30 void pythonErr();
  31
  32
  33 //! Access to global namespace shared by all Python scripts.
  34 boost::python::object pythonGlobals();
  35
  36 //! Convenience function for binding a C++ object into the global Python
  37 //! namespace.
  38 template<class T>
  39 void pythonSetGlobal(const char* name, T pointer)
  40 {
  41         try {
  42                 pythonGlobals()[name] = boost::python::ptr(pointer);
  43         } catch (boost::python::error_already_set) {
  44                 pythonErr();
  45         }
  46 }
  47
  48 template<class Fn>
  49 void pythonAddFunction(const char* name, Fn fn)
  50 {
  51         using namespace boost::python;
  52
  53         try {
  54                 scope bltins(import("__builtin__"));
  55                 def(name, fn);
  56         } catch (error_already_set) {
  57                 pythonErr();
  58         }
  59 }
  60
  61
  62 //! Compile a Python script. Must provide both a representative filename for
  63 //! any error messages along with a string containing the body of code to
  64 //! compile. Returns NULL on failure and prints any errors.
  65 PyCodeObject* pythonCompile(const char* fn, const char* code);
  66
  67 //! Run a compiled Python script. Returns false on runtime error and prints the
  68 //! error.
  69 bool pythonExec(PyCodeObject* code);
  70
  71 #endif
  72