src/eric7/Documentation/Source/eric7.DocumentationTools.APIGenerator.html

Sat, 26 Apr 2025 12:34:32 +0200

author
Detlev Offenbach <detlev@die-offenbachs.de>
date
Sat, 26 Apr 2025 12:34:32 +0200
branch
eric7
changeset 11240
c48c615c04a3
parent 10479
856476537696
permissions
-rw-r--r--

MicroPython
- Added a configuration option to disable the support for the no longer produced Pimoroni Pico Wireless Pack.

<!DOCTYPE html>
<html><head>
<title>eric7.DocumentationTools.APIGenerator</title>
<meta charset="UTF-8">
<link rel="stylesheet" href="styles.css">
</head>
<body>
<a NAME="top" ID="top"></a>
<h1>eric7.DocumentationTools.APIGenerator</h1>
<p>
Module implementing the builtin API generator.
</p>

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

<h3>Classes</h3>
<table>
<tr>
<td><a href="#APIGenerator">APIGenerator</a></td>
<td>Class implementing the builtin documentation generator.</td>
</tr>
</table>

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

<hr />
<hr />
<a NAME="APIGenerator" ID="APIGenerator"></a>
<h2>APIGenerator</h2>
<p>
    Class implementing the builtin documentation generator.
</p>

<h3>Derived from</h3>
None
<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="#APIGenerator.__init__">APIGenerator</a></td>
<td>Constructor</td>
</tr>
<tr>
<td><a href="#APIGenerator.__addClassVariablesAPI">__addClassVariablesAPI</a></td>
<td>Private method to generate class api section for class variables.</td>
</tr>
<tr>
<td><a href="#APIGenerator.__addClassesAPI">__addClassesAPI</a></td>
<td>Private method to generate the api section for classes.</td>
</tr>
<tr>
<td><a href="#APIGenerator.__addFunctionsAPI">__addFunctionsAPI</a></td>
<td>Private method to generate the api section for functions.</td>
</tr>
<tr>
<td><a href="#APIGenerator.__addGlobalsAPI">__addGlobalsAPI</a></td>
<td>Private method to generate the api section for global variables.</td>
</tr>
<tr>
<td><a href="#APIGenerator.__addMethodsAPI">__addMethodsAPI</a></td>
<td>Private method to generate the api section for class methods.</td>
</tr>
<tr>
<td><a href="#APIGenerator.__isPrivate">__isPrivate</a></td>
<td>Private method to check, if an object is considered private.</td>
</tr>
<tr>
<td><a href="#APIGenerator.genAPI">genAPI</a></td>
<td>Public method to generate the API information.</td>
</tr>
<tr>
<td><a href="#APIGenerator.genBases">genBases</a></td>
<td>Public method to generate the base classes information.</td>
</tr>
</table>

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


<a NAME="APIGenerator.__init__" ID="APIGenerator.__init__"></a>
<h4>APIGenerator (Constructor)</h4>
<b>APIGenerator</b>(<i>module</i>)
<p>
        Constructor
</p>

<dl>

<dt><i>module</i> (Module)</dt>
<dd>
information of the parsed Python file
</dd>
</dl>
<a NAME="APIGenerator.__addClassVariablesAPI" ID="APIGenerator.__addClassVariablesAPI"></a>
<h4>APIGenerator.__addClassVariablesAPI</h4>
<b>__addClassVariablesAPI</b>(<i>className</i>)
<p>
        Private method to generate class api section for class variables.
</p>

<dl>

<dt><i>className</i> (str)</dt>
<dd>
name of the class containing the class variables
</dd>
</dl>
<a NAME="APIGenerator.__addClassesAPI" ID="APIGenerator.__addClassesAPI"></a>
<h4>APIGenerator.__addClassesAPI</h4>
<b>__addClassesAPI</b>(<i></i>)
<p>
        Private method to generate the api section for classes.
</p>

<a NAME="APIGenerator.__addFunctionsAPI" ID="APIGenerator.__addFunctionsAPI"></a>
<h4>APIGenerator.__addFunctionsAPI</h4>
<b>__addFunctionsAPI</b>(<i></i>)
<p>
        Private method to generate the api section for functions.
</p>

<a NAME="APIGenerator.__addGlobalsAPI" ID="APIGenerator.__addGlobalsAPI"></a>
<h4>APIGenerator.__addGlobalsAPI</h4>
<b>__addGlobalsAPI</b>(<i></i>)
<p>
        Private method to generate the api section for global variables.
</p>

<a NAME="APIGenerator.__addMethodsAPI" ID="APIGenerator.__addMethodsAPI"></a>
<h4>APIGenerator.__addMethodsAPI</h4>
<b>__addMethodsAPI</b>(<i>className</i>)
<p>
        Private method to generate the api section for class methods.
</p>

<dl>

<dt><i>className</i> (str)</dt>
<dd>
name of the class containing the method
</dd>
</dl>
<a NAME="APIGenerator.__isPrivate" ID="APIGenerator.__isPrivate"></a>
<h4>APIGenerator.__isPrivate</h4>
<b>__isPrivate</b>(<i>obj</i>)
<p>
        Private method to check, if an object is considered private.
</p>

<dl>

<dt><i>obj</i> (ModuleParser.Attribute, ModuleParser.Class or ModuleParser.Function)</dt>
<dd>
reference to the object to be checked
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
flag indicating, that object is considered private
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
bool
</dd>
</dl>
<a NAME="APIGenerator.genAPI" ID="APIGenerator.genAPI"></a>
<h4>APIGenerator.genAPI</h4>
<b>genAPI</b>(<i>basePackage, includePrivate</i>)
<p>
        Public method to generate the API information.
</p>

<dl>

<dt><i>basePackage</i> (str)</dt>
<dd>
name of the base package
</dd>
<dt><i>includePrivate</i> (bool)</dt>
<dd>
flag indicating to include
            private methods/functions
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
API information
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
list of str
</dd>
</dl>
<a NAME="APIGenerator.genBases" ID="APIGenerator.genBases"></a>
<h4>APIGenerator.genBases</h4>
<b>genBases</b>(<i>includePrivate</i>)
<p>
        Public method to generate the base classes information.
</p>

<dl>

<dt><i>includePrivate</i> (bool)</dt>
<dd>
flag indicating to include private classes
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
base classes information
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
dictionary of list of str
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
</body></html>

eric ide

mercurial