Merge pull request #1 from micropython/master

update from original micropython-lib

Author: nirinA

README.md

@@ -1,4 +1,61 @@
+~~~~
+!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+micropython-lib is highly experimental community project.
+
+Please help to drive it to just "expiremental" state by testing
+provided packages with MicroPython.
+!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+~~~~
+
 micropython-lib
 ===============
+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
+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.
+
+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
+-----
+More info:
+
+ * https://github.com/micropython/micropython/issues/405
+ * http://forum.micropython.org/viewtopic.php?f=5&t=70
+
+Basic guidelines for installing packages from PyPI:
 
-Core Python libraries ported to Micro Python
+ * https://github.com/micropython/micropython/issues/413

_libc/_libc.py

@@ -0,0 +1,24 @@
+import ffi
+
+
+_h = None
+
+names = ('libc.so', 'libc.so.0', 'libc.so.6')
+
+def get():
+    global _h
+    if _h:
+        return _h
+    err = None
+    for n in names:
+        try:
+            _h = ffi.open(n)
+            return _h
+        except OSError as e:
+            err = e
+    raise err
+
+
+def set_names(n):
+    global names
+    names = n

_libc/metadata.txt

@@ -0,0 +1,7 @@
+dist_name = libc
+srctype = micropython-lib
+type = module
+version = 0.1
+author = Paul Sokolovsky
+desc = MicroPython FFI helper module
+long_desc = MicroPython FFI helper module to interface with underlying libc

_libc/setup.py

@@ -0,0 +1,18 @@
+import sys
+# Remove current dir from sys.path, otherwise setuptools will peek up our
+# module instead of system.
+sys.path.pop(0)
+from setuptools import setup
+
+
+setup(name='micropython-libc',
+      version='0.1',
+      description='MicroPython FFI helper module',
+      long_description='MicroPython FFI helper module to interface with underlying libc',
+      url='https://github.com/micropython/micropython/issues/405',
+      author='Paul Sokolovsky',
+      author_email='[email protected]',
+      maintainer='MicroPython Developers',
+      maintainer_email='[email protected]',
+      license='MIT',
+      py_modules=['_libc'])

fcntl/fcntl.py

@@ -1,7 +1,8 @@
 import ffi
+import _libc
 
 
-libc = ffi.open("libc.so.6")
+libc = _libc.get()
 
 fcntl_l = libc.func("i", "fcntl", "iil")
 fcntl_s = libc.func("i", "fcntl", "iip")

fcntl/metadata.txt

@@ -0,0 +1,5 @@
+srctype = micropython-lib
+type = module
+version = 0.0.2
+author = Paul Sokolovsky
+depends = libc

fcntl/setup.py

@@ -1,10 +1,19 @@
-from distutils.core import setup
+import sys
+# Remove current dir from sys.path, otherwise setuptools will peek up our
+# module instead of system.
+sys.path.pop(0)
+from setuptools import setup
+
 
 setup(name='micropython-fcntl',
-      version='0.0.1',
+      version='0.0.2',
       description='fcntl module for MicroPython',
+      long_description="This is a module reimplemented specifically for MicroPython standard library,\nwith efficient and lean design in mind. Note that this module is likely work\nin progress and likely supports just a subset of CPython's corresponding\nmodule. Please help with the development if you are interested in this\nmodule.",
       url='https://github.com/micropython/micropython/issues/405',
-      author='MicroPython Developers',
+      author='Paul Sokolovsky',
       author_email='[email protected]',
+      maintainer='MicroPython Developers',
+      maintainer_email='[email protected]',
       license='MIT',
-      py_modules=['fcntl'])
+      py_modules=['fcntl'],
+      install_requires=['micropython-libc'])

functools/functools.py

@@ -4,3 +4,13 @@ def _partial(*more_args, **more_kwargs):
         kw.update(more_kwargs)
         func(*(args + more_args), **kw)
     return _partial
+
+
+def update_wrapper(wrapper, wrapped):
+    # Dummy impl
+    return wrapper
+
+
+def wraps(wrapped):
+    # Dummy impl
+    return wrapped

functools/metadata.txt

@@ -1,3 +1,3 @@
 srctype = micropython-lib
 type = module
-version = 0.0.1
+version = 0.0.2

functools/setup.py

