eric6/Documentation/Source/eric6.Globals.compatibility_fixes.html

changeset 6942
2602857055c5
parent 5606
da305d172769
diff -r f99d60d6b59b -r 2602857055c5 eric6/Documentation/Source/eric6.Globals.compatibility_fixes.html
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/eric6/Documentation/Source/eric6.Globals.compatibility_fixes.html	Sun Apr 14 15:09:21 2019 +0200
@@ -0,0 +1,382 @@
+<!DOCTYPE html>
+<html><head>
+<title>eric6.Globals.compatibility_fixes</title>
+<meta charset="UTF-8">
+<style>
+body {
+    background: #EDECE6;
+    margin: 0em 1em 10em 1em;
+    color: black;
+}
+
+h1 { color: white; background: #85774A; }
+h2 { color: white; background: #85774A; }
+h3 { color: white; background: #9D936E; }
+h4 { color: white; background: #9D936E; }
+    
+a { color: #BA6D36; }
+
+</style>
+</head>
+<body><a NAME="top" ID="top"></a>
+<h1>eric6.Globals.compatibility_fixes</h1>
+<p>
+Module implementing some workarounds to let eric6 run under Python 2.
+</p>
+<h3>Global Attributes</h3>
+<table>
+<tr><td>__find_module</td></tr><tr><td>__join</td></tr><tr><td>__load_source</td></tr>
+</table>
+<h3>Classes</h3>
+<table>
+<tr>
+<td><a href="#File">File</a></td>
+<td></td>
+</tr><tr>
+<td><a href="#PlainStrList">PlainStrList</a></td>
+<td>Keep track that all added paths to sys.path are str.</td>
+</tr>
+</table>
+<h3>Functions</h3>
+<table>
+<tr>
+<td><a href="#find_moduleAsStr">find_moduleAsStr</a></td>
+<td>Convert none str parameter of the imp.find_module into str.</td>
+</tr><tr>
+<td><a href="#joinAsUnicode">joinAsUnicode</a></td>
+<td>Convert none unicode parameter of the os.path.join into unicode.</td>
+</tr><tr>
+<td><a href="#load_sourceAsStr">load_sourceAsStr</a></td>
+<td>Convert none str parameter of the imp.load_source into str.</td>
+</tr><tr>
+<td><a href="#open">open</a></td>
+<td>Replacement for the build in open function.</td>
+</tr>
+</table>
+<hr /><hr />
+<a NAME="File" ID="File"></a>
+<h2>File</h2>
+
+<h3>Derived from</h3>
+file
+<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="#File.__init__">File</a></td>
+<td>Constructor</td>
+</tr><tr>
+<td><a href="#File.next">next</a></td>
+<td>Public method used in an iterator.</td>
+</tr><tr>
+<td><a href="#File.read">read</a></td>
+<td>Public method to read n bytes or all if n=-1 from file.</td>
+</tr><tr>
+<td><a href="#File.readline">readline</a></td>
+<td>Public method to read one line from file.</td>
+</tr><tr>
+<td><a href="#File.readlines">readlines</a></td>
+<td>Public method to read all lines from file.</td>
+</tr><tr>
+<td><a href="#File.write">write</a></td>
+<td>Public method to write given data to file and encode if needed.</td>
+</tr>
+</table>
+<h3>Static Methods</h3>
+<table>
+<tr><td>None</td></tr>
+</table>
+<a NAME="File.__init__" ID="File.__init__"></a>
+<h4>File (Constructor)</h4>
+<b>File</b>(<i>filein, mode='r', buffering=-1, encoding=None, errors=None, newline=None, closefd=True</i>)
+<p>
+        Constructor
+</p><p>
+        It checks for unimplemented parameters.
+</p><dl>
+<dt><i>filein</i></dt>
+<dd>
+filename or file descriptor (string)
+</dd><dt><i>mode=</i></dt>
+<dd>
+access mode (string)
+</dd><dt><i>buffering=</i></dt>
+<dd>
+size of the read buffer (string)
+</dd><dt><i>encoding=</i></dt>
+<dd>
+character encoding for reading/ writing (string)
+</dd><dt><i>errors=</i></dt>
+<dd>
+behavior for the character encoding ('strict',
+            'explicit', ...) (string)
+</dd><dt><i>newline=</i></dt>
+<dd>
+controls how universal newlines works (string)
+</dd><dt><i>closefd=</i></dt>
+<dd>
+close underlying file descriptor if given as file
+            parameter (boolean)
+</dd>
+</dl><dl>
+<dt>Raises <b>NotImplementedError</b>:</dt>
+<dd>
+for not implemented method parameters
+</dd>
+</dl><a NAME="File.next" ID="File.next"></a>
+<h4>File.next</h4>
+<b>next</b>(<i></i>)
+<p>
+        Public method used in an iterator.
+</p><dl>
+<dt>Returns:</dt>
+<dd>
+decoded data read
+</dd>
+</dl><a NAME="File.read" ID="File.read"></a>
+<h4>File.read</h4>
+<b>read</b>(<i>n=-1</i>)
+<p>
+        Public method to read n bytes or all if n=-1 from file.
+</p><dl>
+<dt><i>n=</i></dt>
+<dd>
+bytecount or all if n=-1 (int)
+</dd>
+</dl><dl>
+<dt>Returns:</dt>
+<dd>
+decoded bytes read
+</dd>
+</dl><a NAME="File.readline" ID="File.readline"></a>
+<h4>File.readline</h4>
+<b>readline</b>(<i>limit=-1</i>)
+<p>
+        Public method to read one line from file.
+</p><dl>
+<dt><i>limit=</i></dt>
+<dd>
+maximum bytes to read or all if limit=-1 (int)
+</dd>
+</dl><dl>
+<dt>Returns:</dt>
+<dd>
+decoded line read
+</dd>
+</dl><a NAME="File.readlines" ID="File.readlines"></a>
+<h4>File.readlines</h4>
+<b>readlines</b>(<i>hint=-1</i>)
+<p>
+        Public method to read all lines from file.
+</p><dl>
+<dt><i>hint=</i></dt>
+<dd>
+maximum bytes to read or all if hint=-1 (int)
+</dd>
+</dl><dl>
+<dt>Returns:</dt>
+<dd>
+decoded lines read
+</dd>
+</dl><a NAME="File.write" ID="File.write"></a>
+<h4>File.write</h4>
+<b>write</b>(<i>txt</i>)
+<p>
+        Public method to write given data to file and encode if needed.
+</p><dl>
+<dt><i>txt</i></dt>
+<dd>
+data to write. (str, bytes)
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="PlainStrList" ID="PlainStrList"></a>
+<h2>PlainStrList</h2>
+<p>
+    Keep track that all added paths to sys.path are str.
+</p>
+<h3>Derived from</h3>
+list
+<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="#PlainStrList.__init__">PlainStrList</a></td>
+<td>Constructor</td>
+</tr><tr>
+<td><a href="#PlainStrList.__convert">__convert</a></td>
+<td>Private method to convert unicode to file system encoding.</td>
+</tr><tr>
+<td><a href="#PlainStrList.__setitem__">__setitem__</a></td>
+<td>Special method to overwrite a specific list item.</td>
+</tr><tr>
+<td><a href="#PlainStrList.insert">insert</a></td>
+<td>Public method to insert a specific list item.</td>
+</tr>
+</table>
+<h3>Static Methods</h3>
+<table>
+<tr><td>None</td></tr>
+</table>
+<a NAME="PlainStrList.__init__" ID="PlainStrList.__init__"></a>
+<h4>PlainStrList (Constructor)</h4>
+<b>PlainStrList</b>(<i>*args</i>)
+<p>
+        Constructor
+</p><dl>
+<dt><i>args</i></dt>
+<dd>
+list of paths to start with (list)
+</dd>
+</dl><a NAME="PlainStrList.__convert" ID="PlainStrList.__convert"></a>
+<h4>PlainStrList.__convert</h4>
+<b>__convert</b>(<i>element</i>)
+<p>
+        Private method to convert unicode to file system encoding.
+</p><dl>
+<dt><i>element</i></dt>
+<dd>
+to convert from unicode to file system encoding (any)
+</dd>
+</dl><dl>
+<dt>Returns:</dt>
+<dd>
+converted element
+</dd>
+</dl><a NAME="PlainStrList.__setitem__" ID="PlainStrList.__setitem__"></a>
+<h4>PlainStrList.__setitem__</h4>
+<b>__setitem__</b>(<i>idx, value</i>)
+<p>
+        Special method to overwrite a specific list item.
+</p><dl>
+<dt><i>idx</i></dt>
+<dd>
+index of the item (int)
+</dd><dt><i>value</i></dt>
+<dd>
+the new value (any)
+</dd>
+</dl><a NAME="PlainStrList.insert" ID="PlainStrList.insert"></a>
+<h4>PlainStrList.insert</h4>
+<b>insert</b>(<i>idx, value</i>)
+<p>
+        Public method to insert a specific list item.
+</p><dl>
+<dt><i>idx</i></dt>
+<dd>
+index of the item (int)
+</dd><dt><i>value</i></dt>
+<dd>
+the new value (any)
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="find_moduleAsStr" ID="find_moduleAsStr"></a>
+<h2>find_moduleAsStr</h2>
+<b>find_moduleAsStr</b>(<i>*args</i>)
+<p>
+    Convert none str parameter of the imp.find_module into str.
+</p><dl>
+<dt><i>args</i></dt>
+<dd>
+(str, unicode)
+</dd>
+</dl><dl>
+<dt>Returns:</dt>
+<dd>
+list of args converted to str (list)
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="joinAsUnicode" ID="joinAsUnicode"></a>
+<h2>joinAsUnicode</h2>
+<b>joinAsUnicode</b>(<i>*args</i>)
+<p>
+    Convert none unicode parameter of the os.path.join into unicode.
+</p><dl>
+<dt><i>args</i></dt>
+<dd>
+paths which should be joined (str, unicode)
+</dd>
+</dl><dl>
+<dt>Returns:</dt>
+<dd>
+unicode str of the path (unicode)
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="load_sourceAsStr" ID="load_sourceAsStr"></a>
+<h2>load_sourceAsStr</h2>
+<b>load_sourceAsStr</b>(<i>*args</i>)
+<p>
+    Convert none str parameter of the imp.load_source into str.
+</p><dl>
+<dt><i>args</i></dt>
+<dd>
+(str, unicode)
+</dd>
+</dl><dl>
+<dt>Returns:</dt>
+<dd>
+list of args converted to str (list)
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="open" ID="open"></a>
+<h2>open</h2>
+<b>open</b>(<i>filein, mode='r', buffering=-1, encoding=None, errors=None, newline=None, closefd=True</i>)
+<p>
+    Replacement for the build in open function.
+</p><dl>
+<dt><i>filein</i></dt>
+<dd>
+filename or file descriptor (string)
+</dd><dt><i>mode=</i></dt>
+<dd>
+access mode (string)
+</dd><dt><i>buffering=</i></dt>
+<dd>
+size of the read buffer (string)
+</dd><dt><i>encoding=</i></dt>
+<dd>
+character encoding for reading/ writing (string)
+</dd><dt><i>errors=</i></dt>
+<dd>
+behavior for the character encoding ('strict',
+        'explicit', ...) (string)
+</dd><dt><i>newline=</i></dt>
+<dd>
+controls how universal newlines works (string)
+</dd><dt><i>closefd=</i></dt>
+<dd>
+close underlying file descriptor if given as file
+        parameter (boolean)
+</dd>
+</dl><dl>
+<dt>Returns:</dt>
+<dd>
+Returns the new file object
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr />
+</body></html>
\ No newline at end of file

eric ide

mercurial