src/eric7/Documentation/Source/eric7.Plugins.VcsPlugins.vcsPySvn.SvnLogBrowserDialog.html

Mon, 22 Apr 2024 18:23:20 +0200

author
Detlev Offenbach <detlev@die-offenbachs.de>
date
Mon, 22 Apr 2024 18:23:20 +0200
branch
eric7
changeset 10690
fab36645aa7d
parent 10479
856476537696
permissions
-rw-r--r--

Changed the source code and the source code documentation to improve the indication of unused method/function arguments.

<!DOCTYPE html>
<html><head>
<title>eric7.Plugins.VcsPlugins.vcsPySvn.SvnLogBrowserDialog</title>
<meta charset="UTF-8">
<link rel="stylesheet" href="styles.css">
</head>
<body>
<a NAME="top" ID="top"></a>
<h1>eric7.Plugins.VcsPlugins.vcsPySvn.SvnLogBrowserDialog</h1>
<p>
Module implementing a dialog to browse the log history.
</p>

<h3>Global Attributes</h3>
<table>
<tr><td>None</td></tr>
</table>

<h3>Classes</h3>
<table>
<tr>
<td><a href="#SvnLogBrowserDialog">SvnLogBrowserDialog</a></td>
<td>Class implementing a dialog to browse the log history.</td>
</tr>
</table>

<h3>Functions</h3>
<table>
<tr><td>None</td></tr>
</table>

<hr />
<hr />
<a NAME="SvnLogBrowserDialog" ID="SvnLogBrowserDialog"></a>
<h2>SvnLogBrowserDialog</h2>
<p>
    Class implementing a dialog to browse the log history.
</p>

<h3>Derived from</h3>
QWidget, SvnDialogMixin, Ui_SvnLogBrowserDialog
<h3>Class Attributes</h3>
<table>
<tr><td>None</td></tr>
</table>

<h3>Class Methods</h3>
<table>
<tr><td>None</td></tr>
</table>

<h3>Methods</h3>
<table>
<tr>
<td><a href="#SvnLogBrowserDialog.__init__">SvnLogBrowserDialog</a></td>
<td>Constructor</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.__diffRevisions">__diffRevisions</a></td>
<td>Private method to do a diff of two revisions.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.__filterLogs">__filterLogs</a></td>
<td>Private method to filter the log entries.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.__finish">__finish</a></td>
<td>Private slot called when the user pressed the button.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.__generateFileItem">__generateFileItem</a></td>
<td>Private method to generate a changed files tree entry.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.__generateLogItem">__generateLogItem</a></td>
<td>Private method to generate a log tree entry.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.__getLogEntries">__getLogEntries</a></td>
<td>Private method to retrieve log entries from the repository.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.__initData">__initData</a></td>
<td>Private method to (re-)initialize some data.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.__resetUI">__resetUI</a></td>
<td>Private method to reset the user interface.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.__resizeColumnsFiles">__resizeColumnsFiles</a></td>
<td>Private method to resize the changed files tree columns.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.__resizeColumnsLog">__resizeColumnsLog</a></td>
<td>Private method to resize the log tree columns.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.__resortFiles">__resortFiles</a></td>
<td>Private method to resort the changed files tree.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.__resortLog">__resortLog</a></td>
<td>Private method to resort the log tree.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.__showError">__showError</a></td>
<td>Private slot to show an error message.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog._reset">_reset</a></td>
<td>Protected method to reset the internal state of the dialog.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.closeEvent">closeEvent</a></td>
<td>Protected slot implementing a close event handler.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.on_buttonBox_clicked">on_buttonBox_clicked</a></td>
<td>Private slot called by a button of the button box clicked.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.on_diffPreviousButton_clicked">on_diffPreviousButton_clicked</a></td>
<td>Private slot to handle the Diff to Previous button.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.on_diffRevisionsButton_clicked">on_diffRevisionsButton_clicked</a></td>
<td>Private slot to handle the Compare Revisions button.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.on_downButton_clicked">on_downButton_clicked</a></td>
<td>Private slot to move the current item down one entry.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.on_fieldCombo_activated">on_fieldCombo_activated</a></td>
<td>Private slot called, when a new filter field is selected.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.on_fromDate_dateChanged">on_fromDate_dateChanged</a></td>
<td>Private slot called, when the from date changes.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.on_logTree_currentItemChanged">on_logTree_currentItemChanged</a></td>
<td>Private slot called, when the current item of the log tree changes.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.on_logTree_itemSelectionChanged">on_logTree_itemSelectionChanged</a></td>
<td>Private slot called, when the selection has changed.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.on_nextButton_clicked">on_nextButton_clicked</a></td>
<td>Private slot to handle the Next button.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.on_rxEdit_textChanged">on_rxEdit_textChanged</a></td>
<td>Private slot called, when a filter expression is entered.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.on_stopCheckBox_clicked">on_stopCheckBox_clicked</a></td>
<td>Private slot called, when the stop on copy/move checkbox is clicked.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.on_toDate_dateChanged">on_toDate_dateChanged</a></td>
<td>Private slot called, when the from date changes.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.on_upButton_clicked">on_upButton_clicked</a></td>
<td>Private slot to move the current item up one entry.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.show">show</a></td>
<td>Public slot to show the dialog.</td>
</tr>
<tr>
<td><a href="#SvnLogBrowserDialog.start">start</a></td>
<td>Public slot to start the svn log command.</td>
</tr>
</table>

