Mbed Project

Overview

This package supports the creation and management of Mbed OS projects using .

Common actions supported by this tooling are

• Creation of a new Mbed OS applications.
• Cloning of an existing Mbed OS project.
• Checkout of a specific version of Mbed OS or library.

It is expected that this package will be used by developers of Mbed OS tooling rather than by users of Mbed OS. For a command line interface for Mbed OS please see the package mbed-tools.

Releases

For release notes and a history of changes of all production releases, please see the following:

• Changelog

For a the list of all available versions please, please see the:

• PyPI Release History

Versioning

The version scheme used follows PEP440 and Semantic Versioning. For production quality releases the version will look as follows:

• <major>.<minor>.<patch>

Beta releases are used to give early access to new functionality, for testing and to get feedback on experimental features. As such these releases may not be stable and should not be used for production. Additionally any interfaces introduced in a beta release may be removed or changed without notice. For beta releases the version will look as follows:

• <major>.<minor>.<patch>-beta.<pre-release-number>

Installation

It is recommended that a virtual environment such as Pipenv is used for all installations to avoid Python dependency conflicts.

To install the most recent production quality release use:

pip install mbed-project

To install a specific release:

pip install mbed-project==<version>

Usage

Interface definition and usage documentation (for developers of Mbed OS tooling) is available for the most recent production release here:

• GitHub Pages

Project Structure

The follow described the major aspects of the project structure:

• azure-pipelines/ - CI configuration files for Azure Pipelines.
• docs/ - Interface definition and usage documentation.
• examples/ - Usage examples.
• mbed_project/ - Python source files.
• news/ - Collection of news files for unreleased changes.
• tests/ - Unit and integration tests.

Getting Help

• For interface definition and usage documentation, please see GitHub Pages.
• For a list of known issues and possible work arounds, please see Known Issues.
• To raise a defect or enhancement please use GitHub Issues.
• To ask a question please use the Mbed Forum.

Contributing

• Mbed OS is an open source project and we are committed to fostering a welcoming community, please see our Code of Conduct for more information.
• For ways to contribute to the project, please see the Contributions Guidelines
• For a technical introduction into developing this package, please see the Development Guide