mbed-tools


Namembed-tools JSON
Version 7.23.0 PyPI version JSON
download
home_pagehttps://github.com/ARMmbed/mbed-tools
SummaryCommand line interface for Mbed OS.
upload_time2021-06-17 05:04:15
maintainer
docs_urlNone
authorMbed team
requires_python>=3.6,<4
licenseApache 2.0
keywords arm mbed os mbedos cli command line tools
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Mbed Tools

![Package](https://badgen.net/badge/Package/mbed-tools/grey)
[![Documentation](https://badgen.net/badge/Documentation/GitHub%20Pages/blue?icon=github)](https://armmbed.github.io/mbed-tools/api/)
[![PyPI](https://badgen.net/pypi/v/mbed-tools)](https://pypi.org/project/mbed-tools/)
[![PyPI - Status](https://img.shields.io/pypi/status/mbed-tools)](https://pypi.org/project/mbed-tools/)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/mbed-tools)](https://pypi.org/project/mbed-tools/)

[![License](https://badgen.net/pypi/license/mbed-tools)](https://github.com/ARMmbed/mbed-tools/blob/master/LICENSE)

[![Build Status](https://dev.azure.com/mbed-tools/mbed-tools/_apis/build/status/Build%20and%20Release?branchName=master&stageName=CI%20Checkpoint)](https://dev.azure.com/mbed-tools/mbed-tools/_build/latest?definitionId=10&branchName=master)
[![Test Coverage](https://codecov.io/gh/ARMmbed/mbed-tools/branch/master/graph/badge.svg)](https://codecov.io/gh/ARMmbed/mbed-tools)
[![Maintainability](https://api.codeclimate.com/v1/badges/b9fca0e16f7a85da7674/maintainability)](https://codeclimate.com/github/ARMmbed/mbed-tools/maintainability)

## Overview

This is the **future** command line tool for Mbed OS. It provides the ability to detect Mbed Enabled devices connected
by USB, checkout Mbed projects and perform builds amongst other operations.

> :warning: While this package is generally available it is not complete. The available functionality can be viewed with
> the `--help` option once installed. Please note that the current tools for Mbed OS 5.x and above can be found at
> https://github.com/ARMmbed/mbed-cli.

## Releases

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

- [Changelog](https://github.com/ARMmbed/mbed-tools/blob/master/CHANGELOG.md)

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

- [PyPI Release History](https://pypi.org/project/mbed-tools/#history)

## Versioning

The version scheme used follows [PEP440](https://www.python.org/dev/peps/pep-0440/) and
[Semantic Versioning](https://semver.org/). For production quality releases the version will look as follows:

- `<major>.<minor>.<patch>`

Pre 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 pre release may be removed or changed without notice. For pre releases the version will look as
follows:

- `<major>.<minor>.<patch>.dev<pre-release-number>`

## Installation

`mbed-tools` relies on the Ninja build system and CMake.
- CMake. [Install version 3.19.0 or newer for all operating systems](https://cmake.org/install/).
- Ninja. [Install version 1.0 or newer for all operating systems](https://github.com/ninja-build/ninja/wiki/Pre-built-Ninja-packages).

We recommend installing `mbed-tools` in a Python virtual environment to avoid dependency conflicts.

To install the most recent production quality release use:

```
pip install mbed-tools
```

To install a specific release:

```
pip install mbed-tools==<version>
```

## Usage

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

- [GitHub Pages](https://armmbed.github.io/mbed-tools/api/)

## Project Structure

The follow described the major aspects of the project structure:

- `azure-pipelines/` - CI configuration files for Azure Pipelines.
- `docs/api` - Interface definition and usage documentation.
- `src/mbed_tools/` - 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](https://armmbed.github.io/mbed-tools/api/).
- For a list of known issues and possible work arounds, please see [Known Issues](KNOWN_ISSUES.md).
- To raise a defect or enhancement please use [GitHub Issues](https://github.com/ARMmbed/mbed-tools/issues).
- To ask a question please use the [Mbed Forum](https://forums.mbed.com/).

## Contributing

- Mbed OS is an open source project and we are committed to fostering a welcoming community, please see our
  [Code of Conduct](https://github.com/ARMmbed/mbed-tools/blob/master/CODE_OF_CONDUCT.md) for more information.
- For how to contribute to the project, including how to develop the project,
  please see the [Contributions Guidelines](https://github.com/ARMmbed/mbed-tools/blob/master/CONTRIBUTING.md)



            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/ARMmbed/mbed-tools",
    "name": "mbed-tools",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.6,<4",
    "maintainer_email": "",
    "keywords": "Arm Mbed OS MbedOS cli command line tools",
    "author": "Mbed team",
    "author_email": "support@mbed.com",
    "download_url": "https://files.pythonhosted.org/packages/e6/4f/242727328cdd9ebbc8e573812261da1b2490051eed3b955089d24c94a7d4/mbed-tools-7.23.0.tar.gz",
    "platform": "",
    "description": "# Mbed Tools\n\n![Package](https://badgen.net/badge/Package/mbed-tools/grey)\n[![Documentation](https://badgen.net/badge/Documentation/GitHub%20Pages/blue?icon=github)](https://armmbed.github.io/mbed-tools/api/)\n[![PyPI](https://badgen.net/pypi/v/mbed-tools)](https://pypi.org/project/mbed-tools/)\n[![PyPI - Status](https://img.shields.io/pypi/status/mbed-tools)](https://pypi.org/project/mbed-tools/)\n[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/mbed-tools)](https://pypi.org/project/mbed-tools/)\n\n[![License](https://badgen.net/pypi/license/mbed-tools)](https://github.com/ARMmbed/mbed-tools/blob/master/LICENSE)\n\n[![Build Status](https://dev.azure.com/mbed-tools/mbed-tools/_apis/build/status/Build%20and%20Release?branchName=master&stageName=CI%20Checkpoint)](https://dev.azure.com/mbed-tools/mbed-tools/_build/latest?definitionId=10&branchName=master)\n[![Test Coverage](https://codecov.io/gh/ARMmbed/mbed-tools/branch/master/graph/badge.svg)](https://codecov.io/gh/ARMmbed/mbed-tools)\n[![Maintainability](https://api.codeclimate.com/v1/badges/b9fca0e16f7a85da7674/maintainability)](https://codeclimate.com/github/ARMmbed/mbed-tools/maintainability)\n\n## Overview\n\nThis is the **future** command line tool for Mbed OS. It provides the ability to detect Mbed Enabled devices connected\nby USB, checkout Mbed projects and perform builds amongst other operations.\n\n> :warning: While this package is generally available it is not complete. The available functionality can be viewed with\n> the `--help` option once installed. Please note that the current tools for Mbed OS 5.x and above can be found at\n> https://github.com/ARMmbed/mbed-cli.\n\n## Releases\n\nFor release notes and a history of changes of all **production** releases, please see the following:\n\n- [Changelog](https://github.com/ARMmbed/mbed-tools/blob/master/CHANGELOG.md)\n\nFor a the list of all available versions please, please see the:\n\n- [PyPI Release History](https://pypi.org/project/mbed-tools/#history)\n\n## Versioning\n\nThe version scheme used follows [PEP440](https://www.python.org/dev/peps/pep-0440/) and\n[Semantic Versioning](https://semver.org/). For production quality releases the version will look as follows:\n\n- `<major>.<minor>.<patch>`\n\nPre releases are used to give early access to new functionality, for testing and to get feedback on experimental\nfeatures. As such these releases may not be stable and should not be used for production. Additionally any interfaces\nintroduced in a pre release may be removed or changed without notice. For pre releases the version will look as\nfollows:\n\n- `<major>.<minor>.<patch>.dev<pre-release-number>`\n\n## Installation\n\n`mbed-tools` relies on the Ninja build system and CMake.\n- CMake. [Install version 3.19.0 or newer for all operating systems](https://cmake.org/install/).\n- Ninja. [Install version 1.0 or newer for all operating systems](https://github.com/ninja-build/ninja/wiki/Pre-built-Ninja-packages).\n\nWe recommend installing `mbed-tools` in a Python virtual environment to avoid dependency conflicts.\n\nTo install the most recent production quality release use:\n\n```\npip install mbed-tools\n```\n\nTo install a specific release:\n\n```\npip install mbed-tools==<version>\n```\n\n## Usage\n\nInterface definition and usage documentation (for developers of Mbed OS tooling) is available for the most recent\nproduction release here:\n\n- [GitHub Pages](https://armmbed.github.io/mbed-tools/api/)\n\n## Project Structure\n\nThe follow described the major aspects of the project structure:\n\n- `azure-pipelines/` - CI configuration files for Azure Pipelines.\n- `docs/api` - Interface definition and usage documentation.\n- `src/mbed_tools/` - Python source files.\n- `news/` - Collection of news files for unreleased changes.\n- `tests/` - Unit and integration tests.\n\n## Getting Help\n\n- For interface definition and usage documentation, please see [GitHub Pages](https://armmbed.github.io/mbed-tools/api/).\n- For a list of known issues and possible work arounds, please see [Known Issues](KNOWN_ISSUES.md).\n- To raise a defect or enhancement please use [GitHub Issues](https://github.com/ARMmbed/mbed-tools/issues).\n- To ask a question please use the [Mbed Forum](https://forums.mbed.com/).\n\n## Contributing\n\n- Mbed OS is an open source project and we are committed to fostering a welcoming community, please see our\n  [Code of Conduct](https://github.com/ARMmbed/mbed-tools/blob/master/CODE_OF_CONDUCT.md) for more information.\n- For how to contribute to the project, including how to develop the project,\n  please see the [Contributions Guidelines](https://github.com/ARMmbed/mbed-tools/blob/master/CONTRIBUTING.md)\n\n\n",
    "bugtrack_url": null,
    "license": "Apache 2.0",
    "summary": "Command line interface for Mbed OS.",
    "version": "7.23.0",
    "split_keywords": [
        "arm",
        "mbed",
        "os",
        "mbedos",
        "cli",
        "command",
        "line",
        "tools"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "72bb55ea7627e165e4afee042476dca2",
                "sha256": "6db67a1f9ace8404c8605d4ea30bf4d8765083c4a223a1cd9e6338cbdd9b6076"
            },
            "downloads": -1,
            "filename": "mbed_tools-7.23.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "72bb55ea7627e165e4afee042476dca2",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6,<4",
            "size": 127070,
            "upload_time": "2021-06-17T05:04:13",
            "upload_time_iso_8601": "2021-06-17T05:04:13.589262Z",
            "url": "https://files.pythonhosted.org/packages/0d/a6/62e8f6c67855edf8561ed510d21299da481c8887b2d0b02d6875e8caedb0/mbed_tools-7.23.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "ff11cc6fa1ff525b947ba4872c04ddf6",
                "sha256": "799b8af5f279899971e66c2eb751a0d0b614c580a485f3501db52f78da4592ed"
            },
            "downloads": -1,
            "filename": "mbed-tools-7.23.0.tar.gz",
            "has_sig": false,
            "md5_digest": "ff11cc6fa1ff525b947ba4872c04ddf6",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6,<4",
            "size": 150658,
            "upload_time": "2021-06-17T05:04:15",
            "upload_time_iso_8601": "2021-06-17T05:04:15.543153Z",
            "url": "https://files.pythonhosted.org/packages/e6/4f/242727328cdd9ebbc8e573812261da1b2490051eed3b955089d24c94a7d4/mbed-tools-7.23.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2021-06-17 05:04:15",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "github_user": null,
    "github_project": "ARMmbed",
    "error": "Could not fetch GitHub repository",
    "lcname": "mbed-tools"
}
        
Elapsed time: 0.41547s