/**************************************************************************** ** ** Copyright (C) 2016 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of Qt Creator. ** ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 3 as published by the Free Software ** Foundation with exceptions as appearing in the file LICENSE.GPL3-EXCEPT ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-3.0.html. ** ****************************************************************************/ #include "pythoneditorplugin.h" #include "pythoneditor.h" #include "pythoneditorconstants.h" #include "pythonhighlighter.h" #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include using namespace Core; using namespace ProjectExplorer; using namespace PythonEditor::Constants; using namespace Utils; namespace PythonEditor { namespace Internal { const char PythonRunConfigurationPrefix[] = "PythonEditor.RunConfiguration."; const char InterpreterKey[] = "PythonEditor.RunConfiguation.Interpreter"; const char MainScriptKey[] = "PythonEditor.RunConfiguation.MainScript"; const char PythonMimeType[] = "text/x-python-project"; // ### FIXME const char PythonProjectId[] = "PythonProject"; class PythonRunConfiguration; class PythonProjectFile; class PythonProject : public Project { Q_OBJECT public: explicit PythonProject(const Utils::FileName &filename); bool addFiles(const QStringList &filePaths); bool removeFiles(const QStringList &filePaths); bool setFiles(const QStringList &filePaths); bool renameFile(const QString &filePath, const QString &newFilePath); void refresh(Target *target = nullptr); bool needsConfiguration() const final { return false; } private: RestoreResult fromMap(const QVariantMap &map, QString *errorMessage) override; bool setupTarget(Target *t) override { refresh(t); return Project::setupTarget(t); } bool saveRawFileList(const QStringList &rawFileList); bool saveRawList(const QStringList &rawList, const QString &fileName); void parseProject(); QStringList processEntries(const QStringList &paths, QHash *map = 0) const; QStringList m_rawFileList; QStringList m_files; QHash m_rawListEntries; }; class PythonProjectNode : public ProjectNode { public: PythonProjectNode(PythonProject *project); bool showInSimpleTree() const override; QString addFileFilter() const override; bool renameFile(const QString &filePath, const QString &newFilePath) override; private: PythonProject *m_project; }; class PythonRunConfigurationWidget : public QWidget { public: explicit PythonRunConfigurationWidget(PythonRunConfiguration *runConfiguration); void setInterpreter(const QString &interpreter); private: PythonRunConfiguration *m_runConfiguration; }; class PythonRunConfiguration : public RunConfiguration { Q_OBJECT Q_PROPERTY(bool supportsDebugger READ supportsDebugger) Q_PROPERTY(QString interpreter READ interpreter) Q_PROPERTY(QString mainScript READ mainScript) Q_PROPERTY(QString arguments READ arguments) public: explicit PythonRunConfiguration(Target *target); QWidget *createConfigurationWidget() override; QVariantMap toMap() const override; bool fromMap(const QVariantMap &map) override; Runnable runnable() const override; void doAdditionalSetup(const RunConfigurationCreationInfo &info) override; bool supportsDebugger() const { return true; } QString mainScript() const { return m_mainScript; } QString arguments() const; QString interpreter() const { return m_interpreter; } void setInterpreter(const QString &interpreter) { m_interpreter = interpreter; } private: friend class ProjectExplorer::RunConfigurationFactory; QString defaultDisplayName() const; QString m_interpreter; QString m_mainScript; }; //////////////////////////////////////////////////////////////// PythonRunConfiguration::PythonRunConfiguration(Target *target) : RunConfiguration(target, PythonRunConfigurationPrefix) { addExtraAspect(new LocalEnvironmentAspect(this, LocalEnvironmentAspect::BaseEnvironmentModifier())); addExtraAspect(new ArgumentsAspect(this, "PythonEditor.RunConfiguration.Arguments")); addExtraAspect(new TerminalAspect(this, "PythonEditor.RunConfiguration.UseTerminal")); } QVariantMap PythonRunConfiguration::toMap() const { QVariantMap map(RunConfiguration::toMap()); map.insert(MainScriptKey, m_mainScript); map.insert(InterpreterKey, m_interpreter); return map; } bool PythonRunConfiguration::fromMap(const QVariantMap &map) { if (!RunConfiguration::fromMap(map)) return false; m_mainScript = map.value(MainScriptKey).toString(); m_interpreter = map.value(InterpreterKey).toString(); return true; } void PythonRunConfiguration::doAdditionalSetup(const RunConfigurationCreationInfo &info) { Environment sysEnv = Environment::systemEnvironment(); const QString exec = sysEnv.searchInPath("python").toString(); m_interpreter = exec.isEmpty() ? "python" : exec; m_mainScript = info.targetName; setDefaultDisplayName(defaultDisplayName()); } QString PythonRunConfiguration::defaultDisplayName() const { return tr("Run %1").arg(m_mainScript); } QWidget *PythonRunConfiguration::createConfigurationWidget() { return wrapWidget(new PythonRunConfigurationWidget(this)); } Runnable PythonRunConfiguration::runnable() const { StandardRunnable r; QtcProcess::addArg(&r.commandLineArguments, m_mainScript); QtcProcess::addArgs(&r.commandLineArguments, extraAspect()->arguments()); r.executable = m_interpreter; r.runMode = extraAspect()->runMode(); r.environment = extraAspect()->environment(); return r; } QString PythonRunConfiguration::arguments() const { auto aspect = extraAspect(); QTC_ASSERT(aspect, return QString()); return aspect->arguments(); } PythonRunConfigurationWidget::PythonRunConfigurationWidget(PythonRunConfiguration *runConfiguration) : m_runConfiguration(runConfiguration) { auto fl = new QFormLayout(this); fl->setMargin(0); fl->setFieldGrowthPolicy(QFormLayout::ExpandingFieldsGrow); auto interpreterChooser = new FancyLineEdit(this); interpreterChooser->setText(runConfiguration->interpreter()); connect(interpreterChooser, &QLineEdit::textChanged, this, &PythonRunConfigurationWidget::setInterpreter); auto scriptLabel = new QLabel(this); scriptLabel->setText(runConfiguration->mainScript()); fl->addRow(PythonRunConfiguration::tr("Interpreter: "), interpreterChooser); fl->addRow(PythonRunConfiguration::tr("Script: "), scriptLabel); runConfiguration->extraAspect()->addToMainConfigurationWidget(this, fl); runConfiguration->extraAspect()->addToMainConfigurationWidget(this, fl); connect(runConfiguration->target(), &Target::applicationTargetsChanged, this, [this, scriptLabel] { scriptLabel->setText(QDir::toNativeSeparators(m_runConfiguration->mainScript())); }); } class PythonRunConfigurationFactory : public RunConfigurationFactory { public: PythonRunConfigurationFactory() { registerRunConfiguration(PythonRunConfigurationPrefix); addSupportedProjectType(PythonProjectId); } }; PythonProject::PythonProject(const FileName &fileName) : Project(Constants::C_PY_MIMETYPE, fileName, [this]() { refresh(); }) { setId(PythonProjectId); setProjectLanguages(Context(ProjectExplorer::Constants::CXX_LANGUAGE_ID)); setDisplayName(fileName.toFileInfo().completeBaseName()); } static QStringList readLines(const QString &absoluteFileName) { QStringList lines; QFile file(absoluteFileName); if (file.open(QFile::ReadOnly)) { QTextStream stream(&file); forever { QString line = stream.readLine(); if (line.isNull()) break; lines.append(line); } } return lines; } bool PythonProject::saveRawFileList(const QStringList &rawFileList) { bool result = saveRawList(rawFileList, projectFilePath().toString()); // refresh(PythonProject::Files); return result; } bool PythonProject::saveRawList(const QStringList &rawList, const QString &fileName) { FileChangeBlocker changeGuarg(fileName); // Make sure we can open the file for writing FileSaver saver(fileName, QIODevice::Text); if (!saver.hasError()) { QTextStream stream(saver.file()); foreach (const QString &filePath, rawList) stream << filePath << '\n'; saver.setResult(&stream); } bool result = saver.finalize(ICore::mainWindow()); return result; } bool PythonProject::addFiles(const QStringList &filePaths) { QStringList newList = m_rawFileList; QDir baseDir(projectDirectory().toString()); foreach (const QString &filePath, filePaths) newList.append(baseDir.relativeFilePath(filePath)); QSet toAdd; foreach (const QString &filePath, filePaths) { QString directory = QFileInfo(filePath).absolutePath(); if (!toAdd.contains(directory)) toAdd << directory; } bool result = saveRawList(newList, projectFilePath().toString()); refresh(); return result; } bool PythonProject::removeFiles(const QStringList &filePaths) { QStringList newList = m_rawFileList; foreach (const QString &filePath, filePaths) { QHash::iterator i = m_rawListEntries.find(filePath); if (i != m_rawListEntries.end()) newList.removeOne(i.value()); } return saveRawFileList(newList); } bool PythonProject::setFiles(const QStringList &filePaths) { QStringList newList; QDir baseDir(projectFilePath().toString()); foreach (const QString &filePath, filePaths) newList.append(baseDir.relativeFilePath(filePath)); return saveRawFileList(newList); } bool PythonProject::renameFile(const QString &filePath, const QString &newFilePath) { QStringList newList = m_rawFileList; QHash::iterator i = m_rawListEntries.find(filePath); if (i != m_rawListEntries.end()) { int index = newList.indexOf(i.value()); if (index != -1) { QDir baseDir(projectFilePath().toString()); newList.replace(index, baseDir.relativeFilePath(newFilePath)); } } return saveRawFileList(newList); } void PythonProject::parseProject() { m_rawListEntries.clear(); m_rawFileList = readLines(projectFilePath().toString()); m_rawFileList << projectFilePath().fileName(); m_files = processEntries(m_rawFileList, &m_rawListEntries); } /** * @brief Provides displayName relative to project node */ class PythonFileNode : public FileNode { public: PythonFileNode(const Utils::FileName &filePath, const QString &nodeDisplayName, FileType fileType = FileType::Source) : FileNode(filePath, fileType, false) , m_displayName(nodeDisplayName) {} QString displayName() const override { return m_displayName; } private: QString m_displayName; }; void PythonProject::refresh(Target *target) { emitParsingStarted(); parseProject(); QDir baseDir(projectDirectory().toString()); BuildTargetInfoList appTargets; auto newRoot = new PythonProjectNode(this); for (const QString &f : m_files) { const QString displayName = baseDir.relativeFilePath(f); FileType fileType = f.endsWith(".pyqtc") ? FileType::Project : FileType::Source; newRoot->addNestedNode(new PythonFileNode(FileName::fromString(f), displayName, fileType)); if (fileType == FileType::Source) { BuildTargetInfo bti; bti.targetName = f; bti.targetFilePath = FileName::fromString(f); bti.projectFilePath = projectFilePath(); appTargets.list.append(bti); } } setRootProjectNode(newRoot); if (!target) target = activeTarget(); if (target) target->setApplicationTargets(appTargets); emitParsingFinished(true); } /** * Expands environment variables in the given \a string when they are written * like $$(VARIABLE). */ static void expandEnvironmentVariables(const QProcessEnvironment &env, QString &string) { static QRegExp candidate(QLatin1String("\\$\\$\\((.+)\\)")); int index = candidate.indexIn(string); while (index != -1) { const QString value = env.value(candidate.cap(1)); string.replace(index, candidate.matchedLength(), value); index += value.length(); index = candidate.indexIn(string, index); } } /** * Expands environment variables and converts the path from relative to the * project to an absolute path. * * The \a map variable is an optional argument that will map the returned * absolute paths back to their original \a entries. */ QStringList PythonProject::processEntries(const QStringList &paths, QHash *map) const { const QProcessEnvironment env = QProcessEnvironment::systemEnvironment(); const QDir projectDir(projectDirectory().toString()); QFileInfo fileInfo; QStringList absolutePaths; foreach (const QString &path, paths) { QString trimmedPath = path.trimmed(); if (trimmedPath.isEmpty()) continue; expandEnvironmentVariables(env, trimmedPath); trimmedPath = FileName::fromUserInput(trimmedPath).toString(); fileInfo.setFile(projectDir, trimmedPath); if (fileInfo.exists()) { const QString absPath = fileInfo.absoluteFilePath(); absolutePaths.append(absPath); if (map) map->insert(absPath, trimmedPath); } } absolutePaths.removeDuplicates(); return absolutePaths; } Project::RestoreResult PythonProject::fromMap(const QVariantMap &map, QString *errorMessage) { Project::RestoreResult res = Project::fromMap(map, errorMessage); if (res == RestoreResult::Ok) { refresh(); Kit *defaultKit = KitManager::defaultKit(); if (!activeTarget() && defaultKit) addTarget(createTarget(defaultKit)); } return res; } PythonProjectNode::PythonProjectNode(PythonProject *project) : ProjectNode(project->projectDirectory()) , m_project(project) { setDisplayName(project->projectFilePath().toFileInfo().completeBaseName()); } QHash sortFilesIntoPaths(const QString &base, const QSet &files) { QHash filesInPath; const QDir baseDir(base); foreach (const QString &absoluteFileName, files) { QFileInfo fileInfo(absoluteFileName); FileName absoluteFilePath = FileName::fromString(fileInfo.path()); QString relativeFilePath; if (absoluteFilePath.isChildOf(baseDir)) { relativeFilePath = absoluteFilePath.relativeChildPath(FileName::fromString(base)).toString(); } else { // 'file' is not part of the project. relativeFilePath = baseDir.relativeFilePath(absoluteFilePath.toString()); if (relativeFilePath.endsWith('/')) relativeFilePath.chop(1); } filesInPath[relativeFilePath].append(absoluteFileName); } return filesInPath; } bool PythonProjectNode::showInSimpleTree() const { return true; } QString PythonProjectNode::addFileFilter() const { return QLatin1String("*.py"); } bool PythonProjectNode::renameFile(const QString &filePath, const QString &newFilePath) { return m_project->renameFile(filePath, newFilePath); } // PythonRunConfigurationWidget void PythonRunConfigurationWidget::setInterpreter(const QString &interpreter) { m_runConfiguration->setInterpreter(interpreter); } //////////////////////////////////////////////////////////////////////////////////// // // PythonEditorPlugin // //////////////////////////////////////////////////////////////////////////////////// class PythonEditorPluginPrivate { public: PythonEditorFactory editorFactory; PythonRunConfigurationFactory runConfigFactory; }; static PythonEditorPluginPrivate *dd = nullptr; PythonEditorPlugin::~PythonEditorPlugin() { delete dd; dd = nullptr; } bool PythonEditorPlugin::initialize(const QStringList &arguments, QString *errorMessage) { Q_UNUSED(arguments) Q_UNUSED(errorMessage) dd = new PythonEditorPluginPrivate; ProjectManager::registerProjectType(PythonMimeType); auto constraint = [](RunConfiguration *runConfiguration) { auto rc = dynamic_cast(runConfiguration); return rc && !rc->interpreter().isEmpty(); }; RunControl::registerWorker(ProjectExplorer::Constants::NORMAL_RUN_MODE, constraint); return true; } void PythonEditorPlugin::extensionsInitialized() { // Initialize editor actions handler // Add MIME overlay icons (these icons displayed at Project dock panel) const QIcon icon = QIcon::fromTheme(C_PY_MIME_ICON); if (!icon.isNull()) Core::FileIconProvider::registerIconOverlayForMimeType(icon, C_PY_MIMETYPE); } } // namespace Internal } // namespace PythonEditor #include "pythoneditorplugin.moc"