<h3>Static Methods</h3>
<table>
<tr><td>None</td></tr>
</table>


<a NAME="SvnLogBrowserDialog.__init__" ID="SvnLogBrowserDialog.__init__"></a>
<h4>SvnLogBrowserDialog (Constructor)</h4>
<b>SvnLogBrowserDialog</b>(<i>vcs, parent=None</i>)
<p>
        Constructor
</p>

<dl>

<dt><i>vcs</i> (Subversion)</dt>
<dd>
reference to the vcs object
</dd>
<dt><i>parent</i> (QWidget)</dt>
<dd>
parent widget
</dd>
</dl>
<a NAME="SvnLogBrowserDialog.__diffRevisions" ID="SvnLogBrowserDialog.__diffRevisions"></a>
<h4>SvnLogBrowserDialog.__diffRevisions</h4>
<b>__diffRevisions</b>(<i>rev1, rev2, peg_rev</i>)
<p>
        Private method to do a diff of two revisions.
</p>

<dl>

<dt><i>rev1</i> (int)</dt>
<dd>
first revision number
</dd>
<dt><i>rev2</i> (int)</dt>
<dd>
second revision number
</dd>
<dt><i>peg_rev</i> (int)</dt>
<dd>
revision number to use as a reference
</dd>
</dl>
<a NAME="SvnLogBrowserDialog.__filterLogs" ID="SvnLogBrowserDialog.__filterLogs"></a>
<h4>SvnLogBrowserDialog.__filterLogs</h4>
<b>__filterLogs</b>(<i></i>)
<p>
        Private method to filter the log entries.
</p>

<a NAME="SvnLogBrowserDialog.__finish" ID="SvnLogBrowserDialog.__finish"></a>
<h4>SvnLogBrowserDialog.__finish</h4>
<b>__finish</b>(<i></i>)
<p>
        Private slot called when the user pressed the button.
</p>

<a NAME="SvnLogBrowserDialog.__generateFileItem" ID="SvnLogBrowserDialog.__generateFileItem"></a>
<h4>SvnLogBrowserDialog.__generateFileItem</h4>
<b>__generateFileItem</b>(<i>action, path, copyFrom, copyRev</i>)
<p>
        Private method to generate a changed files tree entry.
</p>

<dl>

