Permalink
Fetching contributors…
Cannot retrieve contributors at this time
54 lines (35 sloc) 1.62 KB

The os Module

.. py:module:: os

MicroPython contains an os module based upon the os module in the Python standard library. It's used for accessing what would traditionally be termed as operating system dependent functionality. Since there is no operating system in MicroPython the module provides functions relating to the management of the simple on-device persistent file system and information about the current system.

To access this module you need to:

import os

We assume you have done this for the examples below.

Functions

.. py:function:: listdir()

    Returns a list of the names of all the files contained within the local
    persistent on-device file system.

.. py:function:: remove(filename)

    Removes (deletes) the file named in the argument ``filename``. If the file
    does not exist an ``OSError`` exception will occur.

.. py:function:: size(filename)

    Returns the size, in bytes, of the file named in the argument ``filename``.
    If the file does not exist an ``OSError`` exception will occur.

.. py:function:: uname()

    Returns information identifying the current operating system. The return
    value is an object with five attributes:

    * ``sysname`` - operating system name
    * ``nodename`` - name of machine on network (implementation-defined)
    * ``release`` - operating system release
    * ``version`` - operating system version
    * ``machine`` - hardware identifier


Note

There is no underlying operating system in MicroPython. As a result the information returned by the uname function is mostly useful for versioning details.