A community fork of MicroFS.
A simple command line tool and module for interacting with the limited file system provided by MicroPython on the BBC micro:bit.
To install simply type:
$ pip install microfs2
There are two ways to use microfs - as a module in your Python code or as a
stand-alone command to use from your shell (ufs).
In your Python script import the required functions like this:
from microfs.lib import MicroBitSerial, ls, rm, cp, mv, cat, du, put, get, version
Read the API documentation below to learn how each of the functions works.
From the command line (but not the Python shell) use the "ufs" ("u" = micro) command.
To read the built-in help:
$ ufs --help
To see the version of microfs:
$ ufs --version
To set the device timeout (default is 10 seconds):
$ ufs --timeout 3 command
List the files on the device:
$ ufs ls
You can also specify a delimiter to separate file names displayed on the output (default is whitespace ' '):
# use ';' as a delimiter $ ufs ls ';'
Delete a file on the device:
$ ufs rm foo.txt
Copy a file from one location to another on the device:
$ ufs cp foo.txt bar.txt
Move a file from one location to another on the device:
$ ufs mv foo.txt bar.txt
Display the contents of a file on the device:
$ ufs cat foo.txt
Get the size of a file on the device in bytes:
$ ufs du foo.txt
Copy a file onto the device:
$ ufs put path/to/local.txt
Get a file from the device:
$ ufs get remote.txt
The put and get commands optionally take a further argument to specify
the name of the target file:
$ ufs put /path/to/local.txt remote.txt $ ufs get remote.txt local.txt
Get version information for MicroPython running on the device:
$ ufs version
The source code is hosted in GitHub. Please feel free to fork the repository. Assuming you have Git installed you can download the code from the canonical repository with the following command:
$ git clone https://github.com/blackteahamburger/microfs.git
To locally install your development version of the module into a virtualenv, run the following command:
$ pip install -e ".[dev]"
This also ensures that you have the correct dependencies for development.
There is a Makefile that helps with most of the common workflows associated with development.