/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2012 NBEE Embedded Systems, Miguel Angel Ajo * Copyright (C) 1992-2012 KiCad Developers, see AUTHORS.txt for contributors. * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License * as published by the Free Software Foundation; either version 2 * of the License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, you may find one here: * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html * or you may search the http://www.gnu.org website for the version 2 license, * or you may write to the Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA */ /** * @file python_scripting.cpp * @brief methods to add scripting capabilities inside pcbnew */ #include #include #include #ifdef __GNUG__ #pragma implementation #endif #include #include #include #include /* init functions defined by swig */ extern "C" void init_kicad( void ); extern "C" void init_pcbnew( void ); #define EXTRA_PYTHON_MODULES 10 // this is the number of python // modules that we want to add into the list /* python inittab that links module names to module init functions * we will rebuild it to include the original python modules plus * our own ones */ struct _inittab *SwigImportInittab; static int SwigNumModules = 0; /* Add a name + initfuction to our SwigImportInittab */ static void swigAddModule( const char* name, void (* initfunc)() ) { SwigImportInittab[SwigNumModules].name = (char*) name; SwigImportInittab[SwigNumModules].initfunc = initfunc; SwigNumModules++; SwigImportInittab[SwigNumModules].name = (char*) 0; SwigImportInittab[SwigNumModules].initfunc = 0; } /* Add the builting python modules */ static void swigAddBuiltin() { int i = 0; /* discover the length of the pyimport inittab */ while( PyImport_Inittab[i].name ) i++; /* allocate memory for the python module table */ SwigImportInittab = (struct _inittab*) malloc( sizeof(struct _inittab)*(i+EXTRA_PYTHON_MODULES)); /* copy all pre-existing python modules into our newly created table */ i=0; while( PyImport_Inittab[i].name ) { swigAddModule( PyImport_Inittab[i].name, PyImport_Inittab[i].initfunc ); i++; } } /* Function swigAddModules * adds the internal modules we offer to the python scripting, so they will be * available to the scripts we run. * */ static void swigAddModules() { swigAddModule( "_pcbnew", init_pcbnew ); // finally it seems better to include all in just one module // but in case we needed to include any other modules, // it must be done like this: // swigAddModule("_kicad",init_kicad); } /* Function swigSwitchPythonBuiltin * switches python module table to our built one . * */ static void swigSwitchPythonBuiltin() { PyImport_Inittab = SwigImportInittab; } /* Function pcbnewInitPythonScripting * Initializes all the python environment and publish our interface inside it * initializes all the wxpython interface, and returns the python thread control structure * */ PyThreadState *g_PythonMainTState; bool pcbnewInitPythonScripting() { swigAddBuiltin(); // add builtin functions swigAddModules(); // add our own modules swigSwitchPythonBuiltin(); // switch the python builtin modules to our new list Py_Initialize(); #ifdef KICAD_SCRIPTING_WXPYTHON PyEval_InitThreads(); // Load the wxPython core API. Imports the wx._core_ module and sets a // local pointer to a function table located there. The pointer is used // internally by the rest of the API functions. if( ! wxPyCoreAPI_IMPORT() ) { wxLogError(wxT("***** Error importing the wxPython API! *****")); PyErr_Print(); Py_Finalize(); return false; } // Save the current Python thread state and release the // Global Interpreter Lock. g_PythonMainTState = wxPyBeginAllowThreads(); // load pcbnew inside python, and load all the user plugins, TODO: add system wide plugins PY_BLOCK_THREADS( blocked ); #endif PyRun_SimpleString( "import sys\n" "sys.path.append(\".\")\n" "import pcbnew\n" "pcbnew.LoadPlugins()" ); PY_UNBLOCK_THREADS( blocked ); return true; } void pcbnewFinishPythonScripting() { #ifdef KICAD_SCRIPTING_WXPYTHON wxPyEndAllowThreads(g_PythonMainTState); #endif Py_Finalize(); } #ifdef KICAD_SCRIPTING_WXPYTHON void RedirectStdio() { // This is a helpful little tidbit to help debugging and such. It // redirects Python's stdout and stderr to a window that will popup // only on demand when something is printed, like a traceback. const char* python_redirect = "import sys\n\ import wx\n\ output = wx.PyOnDemandOutputWindow()\n\ c sys.stderr = output\n"; PY_BLOCK_THREADS( blocked ); PyRun_SimpleString( python_redirect ); PY_UNBLOCK_THREADS( blocked ); } wxWindow* CreatePythonShellWindow(wxWindow* parent) { const char* pycrust_panel = "\ import wx\n\ from wx.py import shell, version\n\ \n\ class PyCrustPanel(wx.Panel):\n\ \tdef __init__(self, parent):\n\ \t\twx.Panel.__init__(self, parent, -1, style=wx.SUNKEN_BORDER)\n\ \t\t\n\ \t\t\n\ \t\tintro = \"Welcome To PyCrust %s - KiCAD Python Shell\" % version.VERSION\n\ \t\tpycrust = shell.Shell(self, -1, introText=intro)\n\ \t\t\n\ \t\tsizer = wx.BoxSizer(wx.VERTICAL)\n\n\ \t\tsizer.Add(pycrust, 1, wx.EXPAND|wx.BOTTOM|wx.LEFT|wx.RIGHT, 10)\n\n\ \t\tself.SetSizer(sizer)\n\n\ \n\ def makeWindow(parent):\n\ win = PyCrustPanel(parent)\n\ return win\n\ "; wxWindow* window = NULL; PyObject* result; // As always, first grab the GIL PY_BLOCK_THREADS( blocked ); // Now make a dictionary to serve as the global namespace when the code is // executed. Put a reference to the builtins module in it. PyObject* globals = PyDict_New(); PyObject* builtins = PyImport_ImportModule( "__builtin__" ); PyDict_SetItemString( globals, "__builtins__", builtins ); Py_DECREF(builtins); // Execute the code to make the makeWindow function we defined above result = PyRun_String( pycrust_panel, Py_file_input, globals, globals ); // Was there an exception? if( !result ) { PyErr_Print(); PY_UNBLOCK_THREADS( blocked ); return NULL; } Py_DECREF(result); // Now there should be an object named 'makeWindow' in the dictionary that // we can grab a pointer to: PyObject* func = PyDict_GetItemString( globals, "makeWindow" ); wxASSERT( PyCallable_Check( func ) ); // Now build an argument tuple and call the Python function. Notice the // use of another wxPython API to take a wxWindows object and build a // wxPython object that wraps it. PyObject* arg = wxPyMake_wxObject( parent, false ); wxASSERT( arg != NULL ); PyObject* tuple = PyTuple_New( 1 ); PyTuple_SET_ITEM( tuple, 0, arg ); result = PyEval_CallObject( func, tuple ); // Was there an exception? if( !result ) PyErr_Print(); else { // Otherwise, get the returned window out of Python-land and // into C++-ville... bool success = wxPyConvertSwigPtr(result, (void**)&window, _T("wxWindow") ); (void)success; wxASSERT_MSG(success, _T("Returned object was not a wxWindow!") ); Py_DECREF(result); } // Release the python objects we still have Py_DECREF( globals ); Py_DECREF( tuple ); // Finally, after all Python stuff is done, release the GIL PY_UNBLOCK_THREADS( blocked ); return window; } #endif