Python.h

Go to the documentation of this file.

#pragma once
 
#include <string>
#include <vector>
 
#include <shlublu/binding/Python_BindingExceptions.h>
#include <shlublu/binding/Python_ObjectHandler.h>
 
 
namespace shlublu
{
 
namespace Python
{
    using PathEntriesList = std::vector<std::string>; 
    using ObjectHandlersList = std::vector<ObjectHandler>; 
    using ObjectPointer = PyObject*; 
    using RawCode = std::string; 
    using Program = std::vector<RawCode>; 
    extern const std::string moduleMain; 
    extern const std::string moduleBuiltins; 
    bool isInitialized();
 
    void init(std::string const& programName, PathEntriesList const& pythonSysPath = PathEntriesList());
 
    void shutdown();
 
    void execute(RawCode const& code);
 
    void execute(Program const& program);
 
 
    ObjectPointer import(std::string const& moduleName);
 
 
    ObjectPointer module(std::string const& moduleName);
 
 
    ObjectHandler const& object(ObjectPointer scope, std::string const& objectName);
 
 
    ObjectHandler const& object(std::string const& moduleName, std::string const& objectName);
 
    ObjectPointer callable(ObjectPointer scope, std::string const& callableName, bool forceReload = false);
 
    ObjectPointer callable(std::string const& moduleName, std::string const& callableName, bool forceReload = false);
 
    ObjectHandler const& call(ObjectPointer callableObject, ObjectHandlersList const& args = {}, bool keepArguments = false);
 
    ObjectHandler tuple(ObjectHandlersList const& args = {}, bool keepArguments = false);
    
    ObjectHandler list(ObjectHandlersList const& args = {}, bool keepArguments = false);
 
    void addList(ObjectHandler list, ObjectHandler item, bool keepArg = false);
 
    ObjectHandler fromAscii(std::string const& str);
 
    std::string toAscii(ObjectHandler utfStr, bool keepArg = false);
 
    ObjectHandler const& keepArgument(ObjectHandler const& object);
 
    ObjectHandler const& controlArgument(ObjectHandler object); // Give Python the ownership of the passed objet created from outside without changing its references count. Object should not be controlled already. 
 
    void forgetArgument(ObjectHandler const& object); // Forgets an object under control after having decreased its references count
 
    void beginCriticalSection();
 
 
    void endCriticalSection();
}
 
}