kicad-source/scripting/python_manager.h
Jon Evans 3bdf82aea7 Python: switch to arg arrays for launch
Fixes Python when there are spaces in interpreter path
2025-02-11 12:14:25 -05:00

70 lines
2.3 KiB
C++

/*
* This program source code file is part of KiCad, a free EDA CAD application.
*
* Copyright (C) 2023 Jon Evans <jon@craftyjon.com>
* Copyright The 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 3 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, see <http://www.gnu.org/licenses/>.
*/
#ifndef KICAD_PYTHON_MANAGER_H
#define KICAD_PYTHON_MANAGER_H
#include <functional>
#include <optional>
#include <wx/wx.h>
#include <kicommon.h>
class KICOMMON_API PYTHON_MANAGER
{
public:
PYTHON_MANAGER( const wxString& aInterpreterPath );
/**
* Launches the Python interpreter with the given arguments
* @param aArgs
* @param aCallback
* @param aEnv
* @param aSaveOutput
* @return the process ID of the created process, or 0 if one was not created
*/
long Execute( const std::vector<wxString>& aArgs,
const std::function<void(int, const wxString&, const wxString&)>& aCallback,
const wxExecuteEnv* aEnv = nullptr,
bool aSaveOutput = false );
wxString GetInterpreterPath() const { return m_interpreterPath; }
void SetInterpreterPath( const wxString& aPath ) { m_interpreterPath = aPath; }
/**
* Searches for a Python intepreter on the user's system
* @return the absolute path to a Python interpreter, or an empty string if one was not found
*/
static wxString FindPythonInterpreter();
static std::optional<wxString> GetPythonEnvironment( const wxString& aNamespace );
/// Returns a full path to the python binary in a venv, if it exists
static std::optional<wxString> GetVirtualPython( const wxString& aNamespace );
private:
wxString m_interpreterPath;
};
#endif //KICAD_PYTHON_MANAGER_H