os -- Basic "operating system" services.
========================================
.. This document was autogenerated by Sphinx-autoapi from a .pyi stub or a source code file.
.. Do not edit this file, instead edit the source file and run Sphinx to update. 
.. Source: docs/stubs/os/__init__.pyi

.. py:module:: os

.. autoapi-nested-parse::

   Basic "operating system" services.

   |see_cpython_module| :mod:`python:os`.

   The ``os`` module contains functions for filesystem access and mounting,
   terminal redirection and duplication, and the ``uname`` and ``urandom``
   functions.



Classes
-------

.. autoapisummary::

   os.VfsFat
   os.VfsLfs1
   os.VfsLfs2
   os.VfsPosix


Functions
---------

.. autoapisummary::

   os.chdir
   os.dupterm
   os.getcwd
   os.ilistdir
   os.listdir
   os.mkdir
   os.mount
   os.remove
   os.rename
   os.rmdir
   os.stat
   os.statvfs
   os.sync
   os.umount
   os.uname
   os.urandom


Module Contents
---------------

.. py:class:: VfsFat(block_dev)

   See `vfs.VfsFat`.


.. py:class:: VfsLfs1(block_dev, readsize=32, progsize=32, lookahead=32)

   See `vfs.VfsLfs1`.


.. py:class:: VfsLfs2(block_dev, readsize=32, progsize=32, lookahead=32, mtime=True)

   See `vfs.VfsLfs2`.


.. py:class:: VfsPosix(root=None)

   See `vfs.VfsPosix`.


.. py:function:: chdir(path) -> _typeshed.Incomplete

   Change current directory.


.. py:function:: dupterm(stream_object, index=0) -> IO

   Duplicate or switch the MicroPython terminal (the REPL) on the given `stream`-like
   object. The *stream_object* argument must be a native stream object, or derive
   from ``io.IOBase`` and implement the ``readinto()`` and
   ``write()`` methods.  The stream should be in non-blocking mode and
   ``readinto()`` should return ``None`` if there is no data available for reading.

   After calling this function all terminal output is repeated on this stream,
   and any input that is available on the stream is passed on to the terminal input.

   The *index* parameter should be a non-negative integer and specifies which
   duplication slot is set.  A given port may implement more than one slot (slot 0
   will always be available) and in that case terminal input and output is
   duplicated on all the slots that are set.

   If ``None`` is passed as the *stream_object* then duplication is cancelled on
   the slot given by *index*.

   The function returns the previous stream-like object in the given slot.


.. py:function:: getcwd() -> _typeshed.Incomplete

   Get the current directory.


.. py:function:: ilistdir(dir: Optional[Any] = None) -> Iterator[Tuple]

   This function returns an iterator which then yields tuples corresponding to
   the entries in the directory that it is listing.  With no argument it lists the
   current directory, otherwise it lists the directory given by *dir*.

   The tuples have the form *(name, type, inode[, size])*:

    - *name* is a string (or bytes if *dir* is a bytes object) and is the name of
      the entry;
    - *type* is an integer that specifies the type of the entry, with 0x4000 for
      directories and 0x8000 for regular files;
    - *inode* is an integer corresponding to the inode of the file, and may be 0
      for filesystems that don't have such a notion.
    - Some platforms may return a 4-tuple that includes the entry's *size*.  For
      file entries, *size* is an integer representing the size of the file
      or -1 if unknown.  Its meaning is currently undefined for directory
      entries.


.. py:function:: listdir(dir: Optional[Any] = None) -> _typeshed.Incomplete

   With no argument, list the current directory.  Otherwise list the given directory.


.. py:function:: mkdir(path) -> _typeshed.Incomplete

   Create a new directory.


.. py:function:: mount(fsobj, mount_point, *, readonly=False) -> _typeshed.Incomplete

   See `vfs.mount`.


.. py:function:: remove(path) -> None

   Remove a file.


.. py:function:: rename(old_path, new_path) -> None

   Rename a file.


.. py:function:: rmdir(path) -> None

   Remove a directory.


.. py:function:: stat(path) -> _typeshed.Incomplete

   Get the status of a file or directory.


.. py:function:: statvfs(path) -> Tuple

   Get the status of a filesystem.

   Returns a tuple with the filesystem information in the following order:

        * ``f_bsize`` -- file system block size
        * ``f_frsize`` -- fragment size
        * ``f_blocks`` -- size of fs in f_frsize units
        * ``f_bfree`` -- number of free blocks
        * ``f_bavail`` -- number of free blocks for unprivileged users
        * ``f_files`` -- number of inodes
        * ``f_ffree`` -- number of free inodes
        * ``f_favail`` -- number of free inodes for unprivileged users
        * ``f_flag`` -- mount flags
        * ``f_namemax`` -- maximum filename length

   Parameters related to inodes: ``f_files``, ``f_ffree``, ``f_avail``
   and the ``f_flags`` parameter may return ``0`` as they can be unavailable
   in a port-specific implementation.


.. py:function:: sync() -> None

   Sync all filesystems.


.. py:function:: umount(mount_point) -> _typeshed.Incomplete

   See `vfs.umount`.


.. py:function:: uname() -> uname_result

   Return a tuple (possibly a named tuple) containing information about the
   underlying machine and/or its operating system.  The tuple has five fields
   in the following order, each of them being a string:

        * ``sysname`` -- the name of the underlying system
        * ``nodename`` -- the network name (can be the same as ``sysname``)
        * ``release`` -- the version of the underlying system
        * ``version`` -- the MicroPython version and build date
        * ``machine`` -- an identifier for the underlying hardware (eg board, CPU)


.. py:function:: urandom(n) -> bytes

   Return a bytes object with *n* random bytes. Whenever possible, it is
   generated by the hardware random number generator.