This is a repository of libraries designed to be useful for writing MicroPython applications.
 
 
Go to file
Brian Pugh 0051a5ef50 pathlib: Add initial pathlib implementation.
This adds most of the common functionality of pathlib.Path.

The glob functionality could use some work; currently it only supports a
single "*" wildcard; however, this is the vast majority of common use-cases
and it won't fail silently if non-supported glob patterns are provided.
2022-11-17 14:26:33 +11:00
.github/workflows workflows: Add initial GitHub workflows support, with code formatting. 2021-05-27 22:42:43 +10:00
micropython nrf24l01: Improve test to add RP2 support, fix ESP32. 2022-11-15 23:50:04 +11:00
python-ecosys all: Replace metadata.txt with manifest.py. 2022-09-05 17:50:28 +10:00
python-stdlib pathlib: Add initial pathlib implementation. 2022-11-17 14:26:33 +11:00
tools tools/build.py: Make build.py work without f-strings. 2022-09-29 23:51:03 +10:00
unix-ffi unittest: Move back to python-stdlib. 2022-09-13 09:57:04 +10:00
.gitignore
CONTRIBUTING.md CONTRIBUTING.md: Add file with a link to Contributor Guidelines. 2015-05-03 21:07:17 +03:00
LICENSE all: Update READMEs. 2021-05-27 15:41:08 +10:00
README.md micropython/mip: Add a new `mip` library for on-device installation. 2022-09-29 22:54:32 +10:00

README.md

micropython-lib

This is a repository of libraries designed to be useful for writing MicroPython applications.

The libraries here fall into four categories corresponding to the four top-level directories:

  • python-stdlib: Compatible versions of modules from the Python Standard Library. These should be drop-in replacements for the Python libraries, although many have reduced functionality or missing methods or classes (which may not be an issue for many most cases).

  • python-ecosys: Compatible, but reduced-functionality versions of modules from the larger Python ecosystem, for example that might be found in the Python Package Index.

  • micropython: MicroPython-specific modules that do not have equivalents in other Python environments. These are typically hardware drivers or highly-optimised alternative implementations of functionality available in other Python modules.

  • unix-ffi: These modules are specifically for the MicroPython Unix port and provide access to operating-system and third-party libraries via FFI.

Usage

Many libraries are self contained modules, and you can quickly get started by copying the relevant Python file to your device. For example, to add the base64 library, you can directly copy python-stdlib/base64/base64.py to the lib directory on your device.

Other libraries are packages, in which case you'll need to copy the directory instead. For example, to add collections.defaultdict, copy collections/collections/__init__.py and collections.defaultdict/collections/defaultdict.py to a directory named lib/collections on your device.

Future plans (and new contributor ideas)

  • Develop a set of example programs using these libraries.
  • Develop more MicroPython libraries for common tasks.