Documentation/Source/eric5.DocumentationTools.APIGenerator.html

changeset 58
37f0444c3479
parent 21
b88a0e6268bd
child 253
3ccdf551bde7
equal deleted inserted replaced
57:81326a94fdca 58:37f0444c3479
20 </style> 20 </style>
21 </head> 21 </head>
22 <body><a NAME="top" ID="top"></a> 22 <body><a NAME="top" ID="top"></a>
23 <h1>eric5.DocumentationTools.APIGenerator</h1> 23 <h1>eric5.DocumentationTools.APIGenerator</h1>
24 <p> 24 <p>
25 &#77;&#111;&#100;&#117;&#108;&#101; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#116;&#104;&#101; &#98;&#117;&#105;&#108;&#116;&#105;&#110; &#65;&#80;&#73; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#111;&#114;. 25 Module implementing the builtin API generator.
26 </p> 26 </p>
27 <h3>Global Attributes</h3> 27 <h3>Global Attributes</h3>
28 <table> 28 <table>
29 <tr><td>None</td></tr> 29 <tr><td>None</td></tr>
30 </table> 30 </table>
31 <h3>Classes</h3> 31 <h3>Classes</h3>
32 <table> 32 <table>
33 <tr> 33 <tr>
34 <td><a href="#APIGenerator">APIGenerator</a></td> 34 <td><a href="#APIGenerator">APIGenerator</a></td>
35 <td>&#67;&#108;&#97;&#115;&#115; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#116;&#104;&#101; &#98;&#117;&#105;&#108;&#116;&#105;&#110; &#100;&#111;&#99;&#117;&#109;&#101;&#110;&#116;&#97;&#116;&#105;&#111;&#110; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#111;&#114;.</td> 35 <td>Class implementing the builtin documentation generator.</td>
36 </tr> 36 </tr>
37 </table> 37 </table>
38 <h3>Functions</h3> 38 <h3>Functions</h3>
39 <table> 39 <table>
40 <tr><td>None</td></tr> 40 <tr><td>None</td></tr>
41 </table> 41 </table>
42 <hr /><hr /> 42 <hr /><hr />
43 <a NAME="APIGenerator" ID="APIGenerator"></a> 43 <a NAME="APIGenerator" ID="APIGenerator"></a>
44 <h2>APIGenerator</h2> 44 <h2>APIGenerator</h2>
45 <p> 45 <p>
46 &#67;&#108;&#97;&#115;&#115; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#116;&#104;&#101; &#98;&#117;&#105;&#108;&#116;&#105;&#110; &#100;&#111;&#99;&#117;&#109;&#101;&#110;&#116;&#97;&#116;&#105;&#111;&#110; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#111;&#114;. 46 Class implementing the builtin documentation generator.
47 </p> 47 </p>
48 <h3>Derived from</h3> 48 <h3>Derived from</h3>
49 object 49 object
50 <h3>Class Attributes</h3> 50 <h3>Class Attributes</h3>
51 <table> 51 <table>
53 </table> 53 </table>
54 <h3>Methods</h3> 54 <h3>Methods</h3>
55 <table> 55 <table>
56 <tr> 56 <tr>
57 <td><a href="#APIGenerator.__init__">APIGenerator</a></td> 57 <td><a href="#APIGenerator.__init__">APIGenerator</a></td>
58 <td>&#67;&#111;&#110;&#115;&#116;&#114;&#117;&#99;&#116;&#111;&#114;</td> 58 <td>Constructor</td>
59 </tr><tr> 59 </tr><tr>
60 <td><a href="#APIGenerator.__addClassVariablesAPI">__addClassVariablesAPI</a></td> 60 <td><a href="#APIGenerator.__addClassVariablesAPI">__addClassVariablesAPI</a></td>
61 <td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#99;&#108;&#97;&#115;&#115; &#97;&#112;&#105; &#115;&#101;&#99;&#116;&#105;&#111;&#110; &#102;&#111;&#114; &#99;&#108;&#97;&#115;&#115; v&#97;&#114;&#105;&#97;&#98;&#108;&#101;&#115;.</td> 61 <td>Private method to generate class api section for class variables.</td>
62 </tr><tr> 62 </tr><tr>
63 <td><a href="#APIGenerator.__addClassesAPI">__addClassesAPI</a></td> 63 <td><a href="#APIGenerator.__addClassesAPI">__addClassesAPI</a></td>
64 <td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#116;&#104;&#101; &#97;&#112;&#105; &#115;&#101;&#99;&#116;&#105;&#111;&#110; &#102;&#111;&#114; &#99;&#108;&#97;&#115;&#115;&#101;&#115;.</td> 64 <td>Private method to generate the api section for classes.</td>
65 </tr><tr> 65 </tr><tr>
66 <td><a href="#APIGenerator.__addFunctionsAPI">__addFunctionsAPI</a></td> 66 <td><a href="#APIGenerator.__addFunctionsAPI">__addFunctionsAPI</a></td>
67 <td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#116;&#104;&#101; &#97;&#112;&#105; &#115;&#101;&#99;&#116;&#105;&#111;&#110; &#102;&#111;&#114; &#102;&#117;&#110;&#99;&#116;&#105;&#111;&#110;&#115;.</td> 67 <td>Private method to generate the api section for functions.</td>
68 </tr><tr> 68 </tr><tr>
69 <td><a href="#APIGenerator.__addGlobalsAPI">__addGlobalsAPI</a></td> 69 <td><a href="#APIGenerator.__addGlobalsAPI">__addGlobalsAPI</a></td>
70 <td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#116;&#104;&#101; &#97;&#112;&#105; &#115;&#101;&#99;&#116;&#105;&#111;&#110; &#102;&#111;&#114; &#103;&#108;&#111;&#98;&#97;&#108; v&#97;&#114;&#105;&#97;&#98;&#108;&#101;&#115;.</td> 70 <td>Private method to generate the api section for global variables.</td>
71 </tr><tr> 71 </tr><tr>
72 <td><a href="#APIGenerator.__addMethodsAPI">__addMethodsAPI</a></td> 72 <td><a href="#APIGenerator.__addMethodsAPI">__addMethodsAPI</a></td>
73 <td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#116;&#104;&#101; &#97;&#112;&#105; &#115;&#101;&#99;&#116;&#105;&#111;&#110; &#102;&#111;&#114; &#99;&#108;&#97;&#115;&#115; &#109;&#101;&#116;&#104;&#111;&#100;&#115;.</td> 73 <td>Private method to generate the api section for class methods.</td>
74 </tr><tr> 74 </tr><tr>
75 <td><a href="#APIGenerator.__isPrivate">__isPrivate</a></td> 75 <td><a href="#APIGenerator.__isPrivate">__isPrivate</a></td>
76 <td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#99;&#104;&#101;&#99;&#107;, &#105;&#102; &#97;&#110; &#111;&#98;&#106;&#101;&#99;&#116; &#105;&#115; &#99;&#111;&#110;&#115;&#105;&#100;&#101;&#114;&#101;&#100; &#112;&#114;&#105;v&#97;&#116;&#101;.</td> 76 <td>Private method to check, if an object is considered private.</td>
77 </tr><tr> 77 </tr><tr>
78 <td><a href="#APIGenerator.genAPI">genAPI</a></td> 78 <td><a href="#APIGenerator.genAPI">genAPI</a></td>
79 <td>&#77;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#116;&#104;&#101; &#115;&#111;&#117;&#114;&#99;&#101; &#99;&#111;&#100;&#101; &#100;&#111;&#99;&#117;&#109;&#101;&#110;&#116;&#97;&#116;&#105;&#111;&#110;.</td> 79 <td>Method to generate the source code documentation.</td>
80 </tr> 80 </tr>
81 </table> 81 </table>
82 <a NAME="APIGenerator.__init__" ID="APIGenerator.__init__"></a> 82 <a NAME="APIGenerator.__init__" ID="APIGenerator.__init__"></a>
83 <h4>APIGenerator (Constructor)</h4> 83 <h4>APIGenerator (Constructor)</h4>
84 <b>APIGenerator</b>(<i>module</i>) 84 <b>APIGenerator</b>(<i>module</i>)
85 <p> 85 <p>
86 &#67;&#111;&#110;&#115;&#116;&#114;&#117;&#99;&#116;&#111;&#114; 86 Constructor
87 </p><dl> 87 </p><dl>
88 <dt><i>module</i></dt> 88 <dt><i>module</i></dt>
89 <dd> 89 <dd>
90 &#84;&#104;&#101; &#105;&#110;&#102;&#111;&#114;&#109;&#97;&#116;&#105;&#111;&#110; &#111;&#102; &#116;&#104;&#101; &#112;&#97;&#114;&#115;&#101;&#100; &#80;y&#116;&#104;&#111;&#110; &#102;&#105;&#108;&#101;. 90 The information of the parsed Python file.
91 </dd> 91 </dd>
92 </dl><a NAME="APIGenerator.__addClassVariablesAPI" ID="APIGenerator.__addClassVariablesAPI"></a> 92 </dl><a NAME="APIGenerator.__addClassVariablesAPI" ID="APIGenerator.__addClassVariablesAPI"></a>
93 <h4>APIGenerator.__addClassVariablesAPI</h4> 93 <h4>APIGenerator.__addClassVariablesAPI</h4>
94 <b>__addClassVariablesAPI</b>(<i>className</i>) 94 <b>__addClassVariablesAPI</b>(<i>className</i>)
95 <p> 95 <p>
96 &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#99;&#108;&#97;&#115;&#115; &#97;&#112;&#105; &#115;&#101;&#99;&#116;&#105;&#111;&#110; &#102;&#111;&#114; &#99;&#108;&#97;&#115;&#115; v&#97;&#114;&#105;&#97;&#98;&#108;&#101;&#115;. 96 Private method to generate class api section for class variables.
97 </p><dl> 97 </p><dl>
98 <dt><i>classname</i></dt> 98 <dt><i>classname</i></dt>
99 <dd> 99 <dd>
100 &#78;&#97;&#109;&#101; &#111;&#102; &#116;&#104;&#101; &#99;&#108;&#97;&#115;&#115; &#99;&#111;&#110;&#116;&#97;&#105;&#110;&#105;&#110;&#103; &#116;&#104;&#101; &#99;&#108;&#97;&#115;&#115; v&#97;&#114;&#105;&#97;&#98;&#108;&#101;&#115;. (&#115;&#116;&#114;&#105;&#110;&#103;) 100 Name of the class containing the class variables. (string)
101 </dd> 101 </dd>
102 </dl><a NAME="APIGenerator.__addClassesAPI" ID="APIGenerator.__addClassesAPI"></a> 102 </dl><a NAME="APIGenerator.__addClassesAPI" ID="APIGenerator.__addClassesAPI"></a>
103 <h4>APIGenerator.__addClassesAPI</h4> 103 <h4>APIGenerator.__addClassesAPI</h4>
104 <b>__addClassesAPI</b>(<i></i>) 104 <b>__addClassesAPI</b>(<i></i>)
105 <p> 105 <p>
106 &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#116;&#104;&#101; &#97;&#112;&#105; &#115;&#101;&#99;&#116;&#105;&#111;&#110; &#102;&#111;&#114; &#99;&#108;&#97;&#115;&#115;&#101;&#115;. 106 Private method to generate the api section for classes.
107 </p><a NAME="APIGenerator.__addFunctionsAPI" ID="APIGenerator.__addFunctionsAPI"></a> 107 </p><a NAME="APIGenerator.__addFunctionsAPI" ID="APIGenerator.__addFunctionsAPI"></a>
108 <h4>APIGenerator.__addFunctionsAPI</h4> 108 <h4>APIGenerator.__addFunctionsAPI</h4>
109 <b>__addFunctionsAPI</b>(<i></i>) 109 <b>__addFunctionsAPI</b>(<i></i>)
110 <p> 110 <p>
111 &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#116;&#104;&#101; &#97;&#112;&#105; &#115;&#101;&#99;&#116;&#105;&#111;&#110; &#102;&#111;&#114; &#102;&#117;&#110;&#99;&#116;&#105;&#111;&#110;&#115;. 111 Private method to generate the api section for functions.
112 </p><a NAME="APIGenerator.__addGlobalsAPI" ID="APIGenerator.__addGlobalsAPI"></a> 112 </p><a NAME="APIGenerator.__addGlobalsAPI" ID="APIGenerator.__addGlobalsAPI"></a>
113 <h4>APIGenerator.__addGlobalsAPI</h4> 113 <h4>APIGenerator.__addGlobalsAPI</h4>
114 <b>__addGlobalsAPI</b>(<i></i>) 114 <b>__addGlobalsAPI</b>(<i></i>)
115 <p> 115 <p>
116 &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#116;&#104;&#101; &#97;&#112;&#105; &#115;&#101;&#99;&#116;&#105;&#111;&#110; &#102;&#111;&#114; &#103;&#108;&#111;&#98;&#97;&#108; v&#97;&#114;&#105;&#97;&#98;&#108;&#101;&#115;. 116 Private method to generate the api section for global variables.
117 </p><a NAME="APIGenerator.__addMethodsAPI" ID="APIGenerator.__addMethodsAPI"></a> 117 </p><a NAME="APIGenerator.__addMethodsAPI" ID="APIGenerator.__addMethodsAPI"></a>
118 <h4>APIGenerator.__addMethodsAPI</h4> 118 <h4>APIGenerator.__addMethodsAPI</h4>
119 <b>__addMethodsAPI</b>(<i>className</i>) 119 <b>__addMethodsAPI</b>(<i>className</i>)
120 <p> 120 <p>
121 &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#116;&#104;&#101; &#97;&#112;&#105; &#115;&#101;&#99;&#116;&#105;&#111;&#110; &#102;&#111;&#114; &#99;&#108;&#97;&#115;&#115; &#109;&#101;&#116;&#104;&#111;&#100;&#115;. 121 Private method to generate the api section for class methods.
122 </p><dl> 122 </p><dl>
123 <dt><i>classname</i></dt> 123 <dt><i>classname</i></dt>
124 <dd> 124 <dd>
125 &#78;&#97;&#109;&#101; &#111;&#102; &#116;&#104;&#101; &#99;&#108;&#97;&#115;&#115; &#99;&#111;&#110;&#116;&#97;&#105;&#110;&#105;&#110;&#103; &#116;&#104;&#101; &#109;&#101;&#116;&#104;&#111;&#100;. (&#115;&#116;&#114;&#105;&#110;&#103;) 125 Name of the class containing the method. (string)
126 </dd> 126 </dd>
127 </dl><a NAME="APIGenerator.__isPrivate" ID="APIGenerator.__isPrivate"></a> 127 </dl><a NAME="APIGenerator.__isPrivate" ID="APIGenerator.__isPrivate"></a>
128 <h4>APIGenerator.__isPrivate</h4> 128 <h4>APIGenerator.__isPrivate</h4>
129 <b>__isPrivate</b>(<i>obj</i>) 129 <b>__isPrivate</b>(<i>obj</i>)
130 <p> 130 <p>
131 &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#99;&#104;&#101;&#99;&#107;, &#105;&#102; &#97;&#110; &#111;&#98;&#106;&#101;&#99;&#116; &#105;&#115; &#99;&#111;&#110;&#115;&#105;&#100;&#101;&#114;&#101;&#100; &#112;&#114;&#105;v&#97;&#116;&#101;. 131 Private method to check, if an object is considered private.
132 </p><dl> 132 </p><dl>
133 <dt><i>obj</i></dt> 133 <dt><i>obj</i></dt>
134 <dd> 134 <dd>
135 &#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101; &#116;&#111; &#116;&#104;&#101; &#111;&#98;&#106;&#101;&#99;&#116; &#116;&#111; &#98;&#101; &#99;&#104;&#101;&#99;&#107;&#101;&#100; 135 reference to the object to be checked
136 </dd> 136 </dd>
137 </dl><dl> 137 </dl><dl>
138 <dt>Returns:</dt> 138 <dt>Returns:</dt>
139 <dd> 139 <dd>
140 &#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103;, &#116;&#104;&#97;&#116; &#111;&#98;&#106;&#101;&#99;&#116; &#105;&#115; &#99;&#111;&#110;&#115;&#105;&#100;&#101;&#114;&#101;&#100; &#112;&#114;&#105;v&#97;&#116;&#101; (&#98;&#111;&#111;&#108;&#101;&#97;&#110;) 140 flag indicating, that object is considered private (boolean)
141 </dd> 141 </dd>
142 </dl><a NAME="APIGenerator.genAPI" ID="APIGenerator.genAPI"></a> 142 </dl><a NAME="APIGenerator.genAPI" ID="APIGenerator.genAPI"></a>
143 <h4>APIGenerator.genAPI</h4> 143 <h4>APIGenerator.genAPI</h4>
144 <b>genAPI</b>(<i>newStyle, basePackage, includePrivate</i>) 144 <b>genAPI</b>(<i>newStyle, basePackage, includePrivate</i>)
145 <p> 145 <p>
146 &#77;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#116;&#104;&#101; &#115;&#111;&#117;&#114;&#99;&#101; &#99;&#111;&#100;&#101; &#100;&#111;&#99;&#117;&#109;&#101;&#110;&#116;&#97;&#116;&#105;&#111;&#110;. 146 Method to generate the source code documentation.
147 </p><dl> 147 </p><dl>
148 <dt><i>newStyle</i></dt> 148 <dt><i>newStyle</i></dt>
149 <dd> 149 <dd>
150 &#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103; &#116;&#104;&#101; &#97;&#112;&#105; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#105;&#111;&#110; &#102;&#111;&#114; &#81;&#83;&#99;&#105;&#110;&#116;&#105;&#108;&#108;&#97; &#49;.&#55; &#97;&#110;&#100; 150 flag indicating the api generation for QScintilla 1.7 and
151 &#110;&#101;w&#101;&#114; (&#98;&#111;&#111;&#108;&#101;&#97;&#110;) 151 newer (boolean)
152 </dd><dt><i>basePackage</i></dt> 152 </dd><dt><i>basePackage</i></dt>
153 <dd> 153 <dd>
154 &#110;&#97;&#109;&#101; &#111;&#102; &#116;&#104;&#101; &#98;&#97;&#115;&#101; &#112;&#97;&#99;&#107;&#97;&#103;&#101; (&#115;&#116;&#114;&#105;&#110;&#103;) 154 name of the base package (string)
155 </dd><dt><i>includePrivate</i></dt> 155 </dd><dt><i>includePrivate</i></dt>
156 <dd> 156 <dd>
157 &#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103; &#116;&#111; &#105;&#110;&#99;&#108;&#117;&#100;&#101; 157 flag indicating to include
158 &#112;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100;&#115;/&#102;&#117;&#110;&#99;&#116;&#105;&#111;&#110;&#115; (&#98;&#111;&#111;&#108;&#101;&#97;&#110;) 158 private methods/functions (boolean)
159 </dd> 159 </dd>
160 </dl><dl> 160 </dl><dl>
161 <dt>Returns:</dt> 161 <dt>Returns:</dt>
162 <dd> 162 <dd>
163 &#84;&#104;&#101; &#65;&#80;&#73; &#105;&#110;&#102;&#111;&#114;&#109;&#97;&#116;&#105;&#111;&#110;. (&#115;&#116;&#114;&#105;&#110;&#103;) 163 The API information. (string)
164 </dd> 164 </dd>
165 </dl> 165 </dl>
166 <div align="right"><a href="#top">Up</a></div> 166 <div align="right"><a href="#top">Up</a></div>
167 <hr /> 167 <hr />
168 </body></html> 168 </body></html>

eric ide

mercurial