2014-06-10 21:18:09 +00:00
|
|
|
~~~~
|
2014-06-14 16:38:03 +00:00
|
|
|
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
2014-06-10 21:18:09 +00:00
|
|
|
micropython-lib is highly experimental community project.
|
|
|
|
|
|
2014-06-14 16:38:03 +00:00
|
|
|
Please help to drive it to just "expiremental" state by testing
|
|
|
|
|
provided packages with MicroPython.
|
|
|
|
|
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
2014-06-10 21:18:09 +00:00
|
|
|
~~~~
|
|
|
|
|
|
2014-04-01 10:47:14 +00:00
|
|
|
micropython-lib
|
|
|
|
|
===============
|
2014-06-10 21:18:09 +00:00
|
|
|
micropython-lib is a project to develop non-monolothic standard library
|
|
|
|
|
for MicroPython. Each module or package is available as a seprate
|
|
|
|
|
distribution package from PyPI. Modules either written from scratch or
|
2014-06-14 16:38:03 +00:00
|
|
|
ported from CPython. Note that main target of micropython-lib is so
|
|
|
|
|
far "Unix" port of MicroPython. Actual requirements vary per module
|
|
|
|
|
(basicly, if module is not related to I/O, it should work without
|
|
|
|
|
problem on baremetal ports too).
|
|
|
|
|
|
|
|
|
|
Usage
|
|
|
|
|
-----
|
|
|
|
|
micropython-lib packages are published on PyPI (Python Package Index),
|
|
|
|
|
standard Python community package repository: http://pypi.python.org/ .
|
|
|
|
|
You can search for MicroPython related packages, read additional info,
|
|
|
|
|
etc.
|
|
|
|
|
|
|
|
|
|
To install packages from PyPI for usage on your local system, use
|
|
|
|
|
"pip-micropython" tool, which is a simple wrapper around a standard
|
|
|
|
|
"pip" tool, which is used to install package for CPython.
|
|
|
|
|
"pip-micropython" tool can be found in "tools" subdirectory of the main
|
|
|
|
|
MicroPython repository (https://github.com/micropython/micropython).
|
|
|
|
|
Just install "pip-micropython" script somewhere on your PATH.
|
|
|
|
|
|
|
|
|
|
Afterwards, just use pip-micropython in a way similar to pip:
|
|
|
|
|
|
|
|
|
|
~~~~
|
|
|
|
|
$ pip-micropython install micropython-copy
|
|
|
|
|
$ micropython
|
|
|
|
|
>>> import copy
|
|
|
|
|
>>> copy.copy([1, 2, 3])
|
|
|
|
|
[1, 2, 3]
|
|
|
|
|
~~~~
|
|
|
|
|
|
|
|
|
|
Review pip-micropython source code for more info.
|
2014-06-10 21:18:09 +00:00
|
|
|
|
2014-06-14 16:38:03 +00:00
|
|
|
Development
|
|
|
|
|
-----------
|
|
|
|
|
To install modules during development, use "make install". By default, it
|
|
|
|
|
will install all available packages. You can pass MOD=<module> parameter
|
|
|
|
|
to install specific module.
|
|
|
|
|
|
|
|
|
|
Links
|
|
|
|
|
-----
|
2014-06-10 21:18:09 +00:00
|
|
|
More info:
|
2014-06-14 16:38:03 +00:00
|
|
|
|
2014-06-10 21:18:09 +00:00
|
|
|
* https://github.com/micropython/micropython/issues/405
|
|
|
|
|
* http://forum.micropython.org/viewtopic.php?f=5&t=70
|
|
|
|
|
|
|
|
|
|
Basic guidelines for installing packages from PyPI:
|
|
|
|
|
|
|
|
|
|
* https://github.com/micropython/micropython/issues/413
|
