diff -r 1779dc278077 -r 391d6b7b1eff eric6/Documentation/Source/eric6.MicroPython.MicroPythonFileManager.html --- a/eric6/Documentation/Source/eric6.MicroPython.MicroPythonFileManager.html Wed Sep 25 19:40:31 2019 +0200 +++ b/eric6/Documentation/Source/eric6.MicroPython.MicroPythonFileManager.html Wed Sep 25 19:42:44 2019 +0200 @@ -18,77 +18,98 @@ </style> </head> -<body><a NAME="top" ID="top"></a> +<body> +<a NAME="top" ID="top"></a> <h1>eric6.MicroPython.MicroPythonFileManager</h1> + <p> Module implementing some file system commands for MicroPython. </p> <h3>Global Attributes</h3> + <table> <tr><td>None</td></tr> </table> <h3>Classes</h3> + <table> + <tr> <td><a href="#MicroPythonFileManager">MicroPythonFileManager</a></td> <td>Class implementing an interface to the device file system commands with some additional sugar.</td> </tr> </table> <h3>Functions</h3> + <table> <tr><td>None</td></tr> </table> -<hr /><hr /> +<hr /> +<hr /> <a NAME="MicroPythonFileManager" ID="MicroPythonFileManager"></a> <h2>MicroPythonFileManager</h2> + <p> Class implementing an interface to the device file system commands with some additional sugar. -</p><h3>Signals</h3> +</p> +<h3>Signals</h3> <dl> + <dt>createDirectoryDone()</dt> <dd> emitted after a directory was created -</dd><dt>currentDir(dirname)</dt> +</dd> +<dt>currentDir(dirname)</dt> <dd> emitted to report the current directory of the device -</dd><dt>currentDirChanged(dirname)</dt> +</dd> +<dt>currentDirChanged(dirname)</dt> <dd> emitted to report back a change of the current directory -</dd><dt>deleteFileDone(deviceFile)</dt> +</dd> +<dt>deleteFileDone(deviceFile)</dt> <dd> emitted after the file has been deleted on the connected device -</dd><dt>error(exc)</dt> +</dd> +<dt>error(exc)</dt> <dd> emitted with a failure message to indicate a failure during the most recent operation -</dd><dt>fsinfoDone(fsinfo)</dt> +</dd> +<dt>fsinfoDone(fsinfo)</dt> <dd> emitted after the file system information was obtained -</dd><dt>getFileDone(deviceFile, localFile)</dt> +</dd> +<dt>getFileDone(deviceFile, localFile)</dt> <dd> emitted after the file was fetched from the connected device and written to the local file system -</dd><dt>longListFiles(result)</dt> +</dd> +<dt>longListFiles(result)</dt> <dd> emitted with a tuple of tuples containing the name, mode, size and time for each directory entry -</dd><dt>putFileDone(localFile, deviceFile)</dt> +</dd> +<dt>putFileDone(localFile, deviceFile)</dt> <dd> emitted after the file was copied to the connected device -</dd><dt>removeDirectoryDone()</dt> +</dd> +<dt>removeDirectoryDone()</dt> <dd> emitted after a directory has been deleted -</dd><dt>rsyncDone(localName, deviceName)</dt> +</dd> +<dt>rsyncDone(localName, deviceName)</dt> <dd> emitted after the rsync operation has been completed -</dd><dt>rsyncProgressMessage(msg)</dt> +</dd> +<dt>rsyncProgressMessage(msg)</dt> <dd> emitted to send a message about what rsync is doing @@ -97,213 +118,287 @@ <h3>Derived from</h3> QObject <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="#MicroPythonFileManager.__init__">MicroPythonFileManager</a></td> <td>Constructor</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicroPythonFileManager.__rsync">__rsync</a></td> <td>Private method to synchronize a local directory to the device.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicroPythonFileManager.cd">cd</a></td> <td>Public slot to change the current directory of the device.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicroPythonFileManager.delete">delete</a></td> <td>Public slot to delete a file on the device.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicroPythonFileManager.fileSystemInfo">fileSystemInfo</a></td> <td>Public method to obtain information about the currently mounted file systems.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicroPythonFileManager.get">get</a></td> <td>Public slot to get a file from the connected device.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicroPythonFileManager.lls">lls</a></td> <td>Public slot to get a long listing of the given directory.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicroPythonFileManager.mkdir">mkdir</a></td> <td>Public slot to create a new directory.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicroPythonFileManager.put">put</a></td> <td>Public slot to put a file onto the device.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicroPythonFileManager.pwd">pwd</a></td> <td>Public slot to get the current directory of the device.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicroPythonFileManager.rmdir">rmdir</a></td> <td>Public slot to (recursively) remove a directory.</td> -</tr><tr> +</tr> +<tr> <td><a href="#MicroPythonFileManager.rsync">rsync</a></td> <td>Public slot to synchronize a local directory to the device.</td> </tr> </table> <h3>Static Methods</h3> + <table> <tr><td>None</td></tr> </table> + <a NAME="MicroPythonFileManager.__init__" ID="MicroPythonFileManager.__init__"></a> <h4>MicroPythonFileManager (Constructor)</h4> <b>MicroPythonFileManager</b>(<i>commandsInterface, parent=None</i>) + <p> Constructor -</p><dl> +</p> +<dl> + <dt><i>commandsInterface</i> (MicroPythonCommandsInterface)</dt> <dd> reference to the commands interface object -</dd><dt><i>parent</i> (QObject)</dt> +</dd> +<dt><i>parent</i> (QObject)</dt> <dd> reference to the parent object </dd> -</dl><a NAME="MicroPythonFileManager.__rsync" ID="MicroPythonFileManager.__rsync"></a> +</dl> +<a NAME="MicroPythonFileManager.__rsync" ID="MicroPythonFileManager.__rsync"></a> <h4>MicroPythonFileManager.__rsync</h4> <b>__rsync</b>(<i>hostDirectory, deviceDirectory, mirror=True, localDevice=False, indentLevel=0</i>) + <p> Private method to synchronize a local directory to the device. -</p><dl> +</p> +<dl> + <dt><i>hostDirectory</i> (str)</dt> <dd> name of the local directory -</dd><dt><i>deviceDirectory</i> (str)</dt> +</dd> +<dt><i>deviceDirectory</i> (str)</dt> <dd> name of the directory on the device -</dd><dt><i>mirror</i> (bool)</dt> +</dd> +<dt><i>mirror</i> (bool)</dt> <dd> flag indicating to mirror the local directory to the device directory -</dd><dt><i>localDevice</i> (bool)</dt> +</dd> +<dt><i>localDevice</i> (bool)</dt> <dd> flag indicating device access via local file system -</dd><dt><i>indentLevel</i> (int)</dt> +</dd> +<dt><i>indentLevel</i> (int)</dt> <dd> indentation level for progress messages </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> list of errors </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> list of str </dd> -</dl><a NAME="MicroPythonFileManager.cd" ID="MicroPythonFileManager.cd"></a> +</dl> +<a NAME="MicroPythonFileManager.cd" ID="MicroPythonFileManager.cd"></a> <h4>MicroPythonFileManager.cd</h4> <b>cd</b>(<i>dirname</i>) + <p> Public slot to change the current directory of the device. -</p><dl> +</p> +<dl> + <dt><i>dirname</i> (str)</dt> <dd> name of the desired current directory </dd> -</dl><a NAME="MicroPythonFileManager.delete" ID="MicroPythonFileManager.delete"></a> +</dl> +<a NAME="MicroPythonFileManager.delete" ID="MicroPythonFileManager.delete"></a> <h4>MicroPythonFileManager.delete</h4> <b>delete</b>(<i>deviceFileName</i>) + <p> Public slot to delete a file on the device. -</p><dl> +</p> +<dl> + <dt><i>deviceFileName</i> (str)</dt> <dd> name of the file on the connected device </dd> -</dl><a NAME="MicroPythonFileManager.fileSystemInfo" ID="MicroPythonFileManager.fileSystemInfo"></a> +</dl> +<a NAME="MicroPythonFileManager.fileSystemInfo" ID="MicroPythonFileManager.fileSystemInfo"></a> <h4>MicroPythonFileManager.fileSystemInfo</h4> <b>fileSystemInfo</b>(<i></i>) + <p> Public method to obtain information about the currently mounted file systems. -</p><a NAME="MicroPythonFileManager.get" ID="MicroPythonFileManager.get"></a> +</p> +<a NAME="MicroPythonFileManager.get" ID="MicroPythonFileManager.get"></a> <h4>MicroPythonFileManager.get</h4> <b>get</b>(<i>deviceFileName, hostFileName=""</i>) + <p> Public slot to get a file from the connected device. -</p><dl> +</p> +<dl> + <dt><i>deviceFileName</i> (str)</dt> <dd> name of the file on the device -</dd><dt><i>hostFileName</i> (str)</dt> +</dd> +<dt><i>hostFileName</i> (str)</dt> <dd> name of the local file </dd> -</dl><a NAME="MicroPythonFileManager.lls" ID="MicroPythonFileManager.lls"></a> +</dl> +<a NAME="MicroPythonFileManager.lls" ID="MicroPythonFileManager.lls"></a> <h4>MicroPythonFileManager.lls</h4> <b>lls</b>(<i>dirname, showHidden=False</i>) + <p> Public slot to get a long listing of the given directory. -</p><dl> +</p> +<dl> + <dt><i>dirname</i> (str)</dt> <dd> name of the directory to list -</dd><dt><i>showHidden</i> (bool)</dt> +</dd> +<dt><i>showHidden</i> (bool)</dt> <dd> flag indicating to show hidden files as well </dd> -</dl><a NAME="MicroPythonFileManager.mkdir" ID="MicroPythonFileManager.mkdir"></a> +</dl> +<a NAME="MicroPythonFileManager.mkdir" ID="MicroPythonFileManager.mkdir"></a> <h4>MicroPythonFileManager.mkdir</h4> <b>mkdir</b>(<i>dirname</i>) + <p> Public slot to create a new directory. -</p><dl> +</p> +<dl> + <dt><i>dirname</i> (str)</dt> <dd> name of the directory to create </dd> -</dl><a NAME="MicroPythonFileManager.put" ID="MicroPythonFileManager.put"></a> +</dl> +<a NAME="MicroPythonFileManager.put" ID="MicroPythonFileManager.put"></a> <h4>MicroPythonFileManager.put</h4> <b>put</b>(<i>hostFileName, deviceFileName=""</i>) + <p> Public slot to put a file onto the device. -</p><dl> +</p> +<dl> + <dt><i>hostFileName</i> (str)</dt> <dd> name of the local file -</dd><dt><i>deviceFileName</i> (str)</dt> +</dd> +<dt><i>deviceFileName</i> (str)</dt> <dd> name of the file on the connected device </dd> -</dl><a NAME="MicroPythonFileManager.pwd" ID="MicroPythonFileManager.pwd"></a> +</dl> +<a NAME="MicroPythonFileManager.pwd" ID="MicroPythonFileManager.pwd"></a> <h4>MicroPythonFileManager.pwd</h4> <b>pwd</b>(<i></i>) + <p> Public slot to get the current directory of the device. -</p><a NAME="MicroPythonFileManager.rmdir" ID="MicroPythonFileManager.rmdir"></a> +</p> +<a NAME="MicroPythonFileManager.rmdir" ID="MicroPythonFileManager.rmdir"></a> <h4>MicroPythonFileManager.rmdir</h4> <b>rmdir</b>(<i>dirname, recursive=False</i>) + <p> Public slot to (recursively) remove a directory. -</p><dl> +</p> +<dl> + <dt><i>dirname</i> (str)</dt> <dd> name of the directory to be removed -</dd><dt><i>recursive</i> (bool)</dt> +</dd> +<dt><i>recursive</i> (bool)</dt> <dd> flag indicating a recursive removal </dd> -</dl><a NAME="MicroPythonFileManager.rsync" ID="MicroPythonFileManager.rsync"></a> +</dl> +<a NAME="MicroPythonFileManager.rsync" ID="MicroPythonFileManager.rsync"></a> <h4>MicroPythonFileManager.rsync</h4> <b>rsync</b>(<i>hostDirectory, deviceDirectory, mirror=True, localDevice=False</i>) + <p> Public slot to synchronize a local directory to the device. -</p><dl> +</p> +<dl> + <dt><i>hostDirectory</i> (str)</dt> <dd> name of the local directory -</dd><dt><i>deviceDirectory</i> (str)</dt> +</dd> +<dt><i>deviceDirectory</i> (str)</dt> <dd> name of the directory on the device -</dd><dt><i>mirror</i> (bool)</dt> +</dd> +<dt><i>mirror</i> (bool)</dt> <dd> flag indicating to mirror the local directory to the device directory -</dd><dt><i>localDevice</i> (bool)</dt> +</dd> +<dt><i>localDevice</i> (bool)</dt> <dd> flag indicating device access via local file system </dd>