Skip to main content

A module and utility to work with the simple filesystem on the BBC micro:bit

Project description


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 microfs

…and the package will download from PyPI. If you wish to upgrade to the latest version, use the following command:

$ pip install --no-cache --upgrade microfs


In your code:

from microfs import ls, rm, put, get

From the command line use the “ufs” (“u” = micro) command.

To read the built-in help:

$ ufs --help

List the files on the device:

$ ufs ls

Delete a file on the device:

$ ufs rm foo.txt

Copy a file onto the device:

$ ufs put path/to/file.txt

Get a file from the device:

$ ufs get foo.txt


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

Ensure you have the correct dependencies for development installed by creating a virtualenv and running:

$ pip install -r requirements.txt

To locally install your development version of the module into a virtualenv, run the following command:

$ python develop

There is a Makefile that helps with most of the common workflows associated with development. Typing “make” on its own will list the options thus:


There is no default Makefile target right now. Try:

make clean - reset the project and remove auto-generated assets.
make pyflakes - run the PyFlakes code checker.
make pep8 - run the PEP8 style checker.
make test - run the test suite.
make coverage - view a report on test coverage.
make check - run all the checkers and tests.
make package - create a deployable package for the project.
make publish - publish the project to PyPI.
make docs - run sphinx to create project documentation.

Release History


  • Allow external modules to use built-in device detection and connection.


  • Unlink command logic from device detection and serial connection.


  • Fix broken ‘put’ and ‘get’ commands to work with arbitrary file sizes.

  • Fix error when working with binary data.

  • Update execute function to work with lists of multiple commands.

  • Minor refactor to extract raw mode related code.

  • Updated tests to keep coverage at 100% on both Python 2 and Python 3.


  • Remove spare print call.


  • Fix broken setup.


  • Full implementation of all the expected features.

  • 100% test coverage.

  • Comprehensive documentation.


  • Initial release. Basic functionality.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

microfs-1.1.2.tar.gz (6.1 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page