python_loader.hh

Go to the documentation of this file.

/*
 * python_utils.hh
 *
 *  Created on: Aug 31, 2012
 *      Author: jb
 */

#ifndef PYTHON_UTILS_HH_
#define PYTHON_UTILS_HH_

#ifdef HAVE_PYTHON

#include "Python.h"
#include <string>


namespace internal {
/**
 * Class to implement initialization and finalization of the python module
 */
class PythonRunning {
public:
    PythonRunning();
    ~PythonRunning();
};
} // close namespace internal



/**
 * Class with static only members, should be used to load and compile Python sources either from file or from string.
 * Implement correct initialization and finalization.
 * TODO:
 * - check validity of results and throw exceptions
 * - better loading of modules from files
 * - explain and resolve RuntimeWarning:
 *   "flow123d_python_loader:1: RuntimeWarning: Parent module 'field_python_script' not found while handling absolute import"
 *   that appears during field_python_test.cpp
 *
 */
class PythonLoader {
public:
    PythonLoader();
    /**
     * This function loads a module from the given file.
     * Resulting module has to be deallocated by Py_DECREF() macro.
     */
    static PyObject * load_module_from_file(const std::string& fname);
    /**
     * This function compile code in the given string and creates a module with name @p module_name.
     * Resulting module has to be deallocated by Py_DECREF() macro.
     */
    static PyObject * load_module_from_string(const std::string& module_name, const std::string& source_string);

protected:
    // implements automatic initialization and finalization
    static internal::PythonRunning py_running;
};



#endif // HAVE_PYTHON

#endif /* PYTHON_UTILS_HH_ */