""" Basic "operating system" services. MicroPython module: https://docs.micropython.org/en/v1.21.0/library/os.html CPython module: :mod:`python:os` https://docs.python.org/3/library/os.html . The ``os`` module contains functions for filesystem access and mounting, terminal redirection and duplication, and the ``uname`` and ``urandom`` functions. """ from _typeshed import Incomplete, Incomplete as Incomplete from stdlib.os import * from typing import Any, IO, Iterator, Optional, Tuple def 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. """ ... def stat(path) -> Incomplete: """ Get the status of a file or directory. """ ... def rmdir(path) -> None: """ Remove a directory. """ ... def rename(old_path, new_path) -> None: """ Rename a file. """ ... def mount(fsobj, mount_point, *, readonly=False) -> Incomplete: """ Mount the filesystem object *fsobj* at the location in the VFS given by the *mount_point* string. *fsobj* can be a a VFS object that has a ``mount()`` method, or a block device. If it's a block device then the filesystem type is automatically detected (an exception is raised if no filesystem was recognised). *mount_point* may be ``'/'`` to mount *fsobj* at the root, or ``'/'`` to mount it at a subdirectory under the root. If *readonly* is ``True`` then the filesystem is mounted read-only. During the mount process the method ``mount()`` is called on the filesystem object. Will raise ``OSError(EPERM)`` if *mount_point* is already mounted. """ ... def sync() -> None: """ Sync all filesystems. """ ... def unlink(*args, **kwargs) -> Incomplete: ... def 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) """ ... def umount(mount_point) -> Incomplete: """ Unmount a filesystem. *mount_point* can be a string naming the mount location, or a previously-mounted filesystem object. During the unmount process the method ``umount()`` is called on the filesystem object. Will raise ``OSError(EINVAL)`` if *mount_point* is not found. """ ... def urandom(n) -> bytes: """ Return a bytes object with *n* random bytes. Whenever possible, it is generated by the hardware random number generator. """ ... def chdir(path) -> Incomplete: """ Change current directory. """ ... def 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. """ ... def remove(path) -> None: """ Remove a file. """ ... def mkdir(path) -> Incomplete: """ Create a new directory. """ ... def getcwd() -> Incomplete: """ Get the current directory. """ ... def listdir(dir: Optional[Any] = None) -> Incomplete: """ With no argument, list the current directory. Otherwise list the given directory. """ ... def 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. """ ... class VfsLfs2: """ Create a filesystem object that uses the `littlefs v2 filesystem format`_. Storage of the littlefs filesystem is provided by *block_dev*, which must support the :ref:`extended interface `. Objects created by this constructor can be mounted using :func:`mount`. The *mtime* argument enables modification timestamps for files, stored using littlefs attributes. This option can be disabled or enabled differently each mount time and timestamps will only be added or updated if *mtime* is enabled, otherwise the timestamps will remain untouched. Littlefs v2 filesystems without timestamps will work without reformatting and timestamps will be added transparently to existing files once they are opened for writing. When *mtime* is enabled `os.stat` on files without timestamps will return 0 for the timestamp. See :ref:`filesystem` for more information. """ def rename(self, *args, **kwargs) -> Incomplete: ... @staticmethod def mkfs(block_dev, readsize=32, progsize=32, lookahead=32) -> None: """ Build a Lfs2 filesystem on *block_dev*. ``Note:`` There are reports of littlefs v2 failing in certain situations, for details see `littlefs issue 295`_. """ ... def mount(self, *args, **kwargs) -> Incomplete: ... def statvfs(self, *args, **kwargs) -> Incomplete: ... def rmdir(self, *args, **kwargs) -> Incomplete: ... def stat(self, *args, **kwargs) -> Incomplete: ... def umount(self, *args, **kwargs) -> Incomplete: ... def remove(self, *args, **kwargs) -> Incomplete: ... def mkdir(self, *args, **kwargs) -> Incomplete: ... def open(self, *args, **kwargs) -> Incomplete: ... def ilistdir(self, *args, **kwargs) -> Incomplete: ... def chdir(self, *args, **kwargs) -> Incomplete: ... def getcwd(self, *args, **kwargs) -> Incomplete: ... def __init__(self, block_dev, readsize=32, progsize=32, lookahead=32, mtime=True) -> None: ... class VfsFat: """ Create a filesystem object that uses the FAT filesystem format. Storage of the FAT filesystem is provided by *block_dev*. Objects created by this constructor can be mounted using :func:`mount`. """ def rename(self, *args, **kwargs) -> Incomplete: ... @staticmethod def mkfs(block_dev) -> None: """ Build a FAT filesystem on *block_dev*. """ ... def mount(self, *args, **kwargs) -> Incomplete: ... def statvfs(self, *args, **kwargs) -> Incomplete: ... def rmdir(self, *args, **kwargs) -> Incomplete: ... def stat(self, *args, **kwargs) -> Incomplete: ... def umount(self, *args, **kwargs) -> Incomplete: ... def remove(self, *args, **kwargs) -> Incomplete: ... def mkdir(self, *args, **kwargs) -> Incomplete: ... def open(self, *args, **kwargs) -> Incomplete: ... def ilistdir(self, *args, **kwargs) -> Incomplete: ... def chdir(self, *args, **kwargs) -> Incomplete: ... def getcwd(self, *args, **kwargs) -> Incomplete: ... def __init__(self, block_dev) -> None: ...