src/panels/terminal/terminalpanel.cpp

   1 /***************************************************************************
   2  *   Copyright (C) 2007-2010 by Peter Penz <peter.penz19@gmail.com>        *
   3  *                                                                         *
   4  *   This program is free software; you can redistribute it and/or modify  *
   5  *   it under the terms of the GNU General Public License as published by  *
   6  *   the Free Software Foundation; either version 2 of the License, or     *
   7  *   (at your option) any later version.                                   *
   8  *                                                                         *
   9  *   This program is distributed in the hope that it will be useful,       *
  10  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
  11  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
  12  *   GNU General Public License for more details.                          *
  13  *                                                                         *
  14  *   You should have received a copy of the GNU General Public License     *
  15  *   along with this program; if not, write to the                         *
  16  *   Free Software Foundation, Inc.,                                       *
  17  *   51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA            *
  18  ***************************************************************************/
  19
  20 #include "terminalpanel.h"
  21
  22 #include <KIO/DesktopExecParser>
  23 #include <KIO/Job>
  24 #include <KIO/JobUiDelegate>
  25 #include <KJobWidgets>
  26 #include <KLocalizedString>
  27 #include <KMessageWidget>
  28 #include <KParts/ReadOnlyPart>
  29 #include <KPluginFactory>
  30 #include <KPluginLoader>
  31 #include <KService>
  32 #include <KShell>
  33 #include <kde_terminal_interface.h>
  34
  35 #include <QAction>
  36 #include <QDesktopServices>
  37 #include <QDir>
  38 #include <QLabel>
  39 #include <QShowEvent>
  40 #include <QTimer>
  41 #include <QVBoxLayout>
  42
  43 TerminalPanel::TerminalPanel(QWidget* parent) :
  44     Panel(parent),
  45     m_clearTerminal(true),
  46     m_mostLocalUrlJob(nullptr),
  47     m_layout(nullptr),
  48     m_terminal(nullptr),
  49     m_terminalWidget(nullptr),
  50     m_konsolePartMissingMessage(nullptr),
  51     m_konsolePart(nullptr),
  52     m_konsolePartCurrentDirectory(),
  53     m_sendCdToTerminalHistory()
  54 {
  55     m_layout = new QVBoxLayout(this);
  56     m_layout->setMargin(0);
  57 }
  58
  59 TerminalPanel::~TerminalPanel()
  60 {
  61 }
  62
  63 void TerminalPanel::goHome()
  64 {
  65     sendCdToTerminal(QDir::homePath(), HistoryPolicy::SkipHistory);
  66 }
  67
  68 QString TerminalPanel::currentWorkingDirectory()
  69 {
  70     if (m_terminal) {
  71         return m_terminal->currentWorkingDirectory();
  72     }
  73     return QString();
  74 }
  75
  76 void TerminalPanel::terminalExited()
  77 {
  78     m_terminal = nullptr;
  79     emit hideTerminalPanel();
  80 }
  81
  82 bool TerminalPanel::isHiddenInVisibleWindow()
  83 {
  84     return parentWidget()
  85         && parentWidget()->isHidden()
  86         && m_terminal
  87         && (m_terminal->foregroundProcessId() == -1);
  88 }
  89
  90 void TerminalPanel::dockVisibilityChanged()
  91 {
  92     // Only react when the DockWidget itself (not some parent) is hidden. This way we don't
  93     // respond when e.g. Dolphin is minimized.
  94     if (isHiddenInVisibleWindow()) {
  95         // Make sure that the following "cd /" command will not affect the view.
  96         disconnect(m_konsolePart, SIGNAL(currentDirectoryChanged(QString)),
  97                    this, SLOT(slotKonsolePartCurrentDirectoryChanged(QString)));
  98
  99         // Make sure this terminal does not prevent unmounting any removable drives
 100         changeDir(QUrl::fromLocalFile(QStringLiteral("/")));
 101
 102         // Because we have disconnected from the part's currentDirectoryChanged()
 103         // signal, we have to update m_konsolePartCurrentDirectory manually. If this
 104         // was not done, showing the panel again might not set the part's working
 105         // directory correctly.
 106         m_konsolePartCurrentDirectory = '/';
 107     }
 108 }
 109
 110 bool TerminalPanel::urlChanged()
 111 {
 112     if (!url().isValid()) {
 113         return false;
 114     }
 115
 116     const bool sendInput = m_terminal && (m_terminal->foregroundProcessId() == -1) && isVisible();
 117     if (sendInput) {
 118         changeDir(url());
 119     }
 120
 121     return true;
 122 }
 123
 124 void TerminalPanel::showEvent(QShowEvent* event)
 125 {
 126     if (event->spontaneous()) {
 127         Panel::showEvent(event);
 128         return;
 129     }
 130
 131     if (!m_terminal) {
 132         m_clearTerminal = true;
 133         KPluginFactory* factory = nullptr;
 134         KService::Ptr service = KService::serviceByDesktopName(QStringLiteral("konsolepart"));
 135         if (service) {
 136             factory = KPluginLoader(service->library()).factory();
 137         }
 138         m_konsolePart = factory ? (factory->create<KParts::ReadOnlyPart>(this)) : nullptr;
 139         if (m_konsolePart) {
 140             connect(m_konsolePart, &KParts::ReadOnlyPart::destroyed, this, &TerminalPanel::terminalExited);
 141             m_terminalWidget = m_konsolePart->widget();
 142             m_layout->addWidget(m_terminalWidget);
 143             if (m_konsolePartMissingMessage) {
 144                 m_layout->removeWidget(m_konsolePartMissingMessage);
 145             }
 146             m_terminal = qobject_cast<TerminalInterface*>(m_konsolePart);
 147         } else if (!m_konsolePartMissingMessage) {
 148             const auto konsoleInstallUrl = QUrl("appstream://org.kde.konsole.desktop");
 149             const auto konsoleNotInstalledText = i18n("Terminal cannot be shown because Konsole is not installed. "
 150                                                       "Please install it and then reopen the panel.");
 151             m_konsolePartMissingMessage = new KMessageWidget(konsoleNotInstalledText, this);
 152             m_konsolePartMissingMessage->setCloseButtonVisible(false);
 153             m_konsolePartMissingMessage->hide();
 154             if (KIO::DesktopExecParser::hasSchemeHandler(konsoleInstallUrl)) {
 155                 auto installKonsoleAction = new QAction(i18n("Install Konsole"), this);
 156                 connect(installKonsoleAction, &QAction::triggered, [konsoleInstallUrl]() {
 157                     QDesktopServices::openUrl(konsoleInstallUrl);
 158                 });
 159                 m_konsolePartMissingMessage->addAction(installKonsoleAction);
 160             }
 161             m_layout->addWidget(m_konsolePartMissingMessage);
 162             m_layout->addStretch();
 163             QTimer::singleShot(0, m_konsolePartMissingMessage, &KMessageWidget::animatedShow);
 164         } else {
 165             m_konsolePartMissingMessage->animatedShow();
 166         }
 167     }
 168     if (m_terminal) {
 169         m_terminal->showShellInDir(url().toLocalFile());
 170         changeDir(url());
 171         m_terminalWidget->setFocus();
 172         connect(m_konsolePart, SIGNAL(currentDirectoryChanged(QString)),
 173                 this, SLOT(slotKonsolePartCurrentDirectoryChanged(QString)));
 174     }
 175
 176     Panel::showEvent(event);
 177 }
 178
 179 void TerminalPanel::changeDir(const QUrl& url)
 180 {
 181     delete m_mostLocalUrlJob;
 182     m_mostLocalUrlJob = nullptr;
 183
 184     if (url.isLocalFile()) {
 185         sendCdToTerminal(url.toLocalFile());
 186     } else {
 187         m_mostLocalUrlJob = KIO::mostLocalUrl(url, KIO::HideProgressInfo);
 188         if (m_mostLocalUrlJob->uiDelegate()) {
 189             KJobWidgets::setWindow(m_mostLocalUrlJob, this);
 190         }
 191         connect(m_mostLocalUrlJob, &KIO::StatJob::result, this, &TerminalPanel::slotMostLocalUrlResult);
 192     }
 193 }
 194
 195 void TerminalPanel::sendCdToTerminal(const QString& dir, HistoryPolicy addToHistory)
 196 {
 197     if (dir == m_konsolePartCurrentDirectory) {
 198         m_clearTerminal = false;
 199         return;
 200     }
 201
 202 #ifndef Q_OS_WIN
 203     if (!m_clearTerminal) {
 204         // The TerminalV2 interface does not provide a way to delete the
 205         // current line before sending a new input. This is mandatory,
 206         // otherwise sending a 'cd x' to a existing 'rm -rf *' might
 207         // result in data loss. As workaround SIGINT is sent.
 208         const int processId = m_terminal->terminalProcessId();
 209         if (processId > 0) {
 210             kill(processId, SIGINT);
 211         }
 212     }
 213 #endif
 214
 215     m_terminal->sendInput(" cd " + KShell::quoteArg(dir) + '\n');
 216
 217     // We want to ignore the currentDirectoryChanged(QString) signal, which we will receive after
 218     // the directory change, because this directory change is not caused by a "cd" command that the
 219     // user entered in the panel. Therefore, we have to remember 'dir'. Note that it could also be
 220     // a symbolic link -> remember the 'canonical' path.
 221     if (addToHistory == HistoryPolicy::AddToHistory)
 222         m_sendCdToTerminalHistory.enqueue(QDir(dir).canonicalPath());
 223
 224     if (m_clearTerminal) {
 225         m_terminal->sendInput(QStringLiteral(" clear\n"));
 226         m_clearTerminal = false;
 227     }
 228 }
 229
 230 void TerminalPanel::slotMostLocalUrlResult(KJob* job)
 231 {
 232     KIO::StatJob* statJob = static_cast<KIO::StatJob *>(job);
 233     const QUrl url = statJob->mostLocalUrl();
 234     if (url.isLocalFile()) {
 235         sendCdToTerminal(url.toLocalFile());
 236     }
 237
 238     m_mostLocalUrlJob = nullptr;
 239 }
 240
 241 void TerminalPanel::slotKonsolePartCurrentDirectoryChanged(const QString& dir)
 242 {
 243     m_konsolePartCurrentDirectory = QDir(dir).canonicalPath();
 244
 245     // Only emit a changeUrl signal if the directory change was caused by the user inside the
 246     // terminal, and not by sendCdToTerminal(QString).
 247     while (!m_sendCdToTerminalHistory.empty()) {
 248         if (m_konsolePartCurrentDirectory == m_sendCdToTerminalHistory.dequeue()) {
 249             return;
 250         }
 251     }
 252
 253     const QUrl url(QUrl::fromLocalFile(dir));
 254     emit changeUrl(url);
 255 }