Browse Project Modules
When browsing project modules, the source browser shows in alphabetical order all Python modules and packages that you have placed into your project and all modules and packages reachable by traversing the directory structure that contains your project files (including all sub-directories). The following types of items are present in this display mode, each of which is displayed with its own icon:
- Packages, which are directories that contain a number of files and a special file __init__.py. This file optionally contains a special variable __all__ that lists the file-level modules Python should automatically import when the package as a whole is imported. See the Python documentation for additional information on creating packages.
- Directories found in your project that do not contain the necessary __init__.py file are shown as directories rather than packages.
- Python files found at any level are shown as modules.
Within each top-level package, directory, or module, the browser will display all sub-modules, sub-directories, modules, and any Python constructs. These are all labeled by generic type, including the following types:
- class -- an object class found in Python source
- method -- a class method
- attribute -- a class or instance attribute
- function -- a function defined at the top-level of a Python module
- variable -- a variable defined at the top-level of a Python module
The icons for these are shown in the Options menu in the top right of the source browser. Note that the base icons are modified in color and with arrows depending on whether they are imported or inherited, and whether they are public, semi-private, or private. This is described in more detail later.