Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rbedia/circman

CircuitPython deployment manager
https://github.com/rbedia/circman

circuitpython python

Last synced: 8 days ago
JSON representation

CircuitPython deployment manager

Host: GitHub
URL: https://github.com/rbedia/circman
Owner: rbedia
License: mit
Created: 2023-02-27T17:29:35.000Z (almost 2 years ago)
Default Branch: main
Last Pushed: 2024-11-04T21:56:36.000Z (about 2 months ago)
Last Synced: 2024-11-13T11:46:01.326Z (about 1 month ago)
Topics: circuitpython, python
Language: Python
Homepage: https://circman.readthedocs.io/en/stable/
Size: 463 KB
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        # CircuitPython Manager

[![PyPI](https://img.shields.io/pypi/v/circman.svg)][pypi status]

[![Status](https://img.shields.io/pypi/status/circman.svg)][pypi status]

[![Python Version](https://img.shields.io/pypi/pyversions/circman)][pypi status]

[![License](https://img.shields.io/pypi/l/circman)][license]

[![Read the documentation at https://circman.readthedocs.io/](https://img.shields.io/readthedocs/circman/latest.svg?label=Read%20the%20Docs)][read the docs]

[![Tests](https://github.com/rbedia/circman/workflows/Tests/badge.svg)][tests]

[![Codecov](https://codecov.io/gh/rbedia/circman/branch/main/graph/badge.svg)][codecov]

[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)][pre-commit]

[![Black](https://img.shields.io/badge/code%20style-black-000000.svg)][black]

[pypi status]: https://pypi.org/project/circman/

[read the docs]: https://circman.readthedocs.io/

[tests]: https://github.com/rbedia/circman/actions?workflow=Tests

[codecov]: https://app.codecov.io/gh/rbedia/circman

[pre-commit]: https://github.com/pre-commit/pre-commit

[black]: https://github.com/psf/black

CircuitPython Manager helps with deploying projects to CircuitPython devices.

## Features

- Automatically detects CircuitPython device path.

- Backs up the CircuitPython device before deploying to allow recovery.

- Simple command to restore a backup to the CircuitPython device in case something goes wrong.

## Requirements

- Linux. May work elsewhere but not tested.

## Installation

You can install _CircuitPython Manager_ via [pip] from [PyPI]:

```console

$ pip install circman

```

## Quick Start

Connect your CircuitPython device to your computer using USB and wait for the

mount to appear.

Change to the directory of your CircuitPython project. The default is for the

project source code to be in **src/** relative to the project directory.

Then run the deploy.

```console

$ circman deploy

```

A backup of the CircuitPython device will be created and then the project source code will be copied to the CircuitPython device.

If you need to restore the code from before the deploy use the restore command.

```console

$ circman restore

```

To list all available backups:

```console

$ circman list

```

If you made a change directly on the CircuitPython device you can copy it back

to the project source directory. The default destination directory is **src/**.

No backup of the destination is created prior to copying so use with caution.

Ideally the destination directory is under version control to identify changes and

restore if needed.

```console

$ circman sync

```

## Usage

Please see the [Command-line Reference] for details.

## Contributing

Contributions are very welcome.

To learn more, see the [Contributor Guide].

## License

Distributed under the terms of the [MIT license][license],

_CircuitPython Manager_ is free and open source software.

## Issues

If you encounter any problems,

please [file an issue] along with a detailed description.

## Credits

Device path detection code (`find_device()`) was copied from Adafruit's [circup] project.

This project was generated from [@rbedia]'s [Hypermodern Python Cookiecutter] template.

[circup]: https://github.com/adafruit/circup

[@rbedia]: https://github.com/rbedia

[pypi]: https://pypi.org/

[hypermodern python cookiecutter]: https://github.com/rbedia/cookiecutter-hypermodern-python

[file an issue]: https://github.com/rbedia/circman/issues

[pip]: https://pip.pypa.io/

[license]: https://github.com/rbedia/circman/blob/main/LICENSE

[contributor guide]: https://github.com/rbedia/circman/blob/main/CONTRIBUTING.md

[command-line reference]: https://circman.readthedocs.io/en/latest/usage.html