@@ -6,7 +6,7 @@
 
 
 setup(name='micropython-functools',
-      version='0.0.1',
+      version='0.0.2',
       description='functools module for MicroPython',
       long_description="This is a module reimplemented specifically for MicroPython standard library,\nwith efficient and lean design in mind. Note that this module is likely work\nin progress and likely supports just a subset of CPython's corresponding\nmodule. Please help with the development if you are interested in this\nmodule.",
       url='https://github.com/micropython/micropython/issues/405',

getpass/getpass.py

@@ -0,0 +1,3 @@
+srctype = dummy
+type = module
+version = 0.0.0

getpass/metadata.txt

@@ -0,0 +1,18 @@
+import sys
+# Remove current dir from sys.path, otherwise setuptools will peek up our
+# module instead of system.
+sys.path.pop(0)
+from setuptools import setup
+
+
+setup(name='micropython-getpass',
+      version='0.0.0',
+      description='Dummy getpass module for MicroPython',
+      long_description='This is a dummy implementation of a module for MicroPython standard library.\nIt contains zero or very little functionality, and primarily intended to\navoid import errors (using idea that even if an application imports a\nmodule, it may be not using it onevery code path, so may work at least\npartially). It is expected that more complete implementation of the module\nwill be provided later. Please help with the development if you are\ninterested in this module.',
+      url='https://github.com/micropython/micropython/issues/405',
+      author='MicroPython Developers',
+      author_email='[email protected]',
+      maintainer='MicroPython Developers',
+      maintainer_email='[email protected]',
+      license='MIT',
+      py_modules=['getpass'])

getpass/setup.py

@@ -1,6 +1,7 @@
 """Filename globbing utility."""
 
 import os
+import os.path
 import re
 import fnmatch
 

glob/glob.py

@@ -1,4 +1,4 @@
 srctype = cpython
 type = module
-version = 0.5
+version = 0.5.1
 depends = os, re-pcre, fnmatch

glob/metadata.txt

@@ -6,7 +6,7 @@
 
 
 setup(name='micropython-glob',
-      version='0.5',
+      version='0.5.1',
       description='CPython glob module ported to MicroPython',
       long_description='This is a module ported from CPython standard library to be compatible with\nMicroPython interpreter. Usually, this means applying small patches for\nfeatures not supported (yet, or at all) in MicroPython. Sometimes, heavier\nchanges are required. Note that CPython modules are written with availability\nof vast resources in mind, and may not work for MicroPython ports with\nlimited heap. If you are affected by such a case, please help reimplement\nthe module from scratch.',
       url='https://github.com/micropython/micropython/issues/405',

glob/setup.py

@@ -30,7 +30,7 @@
 
 # Original code by Kevin O'Connor, augmented by Tim Peters and Raymond Hettinger
 
-__about__ = """Heap queues
+"""Heap queues
 
 [explanation by François Pinard]
 
@@ -127,7 +127,7 @@
 __all__ = ['heappush', 'heappop', 'heapify', 'heapreplace', 'merge',
            'nlargest', 'nsmallest', 'heappushpop']
 
-from itertools import islice, count, tee, chain
+#from itertools import count, tee, chain
 
 def heappush(heap, item):
     """Push item onto heap, maintaining the heap invariant."""
@@ -197,6 +197,7 @@ def nlargest(n, iterable):
 
     Equivalent to:  sorted(iterable, reverse=True)[:n]
     """
+    from itertools import islice, count, tee, chain
     if n < 0:
         return []
     it = iter(iterable)
@@ -215,6 +216,7 @@ def nsmallest(n, iterable):
 
     Equivalent to:  sorted(iterable)[:n]
     """
+    from itertools import islice, count, tee, chain
     if n < 0:
         return []
     it = iter(iterable)
@@ -392,6 +394,7 @@ def nsmallest(n, iterable, key=None):
 
     Equivalent to:  sorted(iterable, key=key)[:n]
     """
+    from itertools import islice, count, tee, chain
     # Short-cut for n==1 is to use min() when len(iterable)>0
     if n == 1:
         it = iter(iterable)
@@ -430,6 +433,7 @@ def nlargest(n, iterable, key=None):
     Equivalent to:  sorted(iterable, key=key, reverse=True)[:n]
     """
 
+    from itertools import islice, count, tee, chain
     # Short-cut for n==1 is to use max() when len(iterable)>0
     if n == 1:
         it = iter(iterable)

heapq/heapq.py

@@ -0,0 +1,5 @@
+srctype = cpython
+type = module
+version = 0.9.2
+# Module uses in *some* functions, but we don't want to depend on it
+#depends = itertools

heapq/metadata.txt

@@ -1,16 +1,18 @@
 import sys
-# Remove current dir from sys.path, otherwise distutils will peek up our
-# copy module instead of system.
+# Remove current dir from sys.path, otherwise setuptools will peek up our
+# module instead of system.
 sys.path.pop(0)
 from setuptools import setup
 
+
 setup(name='micropython-heapq',
-      version='0.9',
+      version='0.9.2',
       description='CPython heapq module ported to MicroPython',
+      long_description='This is a module ported from CPython standard library to be compatible with\nMicroPython interpreter. Usually, this means applying small patches for\nfeatures not supported (yet, or at all) in MicroPython. Sometimes, heavier\nchanges are required. Note that CPython modules are written with availability\nof vast resources in mind, and may not work for MicroPython ports with\nlimited heap. If you are affected by such a case, please help reimplement\nthe module from scratch.',
       url='https://github.com/micropython/micropython/issues/405',
       author='CPython Developers',
+      author_email='[email protected]',
       maintainer='MicroPython Developers',
       maintainer_email='[email protected]',
       license='Python',
-      install_requires=['micropython-itertools'],
       py_modules=['heapq'])

heapq/setup.py

@@ -0,0 +1,4 @@
+srctype = cpython
+type = package
+version = 0.5
+depends = email.parser, email.message, socket, collections, urllib.parse, warnings

http.client/metadata.txt

@@ -0,0 +1,19 @@
+import sys
+# Remove current dir from sys.path, otherwise setuptools will peek up our
+# module instead of system.
+sys.path.pop(0)
+from setuptools import setup
+
+
+setup(name='micropython-http.client',
+      version='0.5',
+      description='CPython http.client module ported to MicroPython',
+      long_description='This is a module ported from CPython standard library to be compatible with\nMicroPython interpreter. Usually, this means applying small patches for\nfeatures not supported (yet, or at all) in MicroPython. Sometimes, heavier\nchanges are required. Note that CPython modules are written with availability\nof vast resources in mind, and may not work for MicroPython ports with\nlimited heap. If you are affected by such a case, please help reimplement\nthe module from scratch.',
+      url='https://github.com/micropython/micropython/issues/405',
+      author='CPython Developers',
+      author_email='[email protected]',
+      maintainer='MicroPython Developers',
+      maintainer_email='[email protected]',
+      license='Python',
+      packages=['http'],
+      install_requires=['micropython-email.parser', 'micropython-email.message', 'micropython-socket', 'micropython-collections', 'micropython-urllib.parse', 'micropython-warnings'])

http.client/setup.py

@@ -2,7 +2,7 @@
 
 
 conn = HTTPConnection("localhost")
-#conn = HTTPConnection("micropython.org")
+#conn = HTTPConnection("python.org")
 conn.request("GET", "/")
 resp = conn.getresponse()
 print(resp)

http.client/test_client.py

@@ -0,0 +1 @@
+from _io import *

io/io.py

@@ -0,0 +1,3 @@
+srctype = dummy
+type = module
+version = 0.0.1

io/metadata.txt

@@ -0,0 +1,18 @@
+import sys
+# Remove current dir from sys.path, otherwise setuptools will peek up our
+# module instead of system.
+sys.path.pop(0)
+from setuptools import setup
+
+
+setup(name='micropython-io',
+      version='0.0.1',
+      description='Dummy io module for MicroPython',
+      long_description='This is a dummy implementation of a module for MicroPython standard library.\nIt contains zero or very little functionality, and primarily intended to\navoid import errors (using idea that even if an application imports a\nmodule, it may be not using it onevery code path, so may work at least\npartially). It is expected that more complete implementation of the module\nwill be provided later. Please help with the development if you are\ninterested in this module.',
+      url='https://github.com/micropython/micropython/issues/405',
+      author='MicroPython Developers',
+      author_email='[email protected]',
+      maintainer='MicroPython Developers',
+      maintainer_email='[email protected]',
+      license='MIT',
+      py_modules=['io'])

io/setup.py

@@ -0,0 +1,3 @@
+srctype = dummy
+type = module
+version = 0.0.0

ipaddress/ipaddress.py

@@ -0,0 +1,18 @@
+import sys
+# Remove current dir from sys.path, otherwise setuptools will peek up our
+# module instead of system.
+sys.path.pop(0)
+from setuptools import setup
+
+
+setup(name='micropython-ipaddress',
+      version='0.0.0',
+      description='Dummy ipaddress module for MicroPython',
+      long_description='This is a dummy implementation of a module for MicroPython standard library.\nIt contains zero or very little functionality, and primarily intended to\navoid import errors (using idea that even if an application imports a\nmodule, it may be not using it onevery code path, so may work at least\npartially). It is expected that more complete implementation of the module\nwill be provided later. Please help with the development if you are\ninterested in this module.',
+      url='https://github.com/micropython/micropython/issues/405',
+      author='MicroPython Developers',
+      author_email='[email protected]',
+      maintainer='MicroPython Developers',
+      maintainer_email='[email protected]',
+      license='MIT',
+      py_modules=['ipaddress'])

ipaddress/metadata.txt

@@ -0,0 +1,3 @@
+srctype = dummy
+type = module
+version = 0.0.0