os – basic “operating system” services¶

Pyboard specifics¶

The filesystem on the pyboard has / as the root directory and the available physical drives are accessible from here. They are currently:

/flash – the internal flash filesystem

/sd – the SD card (if it exists)

On boot up, the current directory is /flash.

Functions¶

os.chdir(path)¶

Change current directory.

os.getcwd()¶

Get the current directory.

os.listdir([dir])¶

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

os.mkdir(path)¶

Create a new directory.

os.remove(path)¶

Remove a file.

os.rmdir(path)¶

Remove a directory.

os.rename(old_path, new_path)¶

Rename a file.

os.stat(path)¶

Get the status of a file or directory.

os.sync()¶

Sync all filesystems.

os.urandom(n)¶

Return a bytes object with n random bytes, generated by the hardware random number generator.

os.mount(block_device, mount_point, *, readonly=False)¶

Mounts a block device (like an SD object) in the specified mount point. Example:

os.mount(sd, '/sd')

os.unmount(path)¶

Unmounts a prevoulsy mounted block device from the given path.

os.mkfs(block_device or path)¶

Formats the specified path, must be either /flash or /sd. A block device can also be passed like an SD object before being mounted.

os.dupterm(stream_object)¶

Duplicate the terminal (the REPL) on the passed stream-like object. The given object must at least implement the .read() and .write() methods.

Constants¶

os.sep¶

separation character used in paths