<dt><i>action</i> (str)</dt>
<dd>
indicator for the change action ("A", "D" or "M")
</dd>
<dt><i>path</i> (str)</dt>
<dd>
path of the file in the repository
</dd>
<dt><i>copyFrom</i> (str)</dt>
<dd>
path the file was copied from
</dd>
<dt><i>copyRev</i> (str)</dt>
<dd>
revision the file was copied from
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
reference to the generated item
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
QTreeWidgetItem
</dd>
</dl>
<a NAME="SvnLogBrowserDialog.__generateLogItem" ID="SvnLogBrowserDialog.__generateLogItem"></a>
<h4>SvnLogBrowserDialog.__generateLogItem</h4>
<b>__generateLogItem</b>(<i>author, date, message, revision, changedPaths</i>)
<p>
        Private method to generate a log tree entry.
</p>

<dl>

<dt><i>author</i> (str)</dt>
<dd>
author info
</dd>
<dt><i>date</i> (int)</dt>
<dd>
date info
</dd>
<dt><i>message</i> (str)</dt>
<dd>
text of the log message
</dd>
<dt><i>revision</i> (str or pysvn.opt_revision_kind)</dt>
<dd>
revision info
</dd>
<dt><i>changedPaths</i> (dict like)</dt>
<dd>
list of pysvn dictionary like objects containing
            info about the changed files/directories
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
reference to the generated item
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
QTreeWidgetItem
</dd>
</dl>
<a NAME="SvnLogBrowserDialog.__getLogEntries" ID="SvnLogBrowserDialog.__getLogEntries"></a>
<h4>SvnLogBrowserDialog.__getLogEntries</h4>
<b>__getLogEntries</b>(<i>startRev=None</i>)
<p>
        Private method to retrieve log entries from the repository.
</p>

<dl>

<dt><i>startRev</i> (tuple of (int, str))</dt>
<dd>
revision number to start from
</dd>
</dl>
<a NAME="SvnLogBrowserDialog.__initData" ID="SvnLogBrowserDialog.__initData"></a>
<h4>SvnLogBrowserDialog.__initData</h4>
<b>__initData</b>(<i></i>)
<p>
        Private method to (re-)initialize some data.
</p>

<a NAME="SvnLogBrowserDialog.__resetUI" ID="SvnLogBrowserDialog.__resetUI"></a>
<h4>SvnLogBrowserDialog.__resetUI</h4>
<b>__resetUI</b>(<i></i>)
<p>
        Private method to reset the user interface.
</p>

<a NAME="SvnLogBrowserDialog.__resizeColumnsFiles" ID="SvnLogBrowserDialog.__resizeColumnsFiles"></a>
<h4>SvnLogBrowserDialog.__resizeColumnsFiles</h4>
<b>__resizeColumnsFiles</b>(<i></i>)
<p>
        Private method to resize the changed files tree columns.
</p>

<a NAME="SvnLogBrowserDialog.__resizeColumnsLog" ID="SvnLogBrowserDialog.__resizeColumnsLog"></a>
<h4>SvnLogBrowserDialog.__resizeColumnsLog</h4>
<b>__resizeColumnsLog</b>(<i></i>)
<p>
        Private method to resize the log tree columns.
</p>

<a NAME="SvnLogBrowserDialog.__resortFiles" ID="SvnLogBrowserDialog.__resortFiles"></a>
<h4>SvnLogBrowserDialog.__resortFiles</h4>
<b>__resortFiles</b>(<i></i>)
<p>
        Private method to resort the changed files tree.
</p>

<a NAME="SvnLogBrowserDialog.__resortLog" ID="SvnLogBrowserDialog.__resortLog"></a>
<h4>SvnLogBrowserDialog.__resortLog</h4>
<b>__resortLog</b>(<i></i>)
<p>
        Private method to resort the log tree.
</p>

