uos – basic “operating system” services

The os module contains functions for filesystem access and urandom function.

Port specifics

The filesystem 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

uos.chdir(path)

Change current directory.

uos.getcwd()

Get the current directory.

uos.listdir([dir])

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

uos.mkdir(path)

Create a new directory.

uos.remove(path)

Remove a file.

uos.rmdir(path)

Remove a directory.

uos.rename(old_path, new_path)

Rename a file.

uos.stat(path)

Get the status of a file or directory.

uos.sync()

Sync all filesystems.

uos.urandom(n)

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

uos.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')
uos.unmount(path)

Unmounts a prevoulsy mounted block device from the given path.

uos.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.

uos.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

uos.sep

separation character used in paths