diff options
| -rw-r--r-- | docs/library/index.rst | 30 |
1 files changed, 27 insertions, 3 deletions
diff --git a/docs/library/index.rst b/docs/library/index.rst index b997318cea..2e8064c8e9 100644 --- a/docs/library/index.rst +++ b/docs/library/index.rst @@ -1,9 +1,33 @@ MicroPython libraries ===================== -The following standard Python libraries are built in to MicroPython. - -For additional libraries, please download them from the `micropython-lib repository +This chapter described modules (function and class libraries) which are built +into MicroPython. There are few categories of modules: + +* Modules which implement subset of standard Python functionality and are not + intended to be extended by a user. +* Modules which are implement subset of Python functionality, with a provision + for extension by a user (via Python code). +* Modules which implement MicroPython extensions to Python standard libraries. +* Modules specific to a particular port and thus not portable. + +Note about the availability of modules and their contents: This documentation +in general aspires to describe all modules and functions/classes which are +implemented in MicroPython. However, MicroPython is highly configurable, and +each port to a particular board/embedded system makes available only a subset +of MicroPython libraries. For officially supported ports, there is an effort +to either filter out non-applicable items, or mark individual descriptions +with "Availability:" clauses describing which ports provide a given feature. +With that in mind, please still be ready to a fact that some function/class +in a module, or even entire module, described in this documentation, may be +not available in a particular build of MicroPython on a particular board. The +best place to find a general information of the availability/non-availability +of a particular feature is "General Information" secton which contains +information pertaining to a specific port. + +Beyond the built-in libraries described in this documentation, many more +modules from the Python standard library, as well as further MicroPython +extensions to it, can be found in the `micropython-lib repository <https://github.com/micropython/micropython-lib>`_. Python standard libraries and micro-libraries |