<a NAME="SvnLogBrowserDialog.__showError" ID="SvnLogBrowserDialog.__showError"></a>
<h4>SvnLogBrowserDialog.__showError</h4>
<b>__showError</b>(<i>msg</i>)
<p>
        Private slot to show an error message.
</p>

<dl>

<dt><i>msg</i> (str)</dt>
<dd>
error message to show
</dd>
</dl>
<a NAME="SvnLogBrowserDialog._reset" ID="SvnLogBrowserDialog._reset"></a>
<h4>SvnLogBrowserDialog._reset</h4>
<b>_reset</b>(<i></i>)
<p>
        Protected method to reset the internal state of the dialog.
</p>

<a NAME="SvnLogBrowserDialog.closeEvent" ID="SvnLogBrowserDialog.closeEvent"></a>
<h4>SvnLogBrowserDialog.closeEvent</h4>
<b>closeEvent</b>(<i>e</i>)
<p>
        Protected slot implementing a close event handler.
</p>

<dl>

<dt><i>e</i> (QCloseEvent)</dt>
<dd>
close event
</dd>
</dl>
<a NAME="SvnLogBrowserDialog.on_buttonBox_clicked" ID="SvnLogBrowserDialog.on_buttonBox_clicked"></a>
<h4>SvnLogBrowserDialog.on_buttonBox_clicked</h4>
<b>on_buttonBox_clicked</b>(<i>button</i>)
<p>
        Private slot called by a button of the button box clicked.
</p>

<dl>

<dt><i>button</i> (QAbstractButton)</dt>
<dd>
button that was clicked
</dd>
</dl>
<a NAME="SvnLogBrowserDialog.on_diffPreviousButton_clicked" ID="SvnLogBrowserDialog.on_diffPreviousButton_clicked"></a>
<h4>SvnLogBrowserDialog.on_diffPreviousButton_clicked</h4>
<b>on_diffPreviousButton_clicked</b>(<i></i>)
<p>
        Private slot to handle the Diff to Previous button.
</p>

<a NAME="SvnLogBrowserDialog.on_diffRevisionsButton_clicked" ID="SvnLogBrowserDialog.on_diffRevisionsButton_clicked"></a>
<h4>SvnLogBrowserDialog.on_diffRevisionsButton_clicked</h4>
<b>on_diffRevisionsButton_clicked</b>(<i></i>)
<p>
        Private slot to handle the Compare Revisions button.
</p>

<a NAME="SvnLogBrowserDialog.on_downButton_clicked" ID="SvnLogBrowserDialog.on_downButton_clicked"></a>
<h4>SvnLogBrowserDialog.on_downButton_clicked</h4>
<b>on_downButton_clicked</b>(<i></i>)
<p>
        Private slot to move the current item down one entry.
</p>

<a NAME="SvnLogBrowserDialog.on_fieldCombo_activated" ID="SvnLogBrowserDialog.on_fieldCombo_activated"></a>
<h4>SvnLogBrowserDialog.on_fieldCombo_activated</h4>
<b>on_fieldCombo_activated</b>(<i>_index</i>)
<p>
        Private slot called, when a new filter field is selected.
</p>

<dl>

<dt><i>_index</i> (int)</dt>
<dd>
index of the selected entry (unused)
</dd>
</dl>
<a NAME="SvnLogBrowserDialog.on_fromDate_dateChanged" ID="SvnLogBrowserDialog.on_fromDate_dateChanged"></a>
<h4>SvnLogBrowserDialog.on_fromDate_dateChanged</h4>
<b>on_fromDate_dateChanged</b>(<i>_date</i>)
<p>
        Private slot called, when the from date changes.
</p>

<dl>

<dt><i>_date</i> (QDate)</dt>
<dd>
new date (unused)
</dd>
</dl>
<a NAME="SvnLogBrowserDialog.on_logTree_currentItemChanged" ID="SvnLogBrowserDialog.on_logTree_currentItemChanged"></a>
<h4>SvnLogBrowserDialog.on_logTree_currentItemChanged</h4>
<b>on_logTree_currentItemChanged</b>(<i>current, previous</i>)
<p>
        Private slot called, when the current item of the log tree changes.
</p>

<dl>

<dt><i>current</i> (QTreeWidgetItem)</dt>
<dd>
reference to the new current item
</dd>
<dt><i>previous</i> (QTreeWidgetItem)</dt>
<dd>
reference to the old current item
</dd>
</dl>
<a NAME="SvnLogBrowserDialog.on_logTree_itemSelectionChanged" ID="SvnLogBrowserDialog.on_logTree_itemSelectionChanged"></a>
<h4>SvnLogBrowserDialog.on_logTree_itemSelectionChanged</h4>
<b>on_logTree_itemSelectionChanged</b>(<i></i>)
<p>
        Private slot called, when the selection has changed.
</p>

<a NAME="SvnLogBrowserDialog.on_nextButton_clicked" ID="SvnLogBrowserDialog.on_nextButton_clicked"></a>
<h4>SvnLogBrowserDialog.on_nextButton_clicked</h4>
<b>on_nextButton_clicked</b>(<i></i>)
<p>
        Private slot to handle the Next button.
</p>

<a NAME="SvnLogBrowserDialog.on_rxEdit_textChanged" ID="SvnLogBrowserDialog.on_rxEdit_textChanged"></a>
<h4>SvnLogBrowserDialog.on_rxEdit_textChanged</h4>
<b>on_rxEdit_textChanged</b>(<i>_txt</i>)
<p>
        Private slot called, when a filter expression is entered.
</p>

<dl>

<dt><i>_txt</i> (str)</dt>
<dd>
filter expression (unused)
</dd>
</dl>
<a NAME="SvnLogBrowserDialog.on_stopCheckBox_clicked" ID="SvnLogBrowserDialog.on_stopCheckBox_clicked"></a>
<h4>SvnLogBrowserDialog.on_stopCheckBox_clicked</h4>
<b>on_stopCheckBox_clicked</b>(<i>_checked</i>)
<p>
        Private slot called, when the stop on copy/move checkbox is clicked.
</p>

<dl>

<dt><i>_checked</i> (bool)</dt>
<dd>
flag indicating the check box state (unused)
</dd>
</dl>
<a NAME="SvnLogBrowserDialog.on_toDate_dateChanged" ID="SvnLogBrowserDialog.on_toDate_dateChanged"></a>
<h4>SvnLogBrowserDialog.on_toDate_dateChanged</h4>
<b>on_toDate_dateChanged</b>(<i>_date</i>)
<p>
        Private slot called, when the from date changes.
</p>

<dl>

<dt><i>_date</i> (QDate)</dt>
<dd>
new date (unused)
</dd>
</dl>
<a NAME="SvnLogBrowserDialog.on_upButton_clicked" ID="SvnLogBrowserDialog.on_upButton_clicked"></a>
<h4>SvnLogBrowserDialog.on_upButton_clicked</h4>
<b>on_upButton_clicked</b>(<i></i>)
<p>
        Private slot to move the current item up one entry.
</p>

<a NAME="SvnLogBrowserDialog.show" ID="SvnLogBrowserDialog.show"></a>
<h4>SvnLogBrowserDialog.show</h4>
<b>show</b>(<i></i>)
<p>
        Public slot to show the dialog.
</p>

<a NAME="SvnLogBrowserDialog.start" ID="SvnLogBrowserDialog.start"></a>
<h4>SvnLogBrowserDialog.start</h4>
<b>start</b>(<i>fn, isFile=False</i>)
<p>
        Public slot to start the svn log command.
</p>

<dl>

<dt><i>fn</i> (str)</dt>
<dd>
filename to show the log for
</dd>
<dt><i>isFile</i> (bool)</dt>
<dd>
flag indicating log for a file is to be shown
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
</body></html>

eric ide

mercurial